/* * This file define a set of standard wireless extensions * * Version :	9	16.10.99 * * Authors :	Jean Tourrilhes - HPL - <jt@hpl.hp.com> */#ifndef _LINUX_WIRELESS_H#define _LINUX_WIRELESS_H/************************** DOCUMENTATION **************************//* * Basically, the wireless extensions are for now a set of standard ioctl * call + /proc/net/wireless * * The entry /proc/net/wireless give statistics and information on the * driver. * This is better than having each driver having its entry because * its centralised and we may remove the driver module safely. * * Ioctl are used to configure the driver and issue commands.  This is * better than command line options of insmod because we may want to * change dynamically (while the driver is running) some parameters. * * The ioctl mechanimsm are copied from standard devices ioctl. * We have the list of command plus a structure descibing the * data exchanged... * Note that to add these ioctl, I was obliged to modify : *	net/core/dev.c (two place + add include) *	net/ipv4/af_inet.c (one place + add include) * * /proc/net/wireless is a copy of /proc/net/dev. * We have a structure for data passed from the driver to /proc/net/wireless * Too add this, I've modified : *	net/core/dev.c (two other places) *	include/linux/netdevice.h (one place) *	include/linux/proc_fs.h (one place) * * Do not add here things that are redundant with other mechanisms * (drivers init, ifconfig, /proc/net/dev, ...) and with are not * wireless specific. * * These wireless extensions are not magic : each driver has to provide * support for them... * * IMPORTANT NOTE : As everything in the kernel, this is very much a * work in progress. Contact me if you have ideas of improvements... *//***************************** INCLUDES *****************************/#include <linux/types.h>		/* for "caddr_t" et al		*/#include <linux/socket.h>		/* for "struct sockaddr" et al	*/#include <linux/if.h>			/* for IFNAMSIZ and co... *//**************************** CONSTANTS ****************************//* --------------------------- VERSION --------------------------- *//* * This constant is used to know the availability of the wireless * extensions and to know which version of wireless extensions it is * (there is some stuff that will be added in the future...) * I just plan to increment with each new version. */#define WIRELESS_EXT	9/* * Changes : * * V2 to V3 * -------- *	Alan Cox start some incompatibles changes. I've integrated a bit more. *	- Encryption renamed to Encode to avoid US regulation problems *	- Frequency changed from float to struct to avoid problems on old 386 * * V3 to V4 * -------- *	- Add sensitivity * * V4 to V5 * -------- *	- Missing encoding definitions in range *	- Access points stuff * * V5 to V6 * -------- *	- 802.11 support (ESSID ioctls) * * V6 to V7 * -------- *	- define IW_ESSID_MAX_SIZE and IW_MAX_AP * * V7 to V8 * -------- *	- Changed my e-mail address *	- More 802.11 support (nickname, rate, rts, frag) *	- List index in frequencies * * V8 to V9 * -------- *	- Support for 'mode of operation' (ad-hoc, managed...) *	- Support for unicast and multicast power saving *	- Change encoding to support larger tokens (>64 bits) *	- Updated iw_params (disable, flags) and use it for NWID *	- Extracted iw_point from iwreq for clarity *//* -------------------------- IOCTL LIST -------------------------- *//* Basic operations */#define SIOCSIWNAME	0x8B00		/* Unused ??? */#define SIOCGIWNAME	0x8B01		/* get name */#define SIOCSIWNWID	0x8B02		/* set network id (the cell) */#define SIOCGIWNWID	0x8B03		/* get network id */#define SIOCSIWFREQ	0x8B04		/* set channel/frequency */#define SIOCGIWFREQ	0x8B05		/* get channel/frequency */#define SIOCSIWMODE	0x8B06		/* set operation mode */#define SIOCGIWMODE	0x8B07		/* get operation mode */#define SIOCSIWSENS	0x8B08		/* set sensitivity */#define SIOCGIWSENS	0x8B09		/* get sensitivity *//* Informative stuff */#define SIOCSIWRANGE	0x8B0A		/* Unused ??? */#define SIOCGIWRANGE	0x8B0B		/* Get range of parameters */#define SIOCSIWPRIV	0x8B0C		/* Unused ??? */#define SIOCGIWPRIV	0x8B0D		/* get private ioctl interface info *//* Mobile IP support */#define SIOCSIWSPY	0x8B10		/* set spy addresses */#define SIOCGIWSPY	0x8B11		/* get spy info (quality of link) *//* Access Point manipulation */#define SIOCSIWAP	0x8B14		/* set access point MAC addresses */#define SIOCGIWAP	0x8B15		/* get access point MAC addresses */#define SIOCGIWAPLIST	0x8B17		/* get list of access point in range *//* 802.11 specific support */#define SIOCSIWESSID	0x8B1A		/* set ESSID (network name) */#define SIOCGIWESSID	0x8B1B		/* get ESSID */#define SIOCSIWNICKN	0x8B1C		/* set node name/nickname */#define SIOCGIWNICKN	0x8B1D		/* get node name/nickname *//* As the ESSID and NICKN are strings up to 32 bytes long, it doesn't fit * within the 'iwreq' structure, so we need to use the 'data' member to * point to a string in user space, like it is done for RANGE... * The "flags" member indicate if the ESSID is active or not (promiscuous). *//* Other parameters usefull in 802.11 and some other devices */#define SIOCSIWRATE	0x8B20		/* set default bit rate (bps) */#define SIOCGIWRATE	0x8B21		/* get default bit rate (bps) */#define SIOCSIWRTS	0x8B22		/* set RTS/CTS threshold (bytes) */#define SIOCGIWRTS	0x8B23		/* get RTS/CTS threshold (bytes) */#define SIOCSIWFRAG	0x8B24		/* set fragmentation thr (bytes) */#define SIOCGIWFRAG	0x8B25		/* get fragmentation thr (bytes) *//* Encoding stuff (scrambling, hardware security, WEP...) */#define SIOCSIWENCODE	0x8B2A		/* set encoding token & mode */#define SIOCGIWENCODE	0x8B2B		/* get encoding token & mode *//* Power saving stuff (power management, unicast and multicast) */#define SIOCSIWPOWER	0x8B2C		/* set Power Management settings */#define SIOCGIWPOWER	0x8B2D		/* get Power Management settings *//* ------------------------- IOCTL STUFF ------------------------- *//* The first and the last (range) */#define SIOCIWFIRST	0x8B00#define SIOCIWLAST	0x8B30/* Even : get (world access), odd : set (root access) */#define IW_IS_SET(cmd)	(!((cmd) & 0x1))#define IW_IS_GET(cmd)	((cmd) & 0x1)/* ------------------------- PRIVATE INFO ------------------------- *//* * The following is used with SIOCGIWPRIV. It allow a driver to define * the interface (name, type of data) for its private ioctl. * Privates ioctl are SIOCDEVPRIVATE -> SIOCDEVPRIVATE + 0xF */#define IW_PRIV_TYPE_MASK	0x7000	/* Type of arguments */#define IW_PRIV_TYPE_NONE	0x0000#define IW_PRIV_TYPE_BYTE	0x1000	/* Char as number */#define IW_PRIV_TYPE_CHAR	0x2000	/* Char as character */#define IW_PRIV_TYPE_INT	0x4000	/* 32 bits int */#define IW_PRIV_TYPE_FLOAT	0x5000#define IW_PRIV_SIZE_FIXED	0x0800	/* Variable or fixed nuber of args */#define IW_PRIV_SIZE_MASK	0x07FF	/* Max number of those args *//* * Note : if the number of args is fixed and the size < 16 octets, * instead of passing a pointer we will put args in the iwreq struct... *//* ----------------------- OTHER CONSTANTS ----------------------- *//* Maximum frequencies in the range struct */#define IW_MAX_FREQUENCIES	16/* Note : if you have something like 80 frequencies, * don't increase this constant and don't fill the frequency list. * The user will be able to set by channel anyway... *//* Maximum bit rates in the range struct */#define IW_MAX_BITRATES		8/* Maximum of address that you may set with SPY */#define IW_MAX_SPY		8/* Maximum of address that you may get in the   list of access points in range */#define IW_MAX_AP		8/* Maximum size of the ESSID and NICKN strings */#define IW_ESSID_MAX_SIZE	32/* Modes of operation */#define IW_MODE_AUTO	0	/* Let the driver decides */#define IW_MODE_ADHOC	1	/* Single cell network */#define IW_MODE_INFRA	2	/* Multi cell network, roaming, ... */#define IW_MODE_MASTER	3	/* Synchronisation master or Access Point */#define IW_MODE_REPEAT	4	/* Wireless Repeater (forwarder) */#define IW_MODE_SECOND	5	/* Secondary master/repeater (backup) *//* Maximum number of size of encoding token available * they are listed in the range structure */#define IW_MAX_ENCODING_SIZES	8/* Maximum size of the encoding token in bytes */#define IW_ENCODING_TOKEN_MAX	32	/* 256 bits (for now) *//* Flags for encoding (along with the token) */#define IW_ENCODE_INDEX		0x00FF	/* Token index (if needed) */#define IW_ENCODE_FLAGS		0xF000	/* Flags defined below */#define IW_ENCODE_DISABLED	0x8000	/* Encoding disabled */#define IW_ENCODE_ENABLED	0x0000	/* Encoding enabled */#define IW_ENCODE_RESTRICTED	0x4000	/* Refuse non-encoded packets */#define IW_ENCODE_OPEN		0x2000	/* Accept non-encoded packets *//* Power management flags available (along with the value, if any) */#define IW_POWER_ON		0x0000	/* No details... */#define IW_POWER_TYPE		0xF000	/* Type of parameter */#define IW_POWER_PERIOD		0x1000	/* Value is a period/duration of  */#define IW_POWER_TIMEOUT	0x2000	/* Value is a timeout (to go asleep) */#define IW_POWER_MODE		0x0F00	/* Power Management mode */#define IW_POWER_UNICAST_R	0x0100	/* Receive only unicast messages */#define IW_POWER_MULTICAST_R	0x0200	/* Receive only multicast messages */#define IW_POWER_ALL_R		0x0300	/* Receive all messages though PM */#define IW_POWER_FORCE_S	0x0400	/* Force PM procedure for sending unicast */#define IW_POWER_REPEATER	0x0800	/* Repeat broadcast messages in PM period *//****************************** TYPES ******************************//* --------------------------- SUBTYPES --------------------------- *//* *	Generic format for most parameters that fit in an int */struct	iw_param{  __s32		value;		/* The value of the parameter itself */  __u8		fixed;		/* Hardware should not use auto select */  __u8		disabled;	/* Disable the feature */  __u16		flags;		/* Various specifc flags (if any) */};/* *	For all data larger than 16 octets, we need to use a *	pointer to memory alocated in user space. */struct	iw_point{  caddr_t	pointer;	/* Pointer to the data  (in user space) */  __u16		length;		/* number of fields or size in bytes */  __u16		flags;		/* Optional params */};/* *	A frequency *	For numbers lower than 10^9, we encode the number in 'm' and *	set 'e' to 0 *	For number greater than 10^9, we divide it by the lowest power *	of 10 to get 'm' lower than 10^9, with 'm'= f / (10^'e')... *	The power of 10 is in 'e', the result of the division is in 'm'. */struct	iw_freq{	__u32		m;		/* Mantissa */	__u16		e;		/* Exponent */	__u8		i;		/* List index (when in range struct) */};/* *	Quality of the link */struct	iw_quality{	__u8		qual;		/* link quality (%retries, SNR or better...) */	__u8		level;		/* signal level */	__u8		noise;		/* noise level */	__u8		updated;	/* Flags to know if updated */};/* *	Packet discarded in the wireless adapter due to *	"wireless" specific problems... */struct	iw_discarded{	__u32		nwid;		/* Wrong nwid */	__u32		code;		/* Unable to code/decode */	__u32		misc;		/* Others cases */};/* ------------------------ WIRELESS STATS ------------------------ *//* * Wireless statistics (used for /proc/net/wireless) */struct	iw_statistics{	__u16		status;		/* Status					 * - device dependent for now */	struct iw_quality	qual;		/* Quality of the link						 * (instant/mean/max) */	struct iw_discarded	discard;	/* Packet discarded counts */};/* ------------------------ IOCTL REQUEST ------------------------ *//* * The structure to exchange data for ioctl. * This structure is the same as 'struct ifreq', but (re)defined for * convenience... * * Note that it should fit on the same memory footprint ! * You should check this when increasing the above structures (16 octets) * 16 octets = 128 bits. Warning, pointers might be 64 bits wide... */struct	iwreq {	union	{		char	ifrn_name[IFNAMSIZ];	/* if name, e.g. "eth0" */	} ifr_ifrn;	/* Data part */	union	{		/* Config - generic */		char		name[IFNAMSIZ];		/* Name : used to verify the presence of  wireless extensions.		 * Name of the protocol/provider... */		struct iw_point	essid;	/* Extended network name */		struct iw_param	nwid;	/* network id (or domain - the cell) */		struct iw_freq	freq;	/* frequency or channel :					 * 0-1000 = channel					 * > 1000 = frequency in Hz */		struct iw_param	sens;		/* signal level threshold */		struct iw_param	bitrate;	/* default bit rate */		struct iw_param	rts;		/* RTS threshold threshold */		struct iw_param	frag;		/* Fragmentation threshold */		__u32		mode;		/* Operation mode */		struct iw_point	encoding;	/* Encoding stuff : tokens */		struct iw_param	power;		/* PM duration/timeout */		struct sockaddr	ap_addr;	/* Access point address */		struct iw_point	data;		/* Other large parameters */	}	u;};/* -------------------------- IOCTL DATA -------------------------- *//* *	For those ioctl which want to exchange mode data that what could *	fit in the above structure... *//* *	Range of parameters */struct	iw_range{	/* Informative stuff (to choose between different interface) */	__u32		throughput;	/* To give an idea... */	/* In theory this value should be the maximum benchmarked	 * TCP/IP throughput, because with most of these devices the	 * bit rate is meaningless (overhead an co) to estimate how	 * fast the connection will go and pick the fastest one.	 * I suggest people to play with Netperf or any benchmark...	 */	/* NWID (or domain id) */	__u32		min_nwid;	/* Minimal NWID we are able to set */	__u32		max_nwid;	/* Maximal NWID we are able to set */	/* Frequency */	__u16		num_channels;	/* Number of channels [0; num - 1] */	__u8		num_frequency;	/* Number of entry in the list */	struct iw_freq	freq[IW_MAX_FREQUENCIES];	/* list */	/* Note : this frequency list doesn't need to fit channel numbers */	/* signal level threshold range */	__s32	sensitivity;	/* Quality of link & SNR stuff */	struct iw_quality	max_qual;	/* Quality of the link */	/* Rates */	__u8		num_bitrates;	/* Number of entries in the list */	__s32		bitrate[IW_MAX_BITRATES];	/* list, in bps */	/* RTS threshold */	__s32		min_rts;	/* Minimal RTS threshold */	__s32		max_rts;	/* Maximal RTS threshold */	/* Frag threshold */	__s32		min_frag;	/* Minimal frag threshold */	__s32		max_frag;	/* Maximal frag threshold */	/* Power Management duration & timeout */	__s32		min_pmd;	/* Minimal PM duration */	__s32		max_pmd;	/* Maximal PM duration */	__s32		min_pmt;	/* Minimal PM timeout */	__s32		max_pmt;	/* Maximal PM timeout */	/* Encoder stuff */	__u16	encoding_size[IW_MAX_ENCODING_SIZES];	/* Different token sizes */	__u8	num_encoding_sizes;	/* Number of entry in the list */	__u8	max_encoding_tokens;	/* Max number of tokens */};/* * Private ioctl interface information */ struct	iw_priv_args{	__u32		cmd;		/* Number of the ioctl to issue */	__u16		set_args;	/* Type and number of args */	__u16		get_args;	/* Type and number of args */	char		name[IFNAMSIZ];	/* Name of the extension */};#endif	/* _LINUX_WIRELESS_H */