2 * This file define a set of standard wireless extensions
6 * Authors : Jean Tourrilhes - HPL - <jt@hpl.hp.com>
7 * Copyright (c) 1997-2002 Jean Tourrilhes, All Rights Reserved.
10 #ifndef _LINUX_WIRELESS_H
11 #define _LINUX_WIRELESS_H
13 /************************** DOCUMENTATION **************************/
15 * Initial APIs (1996 -> onward) :
16 * -----------------------------
17 * Basically, the wireless extensions are for now a set of standard ioctl
18 * call + /proc/net/wireless
20 * The entry /proc/net/wireless give statistics and information on the
22 * This is better than having each driver having its entry because
23 * its centralised and we may remove the driver module safely.
25 * Ioctl are used to configure the driver and issue commands. This is
26 * better than command line options of insmod because we may want to
27 * change dynamically (while the driver is running) some parameters.
29 * The ioctl mechanimsm are copied from standard devices ioctl.
30 * We have the list of command plus a structure descibing the
32 * Note that to add these ioctl, I was obliged to modify :
33 * # net/core/dev.c (two place + add include)
34 * # net/ipv4/af_inet.c (one place + add include)
36 * /proc/net/wireless is a copy of /proc/net/dev.
37 * We have a structure for data passed from the driver to /proc/net/wireless
38 * Too add this, I've modified :
39 * # net/core/dev.c (two other places)
40 * # include/linux/netdevice.h (one place)
41 * # include/linux/proc_fs.h (one place)
43 * New driver API (2002 -> onward) :
44 * -------------------------------
45 * This file is only concerned with the user space API and common definitions.
46 * The new driver API is defined and documented in :
47 * # include/net/iw_handler.h
49 * Note as well that /proc/net/wireless implementation has now moved in :
50 * # include/linux/wireless.c
52 * Wireless Events (2002 -> onward) :
53 * --------------------------------
54 * Events are defined at the end of this file, and implemented in :
55 * # include/linux/wireless.c
59 * Do not add here things that are redundant with other mechanisms
60 * (drivers init, ifconfig, /proc/net/dev, ...) and with are not
63 * These wireless extensions are not magic : each driver has to provide
66 * IMPORTANT NOTE : As everything in the kernel, this is very much a
67 * work in progress. Contact me if you have ideas of improvements...
70 /***************************** INCLUDES *****************************/
72 #include <linux/types.h> /* for "caddr_t" et al */
73 #include <linux/socket.h> /* for "struct sockaddr" et al */
74 #include <linux/if.h> /* for IFNAMSIZ and co... */
76 /***************************** VERSION *****************************/
78 * This constant is used to know the availability of the wireless
79 * extensions and to know which version of wireless extensions it is
80 * (there is some stuff that will be added in the future...)
81 * I just plan to increment with each new version.
83 #define WIRELESS_EXT 15
90 * Alan Cox start some incompatibles changes. I've integrated a bit more.
91 * - Encryption renamed to Encode to avoid US regulation problems
92 * - Frequency changed from float to struct to avoid problems on old 386
100 * - Missing encoding definitions in range
101 * - Access points stuff
105 * - 802.11 support (ESSID ioctls)
109 * - define IW_ESSID_MAX_SIZE and IW_MAX_AP
113 * - Changed my e-mail address
114 * - More 802.11 support (nickname, rate, rts, frag)
115 * - List index in frequencies
119 * - Support for 'mode of operation' (ad-hoc, managed...)
120 * - Support for unicast and multicast power saving
121 * - Change encoding to support larger tokens (>64 bits)
122 * - Updated iw_params (disable, flags) and use it for NWID
123 * - Extracted iw_point from iwreq for clarity
127 * - Add PM capability to range structure
128 * - Add PM modifier : MAX/MIN/RELATIVE
129 * - Add encoding option : IW_ENCODE_NOKEY
130 * - Add TxPower ioctls (work like TxRate)
134 * - Add WE version in range (help backward/forward compatibility)
135 * - Add retry ioctls (work like PM)
139 * - Add SIOCSIWSTATS to get /proc/net/wireless programatically
140 * - Add DEV PRIVATE IOCTL to avoid collisions in SIOCDEVPRIVATE space
141 * - Add new statistics (frag, retry, beacon)
142 * - Add average quality (for user space calibration)
146 * - Document creation of new driver API.
147 * - Extract union iwreq_data from struct iwreq (for new driver API).
148 * - Rename SIOCSIWNAME as SIOCSIWCOMMIT
152 * - Wireless Events support : define struct iw_event
153 * - Define additional specific event numbers
154 * - Add "addr" and "param" fields in union iwreq_data
155 * - AP scanning stuff (SIOCSIWSCAN and friends)
159 * - Add IW_PRIV_TYPE_ADDR for struct sockaddr private arg
160 * - Make struct iw_freq signed (both m & e), add explicit padding
161 * - Add IWEVCUSTOM for driver specific event/scanning token
162 * - Add IW_MAX_GET_SPY for driver returning a lot of addresses
163 * - Add IW_TXPOW_RANGE for range of Tx Powers
164 * - Add IWEVREGISTERED & IWEVEXPIRED events for Access Points
165 * - Add IW_MODE_MONITOR for passive monitor
168 /**************************** CONSTANTS ****************************/
170 /* -------------------------- IOCTL LIST -------------------------- */
172 /* Wireless Identification */
173 #define SIOCSIWCOMMIT 0x8B00 /* Commit pending changes to driver */
174 #define SIOCGIWNAME 0x8B01 /* get name == wireless protocol */
175 /* SIOCGIWNAME is used to verify the presence of Wireless Extensions.
176 * Common values : "IEEE 802.11-DS", "IEEE 802.11-FH", "IEEE 802.11b"...
177 * Don't put the name of your driver there, it's useless. */
179 /* Basic operations */
180 #define SIOCSIWNWID 0x8B02 /* set network id (pre-802.11) */
181 #define SIOCGIWNWID 0x8B03 /* get network id (the cell) */
182 #define SIOCSIWFREQ 0x8B04 /* set channel/frequency (Hz) */
183 #define SIOCGIWFREQ 0x8B05 /* get channel/frequency (Hz) */
184 #define SIOCSIWMODE 0x8B06 /* set operation mode */
185 #define SIOCGIWMODE 0x8B07 /* get operation mode */
186 #define SIOCSIWSENS 0x8B08 /* set sensitivity (dBm) */
187 #define SIOCGIWSENS 0x8B09 /* get sensitivity (dBm) */
189 /* Informative stuff */
190 #define SIOCSIWRANGE 0x8B0A /* Unused */
191 #define SIOCGIWRANGE 0x8B0B /* Get range of parameters */
192 #define SIOCSIWPRIV 0x8B0C /* Unused */
193 #define SIOCGIWPRIV 0x8B0D /* get private ioctl interface info */
194 #define SIOCSIWSTATS 0x8B0E /* Unused */
195 #define SIOCGIWSTATS 0x8B0F /* Get /proc/net/wireless stats */
196 /* SIOCGIWSTATS is strictly used between user space and the kernel, and
197 * is never passed to the driver (i.e. the driver will never see it). */
199 /* Mobile IP support (statistics per MAC address) */
200 #define SIOCSIWSPY 0x8B10 /* set spy addresses */
201 #define SIOCGIWSPY 0x8B11 /* get spy info (quality of link) */
203 /* Access Point manipulation */
204 #define SIOCSIWAP 0x8B14 /* set access point MAC addresses */
205 #define SIOCGIWAP 0x8B15 /* get access point MAC addresses */
206 #define SIOCGIWAPLIST 0x8B17 /* Deprecated in favor of scanning */
207 #define SIOCSIWSCAN 0x8B18 /* trigger scanning (list cells) */
208 #define SIOCGIWSCAN 0x8B19 /* get scanning results */
210 /* 802.11 specific support */
211 #define SIOCSIWESSID 0x8B1A /* set ESSID (network name) */
212 #define SIOCGIWESSID 0x8B1B /* get ESSID */
213 #define SIOCSIWNICKN 0x8B1C /* set node name/nickname */
214 #define SIOCGIWNICKN 0x8B1D /* get node name/nickname */
215 /* As the ESSID and NICKN are strings up to 32 bytes long, it doesn't fit
216 * within the 'iwreq' structure, so we need to use the 'data' member to
217 * point to a string in user space, like it is done for RANGE... */
219 /* Other parameters useful in 802.11 and some other devices */
220 #define SIOCSIWRATE 0x8B20 /* set default bit rate (bps) */
221 #define SIOCGIWRATE 0x8B21 /* get default bit rate (bps) */
222 #define SIOCSIWRTS 0x8B22 /* set RTS/CTS threshold (bytes) */
223 #define SIOCGIWRTS 0x8B23 /* get RTS/CTS threshold (bytes) */
224 #define SIOCSIWFRAG 0x8B24 /* set fragmentation thr (bytes) */
225 #define SIOCGIWFRAG 0x8B25 /* get fragmentation thr (bytes) */
226 #define SIOCSIWTXPOW 0x8B26 /* set transmit power (dBm) */
227 #define SIOCGIWTXPOW 0x8B27 /* get transmit power (dBm) */
228 #define SIOCSIWRETRY 0x8B28 /* set retry limits and lifetime */
229 #define SIOCGIWRETRY 0x8B29 /* get retry limits and lifetime */
231 /* Encoding stuff (scrambling, hardware security, WEP...) */
232 #define SIOCSIWENCODE 0x8B2A /* set encoding token & mode */
233 #define SIOCGIWENCODE 0x8B2B /* get encoding token & mode */
234 /* Power saving stuff (power management, unicast and multicast) */
235 #define SIOCSIWPOWER 0x8B2C /* set Power Management settings */
236 #define SIOCGIWPOWER 0x8B2D /* get Power Management settings */
238 /* -------------------- DEV PRIVATE IOCTL LIST -------------------- */
240 /* These 16 ioctl are wireless device private.
241 * Each driver is free to use them for whatever purpose it chooses,
242 * however the driver *must* export the description of those ioctls
243 * with SIOCGIWPRIV and *must* use arguments as defined below.
244 * If you don't follow those rules, DaveM is going to hate you (reason :
245 * it make mixed 32/64bit operation impossible).
247 #define SIOCIWFIRSTPRIV 0x8BE0
248 #define SIOCIWLASTPRIV 0x8BFF
249 /* Previously, we were using SIOCDEVPRIVATE, but we now have our
250 * separate range because of collisions with other tools such as
252 * We now have 32 commands, so a bit more space ;-).
253 * Also, all 'odd' commands are only usable by root and don't return the
254 * content of ifr/iwr to user (but you are not obliged to use the set/get
255 * convention, just use every other two command).
256 * And I repeat : you are not obliged to use them with iwspy, but you
257 * must be compliant with it.
260 /* ------------------------- IOCTL STUFF ------------------------- */
262 /* The first and the last (range) */
263 #define SIOCIWFIRST 0x8B00
264 #define SIOCIWLAST SIOCIWLASTPRIV /* 0x8BFF */
266 /* Even : get (world access), odd : set (root access) */
267 #define IW_IS_SET(cmd) (!((cmd) & 0x1))
268 #define IW_IS_GET(cmd) ((cmd) & 0x1)
270 /* ----------------------- WIRELESS EVENTS ----------------------- */
271 /* Those are *NOT* ioctls, do not issue request on them !!! */
272 /* Most events use the same identifier as ioctl requests */
274 #define IWEVTXDROP 0x8C00 /* Packet dropped to excessive retry */
275 #define IWEVQUAL 0x8C01 /* Quality part of statistics (scan) */
276 #define IWEVCUSTOM 0x8C02 /* Driver specific ascii string */
277 #define IWEVREGISTERED 0x8C03 /* Discovered a new node (AP mode) */
278 #define IWEVEXPIRED 0x8C04 /* Expired a node (AP mode) */
280 #define IWEVFIRST 0x8C00
282 /* ------------------------- PRIVATE INFO ------------------------- */
284 * The following is used with SIOCGIWPRIV. It allow a driver to define
285 * the interface (name, type of data) for its private ioctl.
286 * Privates ioctl are SIOCIWFIRSTPRIV -> SIOCIWLASTPRIV
289 #define IW_PRIV_TYPE_MASK 0x7000 /* Type of arguments */
290 #define IW_PRIV_TYPE_NONE 0x0000
291 #define IW_PRIV_TYPE_BYTE 0x1000 /* Char as number */
292 #define IW_PRIV_TYPE_CHAR 0x2000 /* Char as character */
293 #define IW_PRIV_TYPE_INT 0x4000 /* 32 bits int */
294 #define IW_PRIV_TYPE_FLOAT 0x5000 /* struct iw_freq */
295 #define IW_PRIV_TYPE_ADDR 0x6000 /* struct sockaddr */
297 #define IW_PRIV_SIZE_FIXED 0x0800 /* Variable or fixed nuber of args */
299 #define IW_PRIV_SIZE_MASK 0x07FF /* Max number of those args */
302 * Note : if the number of args is fixed and the size < 16 octets,
303 * instead of passing a pointer we will put args in the iwreq struct...
306 /* ----------------------- OTHER CONSTANTS ----------------------- */
308 /* Maximum frequencies in the range struct */
309 #define IW_MAX_FREQUENCIES 16
310 /* Note : if you have something like 80 frequencies,
311 * don't increase this constant and don't fill the frequency list.
312 * The user will be able to set by channel anyway... */
314 /* Maximum bit rates in the range struct */
315 #define IW_MAX_BITRATES 8
317 /* Maximum tx powers in the range struct */
318 #define IW_MAX_TXPOWER 8
319 /* Note : if you more than 8 TXPowers, just set the max and min or
320 * a few of them in the struct iw_range. */
322 /* Maximum of address that you may set with SPY */
323 #define IW_MAX_SPY 8 /* set */
324 #define IW_MAX_GET_SPY 64 /* get */
326 /* Maximum of address that you may get in the
327 list of access points in range */
330 /* Maximum size of the ESSID and NICKN strings */
331 #define IW_ESSID_MAX_SIZE 32
333 /* Modes of operation */
334 #define IW_MODE_AUTO 0 /* Let the driver decides */
335 #define IW_MODE_ADHOC 1 /* Single cell network */
336 #define IW_MODE_INFRA 2 /* Multi cell network, roaming, ... */
337 #define IW_MODE_MASTER 3 /* Synchronisation master or Access Point */
338 #define IW_MODE_REPEAT 4 /* Wireless Repeater (forwarder) */
339 #define IW_MODE_SECOND 5 /* Secondary master/repeater (backup) */
340 #define IW_MODE_MONITOR 6 /* Passive monitor (listen only) */
342 /* Maximum number of size of encoding token available
343 * they are listed in the range structure */
344 #define IW_MAX_ENCODING_SIZES 8
346 /* Maximum size of the encoding token in bytes */
347 #define IW_ENCODING_TOKEN_MAX 32 /* 256 bits (for now) */
349 /* Flags for encoding (along with the token) */
350 #define IW_ENCODE_INDEX 0x00FF /* Token index (if needed) */
351 #define IW_ENCODE_FLAGS 0xFF00 /* Flags defined below */
352 #define IW_ENCODE_MODE 0xF000 /* Modes defined below */
353 #define IW_ENCODE_DISABLED 0x8000 /* Encoding disabled */
354 #define IW_ENCODE_ENABLED 0x0000 /* Encoding enabled */
355 #define IW_ENCODE_RESTRICTED 0x4000 /* Refuse non-encoded packets */
356 #define IW_ENCODE_OPEN 0x2000 /* Accept non-encoded packets */
357 #define IW_ENCODE_NOKEY 0x0800 /* Key is write only, so not present */
359 /* Power management flags available (along with the value, if any) */
360 #define IW_POWER_ON 0x0000 /* No details... */
361 #define IW_POWER_TYPE 0xF000 /* Type of parameter */
362 #define IW_POWER_PERIOD 0x1000 /* Value is a period/duration of */
363 #define IW_POWER_TIMEOUT 0x2000 /* Value is a timeout (to go asleep) */
364 #define IW_POWER_MODE 0x0F00 /* Power Management mode */
365 #define IW_POWER_UNICAST_R 0x0100 /* Receive only unicast messages */
366 #define IW_POWER_MULTICAST_R 0x0200 /* Receive only multicast messages */
367 #define IW_POWER_ALL_R 0x0300 /* Receive all messages though PM */
368 #define IW_POWER_FORCE_S 0x0400 /* Force PM procedure for sending unicast */
369 #define IW_POWER_REPEATER 0x0800 /* Repeat broadcast messages in PM period */
370 #define IW_POWER_MODIFIER 0x000F /* Modify a parameter */
371 #define IW_POWER_MIN 0x0001 /* Value is a minimum */
372 #define IW_POWER_MAX 0x0002 /* Value is a maximum */
373 #define IW_POWER_RELATIVE 0x0004 /* Value is not in seconds/ms/us */
375 /* Transmit Power flags available */
376 #define IW_TXPOW_TYPE 0x00FF /* Type of value */
377 #define IW_TXPOW_DBM 0x0000 /* Value is in dBm */
378 #define IW_TXPOW_MWATT 0x0001 /* Value is in mW */
379 #define IW_TXPOW_RANGE 0x1000 /* Range of value between min/max */
381 /* Retry limits and lifetime flags available */
382 #define IW_RETRY_ON 0x0000 /* No details... */
383 #define IW_RETRY_TYPE 0xF000 /* Type of parameter */
384 #define IW_RETRY_LIMIT 0x1000 /* Maximum number of retries*/
385 #define IW_RETRY_LIFETIME 0x2000 /* Maximum duration of retries in us */
386 #define IW_RETRY_MODIFIER 0x000F /* Modify a parameter */
387 #define IW_RETRY_MIN 0x0001 /* Value is a minimum */
388 #define IW_RETRY_MAX 0x0002 /* Value is a maximum */
389 #define IW_RETRY_RELATIVE 0x0004 /* Value is not in seconds/ms/us */
391 /* Scanning request flags */
392 #define IW_SCAN_DEFAULT 0x0000 /* Default scan of the driver */
393 #define IW_SCAN_ALL_ESSID 0x0001 /* Scan all ESSIDs */
394 #define IW_SCAN_THIS_ESSID 0x0002 /* Scan only this ESSID */
395 #define IW_SCAN_ALL_FREQ 0x0004 /* Scan all Frequencies */
396 #define IW_SCAN_THIS_FREQ 0x0008 /* Scan only this Frequency */
397 #define IW_SCAN_ALL_MODE 0x0010 /* Scan all Modes */
398 #define IW_SCAN_THIS_MODE 0x0020 /* Scan only this Mode */
399 #define IW_SCAN_ALL_RATE 0x0040 /* Scan all Bit-Rates */
400 #define IW_SCAN_THIS_RATE 0x0080 /* Scan only this Bit-Rate */
401 /* Maximum size of returned data */
402 #define IW_SCAN_MAX_DATA 4096 /* In bytes */
404 /* Max number of char in custom event - use multiple of them if needed */
405 #define IW_CUSTOM_MAX 256 /* In bytes */
407 /****************************** TYPES ******************************/
409 /* --------------------------- SUBTYPES --------------------------- */
411 * Generic format for most parameters that fit in an int
415 __s32 value; /* The value of the parameter itself */
416 __u8 fixed; /* Hardware should not use auto select */
417 __u8 disabled; /* Disable the feature */
418 __u16 flags; /* Various specifc flags (if any) */
422 * For all data larger than 16 octets, we need to use a
423 * pointer to memory allocated in user space.
427 caddr_t pointer; /* Pointer to the data (in user space) */
428 __u16 length; /* number of fields or size in bytes */
429 __u16 flags; /* Optional params */
434 * For numbers lower than 10^9, we encode the number in 'm' and
436 * For number greater than 10^9, we divide it by the lowest power
437 * of 10 to get 'm' lower than 10^9, with 'm'= f / (10^'e')...
438 * The power of 10 is in 'e', the result of the division is in 'm'.
442 __s32 m; /* Mantissa */
443 __s16 e; /* Exponent */
444 __u8 i; /* List index (when in range struct) */
445 __u8 pad; /* Unused - just for alignement */
449 * Quality of the link
453 __u8 qual; /* link quality (%retries, SNR,
454 %missed beacons or better...) */
455 __u8 level; /* signal level (dBm) */
456 __u8 noise; /* noise level (dBm) */
457 __u8 updated; /* Flags to know if updated */
461 * Packet discarded in the wireless adapter due to
462 * "wireless" specific problems...
463 * Note : the list of counter and statistics in net_device_stats
464 * is already pretty exhaustive, and you should use that first.
465 * This is only additional stats...
469 __u32 nwid; /* Rx : Wrong nwid/essid */
470 __u32 code; /* Rx : Unable to code/decode (WEP) */
471 __u32 fragment; /* Rx : Can't perform MAC reassembly */
472 __u32 retries; /* Tx : Max MAC retries num reached */
473 __u32 misc; /* Others cases */
477 * Packet/Time period missed in the wireless adapter due to
478 * "wireless" specific problems...
482 __u32 beacon; /* Missed beacons/superframe */
485 /* ------------------------ WIRELESS STATS ------------------------ */
487 * Wireless statistics (used for /proc/net/wireless)
491 __u16 status; /* Status
492 * - device dependent for now */
494 struct iw_quality qual; /* Quality of the link
495 * (instant/mean/max) */
496 struct iw_discarded discard; /* Packet discarded counts */
497 struct iw_missed miss; /* Packet missed counts */
500 /* ------------------------ IOCTL REQUEST ------------------------ */
502 * This structure defines the payload of an ioctl, and is used
505 * Note that this structure should fit on the memory footprint
506 * of iwreq (which is the same as ifreq), which mean a max size of
507 * 16 octets = 128 bits. Warning, pointers might be 64 bits wide...
508 * You should check this when increasing the structures defined
509 * above in this file...
513 /* Config - generic */
515 /* Name : used to verify the presence of wireless extensions.
516 * Name of the protocol/provider... */
518 struct iw_point essid; /* Extended network name */
519 struct iw_param nwid; /* network id (or domain - the cell) */
520 struct iw_freq freq; /* frequency or channel :
522 * > 1000 = frequency in Hz */
524 struct iw_param sens; /* signal level threshold */
525 struct iw_param bitrate; /* default bit rate */
526 struct iw_param txpower; /* default transmit power */
527 struct iw_param rts; /* RTS threshold threshold */
528 struct iw_param frag; /* Fragmentation threshold */
529 __u32 mode; /* Operation mode */
530 struct iw_param retry; /* Retry limits & lifetime */
532 struct iw_point encoding; /* Encoding stuff : tokens */
533 struct iw_param power; /* PM duration/timeout */
534 struct iw_quality qual; /* Quality part of statistics */
536 struct sockaddr ap_addr; /* Access point address */
537 struct sockaddr addr; /* Destination address (hw) */
539 struct iw_param param; /* Other small parameters */
540 struct iw_point data; /* Other large parameters */
544 * The structure to exchange data for ioctl.
545 * This structure is the same as 'struct ifreq', but (re)defined for
547 * Do I need to remind you about structure size (32 octets) ?
553 char ifrn_name[IFNAMSIZ]; /* if name, e.g. "eth0" */
556 /* Data part (defined just above) */
560 /* -------------------------- IOCTL DATA -------------------------- */
562 * For those ioctl which want to exchange mode data that what could
563 * fit in the above structure...
567 * Range of parameters
572 /* Informative stuff (to choose between different interface) */
573 __u32 throughput; /* To give an idea... */
574 /* In theory this value should be the maximum benchmarked
575 * TCP/IP throughput, because with most of these devices the
576 * bit rate is meaningless (overhead an co) to estimate how
577 * fast the connection will go and pick the fastest one.
578 * I suggest people to play with Netperf or any benchmark...
581 /* NWID (or domain id) */
582 __u32 min_nwid; /* Minimal NWID we are able to set */
583 __u32 max_nwid; /* Maximal NWID we are able to set */
586 __u16 num_channels; /* Number of channels [0; num - 1] */
587 __u8 num_frequency; /* Number of entry in the list */
588 struct iw_freq freq[IW_MAX_FREQUENCIES]; /* list */
589 /* Note : this frequency list doesn't need to fit channel numbers */
591 /* signal level threshold range */
594 /* Quality of link & SNR stuff */
595 struct iw_quality max_qual; /* Quality of the link */
598 __u8 num_bitrates; /* Number of entries in the list */
599 __s32 bitrate[IW_MAX_BITRATES]; /* list, in bps */
602 __s32 min_rts; /* Minimal RTS threshold */
603 __s32 max_rts; /* Maximal RTS threshold */
606 __s32 min_frag; /* Minimal frag threshold */
607 __s32 max_frag; /* Maximal frag threshold */
609 /* Power Management duration & timeout */
610 __s32 min_pmp; /* Minimal PM period */
611 __s32 max_pmp; /* Maximal PM period */
612 __s32 min_pmt; /* Minimal PM timeout */
613 __s32 max_pmt; /* Maximal PM timeout */
614 __u16 pmp_flags; /* How to decode max/min PM period */
615 __u16 pmt_flags; /* How to decode max/min PM timeout */
616 __u16 pm_capa; /* What PM options are supported */
619 __u16 encoding_size[IW_MAX_ENCODING_SIZES]; /* Different token sizes */
620 __u8 num_encoding_sizes; /* Number of entry in the list */
621 __u8 max_encoding_tokens; /* Max number of tokens */
624 __u16 txpower_capa; /* What options are supported */
625 __u8 num_txpower; /* Number of entries in the list */
626 __s32 txpower[IW_MAX_TXPOWER]; /* list, in bps */
628 /* Wireless Extension version info */
629 __u8 we_version_compiled; /* Must be WIRELESS_EXT */
630 __u8 we_version_source; /* Last update of source */
632 /* Retry limits and lifetime */
633 __u16 retry_capa; /* What retry options are supported */
634 __u16 retry_flags; /* How to decode max/min retry limit */
635 __u16 r_time_flags; /* How to decode max/min retry life */
636 __s32 min_retry; /* Minimal number of retries */
637 __s32 max_retry; /* Maximal number of retries */
638 __s32 min_r_time; /* Minimal retry lifetime */
639 __s32 max_r_time; /* Maximal retry lifetime */
641 /* Average quality of link & SNR */
642 struct iw_quality avg_qual; /* Quality of the link */
643 /* This should contain the average/typical values of the quality
644 * indicator. This should be the threshold between a "good" and
645 * a "bad" link (example : monitor going from green to orange).
646 * Currently, user space apps like quality monitors don't have any
647 * way to calibrate the measurement. With this, they can split
648 * the range between 0 and max_qual in different quality level
649 * (using a geometric subdivision centered on the average).
650 * I expect that people doing the user space apps will feedback
651 * us on which value we need to put in each driver...
656 * Private ioctl interface information
661 __u32 cmd; /* Number of the ioctl to issue */
662 __u16 set_args; /* Type and number of args */
663 __u16 get_args; /* Type and number of args */
664 char name[IFNAMSIZ]; /* Name of the extension */
667 /* ----------------------- WIRELESS EVENTS ----------------------- */
669 * Wireless events are carried through the rtnetlink socket to user
670 * space. They are encapsulated in the IFLA_WIRELESS field of
671 * a RTM_NEWLINK message.
675 * A Wireless Event. Contains basically the same data as the ioctl...
679 __u16 len; /* Real lenght of this stuff */
680 __u16 cmd; /* Wireless IOCTL */
681 union iwreq_data u; /* IOCTL fixed payload */
684 /* Size of the Event prefix (including padding and alignement junk) */
685 #define IW_EV_LCP_LEN (sizeof(struct iw_event) - sizeof(union iwreq_data))
686 /* Size of the various events */
687 #define IW_EV_CHAR_LEN (IW_EV_LCP_LEN + IFNAMSIZ)
688 #define IW_EV_UINT_LEN (IW_EV_LCP_LEN + sizeof(__u32))
689 #define IW_EV_FREQ_LEN (IW_EV_LCP_LEN + sizeof(struct iw_freq))
690 #define IW_EV_POINT_LEN (IW_EV_LCP_LEN + sizeof(struct iw_point))
691 #define IW_EV_PARAM_LEN (IW_EV_LCP_LEN + sizeof(struct iw_param))
692 #define IW_EV_ADDR_LEN (IW_EV_LCP_LEN + sizeof(struct sockaddr))
693 #define IW_EV_QUAL_LEN (IW_EV_LCP_LEN + sizeof(struct iw_quality))
695 /* Note : in the case of iw_point, the extra data will come at the
696 * end of the event */
698 #endif /* _LINUX_WIRELESS_H */