1 /* 2 * IEEE 802.11 defines 3 * 4 * Copyright (c) 2001-2002, SSH Communications Security Corp and Jouni Malinen 5 * <[email protected]> 6 * Copyright (c) 2002-2003, Jouni Malinen <[email protected]> 7 * Copyright (c) 2005, Devicescape Software, Inc. 8 * Copyright (c) 2006, Michael Wu <[email protected]> 9 * 10 * This program is free software; you can redistribute it and/or modify 11 * it under the terms of the GNU General Public License version 2 as 12 * published by the Free Software Foundation. 13 */ 14 15 #ifndef IEEE80211_H 16 #define IEEE80211_H 17 18 #include <linux/types.h> 19 #include <asm/byteorder.h> 20 21 #define FCS_LEN 4 22 23 #define IEEE80211_FCTL_VERS 0x0003 24 #define IEEE80211_FCTL_FTYPE 0x000c 25 #define IEEE80211_FCTL_STYPE 0x00f0 26 #define IEEE80211_FCTL_TODS 0x0100 27 #define IEEE80211_FCTL_FROMDS 0x0200 28 #define IEEE80211_FCTL_MOREFRAGS 0x0400 29 #define IEEE80211_FCTL_RETRY 0x0800 30 #define IEEE80211_FCTL_PM 0x1000 31 #define IEEE80211_FCTL_MOREDATA 0x2000 32 #define IEEE80211_FCTL_PROTECTED 0x4000 33 #define IEEE80211_FCTL_ORDER 0x8000 34 35 #define IEEE80211_SCTL_FRAG 0x000F 36 #define IEEE80211_SCTL_SEQ 0xFFF0 37 38 #define IEEE80211_FTYPE_MGMT 0x0000 39 #define IEEE80211_FTYPE_CTL 0x0004 40 #define IEEE80211_FTYPE_DATA 0x0008 41 42 /* management */ 43 #define IEEE80211_STYPE_ASSOC_REQ 0x0000 44 #define IEEE80211_STYPE_ASSOC_RESP 0x0010 45 #define IEEE80211_STYPE_REASSOC_REQ 0x0020 46 #define IEEE80211_STYPE_REASSOC_RESP 0x0030 47 #define IEEE80211_STYPE_PROBE_REQ 0x0040 48 #define IEEE80211_STYPE_PROBE_RESP 0x0050 49 #define IEEE80211_STYPE_BEACON 0x0080 50 #define IEEE80211_STYPE_ATIM 0x0090 51 #define IEEE80211_STYPE_DISASSOC 0x00A0 52 #define IEEE80211_STYPE_AUTH 0x00B0 53 #define IEEE80211_STYPE_DEAUTH 0x00C0 54 #define IEEE80211_STYPE_ACTION 0x00D0 55 56 /* control */ 57 #define IEEE80211_STYPE_PSPOLL 0x00A0 58 #define IEEE80211_STYPE_RTS 0x00B0 59 #define IEEE80211_STYPE_CTS 0x00C0 60 #define IEEE80211_STYPE_ACK 0x00D0 61 #define IEEE80211_STYPE_CFEND 0x00E0 62 #define IEEE80211_STYPE_CFENDACK 0x00F0 63 64 /* data */ 65 #define IEEE80211_STYPE_DATA 0x0000 66 #define IEEE80211_STYPE_DATA_CFACK 0x0010 67 #define IEEE80211_STYPE_DATA_CFPOLL 0x0020 68 #define IEEE80211_STYPE_DATA_CFACKPOLL 0x0030 69 #define IEEE80211_STYPE_NULLFUNC 0x0040 70 #define IEEE80211_STYPE_CFACK 0x0050 71 #define IEEE80211_STYPE_CFPOLL 0x0060 72 #define IEEE80211_STYPE_CFACKPOLL 0x0070 73 #define IEEE80211_STYPE_QOS_DATA 0x0080 74 #define IEEE80211_STYPE_QOS_DATA_CFACK 0x0090 75 #define IEEE80211_STYPE_QOS_DATA_CFPOLL 0x00A0 76 #define IEEE80211_STYPE_QOS_DATA_CFACKPOLL 0x00B0 77 #define IEEE80211_STYPE_QOS_NULLFUNC 0x00C0 78 #define IEEE80211_STYPE_QOS_CFACK 0x00D0 79 #define IEEE80211_STYPE_QOS_CFPOLL 0x00E0 80 #define IEEE80211_STYPE_QOS_CFACKPOLL 0x00F0 81 82 83 /* miscellaneous IEEE 802.11 constants */ 84 #define IEEE80211_MAX_FRAG_THRESHOLD 2346 85 #define IEEE80211_MAX_RTS_THRESHOLD 2347 86 #define IEEE80211_MAX_AID 2007 87 #define IEEE80211_MAX_TIM_LEN 251 88 #define IEEE80211_MAX_DATA_LEN 2304 89 /* Maximum size for the MA-UNITDATA primitive, 802.11 standard section 90 6.2.1.1.2. 91 92 The figure in section 7.1.2 suggests a body size of up to 2312 93 bytes is allowed, which is a bit confusing, I suspect this 94 represents the 2304 bytes of real data, plus a possible 8 bytes of 95 WEP IV and ICV. (this interpretation suggested by Ramiro Barreiro) */ 96 97 #define IEEE80211_MAX_SSID_LEN 32 98 99 struct ieee80211_hdr { 100 __le16 frame_control; 101 __le16 duration_id; 102 u8 addr1[6]; 103 u8 addr2[6]; 104 u8 addr3[6]; 105 __le16 seq_ctrl; 106 u8 addr4[6]; 107 } __attribute__ ((packed)); 108 109 110 struct ieee80211_mgmt { 111 __le16 frame_control; 112 __le16 duration; 113 u8 da[6]; 114 u8 sa[6]; 115 u8 bssid[6]; 116 __le16 seq_ctrl; 117 union { 118 struct { 119 __le16 auth_alg; 120 __le16 auth_transaction; 121 __le16 status_code; 122 /* possibly followed by Challenge text */ 123 u8 variable[0]; 124 } __attribute__ ((packed)) auth; 125 struct { 126 __le16 reason_code; 127 } __attribute__ ((packed)) deauth; 128 struct { 129 __le16 capab_info; 130 __le16 listen_interval; 131 /* followed by SSID and Supported rates */ 132 u8 variable[0]; 133 } __attribute__ ((packed)) assoc_req; 134 struct { 135 __le16 capab_info; 136 __le16 status_code; 137 __le16 aid; 138 /* followed by Supported rates */ 139 u8 variable[0]; 140 } __attribute__ ((packed)) assoc_resp, reassoc_resp; 141 struct { 142 __le16 capab_info; 143 __le16 listen_interval; 144 u8 current_ap[6]; 145 /* followed by SSID and Supported rates */ 146 u8 variable[0]; 147 } __attribute__ ((packed)) reassoc_req; 148 struct { 149 __le16 reason_code; 150 } __attribute__ ((packed)) disassoc; 151 struct { 152 __le64 timestamp; 153 __le16 beacon_int; 154 __le16 capab_info; 155 /* followed by some of SSID, Supported rates, 156 * FH Params, DS Params, CF Params, IBSS Params, TIM */ 157 u8 variable[0]; 158 } __attribute__ ((packed)) beacon; 159 struct { 160 /* only variable items: SSID, Supported rates */ 161 u8 variable[0]; 162 } __attribute__ ((packed)) probe_req; 163 struct { 164 __le64 timestamp; 165 __le16 beacon_int; 166 __le16 capab_info; 167 /* followed by some of SSID, Supported rates, 168 * FH Params, DS Params, CF Params, IBSS Params */ 169 u8 variable[0]; 170 } __attribute__ ((packed)) probe_resp; 171 struct { 172 u8 category; 173 union { 174 struct { 175 u8 action_code; 176 u8 dialog_token; 177 u8 status_code; 178 u8 variable[0]; 179 } __attribute__ ((packed)) wme_action; 180 struct{ 181 u8 action_code; 182 u8 element_id; 183 u8 length; 184 u8 switch_mode; 185 u8 new_chan; 186 u8 switch_count; 187 } __attribute__((packed)) chan_switch; 188 } u; 189 } __attribute__ ((packed)) action; 190 } u; 191 } __attribute__ ((packed)); 192 193 194 /* Control frames */ 195 struct ieee80211_rts { 196 __le16 frame_control; 197 __le16 duration; 198 u8 ra[6]; 199 u8 ta[6]; 200 } __attribute__ ((packed)); 201 202 struct ieee80211_cts { 203 __le16 frame_control; 204 __le16 duration; 205 u8 ra[6]; 206 } __attribute__ ((packed)); 207 208 209 /* Authentication algorithms */ 210 #define WLAN_AUTH_OPEN 0 211 #define WLAN_AUTH_SHARED_KEY 1 212 #define WLAN_AUTH_FAST_BSS_TRANSITION 2 213 #define WLAN_AUTH_LEAP 128 214 215 #define WLAN_AUTH_CHALLENGE_LEN 128 216 217 #define WLAN_CAPABILITY_ESS (1<<0) 218 #define WLAN_CAPABILITY_IBSS (1<<1) 219 #define WLAN_CAPABILITY_CF_POLLABLE (1<<2) 220 #define WLAN_CAPABILITY_CF_POLL_REQUEST (1<<3) 221 #define WLAN_CAPABILITY_PRIVACY (1<<4) 222 #define WLAN_CAPABILITY_SHORT_PREAMBLE (1<<5) 223 #define WLAN_CAPABILITY_PBCC (1<<6) 224 #define WLAN_CAPABILITY_CHANNEL_AGILITY (1<<7) 225 /* 802.11h */ 226 #define WLAN_CAPABILITY_SPECTRUM_MGMT (1<<8) 227 #define WLAN_CAPABILITY_QOS (1<<9) 228 #define WLAN_CAPABILITY_SHORT_SLOT_TIME (1<<10) 229 #define WLAN_CAPABILITY_DSSS_OFDM (1<<13) 230 231 /* 802.11g ERP information element */ 232 #define WLAN_ERP_NON_ERP_PRESENT (1<<0) 233 #define WLAN_ERP_USE_PROTECTION (1<<1) 234 #define WLAN_ERP_BARKER_PREAMBLE (1<<2) 235 236 /* WLAN_ERP_BARKER_PREAMBLE values */ 237 enum { 238 WLAN_ERP_PREAMBLE_SHORT = 0, 239 WLAN_ERP_PREAMBLE_LONG = 1, 240 }; 241 242 /* Status codes */ 243 enum ieee80211_statuscode { 244 WLAN_STATUS_SUCCESS = 0, 245 WLAN_STATUS_UNSPECIFIED_FAILURE = 1, 246 WLAN_STATUS_CAPS_UNSUPPORTED = 10, 247 WLAN_STATUS_REASSOC_NO_ASSOC = 11, 248 WLAN_STATUS_ASSOC_DENIED_UNSPEC = 12, 249 WLAN_STATUS_NOT_SUPPORTED_AUTH_ALG = 13, 250 WLAN_STATUS_UNKNOWN_AUTH_TRANSACTION = 14, 251 WLAN_STATUS_CHALLENGE_FAIL = 15, 252 WLAN_STATUS_AUTH_TIMEOUT = 16, 253 WLAN_STATUS_AP_UNABLE_TO_HANDLE_NEW_STA = 17, 254 WLAN_STATUS_ASSOC_DENIED_RATES = 18, 255 /* 802.11b */ 256 WLAN_STATUS_ASSOC_DENIED_NOSHORTPREAMBLE = 19, 257 WLAN_STATUS_ASSOC_DENIED_NOPBCC = 20, 258 WLAN_STATUS_ASSOC_DENIED_NOAGILITY = 21, 259 /* 802.11h */ 260 WLAN_STATUS_ASSOC_DENIED_NOSPECTRUM = 22, 261 WLAN_STATUS_ASSOC_REJECTED_BAD_POWER = 23, 262 WLAN_STATUS_ASSOC_REJECTED_BAD_SUPP_CHAN = 24, 263 /* 802.11g */ 264 WLAN_STATUS_ASSOC_DENIED_NOSHORTTIME = 25, 265 WLAN_STATUS_ASSOC_DENIED_NODSSSOFDM = 26, 266 /* 802.11i */ 267 WLAN_STATUS_INVALID_IE = 40, 268 WLAN_STATUS_INVALID_GROUP_CIPHER = 41, 269 WLAN_STATUS_INVALID_PAIRWISE_CIPHER = 42, 270 WLAN_STATUS_INVALID_AKMP = 43, 271 WLAN_STATUS_UNSUPP_RSN_VERSION = 44, 272 WLAN_STATUS_INVALID_RSN_IE_CAP = 45, 273 WLAN_STATUS_CIPHER_SUITE_REJECTED = 46, 274 }; 275 276 277 /* Reason codes */ 278 enum ieee80211_reasoncode { 279 WLAN_REASON_UNSPECIFIED = 1, 280 WLAN_REASON_PREV_AUTH_NOT_VALID = 2, 281 WLAN_REASON_DEAUTH_LEAVING = 3, 282 WLAN_REASON_DISASSOC_DUE_TO_INACTIVITY = 4, 283 WLAN_REASON_DISASSOC_AP_BUSY = 5, 284 WLAN_REASON_CLASS2_FRAME_FROM_NONAUTH_STA = 6, 285 WLAN_REASON_CLASS3_FRAME_FROM_NONASSOC_STA = 7, 286 WLAN_REASON_DISASSOC_STA_HAS_LEFT = 8, 287 WLAN_REASON_STA_REQ_ASSOC_WITHOUT_AUTH = 9, 288 /* 802.11h */ 289 WLAN_REASON_DISASSOC_BAD_POWER = 10, 290 WLAN_REASON_DISASSOC_BAD_SUPP_CHAN = 11, 291 /* 802.11i */ 292 WLAN_REASON_INVALID_IE = 13, 293 WLAN_REASON_MIC_FAILURE = 14, 294 WLAN_REASON_4WAY_HANDSHAKE_TIMEOUT = 15, 295 WLAN_REASON_GROUP_KEY_HANDSHAKE_TIMEOUT = 16, 296 WLAN_REASON_IE_DIFFERENT = 17, 297 WLAN_REASON_INVALID_GROUP_CIPHER = 18, 298 WLAN_REASON_INVALID_PAIRWISE_CIPHER = 19, 299 WLAN_REASON_INVALID_AKMP = 20, 300 WLAN_REASON_UNSUPP_RSN_VERSION = 21, 301 WLAN_REASON_INVALID_RSN_IE_CAP = 22, 302 WLAN_REASON_IEEE8021X_FAILED = 23, 303 WLAN_REASON_CIPHER_SUITE_REJECTED = 24, 304 }; 305 306 307 /* Information Element IDs */ 308 enum ieee80211_eid { 309 WLAN_EID_SSID = 0, 310 WLAN_EID_SUPP_RATES = 1, 311 WLAN_EID_FH_PARAMS = 2, 312 WLAN_EID_DS_PARAMS = 3, 313 WLAN_EID_CF_PARAMS = 4, 314 WLAN_EID_TIM = 5, 315 WLAN_EID_IBSS_PARAMS = 6, 316 WLAN_EID_CHALLENGE = 16, 317 /* 802.11d */ 318 WLAN_EID_COUNTRY = 7, 319 WLAN_EID_HP_PARAMS = 8, 320 WLAN_EID_HP_TABLE = 9, 321 WLAN_EID_REQUEST = 10, 322 /* 802.11h */ 323 WLAN_EID_PWR_CONSTRAINT = 32, 324 WLAN_EID_PWR_CAPABILITY = 33, 325 WLAN_EID_TPC_REQUEST = 34, 326 WLAN_EID_TPC_REPORT = 35, 327 WLAN_EID_SUPPORTED_CHANNELS = 36, 328 WLAN_EID_CHANNEL_SWITCH = 37, 329 WLAN_EID_MEASURE_REQUEST = 38, 330 WLAN_EID_MEASURE_REPORT = 39, 331 WLAN_EID_QUIET = 40, 332 WLAN_EID_IBSS_DFS = 41, 333 /* 802.11g */ 334 WLAN_EID_ERP_INFO = 42, 335 WLAN_EID_EXT_SUPP_RATES = 50, 336 /* 802.11i */ 337 WLAN_EID_RSN = 48, 338 WLAN_EID_WPA = 221, 339 WLAN_EID_GENERIC = 221, 340 WLAN_EID_VENDOR_SPECIFIC = 221, 341 WLAN_EID_QOS_PARAMETER = 222 342 }; 343 344 /* cipher suite selectors */ 345 #define WLAN_CIPHER_SUITE_USE_GROUP 0x000FAC00 346 #define WLAN_CIPHER_SUITE_WEP40 0x000FAC01 347 #define WLAN_CIPHER_SUITE_TKIP 0x000FAC02 348 /* reserved: 0x000FAC03 */ 349 #define WLAN_CIPHER_SUITE_CCMP 0x000FAC04 350 #define WLAN_CIPHER_SUITE_WEP104 0x000FAC05 351 352 #define WLAN_MAX_KEY_LEN 32 353 354 /** 355 * ieee80211_get_SA - get pointer to SA 356 * 357 * Given an 802.11 frame, this function returns the offset 358 * to the source address (SA). It does not verify that the 359 * header is long enough to contain the address, and the 360 * header must be long enough to contain the frame control 361 * field. 362 * 363 * @hdr: the frame 364 */ 365 static inline u8 *ieee80211_get_SA(struct ieee80211_hdr *hdr) 366 { 367 u8 *raw = (u8 *) hdr; 368 u8 tofrom = (*(raw+1)) & 3; /* get the TODS and FROMDS bits */ 369 370 switch (tofrom) { 371 case 2: 372 return hdr->addr3; 373 case 3: 374 return hdr->addr4; 375 } 376 return hdr->addr2; 377 } 378 379 /** 380 * ieee80211_get_DA - get pointer to DA 381 * 382 * Given an 802.11 frame, this function returns the offset 383 * to the destination address (DA). It does not verify that 384 * the header is long enough to contain the address, and the 385 * header must be long enough to contain the frame control 386 * field. 387 * 388 * @hdr: the frame 389 */ 390 static inline u8 *ieee80211_get_DA(struct ieee80211_hdr *hdr) 391 { 392 u8 *raw = (u8 *) hdr; 393 u8 to_ds = (*(raw+1)) & 1; /* get the TODS bit */ 394 395 if (to_ds) 396 return hdr->addr3; 397 return hdr->addr1; 398 } 399 400 /** 401 * ieee80211_get_morefrag - determine whether the MOREFRAGS bit is set 402 * 403 * This function determines whether the "more fragments" bit is set 404 * in the frame. 405 * 406 * @hdr: the frame 407 */ 408 static inline int ieee80211_get_morefrag(struct ieee80211_hdr *hdr) 409 { 410 return (le16_to_cpu(hdr->frame_control) & 411 IEEE80211_FCTL_MOREFRAGS) != 0; 412 } 413 414 #endif /* IEEE80211_H */ 415