err.no Git - linux-2.6/blob - include/linux/ieee80211.h

   1 /*
   2  * IEEE 802.11 defines
   3  *
   4  * Copyright (c) 2001-2002, SSH Communications Security Corp and Jouni Malinen
   5  * <jkmaline@cc.hut.fi>
   6  * Copyright (c) 2002-2003, Jouni Malinen <jkmaline@cc.hut.fi>
   7  * Copyright (c) 2005, Devicescape Software, Inc.
   8  * Copyright (c) 2006, Michael Wu <flamingice@sourmilk.net>
   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    2352
  85 #define IEEE80211_MAX_RTS_THRESHOLD     2353
  86 #define IEEE80211_MAX_AID               2007
  87 #define IEEE80211_MAX_TIM_LEN           251
  88 /* Maximum size for the MA-UNITDATA primitive, 802.11 standard section
  89    6.2.1.1.2.
  90
  91    802.11e clarifies the figure in section 7.1.2. The frame body is
  92    up to 2304 octets long (maximum MSDU size) plus any crypt overhead. */
  93 #define IEEE80211_MAX_DATA_LEN          2304
  94 /* 30 byte 4 addr hdr, 2 byte QoS, 2304 byte MSDU, 12 byte crypt, 4 byte FCS */
  95 #define IEEE80211_MAX_FRAME_LEN         2352
  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 */