2 * Merged with mainline ieee80211.h in Aug 2004. Original ieee802_11
3 * remains copyright by the original authors
5 * Portions of the merged code are based on Host AP (software wireless
6 * LAN access point) driver for Intersil Prism2/2.5/3.
8 * Copyright (c) 2001-2002, SSH Communications Security Corp and Jouni Malinen
10 * Copyright (c) 2002-2003, Jouni Malinen <j@w1.fi>
12 * Adaption to a generic IEEE 802.11 stack by James Ketrenos
13 * <jketreno@linux.intel.com>
14 * Copyright (c) 2004-2005, Intel Corporation
16 * This program is free software; you can redistribute it and/or modify
17 * it under the terms of the GNU General Public License version 2 as
18 * published by the Free Software Foundation. See README and COPYING for
22 * 1.0.x -- Initial version
23 * 1.1.x -- Added radiotap, QoS, TIM, ieee80211_geo APIs,
24 * various structure changes, and crypto API init method
28 #include <linux/if_ether.h> /* ETH_ALEN */
29 #include <linux/kernel.h> /* ARRAY_SIZE */
30 #include <linux/wireless.h>
32 #define IEEE80211_VERSION "git-1.1.13"
34 #define IEEE80211_DATA_LEN 2304
35 /* Maximum size for the MA-UNITDATA primitive, 802.11 standard section
38 The figure in section 7.1.2 suggests a body size of up to 2312
39 bytes is allowed, which is a bit confusing, I suspect this
40 represents the 2304 bytes of real data, plus a possible 8 bytes of
41 WEP IV and ICV. (this interpretation suggested by Ramiro Barreiro) */
43 #define IEEE80211_1ADDR_LEN 10
44 #define IEEE80211_2ADDR_LEN 16
45 #define IEEE80211_3ADDR_LEN 24
46 #define IEEE80211_4ADDR_LEN 30
47 #define IEEE80211_FCS_LEN 4
48 #define IEEE80211_HLEN (IEEE80211_4ADDR_LEN)
49 #define IEEE80211_FRAME_LEN (IEEE80211_DATA_LEN + IEEE80211_HLEN)
51 #define MIN_FRAG_THRESHOLD 256U
52 #define MAX_FRAG_THRESHOLD 2346U
54 /* Frame control field constants */
55 #define IEEE80211_FCTL_VERS 0x0003
56 #define IEEE80211_FCTL_FTYPE 0x000c
57 #define IEEE80211_FCTL_STYPE 0x00f0
58 #define IEEE80211_FCTL_TODS 0x0100
59 #define IEEE80211_FCTL_FROMDS 0x0200
60 #define IEEE80211_FCTL_MOREFRAGS 0x0400
61 #define IEEE80211_FCTL_RETRY 0x0800
62 #define IEEE80211_FCTL_PM 0x1000
63 #define IEEE80211_FCTL_MOREDATA 0x2000
64 #define IEEE80211_FCTL_PROTECTED 0x4000
65 #define IEEE80211_FCTL_ORDER 0x8000
67 #define IEEE80211_FTYPE_MGMT 0x0000
68 #define IEEE80211_FTYPE_CTL 0x0004
69 #define IEEE80211_FTYPE_DATA 0x0008
72 #define IEEE80211_STYPE_ASSOC_REQ 0x0000
73 #define IEEE80211_STYPE_ASSOC_RESP 0x0010
74 #define IEEE80211_STYPE_REASSOC_REQ 0x0020
75 #define IEEE80211_STYPE_REASSOC_RESP 0x0030
76 #define IEEE80211_STYPE_PROBE_REQ 0x0040
77 #define IEEE80211_STYPE_PROBE_RESP 0x0050
78 #define IEEE80211_STYPE_BEACON 0x0080
79 #define IEEE80211_STYPE_ATIM 0x0090
80 #define IEEE80211_STYPE_DISASSOC 0x00A0
81 #define IEEE80211_STYPE_AUTH 0x00B0
82 #define IEEE80211_STYPE_DEAUTH 0x00C0
83 #define IEEE80211_STYPE_ACTION 0x00D0
86 #define IEEE80211_STYPE_PSPOLL 0x00A0
87 #define IEEE80211_STYPE_RTS 0x00B0
88 #define IEEE80211_STYPE_CTS 0x00C0
89 #define IEEE80211_STYPE_ACK 0x00D0
90 #define IEEE80211_STYPE_CFEND 0x00E0
91 #define IEEE80211_STYPE_CFENDACK 0x00F0
94 #define IEEE80211_STYPE_DATA 0x0000
95 #define IEEE80211_STYPE_DATA_CFACK 0x0010
96 #define IEEE80211_STYPE_DATA_CFPOLL 0x0020
97 #define IEEE80211_STYPE_DATA_CFACKPOLL 0x0030
98 #define IEEE80211_STYPE_NULLFUNC 0x0040
99 #define IEEE80211_STYPE_CFACK 0x0050
100 #define IEEE80211_STYPE_CFPOLL 0x0060
101 #define IEEE80211_STYPE_CFACKPOLL 0x0070
102 #define IEEE80211_STYPE_QOS_DATA 0x0080
104 #define IEEE80211_SCTL_FRAG 0x000F
105 #define IEEE80211_SCTL_SEQ 0xFFF0
108 #define IEEE80211_QCTL_TID 0x000F
112 #ifdef CONFIG_IEEE80211_DEBUG
113 extern u32 ieee80211_debug_level;
114 #define IEEE80211_DEBUG(level, fmt, args...) \
115 do { if (ieee80211_debug_level & (level)) \
116 printk(KERN_DEBUG "ieee80211: %c %s " fmt, \
117 in_interrupt() ? 'I' : 'U', __FUNCTION__ , ## args); } while (0)
118 static inline bool ieee80211_ratelimit_debug(u32 level)
120 return (ieee80211_debug_level & level) && net_ratelimit();
123 #define IEEE80211_DEBUG(level, fmt, args...) do {} while (0)
124 static inline bool ieee80211_ratelimit_debug(u32 level)
128 #endif /* CONFIG_IEEE80211_DEBUG */
130 /* escape_essid() is intended to be used in debug (and possibly error)
131 * messages. It should never be used for passing essid to user space. */
132 const char *escape_essid(const char *essid, u8 essid_len);
135 * To use the debug system:
137 * If you are defining a new debug classification, simply add it to the #define
138 * list here in the form of:
140 * #define IEEE80211_DL_xxxx VALUE
142 * shifting value to the left one bit from the previous entry. xxxx should be
143 * the name of the classification (for example, WEP)
145 * You then need to either add a IEEE80211_xxxx_DEBUG() macro definition for your
146 * classification, or use IEEE80211_DEBUG(IEEE80211_DL_xxxx, ...) whenever you want
147 * to send output to that classification.
149 * To add your debug level to the list of levels seen when you perform
151 * % cat /proc/net/ieee80211/debug_level
153 * you simply need to add your entry to the ieee80211_debug_level array.
155 * If you do not see debug_level in /proc/net/ieee80211 then you do not have
156 * CONFIG_IEEE80211_DEBUG defined in your kernel configuration
160 #define IEEE80211_DL_INFO (1<<0)
161 #define IEEE80211_DL_WX (1<<1)
162 #define IEEE80211_DL_SCAN (1<<2)
163 #define IEEE80211_DL_STATE (1<<3)
164 #define IEEE80211_DL_MGMT (1<<4)
165 #define IEEE80211_DL_FRAG (1<<5)
166 #define IEEE80211_DL_DROP (1<<7)
168 #define IEEE80211_DL_TX (1<<8)
169 #define IEEE80211_DL_RX (1<<9)
170 #define IEEE80211_DL_QOS (1<<31)
172 #define IEEE80211_ERROR(f, a...) printk(KERN_ERR "ieee80211: " f, ## a)
173 #define IEEE80211_WARNING(f, a...) printk(KERN_WARNING "ieee80211: " f, ## a)
174 #define IEEE80211_DEBUG_INFO(f, a...) IEEE80211_DEBUG(IEEE80211_DL_INFO, f, ## a)
176 #define IEEE80211_DEBUG_WX(f, a...) IEEE80211_DEBUG(IEEE80211_DL_WX, f, ## a)
177 #define IEEE80211_DEBUG_SCAN(f, a...) IEEE80211_DEBUG(IEEE80211_DL_SCAN, f, ## a)
178 #define IEEE80211_DEBUG_STATE(f, a...) IEEE80211_DEBUG(IEEE80211_DL_STATE, f, ## a)
179 #define IEEE80211_DEBUG_MGMT(f, a...) IEEE80211_DEBUG(IEEE80211_DL_MGMT, f, ## a)
180 #define IEEE80211_DEBUG_FRAG(f, a...) IEEE80211_DEBUG(IEEE80211_DL_FRAG, f, ## a)
181 #define IEEE80211_DEBUG_DROP(f, a...) IEEE80211_DEBUG(IEEE80211_DL_DROP, f, ## a)
182 #define IEEE80211_DEBUG_TX(f, a...) IEEE80211_DEBUG(IEEE80211_DL_TX, f, ## a)
183 #define IEEE80211_DEBUG_RX(f, a...) IEEE80211_DEBUG(IEEE80211_DL_RX, f, ## a)
184 #define IEEE80211_DEBUG_QOS(f, a...) IEEE80211_DEBUG(IEEE80211_DL_QOS, f, ## a)
185 #include <linux/netdevice.h>
186 #include <linux/if_arp.h> /* ARPHRD_ETHER */
189 #define WIRELESS_SPY /* enable iwspy support */
191 #include <net/iw_handler.h> /* new driver API */
194 #define ETH_P_PAE 0x888E /* Port Access Entity (IEEE 802.1X) */
195 #endif /* ETH_P_PAE */
197 #define ETH_P_PREAUTH 0x88C7 /* IEEE 802.11i pre-authentication */
199 #ifndef ETH_P_80211_RAW
200 #define ETH_P_80211_RAW (ETH_P_ECONET + 1)
203 /* IEEE 802.11 defines */
205 #define P80211_OUI_LEN 3
207 struct ieee80211_snap_hdr {
209 u8 dsap; /* always 0xAA */
210 u8 ssap; /* always 0xAA */
211 u8 ctrl; /* always 0x03 */
212 u8 oui[P80211_OUI_LEN]; /* organizational universal id */
214 } __attribute__ ((packed));
216 #define SNAP_SIZE sizeof(struct ieee80211_snap_hdr)
218 #define WLAN_FC_GET_VERS(fc) ((fc) & IEEE80211_FCTL_VERS)
219 #define WLAN_FC_GET_TYPE(fc) ((fc) & IEEE80211_FCTL_FTYPE)
220 #define WLAN_FC_GET_STYPE(fc) ((fc) & IEEE80211_FCTL_STYPE)
222 #define WLAN_GET_SEQ_FRAG(seq) ((seq) & IEEE80211_SCTL_FRAG)
223 #define WLAN_GET_SEQ_SEQ(seq) (((seq) & IEEE80211_SCTL_SEQ) >> 4)
225 /* Authentication algorithms */
226 #define WLAN_AUTH_OPEN 0
227 #define WLAN_AUTH_SHARED_KEY 1
228 #define WLAN_AUTH_LEAP 2
230 #define WLAN_AUTH_CHALLENGE_LEN 128
232 #define WLAN_CAPABILITY_ESS (1<<0)
233 #define WLAN_CAPABILITY_IBSS (1<<1)
234 #define WLAN_CAPABILITY_CF_POLLABLE (1<<2)
235 #define WLAN_CAPABILITY_CF_POLL_REQUEST (1<<3)
236 #define WLAN_CAPABILITY_PRIVACY (1<<4)
237 #define WLAN_CAPABILITY_SHORT_PREAMBLE (1<<5)
238 #define WLAN_CAPABILITY_PBCC (1<<6)
239 #define WLAN_CAPABILITY_CHANNEL_AGILITY (1<<7)
240 #define WLAN_CAPABILITY_SPECTRUM_MGMT (1<<8)
241 #define WLAN_CAPABILITY_QOS (1<<9)
242 #define WLAN_CAPABILITY_SHORT_SLOT_TIME (1<<10)
243 #define WLAN_CAPABILITY_DSSS_OFDM (1<<13)
245 /* 802.11g ERP information element */
246 #define WLAN_ERP_NON_ERP_PRESENT (1<<0)
247 #define WLAN_ERP_USE_PROTECTION (1<<1)
248 #define WLAN_ERP_BARKER_PREAMBLE (1<<2)
251 enum ieee80211_statuscode {
252 WLAN_STATUS_SUCCESS = 0,
253 WLAN_STATUS_UNSPECIFIED_FAILURE = 1,
254 WLAN_STATUS_CAPS_UNSUPPORTED = 10,
255 WLAN_STATUS_REASSOC_NO_ASSOC = 11,
256 WLAN_STATUS_ASSOC_DENIED_UNSPEC = 12,
257 WLAN_STATUS_NOT_SUPPORTED_AUTH_ALG = 13,
258 WLAN_STATUS_UNKNOWN_AUTH_TRANSACTION = 14,
259 WLAN_STATUS_CHALLENGE_FAIL = 15,
260 WLAN_STATUS_AUTH_TIMEOUT = 16,
261 WLAN_STATUS_AP_UNABLE_TO_HANDLE_NEW_STA = 17,
262 WLAN_STATUS_ASSOC_DENIED_RATES = 18,
264 WLAN_STATUS_ASSOC_DENIED_NOSHORTPREAMBLE = 19,
265 WLAN_STATUS_ASSOC_DENIED_NOPBCC = 20,
266 WLAN_STATUS_ASSOC_DENIED_NOAGILITY = 21,
268 WLAN_STATUS_ASSOC_DENIED_NOSPECTRUM = 22,
269 WLAN_STATUS_ASSOC_REJECTED_BAD_POWER = 23,
270 WLAN_STATUS_ASSOC_REJECTED_BAD_SUPP_CHAN = 24,
272 WLAN_STATUS_ASSOC_DENIED_NOSHORTTIME = 25,
273 WLAN_STATUS_ASSOC_DENIED_NODSSSOFDM = 26,
275 WLAN_STATUS_INVALID_IE = 40,
276 WLAN_STATUS_INVALID_GROUP_CIPHER = 41,
277 WLAN_STATUS_INVALID_PAIRWISE_CIPHER = 42,
278 WLAN_STATUS_INVALID_AKMP = 43,
279 WLAN_STATUS_UNSUPP_RSN_VERSION = 44,
280 WLAN_STATUS_INVALID_RSN_IE_CAP = 45,
281 WLAN_STATUS_CIPHER_SUITE_REJECTED = 46,
285 enum ieee80211_reasoncode {
286 WLAN_REASON_UNSPECIFIED = 1,
287 WLAN_REASON_PREV_AUTH_NOT_VALID = 2,
288 WLAN_REASON_DEAUTH_LEAVING = 3,
289 WLAN_REASON_DISASSOC_DUE_TO_INACTIVITY = 4,
290 WLAN_REASON_DISASSOC_AP_BUSY = 5,
291 WLAN_REASON_CLASS2_FRAME_FROM_NONAUTH_STA = 6,
292 WLAN_REASON_CLASS3_FRAME_FROM_NONASSOC_STA = 7,
293 WLAN_REASON_DISASSOC_STA_HAS_LEFT = 8,
294 WLAN_REASON_STA_REQ_ASSOC_WITHOUT_AUTH = 9,
296 WLAN_REASON_DISASSOC_BAD_POWER = 10,
297 WLAN_REASON_DISASSOC_BAD_SUPP_CHAN = 11,
299 WLAN_REASON_INVALID_IE = 13,
300 WLAN_REASON_MIC_FAILURE = 14,
301 WLAN_REASON_4WAY_HANDSHAKE_TIMEOUT = 15,
302 WLAN_REASON_GROUP_KEY_HANDSHAKE_TIMEOUT = 16,
303 WLAN_REASON_IE_DIFFERENT = 17,
304 WLAN_REASON_INVALID_GROUP_CIPHER = 18,
305 WLAN_REASON_INVALID_PAIRWISE_CIPHER = 19,
306 WLAN_REASON_INVALID_AKMP = 20,
307 WLAN_REASON_UNSUPP_RSN_VERSION = 21,
308 WLAN_REASON_INVALID_RSN_IE_CAP = 22,
309 WLAN_REASON_IEEE8021X_FAILED = 23,
310 WLAN_REASON_CIPHER_SUITE_REJECTED = 24,
313 /* Action categories - 802.11h */
314 enum ieee80211_actioncategories {
315 WLAN_ACTION_SPECTRUM_MGMT = 0,
320 /* Action details - 802.11h */
321 enum ieee80211_actiondetails {
322 WLAN_ACTION_CATEGORY_MEASURE_REQUEST = 0,
323 WLAN_ACTION_CATEGORY_MEASURE_REPORT = 1,
324 WLAN_ACTION_CATEGORY_TPC_REQUEST = 2,
325 WLAN_ACTION_CATEGORY_TPC_REPORT = 3,
326 WLAN_ACTION_CATEGORY_CHANNEL_SWITCH = 4,
327 /* 5 - 255 Reserved */
330 #define IEEE80211_STATMASK_SIGNAL (1<<0)
331 #define IEEE80211_STATMASK_RSSI (1<<1)
332 #define IEEE80211_STATMASK_NOISE (1<<2)
333 #define IEEE80211_STATMASK_RATE (1<<3)
334 #define IEEE80211_STATMASK_WEMASK 0x7
336 #define IEEE80211_CCK_MODULATION (1<<0)
337 #define IEEE80211_OFDM_MODULATION (1<<1)
339 #define IEEE80211_24GHZ_BAND (1<<0)
340 #define IEEE80211_52GHZ_BAND (1<<1)
342 #define IEEE80211_CCK_RATE_1MB 0x02
343 #define IEEE80211_CCK_RATE_2MB 0x04
344 #define IEEE80211_CCK_RATE_5MB 0x0B
345 #define IEEE80211_CCK_RATE_11MB 0x16
346 #define IEEE80211_OFDM_RATE_6MB 0x0C
347 #define IEEE80211_OFDM_RATE_9MB 0x12
348 #define IEEE80211_OFDM_RATE_12MB 0x18
349 #define IEEE80211_OFDM_RATE_18MB 0x24
350 #define IEEE80211_OFDM_RATE_24MB 0x30
351 #define IEEE80211_OFDM_RATE_36MB 0x48
352 #define IEEE80211_OFDM_RATE_48MB 0x60
353 #define IEEE80211_OFDM_RATE_54MB 0x6C
354 #define IEEE80211_BASIC_RATE_MASK 0x80
356 #define IEEE80211_CCK_RATE_1MB_MASK (1<<0)
357 #define IEEE80211_CCK_RATE_2MB_MASK (1<<1)
358 #define IEEE80211_CCK_RATE_5MB_MASK (1<<2)
359 #define IEEE80211_CCK_RATE_11MB_MASK (1<<3)
360 #define IEEE80211_OFDM_RATE_6MB_MASK (1<<4)
361 #define IEEE80211_OFDM_RATE_9MB_MASK (1<<5)
362 #define IEEE80211_OFDM_RATE_12MB_MASK (1<<6)
363 #define IEEE80211_OFDM_RATE_18MB_MASK (1<<7)
364 #define IEEE80211_OFDM_RATE_24MB_MASK (1<<8)
365 #define IEEE80211_OFDM_RATE_36MB_MASK (1<<9)
366 #define IEEE80211_OFDM_RATE_48MB_MASK (1<<10)
367 #define IEEE80211_OFDM_RATE_54MB_MASK (1<<11)
369 #define IEEE80211_CCK_RATES_MASK 0x0000000F
370 #define IEEE80211_CCK_BASIC_RATES_MASK (IEEE80211_CCK_RATE_1MB_MASK | \
371 IEEE80211_CCK_RATE_2MB_MASK)
372 #define IEEE80211_CCK_DEFAULT_RATES_MASK (IEEE80211_CCK_BASIC_RATES_MASK | \
373 IEEE80211_CCK_RATE_5MB_MASK | \
374 IEEE80211_CCK_RATE_11MB_MASK)
376 #define IEEE80211_OFDM_RATES_MASK 0x00000FF0
377 #define IEEE80211_OFDM_BASIC_RATES_MASK (IEEE80211_OFDM_RATE_6MB_MASK | \
378 IEEE80211_OFDM_RATE_12MB_MASK | \
379 IEEE80211_OFDM_RATE_24MB_MASK)
380 #define IEEE80211_OFDM_DEFAULT_RATES_MASK (IEEE80211_OFDM_BASIC_RATES_MASK | \
381 IEEE80211_OFDM_RATE_9MB_MASK | \
382 IEEE80211_OFDM_RATE_18MB_MASK | \
383 IEEE80211_OFDM_RATE_36MB_MASK | \
384 IEEE80211_OFDM_RATE_48MB_MASK | \
385 IEEE80211_OFDM_RATE_54MB_MASK)
386 #define IEEE80211_DEFAULT_RATES_MASK (IEEE80211_OFDM_DEFAULT_RATES_MASK | \
387 IEEE80211_CCK_DEFAULT_RATES_MASK)
389 #define IEEE80211_NUM_OFDM_RATES 8
390 #define IEEE80211_NUM_CCK_RATES 4
391 #define IEEE80211_OFDM_SHIFT_MASK_A 4
393 /* NOTE: This data is for statistical purposes; not all hardware provides this
394 * information for frames received.
395 * For ieee80211_rx_mgt, you need to set at least the 'len' parameter.
397 struct ieee80211_rx_stats {
402 u16 rate; /* in 100 kbps */
412 /* IEEE 802.11 requires that STA supports concurrent reception of at least
413 * three fragmented frames. This define can be increased to support more
414 * concurrent frames, but it should be noted that each entry can consume about
415 * 2 kB of RAM and increasing cache size will slow down frame reassembly. */
416 #define IEEE80211_FRAG_CACHE_LEN 4
418 struct ieee80211_frag_entry {
419 unsigned long first_frag_time;
421 unsigned int last_frag;
423 u8 src_addr[ETH_ALEN];
424 u8 dst_addr[ETH_ALEN];
427 struct ieee80211_stats {
428 unsigned int tx_unicast_frames;
429 unsigned int tx_multicast_frames;
430 unsigned int tx_fragments;
431 unsigned int tx_unicast_octets;
432 unsigned int tx_multicast_octets;
433 unsigned int tx_deferred_transmissions;
434 unsigned int tx_single_retry_frames;
435 unsigned int tx_multiple_retry_frames;
436 unsigned int tx_retry_limit_exceeded;
437 unsigned int tx_discards;
438 unsigned int rx_unicast_frames;
439 unsigned int rx_multicast_frames;
440 unsigned int rx_fragments;
441 unsigned int rx_unicast_octets;
442 unsigned int rx_multicast_octets;
443 unsigned int rx_fcs_errors;
444 unsigned int rx_discards_no_buffer;
445 unsigned int tx_discards_wrong_sa;
446 unsigned int rx_discards_undecryptable;
447 unsigned int rx_message_in_msg_fragments;
448 unsigned int rx_message_in_bad_msg_fragments;
451 struct ieee80211_device;
453 #include "ieee80211_crypt.h"
455 #define SEC_KEY_1 (1<<0)
456 #define SEC_KEY_2 (1<<1)
457 #define SEC_KEY_3 (1<<2)
458 #define SEC_KEY_4 (1<<3)
459 #define SEC_ACTIVE_KEY (1<<4)
460 #define SEC_AUTH_MODE (1<<5)
461 #define SEC_UNICAST_GROUP (1<<6)
462 #define SEC_LEVEL (1<<7)
463 #define SEC_ENABLED (1<<8)
464 #define SEC_ENCRYPT (1<<9)
466 #define SEC_LEVEL_0 0 /* None */
467 #define SEC_LEVEL_1 1 /* WEP 40 and 104 bit */
468 #define SEC_LEVEL_2 2 /* Level 1 + TKIP */
469 #define SEC_LEVEL_2_CKIP 3 /* Level 1 + CKIP */
470 #define SEC_LEVEL_3 4 /* Level 2 + CCMP */
472 #define SEC_ALG_NONE 0
473 #define SEC_ALG_WEP 1
474 #define SEC_ALG_TKIP 2
475 #define SEC_ALG_CCMP 3
478 #define WEP_KEY_LEN 13
479 #define SCM_KEY_LEN 32
480 #define SCM_TEMPORAL_KEY_LENGTH 16
482 struct ieee80211_security {
485 auth_mode:2, auth_algo:4, unicast_uses_group:1, encrypt:1;
486 u8 encode_alg[WEP_KEYS];
487 u8 key_sizes[WEP_KEYS];
488 u8 keys[WEP_KEYS][SCM_KEY_LEN];
491 } __attribute__ ((packed));
495 802.11 data frame from AP
497 ,-------------------------------------------------------------------.
498 Bytes | 2 | 2 | 6 | 6 | 6 | 2 | 0..2312 | 4 |
499 |------|------|---------|---------|---------|------|---------|------|
500 Desc. | ctrl | dura | DA/RA | TA | SA | Sequ | frame | fcs |
501 | | tion | (BSSID) | | | ence | data | |
502 `-------------------------------------------------------------------'
508 #define BEACON_PROBE_SSID_ID_POSITION 12
510 /* Management Frame Information Element Types */
511 enum ieee80211_mfie {
514 MFIE_TYPE_FH_SET = 2,
515 MFIE_TYPE_DS_SET = 3,
516 MFIE_TYPE_CF_SET = 4,
518 MFIE_TYPE_IBSS_SET = 6,
519 MFIE_TYPE_COUNTRY = 7,
520 MFIE_TYPE_HOP_PARAMS = 8,
521 MFIE_TYPE_HOP_TABLE = 9,
522 MFIE_TYPE_REQUEST = 10,
523 MFIE_TYPE_CHALLENGE = 16,
524 MFIE_TYPE_POWER_CONSTRAINT = 32,
525 MFIE_TYPE_POWER_CAPABILITY = 33,
526 MFIE_TYPE_TPC_REQUEST = 34,
527 MFIE_TYPE_TPC_REPORT = 35,
528 MFIE_TYPE_SUPP_CHANNELS = 36,
530 MFIE_TYPE_MEASURE_REQUEST = 38,
531 MFIE_TYPE_MEASURE_REPORT = 39,
532 MFIE_TYPE_QUIET = 40,
533 MFIE_TYPE_IBSS_DFS = 41,
534 MFIE_TYPE_ERP_INFO = 42,
536 MFIE_TYPE_RATES_EX = 50,
537 MFIE_TYPE_GENERIC = 221,
538 MFIE_TYPE_QOS_PARAMETER = 222,
541 /* Minimal header; can be used for passing 802.11 frames with sufficient
542 * information to determine what type of underlying data type is actually
543 * stored in the data. */
544 struct ieee80211_hdr {
548 } __attribute__ ((packed));
550 struct ieee80211_hdr_1addr {
555 } __attribute__ ((packed));
557 struct ieee80211_hdr_2addr {
563 } __attribute__ ((packed));
565 struct ieee80211_hdr_3addr {
573 } __attribute__ ((packed));
575 struct ieee80211_hdr_4addr {
584 } __attribute__ ((packed));
586 struct ieee80211_hdr_3addrqos {
595 } __attribute__ ((packed));
597 struct ieee80211_hdr_4addrqos {
607 } __attribute__ ((packed));
609 struct ieee80211_info_element {
613 } __attribute__ ((packed));
616 * These are the data types that can make up management packets
622 u8 current_ap[ETH_ALEN];
625 u16 association_id:14, reserved:2;
626 } __attribute__ ((packed));
632 struct ieee80211_auth {
633 struct ieee80211_hdr_3addr header;
638 struct ieee80211_info_element info_element[0];
639 } __attribute__ ((packed));
641 struct ieee80211_channel_switch {
647 } __attribute__ ((packed));
649 struct ieee80211_action {
650 struct ieee80211_hdr_3addr header;
654 struct ieee80211_action_exchange {
656 struct ieee80211_info_element info_element[0];
658 struct ieee80211_channel_switch channel_switch;
661 } __attribute__ ((packed));
663 struct ieee80211_disassoc {
664 struct ieee80211_hdr_3addr header;
666 } __attribute__ ((packed));
668 /* Alias deauth for disassoc */
669 #define ieee80211_deauth ieee80211_disassoc
671 struct ieee80211_probe_request {
672 struct ieee80211_hdr_3addr header;
673 /* SSID, supported rates */
674 struct ieee80211_info_element info_element[0];
675 } __attribute__ ((packed));
677 struct ieee80211_probe_response {
678 struct ieee80211_hdr_3addr header;
679 __le32 time_stamp[2];
680 __le16 beacon_interval;
682 /* SSID, supported rates, FH params, DS params,
683 * CF params, IBSS params, TIM (if beacon), RSN */
684 struct ieee80211_info_element info_element[0];
685 } __attribute__ ((packed));
687 /* Alias beacon for probe_response */
688 #define ieee80211_beacon ieee80211_probe_response
690 struct ieee80211_assoc_request {
691 struct ieee80211_hdr_3addr header;
693 __le16 listen_interval;
694 /* SSID, supported rates, RSN */
695 struct ieee80211_info_element info_element[0];
696 } __attribute__ ((packed));
698 struct ieee80211_reassoc_request {
699 struct ieee80211_hdr_3addr header;
701 __le16 listen_interval;
702 u8 current_ap[ETH_ALEN];
703 struct ieee80211_info_element info_element[0];
704 } __attribute__ ((packed));
706 struct ieee80211_assoc_response {
707 struct ieee80211_hdr_3addr header;
711 /* supported rates */
712 struct ieee80211_info_element info_element[0];
713 } __attribute__ ((packed));
715 struct ieee80211_txb {
722 struct sk_buff *fragments[0];
725 /* SWEEP TABLE ENTRIES NUMBER */
726 #define MAX_SWEEP_TAB_ENTRIES 42
727 #define MAX_SWEEP_TAB_ENTRIES_PER_PACKET 7
728 /* MAX_RATES_LENGTH needs to be 12. The spec says 8, and many APs
729 * only use 8, and then use extended rates for the remaining supported
730 * rates. Other APs, however, stick all of their supported rates on the
731 * main rates information element... */
732 #define MAX_RATES_LENGTH ((u8)12)
733 #define MAX_RATES_EX_LENGTH ((u8)16)
734 #define MAX_NETWORK_COUNT 128
736 #define CRC_LENGTH 4U
738 #define MAX_WPA_IE_LEN 64
740 #define NETWORK_EMPTY_ESSID (1<<0)
741 #define NETWORK_HAS_OFDM (1<<1)
742 #define NETWORK_HAS_CCK (1<<2)
745 #define NETWORK_HAS_QOS_PARAMETERS (1<<3)
746 #define NETWORK_HAS_QOS_INFORMATION (1<<4)
747 #define NETWORK_HAS_QOS_MASK (NETWORK_HAS_QOS_PARAMETERS | \
748 NETWORK_HAS_QOS_INFORMATION)
751 #define NETWORK_HAS_POWER_CONSTRAINT (1<<5)
752 #define NETWORK_HAS_CSA (1<<6)
753 #define NETWORK_HAS_QUIET (1<<7)
754 #define NETWORK_HAS_IBSS_DFS (1<<8)
755 #define NETWORK_HAS_TPC_REPORT (1<<9)
757 #define NETWORK_HAS_ERP_VALUE (1<<10)
759 #define QOS_QUEUE_NUM 4
760 #define QOS_OUI_LEN 3
761 #define QOS_OUI_TYPE 2
762 #define QOS_ELEMENT_ID 221
763 #define QOS_OUI_INFO_SUB_TYPE 0
764 #define QOS_OUI_PARAM_SUB_TYPE 1
765 #define QOS_VERSION_1 1
766 #define QOS_AIFSN_MIN_VALUE 2
768 struct ieee80211_qos_information_element {
776 } __attribute__ ((packed));
778 struct ieee80211_qos_ac_parameter {
782 } __attribute__ ((packed));
784 struct ieee80211_qos_parameter_info {
785 struct ieee80211_qos_information_element info_element;
787 struct ieee80211_qos_ac_parameter ac_params_record[QOS_QUEUE_NUM];
788 } __attribute__ ((packed));
790 struct ieee80211_qos_parameters {
791 __le16 cw_min[QOS_QUEUE_NUM];
792 __le16 cw_max[QOS_QUEUE_NUM];
793 u8 aifs[QOS_QUEUE_NUM];
794 u8 flag[QOS_QUEUE_NUM];
795 __le16 tx_op_limit[QOS_QUEUE_NUM];
796 } __attribute__ ((packed));
798 struct ieee80211_qos_data {
799 struct ieee80211_qos_parameters parameters;
806 struct ieee80211_tim_parameters {
809 } __attribute__ ((packed));
811 /*******************************************************/
813 enum { /* ieee80211_basic_report.map */
814 IEEE80211_BASIC_MAP_BSS = (1 << 0),
815 IEEE80211_BASIC_MAP_OFDM = (1 << 1),
816 IEEE80211_BASIC_MAP_UNIDENTIFIED = (1 << 2),
817 IEEE80211_BASIC_MAP_RADAR = (1 << 3),
818 IEEE80211_BASIC_MAP_UNMEASURED = (1 << 4),
819 /* Bits 5-7 are reserved */
822 struct ieee80211_basic_report {
827 } __attribute__ ((packed));
829 enum { /* ieee80211_measurement_request.mode */
830 /* Bit 0 is reserved */
831 IEEE80211_MEASUREMENT_ENABLE = (1 << 1),
832 IEEE80211_MEASUREMENT_REQUEST = (1 << 2),
833 IEEE80211_MEASUREMENT_REPORT = (1 << 3),
834 /* Bits 4-7 are reserved */
838 IEEE80211_REPORT_BASIC = 0, /* required */
839 IEEE80211_REPORT_CCA = 1, /* optional */
840 IEEE80211_REPORT_RPI = 2, /* optional */
844 struct ieee80211_measurement_params {
848 } __attribute__ ((packed));
850 struct ieee80211_measurement_request {
851 struct ieee80211_info_element ie;
855 struct ieee80211_measurement_params params[0];
856 } __attribute__ ((packed));
858 struct ieee80211_measurement_report {
859 struct ieee80211_info_element ie;
864 struct ieee80211_basic_report basic[0];
866 } __attribute__ ((packed));
868 struct ieee80211_tpc_report {
871 } __attribute__ ((packed));
873 struct ieee80211_channel_map {
876 } __attribute__ ((packed));
878 struct ieee80211_ibss_dfs {
879 struct ieee80211_info_element ie;
881 u8 recovery_interval;
882 struct ieee80211_channel_map channel_map[0];
885 struct ieee80211_csa {
889 } __attribute__ ((packed));
891 struct ieee80211_quiet {
896 } __attribute__ ((packed));
898 struct ieee80211_network {
899 /* These entries are used to identify a unique network */
902 /* Ensure null-terminated for any debug msgs */
903 u8 ssid[IW_ESSID_MAX_SIZE + 1];
906 struct ieee80211_qos_data qos_data;
908 /* These are network statistics */
909 struct ieee80211_rx_stats stats;
911 u8 rates[MAX_RATES_LENGTH];
913 u8 rates_ex[MAX_RATES_EX_LENGTH];
915 unsigned long last_scanned;
924 u8 wpa_ie[MAX_WPA_IE_LEN];
926 u8 rsn_ie[MAX_WPA_IE_LEN];
928 struct ieee80211_tim_parameters tim;
932 /* Power Constraint - mandatory if spctrm mgmt required */
935 /* TPC Report - mandatory if spctrm mgmt required */
936 struct ieee80211_tpc_report tpc_report;
938 /* IBSS DFS - mandatory if spctrm mgmt required and IBSS
939 * NOTE: This is variable length and so must be allocated dynamically */
940 struct ieee80211_ibss_dfs *ibss_dfs;
942 /* Channel Switch Announcement - optional if spctrm mgmt required */
943 struct ieee80211_csa csa;
945 /* Quiet - optional if spctrm mgmt required */
946 struct ieee80211_quiet quiet;
948 struct list_head list;
951 enum ieee80211_state {
952 IEEE80211_UNINITIALIZED = 0,
953 IEEE80211_INITIALIZED,
954 IEEE80211_ASSOCIATING,
955 IEEE80211_ASSOCIATED,
956 IEEE80211_AUTHENTICATING,
957 IEEE80211_AUTHENTICATED,
961 #define DEFAULT_MAX_SCAN_AGE (15 * HZ)
962 #define DEFAULT_FTS 2346
964 #define CFG_IEEE80211_RESERVE_FCS (1<<0)
965 #define CFG_IEEE80211_COMPUTE_FCS (1<<1)
966 #define CFG_IEEE80211_RTS (1<<2)
968 #define IEEE80211_24GHZ_MIN_CHANNEL 1
969 #define IEEE80211_24GHZ_MAX_CHANNEL 14
970 #define IEEE80211_24GHZ_CHANNELS (IEEE80211_24GHZ_MAX_CHANNEL - \
971 IEEE80211_24GHZ_MIN_CHANNEL + 1)
973 #define IEEE80211_52GHZ_MIN_CHANNEL 34
974 #define IEEE80211_52GHZ_MAX_CHANNEL 165
975 #define IEEE80211_52GHZ_CHANNELS (IEEE80211_52GHZ_MAX_CHANNEL - \
976 IEEE80211_52GHZ_MIN_CHANNEL + 1)
979 IEEE80211_CH_PASSIVE_ONLY = (1 << 0),
980 IEEE80211_CH_80211H_RULES = (1 << 1),
981 IEEE80211_CH_B_ONLY = (1 << 2),
982 IEEE80211_CH_NO_IBSS = (1 << 3),
983 IEEE80211_CH_UNIFORM_SPREADING = (1 << 4),
984 IEEE80211_CH_RADAR_DETECT = (1 << 5),
985 IEEE80211_CH_INVALID = (1 << 6),
988 struct ieee80211_channel {
989 u32 freq; /* in MHz */
992 u8 max_power; /* in dBm */
995 struct ieee80211_geo {
999 struct ieee80211_channel bg[IEEE80211_24GHZ_CHANNELS];
1000 struct ieee80211_channel a[IEEE80211_52GHZ_CHANNELS];
1003 struct ieee80211_device {
1004 struct net_device *dev;
1005 struct ieee80211_security sec;
1007 /* Bookkeeping structures */
1008 struct net_device_stats stats;
1009 struct ieee80211_stats ieee_stats;
1011 struct ieee80211_geo geo;
1013 /* Probe / Beacon management */
1014 struct list_head network_free_list;
1015 struct list_head network_list;
1016 struct ieee80211_network *networks;
1020 int iw_mode; /* operating mode (IW_MODE_*) */
1021 struct iw_spy_data spy_data; /* iwspy support */
1025 int tx_headroom; /* Set to size of any additional room needed at front
1026 * of allocated Tx SKBs */
1029 /* WEP and other encryption related settings at the device level */
1030 int open_wep; /* Set to 1 to allow unencrypted frames */
1032 int reset_on_keychange; /* Set to 1 if the HW needs to be reset on
1033 * WEP key changes */
1035 /* If the host performs {en,de}cryption, then set to 1 */
1037 int host_encrypt_msdu;
1039 /* host performs multicast decryption */
1040 int host_mc_decrypt;
1042 /* host should strip IV and ICV from protected frames */
1043 /* meaningful only when hardware decryption is being used */
1044 int host_strip_iv_icv;
1048 int ieee802_1x; /* is IEEE 802.1X used */
1052 int drop_unencrypted;
1053 int privacy_invoked;
1057 struct list_head crypt_deinit_list;
1058 struct ieee80211_crypt_data *crypt[WEP_KEYS];
1059 int tx_keyidx; /* default TX key index (crypt[tx_keyidx]) */
1060 struct timer_list crypt_deinit_timer;
1063 int bcrx_sta_key; /* use individual keys to override default keys even
1064 * with RX of broad/multicast frames */
1066 /* Fragmentation structures */
1067 struct ieee80211_frag_entry frag_cache[IEEE80211_FRAG_CACHE_LEN];
1068 unsigned int frag_next_idx;
1069 u16 fts; /* Fragmentation Threshold */
1070 u16 rts; /* RTS threshold */
1072 /* Association info */
1075 enum ieee80211_state state;
1077 int mode; /* A, B, G */
1078 int modulation; /* CCK, OFDM */
1079 int freq_band; /* 2.4Ghz, 5.2Ghz, Mixed */
1080 int abg_true; /* ABG flag */
1085 u16 prev_seq_ctl; /* used to drop duplicate frames */
1087 /* Callback functions */
1088 void (*set_security) (struct net_device * dev,
1089 struct ieee80211_security * sec);
1090 int (*hard_start_xmit) (struct ieee80211_txb * txb,
1091 struct net_device * dev, int pri);
1092 int (*reset_port) (struct net_device * dev);
1093 int (*is_queue_full) (struct net_device * dev, int pri);
1095 int (*handle_management) (struct net_device * dev,
1096 struct ieee80211_network * network, u16 type);
1097 int (*is_qos_active) (struct net_device *dev, struct sk_buff *skb);
1099 /* Typical STA methods */
1100 int (*handle_auth) (struct net_device * dev,
1101 struct ieee80211_auth * auth);
1102 int (*handle_deauth) (struct net_device * dev,
1103 struct ieee80211_deauth * auth);
1104 int (*handle_action) (struct net_device * dev,
1105 struct ieee80211_action * action,
1106 struct ieee80211_rx_stats * stats);
1107 int (*handle_disassoc) (struct net_device * dev,
1108 struct ieee80211_disassoc * assoc);
1109 int (*handle_beacon) (struct net_device * dev,
1110 struct ieee80211_beacon * beacon,
1111 struct ieee80211_network * network);
1112 int (*handle_probe_response) (struct net_device * dev,
1113 struct ieee80211_probe_response * resp,
1114 struct ieee80211_network * network);
1115 int (*handle_probe_request) (struct net_device * dev,
1116 struct ieee80211_probe_request * req,
1117 struct ieee80211_rx_stats * stats);
1118 int (*handle_assoc_response) (struct net_device * dev,
1119 struct ieee80211_assoc_response * resp,
1120 struct ieee80211_network * network);
1122 /* Typical AP methods */
1123 int (*handle_assoc_request) (struct net_device * dev);
1124 int (*handle_reassoc_request) (struct net_device * dev,
1125 struct ieee80211_reassoc_request * req);
1127 /* This must be the last item so that it points to the data
1128 * allocated beyond this structure by alloc_ieee80211 */
1132 #define IEEE_A (1<<0)
1133 #define IEEE_B (1<<1)
1134 #define IEEE_G (1<<2)
1135 #define IEEE_MODE_MASK (IEEE_A|IEEE_B|IEEE_G)
1137 static inline void *ieee80211_priv(struct net_device *dev)
1139 return ((struct ieee80211_device *)netdev_priv(dev))->priv;
1142 static inline int ieee80211_is_empty_essid(const char *essid, int essid_len)
1144 /* Single white space is for Linksys APs */
1145 if (essid_len == 1 && essid[0] == ' ')
1148 /* Otherwise, if the entire essid is 0, we assume it is hidden */
1151 if (essid[essid_len] != '\0')
1158 static inline int ieee80211_is_valid_mode(struct ieee80211_device *ieee,
1162 * It is possible for both access points and our device to support
1163 * combinations of modes, so as long as there is one valid combination
1164 * of ap/device supported modes, then return success
1167 if ((mode & IEEE_A) &&
1168 (ieee->modulation & IEEE80211_OFDM_MODULATION) &&
1169 (ieee->freq_band & IEEE80211_52GHZ_BAND))
1172 if ((mode & IEEE_G) &&
1173 (ieee->modulation & IEEE80211_OFDM_MODULATION) &&
1174 (ieee->freq_band & IEEE80211_24GHZ_BAND))
1177 if ((mode & IEEE_B) &&
1178 (ieee->modulation & IEEE80211_CCK_MODULATION) &&
1179 (ieee->freq_band & IEEE80211_24GHZ_BAND))
1185 static inline int ieee80211_get_hdrlen(u16 fc)
1187 int hdrlen = IEEE80211_3ADDR_LEN;
1188 u16 stype = WLAN_FC_GET_STYPE(fc);
1190 switch (WLAN_FC_GET_TYPE(fc)) {
1191 case IEEE80211_FTYPE_DATA:
1192 if ((fc & IEEE80211_FCTL_FROMDS) && (fc & IEEE80211_FCTL_TODS))
1193 hdrlen = IEEE80211_4ADDR_LEN;
1194 if (stype & IEEE80211_STYPE_QOS_DATA)
1197 case IEEE80211_FTYPE_CTL:
1198 switch (WLAN_FC_GET_STYPE(fc)) {
1199 case IEEE80211_STYPE_CTS:
1200 case IEEE80211_STYPE_ACK:
1201 hdrlen = IEEE80211_1ADDR_LEN;
1204 hdrlen = IEEE80211_2ADDR_LEN;
1213 static inline u8 *ieee80211_get_payload(struct ieee80211_hdr *hdr)
1215 switch (ieee80211_get_hdrlen(le16_to_cpu(hdr->frame_ctl))) {
1216 case IEEE80211_1ADDR_LEN:
1217 return ((struct ieee80211_hdr_1addr *)hdr)->payload;
1218 case IEEE80211_2ADDR_LEN:
1219 return ((struct ieee80211_hdr_2addr *)hdr)->payload;
1220 case IEEE80211_3ADDR_LEN:
1221 return ((struct ieee80211_hdr_3addr *)hdr)->payload;
1222 case IEEE80211_4ADDR_LEN:
1223 return ((struct ieee80211_hdr_4addr *)hdr)->payload;
1228 static inline int ieee80211_is_ofdm_rate(u8 rate)
1230 switch (rate & ~IEEE80211_BASIC_RATE_MASK) {
1231 case IEEE80211_OFDM_RATE_6MB:
1232 case IEEE80211_OFDM_RATE_9MB:
1233 case IEEE80211_OFDM_RATE_12MB:
1234 case IEEE80211_OFDM_RATE_18MB:
1235 case IEEE80211_OFDM_RATE_24MB:
1236 case IEEE80211_OFDM_RATE_36MB:
1237 case IEEE80211_OFDM_RATE_48MB:
1238 case IEEE80211_OFDM_RATE_54MB:
1244 static inline int ieee80211_is_cck_rate(u8 rate)
1246 switch (rate & ~IEEE80211_BASIC_RATE_MASK) {
1247 case IEEE80211_CCK_RATE_1MB:
1248 case IEEE80211_CCK_RATE_2MB:
1249 case IEEE80211_CCK_RATE_5MB:
1250 case IEEE80211_CCK_RATE_11MB:
1257 extern void free_ieee80211(struct net_device *dev);
1258 extern struct net_device *alloc_ieee80211(int sizeof_priv);
1260 extern int ieee80211_set_encryption(struct ieee80211_device *ieee);
1262 /* ieee80211_tx.c */
1263 extern int ieee80211_xmit(struct sk_buff *skb, struct net_device *dev);
1264 extern void ieee80211_txb_free(struct ieee80211_txb *);
1266 /* ieee80211_rx.c */
1267 extern void ieee80211_rx_any(struct ieee80211_device *ieee,
1268 struct sk_buff *skb, struct ieee80211_rx_stats *stats);
1269 extern int ieee80211_rx(struct ieee80211_device *ieee, struct sk_buff *skb,
1270 struct ieee80211_rx_stats *rx_stats);
1271 /* make sure to set stats->len */
1272 extern void ieee80211_rx_mgt(struct ieee80211_device *ieee,
1273 struct ieee80211_hdr_4addr *header,
1274 struct ieee80211_rx_stats *stats);
1275 extern void ieee80211_network_reset(struct ieee80211_network *network);
1277 /* ieee80211_geo.c */
1278 extern const struct ieee80211_geo *ieee80211_get_geo(struct ieee80211_device
1280 extern int ieee80211_set_geo(struct ieee80211_device *ieee,
1281 const struct ieee80211_geo *geo);
1283 extern int ieee80211_is_valid_channel(struct ieee80211_device *ieee,
1285 extern int ieee80211_channel_to_index(struct ieee80211_device *ieee,
1287 extern u8 ieee80211_freq_to_channel(struct ieee80211_device *ieee, u32 freq);
1288 extern u8 ieee80211_get_channel_flags(struct ieee80211_device *ieee,
1290 extern const struct ieee80211_channel *ieee80211_get_channel(struct
1293 extern u32 ieee80211_channel_to_freq(struct ieee80211_device * ieee,
1296 /* ieee80211_wx.c */
1297 extern int ieee80211_wx_get_scan(struct ieee80211_device *ieee,
1298 struct iw_request_info *info,
1299 union iwreq_data *wrqu, char *key);
1300 extern int ieee80211_wx_set_encode(struct ieee80211_device *ieee,
1301 struct iw_request_info *info,
1302 union iwreq_data *wrqu, char *key);
1303 extern int ieee80211_wx_get_encode(struct ieee80211_device *ieee,
1304 struct iw_request_info *info,
1305 union iwreq_data *wrqu, char *key);
1306 extern int ieee80211_wx_set_encodeext(struct ieee80211_device *ieee,
1307 struct iw_request_info *info,
1308 union iwreq_data *wrqu, char *extra);
1309 extern int ieee80211_wx_get_encodeext(struct ieee80211_device *ieee,
1310 struct iw_request_info *info,
1311 union iwreq_data *wrqu, char *extra);
1313 static inline void ieee80211_increment_scans(struct ieee80211_device *ieee)
1318 static inline int ieee80211_get_scans(struct ieee80211_device *ieee)
1323 #endif /* IEEE80211_H */