[PATCH] ieee80211: Type-o, capbility definition for QoS, and ERP parsing
[linux-2.6/linux-acpi-2.6/ibm-acpi-2.6.git] / include / net / ieee80211.h
blob931737eec6c67e88e968272bcd127a1e185e4e5c
1 /*
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
9 * <jkmaline@cc.hut.fi>
10 * Copyright (c) 2002-2003, Jouni Malinen <jkmaline@cc.hut.fi>
12 * Adaption to a generic IEEE 802.11 stack by James Ketrenos
13 * <jketreno@linux.intel.com>
14 * Copyright (c) 2004, 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
19 * more details.
21 #ifndef IEEE80211_H
22 #define IEEE80211_H
23 #include <linux/if_ether.h> /* ETH_ALEN */
24 #include <linux/kernel.h> /* ARRAY_SIZE */
25 #include <linux/wireless.h>
27 #define IEEE80211_DATA_LEN 2304
28 /* Maximum size for the MA-UNITDATA primitive, 802.11 standard section
29 6.2.1.1.2.
31 The figure in section 7.1.2 suggests a body size of up to 2312
32 bytes is allowed, which is a bit confusing, I suspect this
33 represents the 2304 bytes of real data, plus a possible 8 bytes of
34 WEP IV and ICV. (this interpretation suggested by Ramiro Barreiro) */
36 #define IEEE80211_1ADDR_LEN 10
37 #define IEEE80211_2ADDR_LEN 16
38 #define IEEE80211_3ADDR_LEN 24
39 #define IEEE80211_4ADDR_LEN 30
40 #define IEEE80211_FCS_LEN 4
41 #define IEEE80211_HLEN (IEEE80211_4ADDR_LEN)
42 #define IEEE80211_FRAME_LEN (IEEE80211_DATA_LEN + IEEE80211_HLEN)
44 #define MIN_FRAG_THRESHOLD 256U
45 #define MAX_FRAG_THRESHOLD 2346U
47 /* Frame control field constants */
48 #define IEEE80211_FCTL_VERS 0x0003
49 #define IEEE80211_FCTL_FTYPE 0x000c
50 #define IEEE80211_FCTL_STYPE 0x00f0
51 #define IEEE80211_FCTL_TODS 0x0100
52 #define IEEE80211_FCTL_FROMDS 0x0200
53 #define IEEE80211_FCTL_MOREFRAGS 0x0400
54 #define IEEE80211_FCTL_RETRY 0x0800
55 #define IEEE80211_FCTL_PM 0x1000
56 #define IEEE80211_FCTL_MOREDATA 0x2000
57 #define IEEE80211_FCTL_PROTECTED 0x4000
58 #define IEEE80211_FCTL_ORDER 0x8000
60 #define IEEE80211_FTYPE_MGMT 0x0000
61 #define IEEE80211_FTYPE_CTL 0x0004
62 #define IEEE80211_FTYPE_DATA 0x0008
64 /* management */
65 #define IEEE80211_STYPE_ASSOC_REQ 0x0000
66 #define IEEE80211_STYPE_ASSOC_RESP 0x0010
67 #define IEEE80211_STYPE_REASSOC_REQ 0x0020
68 #define IEEE80211_STYPE_REASSOC_RESP 0x0030
69 #define IEEE80211_STYPE_PROBE_REQ 0x0040
70 #define IEEE80211_STYPE_PROBE_RESP 0x0050
71 #define IEEE80211_STYPE_BEACON 0x0080
72 #define IEEE80211_STYPE_ATIM 0x0090
73 #define IEEE80211_STYPE_DISASSOC 0x00A0
74 #define IEEE80211_STYPE_AUTH 0x00B0
75 #define IEEE80211_STYPE_DEAUTH 0x00C0
76 #define IEEE80211_STYPE_ACTION 0x00D0
78 /* control */
79 #define IEEE80211_STYPE_PSPOLL 0x00A0
80 #define IEEE80211_STYPE_RTS 0x00B0
81 #define IEEE80211_STYPE_CTS 0x00C0
82 #define IEEE80211_STYPE_ACK 0x00D0
83 #define IEEE80211_STYPE_CFEND 0x00E0
84 #define IEEE80211_STYPE_CFENDACK 0x00F0
86 /* data */
87 #define IEEE80211_STYPE_DATA 0x0000
88 #define IEEE80211_STYPE_DATA_CFACK 0x0010
89 #define IEEE80211_STYPE_DATA_CFPOLL 0x0020
90 #define IEEE80211_STYPE_DATA_CFACKPOLL 0x0030
91 #define IEEE80211_STYPE_NULLFUNC 0x0040
92 #define IEEE80211_STYPE_CFACK 0x0050
93 #define IEEE80211_STYPE_CFPOLL 0x0060
94 #define IEEE80211_STYPE_CFACKPOLL 0x0070
95 #define IEEE80211_STYPE_QOS_DATA 0x0080
97 #define IEEE80211_SCTL_FRAG 0x000F
98 #define IEEE80211_SCTL_SEQ 0xFFF0
100 /* debug macros */
102 #ifdef CONFIG_IEEE80211_DEBUG
103 extern u32 ieee80211_debug_level;
104 #define IEEE80211_DEBUG(level, fmt, args...) \
105 do { if (ieee80211_debug_level & (level)) \
106 printk(KERN_DEBUG "ieee80211: %c %s " fmt, \
107 in_interrupt() ? 'I' : 'U', __FUNCTION__ , ## args); } while (0)
108 #else
109 #define IEEE80211_DEBUG(level, fmt, args...) do {} while (0)
110 #endif /* CONFIG_IEEE80211_DEBUG */
112 /* debug macros not dependent on CONFIG_IEEE80211_DEBUG */
114 #define MAC_FMT "%02x:%02x:%02x:%02x:%02x:%02x"
115 #define MAC_ARG(x) ((u8*)(x))[0],((u8*)(x))[1],((u8*)(x))[2],((u8*)(x))[3],((u8*)(x))[4],((u8*)(x))[5]
117 /* escape_essid() is intended to be used in debug (and possibly error)
118 * messages. It should never be used for passing essid to user space. */
119 const char *escape_essid(const char *essid, u8 essid_len);
122 * To use the debug system:
124 * If you are defining a new debug classification, simply add it to the #define
125 * list here in the form of:
127 * #define IEEE80211_DL_xxxx VALUE
129 * shifting value to the left one bit from the previous entry. xxxx should be
130 * the name of the classification (for example, WEP)
132 * You then need to either add a IEEE80211_xxxx_DEBUG() macro definition for your
133 * classification, or use IEEE80211_DEBUG(IEEE80211_DL_xxxx, ...) whenever you want
134 * to send output to that classification.
136 * To add your debug level to the list of levels seen when you perform
138 * % cat /proc/net/ieee80211/debug_level
140 * you simply need to add your entry to the ieee80211_debug_level array.
142 * If you do not see debug_level in /proc/net/ieee80211 then you do not have
143 * CONFIG_IEEE80211_DEBUG defined in your kernel configuration
147 #define IEEE80211_DL_INFO (1<<0)
148 #define IEEE80211_DL_WX (1<<1)
149 #define IEEE80211_DL_SCAN (1<<2)
150 #define IEEE80211_DL_STATE (1<<3)
151 #define IEEE80211_DL_MGMT (1<<4)
152 #define IEEE80211_DL_FRAG (1<<5)
153 #define IEEE80211_DL_DROP (1<<7)
155 #define IEEE80211_DL_TX (1<<8)
156 #define IEEE80211_DL_RX (1<<9)
157 #define IEEE80211_DL_QOS (1<<31)
159 #define IEEE80211_ERROR(f, a...) printk(KERN_ERR "ieee80211: " f, ## a)
160 #define IEEE80211_WARNING(f, a...) printk(KERN_WARNING "ieee80211: " f, ## a)
161 #define IEEE80211_DEBUG_INFO(f, a...) IEEE80211_DEBUG(IEEE80211_DL_INFO, f, ## a)
163 #define IEEE80211_DEBUG_WX(f, a...) IEEE80211_DEBUG(IEEE80211_DL_WX, f, ## a)
164 #define IEEE80211_DEBUG_SCAN(f, a...) IEEE80211_DEBUG(IEEE80211_DL_SCAN, f, ## a)
165 #define IEEE80211_DEBUG_STATE(f, a...) IEEE80211_DEBUG(IEEE80211_DL_STATE, f, ## a)
166 #define IEEE80211_DEBUG_MGMT(f, a...) IEEE80211_DEBUG(IEEE80211_DL_MGMT, f, ## a)
167 #define IEEE80211_DEBUG_FRAG(f, a...) IEEE80211_DEBUG(IEEE80211_DL_FRAG, f, ## a)
168 #define IEEE80211_DEBUG_DROP(f, a...) IEEE80211_DEBUG(IEEE80211_DL_DROP, f, ## a)
169 #define IEEE80211_DEBUG_TX(f, a...) IEEE80211_DEBUG(IEEE80211_DL_TX, f, ## a)
170 #define IEEE80211_DEBUG_RX(f, a...) IEEE80211_DEBUG(IEEE80211_DL_RX, f, ## a)
171 #define IEEE80211_DEBUG_QOS(f, a...) IEEE80211_DEBUG(IEEE80211_DL_QOS, f, ## a)
172 #include <linux/netdevice.h>
173 #include <linux/wireless.h>
174 #include <linux/if_arp.h> /* ARPHRD_ETHER */
176 #ifndef WIRELESS_SPY
177 #define WIRELESS_SPY /* enable iwspy support */
178 #endif
179 #include <net/iw_handler.h> /* new driver API */
181 #ifndef ETH_P_PAE
182 #define ETH_P_PAE 0x888E /* Port Access Entity (IEEE 802.1X) */
183 #endif /* ETH_P_PAE */
185 #define ETH_P_PREAUTH 0x88C7 /* IEEE 802.11i pre-authentication */
187 #ifndef ETH_P_80211_RAW
188 #define ETH_P_80211_RAW (ETH_P_ECONET + 1)
189 #endif
191 /* IEEE 802.11 defines */
193 #define P80211_OUI_LEN 3
195 struct ieee80211_snap_hdr {
197 u8 dsap; /* always 0xAA */
198 u8 ssap; /* always 0xAA */
199 u8 ctrl; /* always 0x03 */
200 u8 oui[P80211_OUI_LEN]; /* organizational universal id */
202 } __attribute__ ((packed));
204 #define SNAP_SIZE sizeof(struct ieee80211_snap_hdr)
206 #define WLAN_FC_GET_VERS(fc) ((fc) & IEEE80211_FCTL_VERS)
207 #define WLAN_FC_GET_TYPE(fc) ((fc) & IEEE80211_FCTL_FTYPE)
208 #define WLAN_FC_GET_STYPE(fc) ((fc) & IEEE80211_FCTL_STYPE)
210 #define WLAN_GET_SEQ_FRAG(seq) ((seq) & IEEE80211_SCTL_FRAG)
211 #define WLAN_GET_SEQ_SEQ(seq) ((seq) & IEEE80211_SCTL_SEQ)
213 /* Authentication algorithms */
214 #define WLAN_AUTH_OPEN 0
215 #define WLAN_AUTH_SHARED_KEY 1
217 #define WLAN_AUTH_CHALLENGE_LEN 128
219 #define WLAN_CAPABILITY_ESS (1<<0)
220 #define WLAN_CAPABILITY_IBSS (1<<1)
221 #define WLAN_CAPABILITY_CF_POLLABLE (1<<2)
222 #define WLAN_CAPABILITY_CF_POLL_REQUEST (1<<3)
223 #define WLAN_CAPABILITY_PRIVACY (1<<4)
224 #define WLAN_CAPABILITY_SHORT_PREAMBLE (1<<5)
225 #define WLAN_CAPABILITY_PBCC (1<<6)
226 #define WLAN_CAPABILITY_CHANNEL_AGILITY (1<<7)
227 #define WLAN_CAPABILITY_SPECTRUM_MGMT (1<<8)
228 #define WLAN_CAPABILITY_QOS (1<<9)
229 #define WLAN_CAPABILITY_SHORT_SLOT_TIME (1<<10)
230 #define WLAN_CAPABILITY_DSSS_OFDM (1<<13)
232 /* Status codes */
233 enum ieee80211_statuscode {
234 WLAN_STATUS_SUCCESS = 0,
235 WLAN_STATUS_UNSPECIFIED_FAILURE = 1,
236 WLAN_STATUS_CAPS_UNSUPPORTED = 10,
237 WLAN_STATUS_REASSOC_NO_ASSOC = 11,
238 WLAN_STATUS_ASSOC_DENIED_UNSPEC = 12,
239 WLAN_STATUS_NOT_SUPPORTED_AUTH_ALG = 13,
240 WLAN_STATUS_UNKNOWN_AUTH_TRANSACTION = 14,
241 WLAN_STATUS_CHALLENGE_FAIL = 15,
242 WLAN_STATUS_AUTH_TIMEOUT = 16,
243 WLAN_STATUS_AP_UNABLE_TO_HANDLE_NEW_STA = 17,
244 WLAN_STATUS_ASSOC_DENIED_RATES = 18,
245 /* 802.11b */
246 WLAN_STATUS_ASSOC_DENIED_NOSHORTPREAMBLE = 19,
247 WLAN_STATUS_ASSOC_DENIED_NOPBCC = 20,
248 WLAN_STATUS_ASSOC_DENIED_NOAGILITY = 21,
249 /* 802.11h */
250 WLAN_STATUS_ASSOC_DENIED_NOSPECTRUM = 22,
251 WLAN_STATUS_ASSOC_REJECTED_BAD_POWER = 23,
252 WLAN_STATUS_ASSOC_REJECTED_BAD_SUPP_CHAN = 24,
253 /* 802.11g */
254 WLAN_STATUS_ASSOC_DENIED_NOSHORTTIME = 25,
255 WLAN_STATUS_ASSOC_DENIED_NODSSSOFDM = 26,
256 /* 802.11i */
257 WLAN_STATUS_INVALID_IE = 40,
258 WLAN_STATUS_INVALID_GROUP_CIPHER = 41,
259 WLAN_STATUS_INVALID_PAIRWISE_CIPHER = 42,
260 WLAN_STATUS_INVALID_AKMP = 43,
261 WLAN_STATUS_UNSUPP_RSN_VERSION = 44,
262 WLAN_STATUS_INVALID_RSN_IE_CAP = 45,
263 WLAN_STATUS_CIPHER_SUITE_REJECTED = 46,
266 /* Reason codes */
267 enum ieee80211_reasoncode {
268 WLAN_REASON_UNSPECIFIED = 1,
269 WLAN_REASON_PREV_AUTH_NOT_VALID = 2,
270 WLAN_REASON_DEAUTH_LEAVING = 3,
271 WLAN_REASON_DISASSOC_DUE_TO_INACTIVITY = 4,
272 WLAN_REASON_DISASSOC_AP_BUSY = 5,
273 WLAN_REASON_CLASS2_FRAME_FROM_NONAUTH_STA = 6,
274 WLAN_REASON_CLASS3_FRAME_FROM_NONASSOC_STA = 7,
275 WLAN_REASON_DISASSOC_STA_HAS_LEFT = 8,
276 WLAN_REASON_STA_REQ_ASSOC_WITHOUT_AUTH = 9,
277 /* 802.11h */
278 WLAN_REASON_DISASSOC_BAD_POWER = 10,
279 WLAN_REASON_DISASSOC_BAD_SUPP_CHAN = 11,
280 /* 802.11i */
281 WLAN_REASON_INVALID_IE = 13,
282 WLAN_REASON_MIC_FAILURE = 14,
283 WLAN_REASON_4WAY_HANDSHAKE_TIMEOUT = 15,
284 WLAN_REASON_GROUP_KEY_HANDSHAKE_TIMEOUT = 16,
285 WLAN_REASON_IE_DIFFERENT = 17,
286 WLAN_REASON_INVALID_GROUP_CIPHER = 18,
287 WLAN_REASON_INVALID_PAIRWISE_CIPHER = 19,
288 WLAN_REASON_INVALID_AKMP = 20,
289 WLAN_REASON_UNSUPP_RSN_VERSION = 21,
290 WLAN_REASON_INVALID_RSN_IE_CAP = 22,
291 WLAN_REASON_IEEE8021X_FAILED = 23,
292 WLAN_REASON_CIPHER_SUITE_REJECTED = 24,
295 #define IEEE80211_STATMASK_SIGNAL (1<<0)
296 #define IEEE80211_STATMASK_RSSI (1<<1)
297 #define IEEE80211_STATMASK_NOISE (1<<2)
298 #define IEEE80211_STATMASK_RATE (1<<3)
299 #define IEEE80211_STATMASK_WEMASK 0x7
301 #define IEEE80211_CCK_MODULATION (1<<0)
302 #define IEEE80211_OFDM_MODULATION (1<<1)
304 #define IEEE80211_24GHZ_BAND (1<<0)
305 #define IEEE80211_52GHZ_BAND (1<<1)
307 #define IEEE80211_CCK_RATE_1MB 0x02
308 #define IEEE80211_CCK_RATE_2MB 0x04
309 #define IEEE80211_CCK_RATE_5MB 0x0B
310 #define IEEE80211_CCK_RATE_11MB 0x16
311 #define IEEE80211_OFDM_RATE_6MB 0x0C
312 #define IEEE80211_OFDM_RATE_9MB 0x12
313 #define IEEE80211_OFDM_RATE_12MB 0x18
314 #define IEEE80211_OFDM_RATE_18MB 0x24
315 #define IEEE80211_OFDM_RATE_24MB 0x30
316 #define IEEE80211_OFDM_RATE_36MB 0x48
317 #define IEEE80211_OFDM_RATE_48MB 0x60
318 #define IEEE80211_OFDM_RATE_54MB 0x6C
319 #define IEEE80211_BASIC_RATE_MASK 0x80
321 #define IEEE80211_CCK_RATE_1MB_MASK (1<<0)
322 #define IEEE80211_CCK_RATE_2MB_MASK (1<<1)
323 #define IEEE80211_CCK_RATE_5MB_MASK (1<<2)
324 #define IEEE80211_CCK_RATE_11MB_MASK (1<<3)
325 #define IEEE80211_OFDM_RATE_6MB_MASK (1<<4)
326 #define IEEE80211_OFDM_RATE_9MB_MASK (1<<5)
327 #define IEEE80211_OFDM_RATE_12MB_MASK (1<<6)
328 #define IEEE80211_OFDM_RATE_18MB_MASK (1<<7)
329 #define IEEE80211_OFDM_RATE_24MB_MASK (1<<8)
330 #define IEEE80211_OFDM_RATE_36MB_MASK (1<<9)
331 #define IEEE80211_OFDM_RATE_48MB_MASK (1<<10)
332 #define IEEE80211_OFDM_RATE_54MB_MASK (1<<11)
334 #define IEEE80211_CCK_RATES_MASK 0x0000000F
335 #define IEEE80211_CCK_BASIC_RATES_MASK (IEEE80211_CCK_RATE_1MB_MASK | \
336 IEEE80211_CCK_RATE_2MB_MASK)
337 #define IEEE80211_CCK_DEFAULT_RATES_MASK (IEEE80211_CCK_BASIC_RATES_MASK | \
338 IEEE80211_CCK_RATE_5MB_MASK | \
339 IEEE80211_CCK_RATE_11MB_MASK)
341 #define IEEE80211_OFDM_RATES_MASK 0x00000FF0
342 #define IEEE80211_OFDM_BASIC_RATES_MASK (IEEE80211_OFDM_RATE_6MB_MASK | \
343 IEEE80211_OFDM_RATE_12MB_MASK | \
344 IEEE80211_OFDM_RATE_24MB_MASK)
345 #define IEEE80211_OFDM_DEFAULT_RATES_MASK (IEEE80211_OFDM_BASIC_RATES_MASK | \
346 IEEE80211_OFDM_RATE_9MB_MASK | \
347 IEEE80211_OFDM_RATE_18MB_MASK | \
348 IEEE80211_OFDM_RATE_36MB_MASK | \
349 IEEE80211_OFDM_RATE_48MB_MASK | \
350 IEEE80211_OFDM_RATE_54MB_MASK)
351 #define IEEE80211_DEFAULT_RATES_MASK (IEEE80211_OFDM_DEFAULT_RATES_MASK | \
352 IEEE80211_CCK_DEFAULT_RATES_MASK)
354 #define IEEE80211_NUM_OFDM_RATES 8
355 #define IEEE80211_NUM_CCK_RATES 4
356 #define IEEE80211_OFDM_SHIFT_MASK_A 4
358 /* NOTE: This data is for statistical purposes; not all hardware provides this
359 * information for frames received. Not setting these will not cause
360 * any adverse affects. */
361 struct ieee80211_rx_stats {
362 u32 mac_time;
363 s8 rssi;
364 u8 signal;
365 u8 noise;
366 u16 rate; /* in 100 kbps */
367 u8 received_channel;
368 u8 control;
369 u8 mask;
370 u8 freq;
371 u16 len;
374 /* IEEE 802.11 requires that STA supports concurrent reception of at least
375 * three fragmented frames. This define can be increased to support more
376 * concurrent frames, but it should be noted that each entry can consume about
377 * 2 kB of RAM and increasing cache size will slow down frame reassembly. */
378 #define IEEE80211_FRAG_CACHE_LEN 4
380 struct ieee80211_frag_entry {
381 unsigned long first_frag_time;
382 unsigned int seq;
383 unsigned int last_frag;
384 struct sk_buff *skb;
385 u8 src_addr[ETH_ALEN];
386 u8 dst_addr[ETH_ALEN];
389 struct ieee80211_stats {
390 unsigned int tx_unicast_frames;
391 unsigned int tx_multicast_frames;
392 unsigned int tx_fragments;
393 unsigned int tx_unicast_octets;
394 unsigned int tx_multicast_octets;
395 unsigned int tx_deferred_transmissions;
396 unsigned int tx_single_retry_frames;
397 unsigned int tx_multiple_retry_frames;
398 unsigned int tx_retry_limit_exceeded;
399 unsigned int tx_discards;
400 unsigned int rx_unicast_frames;
401 unsigned int rx_multicast_frames;
402 unsigned int rx_fragments;
403 unsigned int rx_unicast_octets;
404 unsigned int rx_multicast_octets;
405 unsigned int rx_fcs_errors;
406 unsigned int rx_discards_no_buffer;
407 unsigned int tx_discards_wrong_sa;
408 unsigned int rx_discards_undecryptable;
409 unsigned int rx_message_in_msg_fragments;
410 unsigned int rx_message_in_bad_msg_fragments;
413 struct ieee80211_device;
415 #include "ieee80211_crypt.h"
417 #define SEC_KEY_1 (1<<0)
418 #define SEC_KEY_2 (1<<1)
419 #define SEC_KEY_3 (1<<2)
420 #define SEC_KEY_4 (1<<3)
421 #define SEC_ACTIVE_KEY (1<<4)
422 #define SEC_AUTH_MODE (1<<5)
423 #define SEC_UNICAST_GROUP (1<<6)
424 #define SEC_LEVEL (1<<7)
425 #define SEC_ENABLED (1<<8)
426 #define SEC_ENCRYPT (1<<9)
428 #define SEC_LEVEL_0 0 /* None */
429 #define SEC_LEVEL_1 1 /* WEP 40 and 104 bit */
430 #define SEC_LEVEL_2 2 /* Level 1 + TKIP */
431 #define SEC_LEVEL_2_CKIP 3 /* Level 1 + CKIP */
432 #define SEC_LEVEL_3 4 /* Level 2 + CCMP */
434 #define SEC_ALG_NONE 0
435 #define SEC_ALG_WEP 1
436 #define SEC_ALG_TKIP 2
437 #define SEC_ALG_CCMP 3
439 #define WEP_KEYS 4
440 #define WEP_KEY_LEN 13
441 #define SCM_KEY_LEN 32
442 #define SCM_TEMPORAL_KEY_LENGTH 16
444 struct ieee80211_security {
445 u16 active_key:2,
446 enabled:1,
447 auth_mode:2, auth_algo:4, unicast_uses_group:1, encrypt:1;
448 u8 encode_alg[WEP_KEYS];
449 u8 key_sizes[WEP_KEYS];
450 u8 keys[WEP_KEYS][SCM_KEY_LEN];
451 u8 level;
452 u16 flags;
453 } __attribute__ ((packed));
457 802.11 data frame from AP
459 ,-------------------------------------------------------------------.
460 Bytes | 2 | 2 | 6 | 6 | 6 | 2 | 0..2312 | 4 |
461 |------|------|---------|---------|---------|------|---------|------|
462 Desc. | ctrl | dura | DA/RA | TA | SA | Sequ | frame | fcs |
463 | | tion | (BSSID) | | | ence | data | |
464 `-------------------------------------------------------------------'
466 Total: 28-2340 bytes
470 #define BEACON_PROBE_SSID_ID_POSITION 12
472 /* Management Frame Information Element Types */
473 enum ieee80211_mfie {
474 MFIE_TYPE_SSID = 0,
475 MFIE_TYPE_RATES = 1,
476 MFIE_TYPE_FH_SET = 2,
477 MFIE_TYPE_DS_SET = 3,
478 MFIE_TYPE_CF_SET = 4,
479 MFIE_TYPE_TIM = 5,
480 MFIE_TYPE_IBSS_SET = 6,
481 MFIE_TYPE_COUNTRY = 7,
482 MFIE_TYPE_HOP_PARAMS = 8,
483 MFIE_TYPE_HOP_TABLE = 9,
484 MFIE_TYPE_REQUEST = 10,
485 MFIE_TYPE_CHALLENGE = 16,
486 MFIE_TYPE_POWER_CONSTRAINT = 32,
487 MFIE_TYPE_POWER_CAPABILITY = 33,
488 MFIE_TYPE_TPC_REQUEST = 34,
489 MFIE_TYPE_TPC_REPORT = 35,
490 MFIE_TYPE_SUPP_CHANNELS = 36,
491 MFIE_TYPE_CSA = 37,
492 MFIE_TYPE_MEASURE_REQUEST = 38,
493 MFIE_TYPE_MEASURE_REPORT = 39,
494 MFIE_TYPE_QUIET = 40,
495 MFIE_TYPE_IBSS_DFS = 41,
496 MFIE_TYPE_ERP_INFO = 42,
497 MFIE_TYPE_RSN = 48,
498 MFIE_TYPE_RATES_EX = 50,
499 MFIE_TYPE_GENERIC = 221,
500 MFIE_TYPE_QOS_PARAMETER = 222,
503 /* Minimal header; can be used for passing 802.11 frames with sufficient
504 * information to determine what type of underlying data type is actually
505 * stored in the data. */
506 struct ieee80211_hdr {
507 __le16 frame_ctl;
508 __le16 duration_id;
509 u8 payload[0];
510 } __attribute__ ((packed));
512 struct ieee80211_hdr_1addr {
513 __le16 frame_ctl;
514 __le16 duration_id;
515 u8 addr1[ETH_ALEN];
516 u8 payload[0];
517 } __attribute__ ((packed));
519 struct ieee80211_hdr_2addr {
520 __le16 frame_ctl;
521 __le16 duration_id;
522 u8 addr1[ETH_ALEN];
523 u8 addr2[ETH_ALEN];
524 u8 payload[0];
525 } __attribute__ ((packed));
527 struct ieee80211_hdr_3addr {
528 __le16 frame_ctl;
529 __le16 duration_id;
530 u8 addr1[ETH_ALEN];
531 u8 addr2[ETH_ALEN];
532 u8 addr3[ETH_ALEN];
533 __le16 seq_ctl;
534 u8 payload[0];
535 } __attribute__ ((packed));
537 struct ieee80211_hdr_4addr {
538 __le16 frame_ctl;
539 __le16 duration_id;
540 u8 addr1[ETH_ALEN];
541 u8 addr2[ETH_ALEN];
542 u8 addr3[ETH_ALEN];
543 __le16 seq_ctl;
544 u8 addr4[ETH_ALEN];
545 u8 payload[0];
546 } __attribute__ ((packed));
548 struct ieee80211_hdr_3addrqos {
549 __le16 frame_ctl;
550 __le16 duration_id;
551 u8 addr1[ETH_ALEN];
552 u8 addr2[ETH_ALEN];
553 u8 addr3[ETH_ALEN];
554 __le16 seq_ctl;
555 u8 payload[0];
556 __le16 qos_ctl;
557 } __attribute__ ((packed));
559 struct ieee80211_hdr_4addrqos {
560 __le16 frame_ctl;
561 __le16 duration_id;
562 u8 addr1[ETH_ALEN];
563 u8 addr2[ETH_ALEN];
564 u8 addr3[ETH_ALEN];
565 __le16 seq_ctl;
566 u8 addr4[ETH_ALEN];
567 u8 payload[0];
568 __le16 qos_ctl;
569 } __attribute__ ((packed));
571 struct ieee80211_info_element {
572 u8 id;
573 u8 len;
574 u8 data[0];
575 } __attribute__ ((packed));
578 * These are the data types that can make up management packets
580 u16 auth_algorithm;
581 u16 auth_sequence;
582 u16 beacon_interval;
583 u16 capability;
584 u8 current_ap[ETH_ALEN];
585 u16 listen_interval;
586 struct {
587 u16 association_id:14, reserved:2;
588 } __attribute__ ((packed));
589 u32 time_stamp[2];
590 u16 reason;
591 u16 status;
594 struct ieee80211_auth {
595 struct ieee80211_hdr_3addr header;
596 __le16 algorithm;
597 __le16 transaction;
598 __le16 status;
599 struct ieee80211_info_element info_element[0];
600 } __attribute__ ((packed));
602 struct ieee80211_disassoc {
603 struct ieee80211_hdr_3addr header;
604 __le16 reason_code;
605 struct ieee80211_info_element info_element[0];
606 } __attribute__ ((packed));
608 struct ieee80211_probe_request {
609 struct ieee80211_hdr_3addr header;
610 struct ieee80211_info_element info_element[0];
611 } __attribute__ ((packed));
613 struct ieee80211_probe_response {
614 struct ieee80211_hdr_3addr header;
615 u32 time_stamp[2];
616 __le16 beacon_interval;
617 __le16 capability;
618 struct ieee80211_info_element info_element[0];
619 } __attribute__ ((packed));
621 /* Alias beacon for probe_response */
622 #define ieee80211_beacon ieee80211_probe_response
624 struct ieee80211_assoc_request {
625 struct ieee80211_hdr_3addr header;
626 __le16 capability;
627 __le16 listen_interval;
628 struct ieee80211_info_element info_element[0];
629 } __attribute__ ((packed));
631 struct ieee80211_reassoc_request {
632 struct ieee80211_hdr_3addr header;
633 __le16 capability;
634 __le16 listen_interval;
635 u8 current_ap[ETH_ALEN];
636 struct ieee80211_info_element info_element[0];
637 } __attribute__ ((packed));
639 struct ieee80211_assoc_response {
640 struct ieee80211_hdr_3addr header;
641 __le16 capability;
642 __le16 status;
643 __le16 aid;
644 struct ieee80211_info_element info_element[0]; /* supported rates */
645 } __attribute__ ((packed));
647 struct ieee80211_txb {
648 u8 nr_frags;
649 u8 encrypted;
650 u8 rts_included;
651 u8 reserved;
652 __le16 frag_size;
653 __le16 payload_size;
654 struct sk_buff *fragments[0];
657 /* SWEEP TABLE ENTRIES NUMBER */
658 #define MAX_SWEEP_TAB_ENTRIES 42
659 #define MAX_SWEEP_TAB_ENTRIES_PER_PACKET 7
660 /* MAX_RATES_LENGTH needs to be 12. The spec says 8, and many APs
661 * only use 8, and then use extended rates for the remaining supported
662 * rates. Other APs, however, stick all of their supported rates on the
663 * main rates information element... */
664 #define MAX_RATES_LENGTH ((u8)12)
665 #define MAX_RATES_EX_LENGTH ((u8)16)
666 #define MAX_NETWORK_COUNT 128
668 #define CRC_LENGTH 4U
670 #define MAX_WPA_IE_LEN 64
672 #define NETWORK_EMPTY_ESSID (1<<0)
673 #define NETWORK_HAS_OFDM (1<<1)
674 #define NETWORK_HAS_CCK (1<<2)
676 /* QoS structure */
677 #define NETWORK_HAS_QOS_PARAMETERS (1<<3)
678 #define NETWORK_HAS_QOS_INFORMATION (1<<4)
679 #define NETWORK_HAS_QOS_MASK (NETWORK_HAS_QOS_PARAMETERS | NETWORK_HAS_QOS_INFORMATION)
681 #define QOS_QUEUE_NUM 4
682 #define QOS_OUI_LEN 3
683 #define QOS_OUI_TYPE 2
684 #define QOS_ELEMENT_ID 221
685 #define QOS_OUI_INFO_SUB_TYPE 0
686 #define QOS_OUI_PARAM_SUB_TYPE 1
687 #define QOS_VERSION_1 1
688 #define QOS_AIFSN_MIN_VALUE 2
690 struct ieee80211_qos_information_element {
691 u8 elementID;
692 u8 length;
693 u8 qui[QOS_OUI_LEN];
694 u8 qui_type;
695 u8 qui_subtype;
696 u8 version;
697 u8 ac_info;
698 } __attribute__ ((packed));
700 struct ieee80211_qos_ac_parameter {
701 u8 aci_aifsn;
702 u8 ecw_min_max;
703 __le16 tx_op_limit;
704 } __attribute__ ((packed));
706 struct ieee80211_qos_parameter_info {
707 struct ieee80211_qos_information_element info_element;
708 u8 reserved;
709 struct ieee80211_qos_ac_parameter ac_params_record[QOS_QUEUE_NUM];
710 } __attribute__ ((packed));
712 struct ieee80211_qos_parameters {
713 __le16 cw_min[QOS_QUEUE_NUM];
714 __le16 cw_max[QOS_QUEUE_NUM];
715 u8 aifs[QOS_QUEUE_NUM];
716 u8 flag[QOS_QUEUE_NUM];
717 __le16 tx_op_limit[QOS_QUEUE_NUM];
718 } __attribute__ ((packed));
720 struct ieee80211_qos_data {
721 struct ieee80211_qos_parameters parameters;
722 int active;
723 int supported;
724 u8 param_count;
725 u8 old_param_count;
728 struct ieee80211_tim_parameters {
729 u8 tim_count;
730 u8 tim_period;
731 } __attribute__ ((packed));
733 /*******************************************************/
735 struct ieee80211_network {
736 /* These entries are used to identify a unique network */
737 u8 bssid[ETH_ALEN];
738 u8 channel;
739 /* Ensure null-terminated for any debug msgs */
740 u8 ssid[IW_ESSID_MAX_SIZE + 1];
741 u8 ssid_len;
743 struct ieee80211_qos_data qos_data;
745 /* These are network statistics */
746 struct ieee80211_rx_stats stats;
747 u16 capability;
748 u8 rates[MAX_RATES_LENGTH];
749 u8 rates_len;
750 u8 rates_ex[MAX_RATES_EX_LENGTH];
751 u8 rates_ex_len;
752 unsigned long last_scanned;
753 u8 mode;
754 u8 flags;
755 u32 last_associate;
756 u32 time_stamp[2];
757 u16 beacon_interval;
758 u16 listen_interval;
759 u16 atim_window;
760 u8 erp_value;
761 u8 wpa_ie[MAX_WPA_IE_LEN];
762 size_t wpa_ie_len;
763 u8 rsn_ie[MAX_WPA_IE_LEN];
764 size_t rsn_ie_len;
765 struct ieee80211_tim_parameters tim;
766 struct list_head list;
769 enum ieee80211_state {
770 IEEE80211_UNINITIALIZED = 0,
771 IEEE80211_INITIALIZED,
772 IEEE80211_ASSOCIATING,
773 IEEE80211_ASSOCIATED,
774 IEEE80211_AUTHENTICATING,
775 IEEE80211_AUTHENTICATED,
776 IEEE80211_SHUTDOWN
779 #define DEFAULT_MAX_SCAN_AGE (15 * HZ)
780 #define DEFAULT_FTS 2346
782 #define CFG_IEEE80211_RESERVE_FCS (1<<0)
783 #define CFG_IEEE80211_COMPUTE_FCS (1<<1)
784 #define CFG_IEEE80211_RTS (1<<2)
786 #define IEEE80211_24GHZ_MIN_CHANNEL 1
787 #define IEEE80211_24GHZ_MAX_CHANNEL 14
788 #define IEEE80211_24GHZ_CHANNELS 14
790 #define IEEE80211_52GHZ_MIN_CHANNEL 36
791 #define IEEE80211_52GHZ_MAX_CHANNEL 165
792 #define IEEE80211_52GHZ_CHANNELS 32
794 enum {
795 IEEE80211_CH_PASSIVE_ONLY = (1 << 0),
796 IEEE80211_CH_B_ONLY = (1 << 2),
797 IEEE80211_CH_NO_IBSS = (1 << 3),
798 IEEE80211_CH_UNIFORM_SPREADING = (1 << 4),
799 IEEE80211_CH_RADAR_DETECT = (1 << 5),
800 IEEE80211_CH_INVALID = (1 << 6),
803 struct ieee80211_channel {
804 u16 freq;
805 u8 channel;
806 u8 flags;
807 u8 max_power;
810 struct ieee80211_geo {
811 u8 name[4];
812 u8 bg_channels;
813 u8 a_channels;
814 struct ieee80211_channel bg[IEEE80211_24GHZ_CHANNELS];
815 struct ieee80211_channel a[IEEE80211_52GHZ_CHANNELS];
818 struct ieee80211_device {
819 struct net_device *dev;
820 struct ieee80211_security sec;
822 /* Bookkeeping structures */
823 struct net_device_stats stats;
824 struct ieee80211_stats ieee_stats;
826 struct ieee80211_geo geo;
828 /* Probe / Beacon management */
829 struct list_head network_free_list;
830 struct list_head network_list;
831 struct ieee80211_network *networks;
832 int scans;
833 int scan_age;
835 int iw_mode; /* operating mode (IW_MODE_*) */
836 struct iw_spy_data spy_data; /* iwspy support */
838 spinlock_t lock;
840 int tx_headroom; /* Set to size of any additional room needed at front
841 * of allocated Tx SKBs */
842 u32 config;
844 /* WEP and other encryption related settings at the device level */
845 int open_wep; /* Set to 1 to allow unencrypted frames */
847 int reset_on_keychange; /* Set to 1 if the HW needs to be reset on
848 * WEP key changes */
850 /* If the host performs {en,de}cryption, then set to 1 */
851 int host_encrypt;
852 int host_encrypt_msdu;
853 int host_decrypt;
854 int host_open_frag;
855 int ieee802_1x; /* is IEEE 802.1X used */
857 /* WPA data */
858 int wpa_enabled;
859 int drop_unencrypted;
860 int tkip_countermeasures;
861 int privacy_invoked;
862 size_t wpa_ie_len;
863 u8 *wpa_ie;
865 struct list_head crypt_deinit_list;
866 struct ieee80211_crypt_data *crypt[WEP_KEYS];
867 int tx_keyidx; /* default TX key index (crypt[tx_keyidx]) */
868 struct timer_list crypt_deinit_timer;
869 int crypt_quiesced;
871 int bcrx_sta_key; /* use individual keys to override default keys even
872 * with RX of broad/multicast frames */
874 /* Fragmentation structures */
875 struct ieee80211_frag_entry frag_cache[IEEE80211_FRAG_CACHE_LEN];
876 unsigned int frag_next_idx;
877 u16 fts; /* Fragmentation Threshold */
878 u16 rts; /* RTS threshold */
880 /* Association info */
881 u8 bssid[ETH_ALEN];
883 enum ieee80211_state state;
885 int mode; /* A, B, G */
886 int modulation; /* CCK, OFDM */
887 int freq_band; /* 2.4Ghz, 5.2Ghz, Mixed */
888 int abg_true; /* ABG flag */
890 int perfect_rssi;
891 int worst_rssi;
893 /* Callback functions */
894 void (*set_security) (struct net_device * dev,
895 struct ieee80211_security * sec);
896 int (*hard_start_xmit) (struct ieee80211_txb * txb,
897 struct net_device * dev, int pri);
898 int (*reset_port) (struct net_device * dev);
899 int (*is_queue_full) (struct net_device * dev, int pri);
901 int (*handle_management) (struct net_device * dev,
902 struct ieee80211_network * network, u16 type);
904 /* Typical STA methods */
905 int (*handle_auth) (struct net_device * dev,
906 struct ieee80211_auth * auth);
907 int (*handle_disassoc) (struct net_device * dev,
908 struct ieee80211_disassoc * assoc);
909 int (*handle_beacon) (struct net_device * dev,
910 struct ieee80211_beacon * beacon,
911 struct ieee80211_network * network);
912 int (*handle_probe_response) (struct net_device * dev,
913 struct ieee80211_probe_response * resp,
914 struct ieee80211_network * network);
915 int (*handle_probe_request) (struct net_device * dev,
916 struct ieee80211_probe_request * req,
917 struct ieee80211_rx_stats * stats);
918 int (*handle_assoc_response) (struct net_device * dev,
919 struct ieee80211_assoc_response * resp,
920 struct ieee80211_network * network);
922 /* Typical AP methods */
923 int (*handle_assoc_request) (struct net_device * dev);
924 int (*handle_reassoc_request) (struct net_device * dev,
925 struct ieee80211_reassoc_request * req);
927 /* This must be the last item so that it points to the data
928 * allocated beyond this structure by alloc_ieee80211 */
929 u8 priv[0];
932 #define IEEE_A (1<<0)
933 #define IEEE_B (1<<1)
934 #define IEEE_G (1<<2)
935 #define IEEE_MODE_MASK (IEEE_A|IEEE_B|IEEE_G)
937 static inline void *ieee80211_priv(struct net_device *dev)
939 return ((struct ieee80211_device *)netdev_priv(dev))->priv;
942 static inline int ieee80211_is_empty_essid(const char *essid, int essid_len)
944 /* Single white space is for Linksys APs */
945 if (essid_len == 1 && essid[0] == ' ')
946 return 1;
948 /* Otherwise, if the entire essid is 0, we assume it is hidden */
949 while (essid_len) {
950 essid_len--;
951 if (essid[essid_len] != '\0')
952 return 0;
955 return 1;
958 static inline int ieee80211_is_valid_mode(struct ieee80211_device *ieee,
959 int mode)
962 * It is possible for both access points and our device to support
963 * combinations of modes, so as long as there is one valid combination
964 * of ap/device supported modes, then return success
967 if ((mode & IEEE_A) &&
968 (ieee->modulation & IEEE80211_OFDM_MODULATION) &&
969 (ieee->freq_band & IEEE80211_52GHZ_BAND))
970 return 1;
972 if ((mode & IEEE_G) &&
973 (ieee->modulation & IEEE80211_OFDM_MODULATION) &&
974 (ieee->freq_band & IEEE80211_24GHZ_BAND))
975 return 1;
977 if ((mode & IEEE_B) &&
978 (ieee->modulation & IEEE80211_CCK_MODULATION) &&
979 (ieee->freq_band & IEEE80211_24GHZ_BAND))
980 return 1;
982 return 0;
985 static inline int ieee80211_get_hdrlen(u16 fc)
987 int hdrlen = IEEE80211_3ADDR_LEN;
988 u16 stype = WLAN_FC_GET_STYPE(fc);
990 switch (WLAN_FC_GET_TYPE(fc)) {
991 case IEEE80211_FTYPE_DATA:
992 if ((fc & IEEE80211_FCTL_FROMDS) && (fc & IEEE80211_FCTL_TODS))
993 hdrlen = IEEE80211_4ADDR_LEN;
994 if (stype & IEEE80211_STYPE_QOS_DATA)
995 hdrlen += 2;
996 break;
997 case IEEE80211_FTYPE_CTL:
998 switch (WLAN_FC_GET_STYPE(fc)) {
999 case IEEE80211_STYPE_CTS:
1000 case IEEE80211_STYPE_ACK:
1001 hdrlen = IEEE80211_1ADDR_LEN;
1002 break;
1003 default:
1004 hdrlen = IEEE80211_2ADDR_LEN;
1005 break;
1007 break;
1010 return hdrlen;
1013 static inline u8 *ieee80211_get_payload(struct ieee80211_hdr *hdr)
1015 switch (ieee80211_get_hdrlen(le16_to_cpu(hdr->frame_ctl))) {
1016 case IEEE80211_1ADDR_LEN:
1017 return ((struct ieee80211_hdr_1addr *)hdr)->payload;
1018 case IEEE80211_2ADDR_LEN:
1019 return ((struct ieee80211_hdr_2addr *)hdr)->payload;
1020 case IEEE80211_3ADDR_LEN:
1021 return ((struct ieee80211_hdr_3addr *)hdr)->payload;
1022 case IEEE80211_4ADDR_LEN:
1023 return ((struct ieee80211_hdr_4addr *)hdr)->payload;
1028 /* ieee80211.c */
1029 extern void free_ieee80211(struct net_device *dev);
1030 extern struct net_device *alloc_ieee80211(int sizeof_priv);
1032 extern int ieee80211_set_encryption(struct ieee80211_device *ieee);
1034 /* ieee80211_tx.c */
1035 extern int ieee80211_xmit(struct sk_buff *skb, struct net_device *dev);
1036 extern void ieee80211_txb_free(struct ieee80211_txb *);
1037 extern int ieee80211_tx_frame(struct ieee80211_device *ieee,
1038 struct ieee80211_hdr *frame, int len);
1040 /* ieee80211_rx.c */
1041 extern int ieee80211_rx(struct ieee80211_device *ieee, struct sk_buff *skb,
1042 struct ieee80211_rx_stats *rx_stats);
1043 extern void ieee80211_rx_mgt(struct ieee80211_device *ieee,
1044 struct ieee80211_hdr_4addr *header,
1045 struct ieee80211_rx_stats *stats);
1047 /* ieee80211_geo.c */
1048 extern const struct ieee80211_geo *ieee80211_get_geo(struct ieee80211_device
1049 *ieee);
1050 extern int ieee80211_set_geo(struct ieee80211_device *ieee,
1051 const struct ieee80211_geo *geo);
1053 extern int ieee80211_is_valid_channel(struct ieee80211_device *ieee,
1054 u8 channel);
1055 extern int ieee80211_channel_to_index(struct ieee80211_device *ieee,
1056 u8 channel);
1057 extern u8 ieee80211_freq_to_channel(struct ieee80211_device *ieee, u32 freq);
1059 /* ieee80211_wx.c */
1060 extern int ieee80211_wx_get_scan(struct ieee80211_device *ieee,
1061 struct iw_request_info *info,
1062 union iwreq_data *wrqu, char *key);
1063 extern int ieee80211_wx_set_encode(struct ieee80211_device *ieee,
1064 struct iw_request_info *info,
1065 union iwreq_data *wrqu, char *key);
1066 extern int ieee80211_wx_get_encode(struct ieee80211_device *ieee,
1067 struct iw_request_info *info,
1068 union iwreq_data *wrqu, char *key);
1069 #if WIRELESS_EXT > 17
1070 extern int ieee80211_wx_set_encodeext(struct ieee80211_device *ieee,
1071 struct iw_request_info *info,
1072 union iwreq_data *wrqu, char *extra);
1073 extern int ieee80211_wx_get_encodeext(struct ieee80211_device *ieee,
1074 struct iw_request_info *info,
1075 union iwreq_data *wrqu, char *extra);
1076 #endif
1078 static inline void ieee80211_increment_scans(struct ieee80211_device *ieee)
1080 ieee->scans++;
1083 static inline int ieee80211_get_scans(struct ieee80211_device *ieee)
1085 return ieee->scans;
1088 #endif /* IEEE80211_H */