include/net/ieee80211.h

   1 /*
   2  * Merged with mainline ieee80211.h in Aug 2004.  Original ieee802_11
   3  * remains copyright by the original authors
   4  *
   5  * Portions of the merged code are based on Host AP (software wireless
   6  * LAN access point) driver for Intersil Prism2/2.5/3.
   7  *
   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>
  11  *
  12  * Adaption to a generic IEEE 802.11 stack by James Ketrenos
  13  * <jketreno@linux.intel.com>
  14  * Copyright (c) 2004, Intel Corporation
  15  *
  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.
  20  */
  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>
  26
  27 #if WIRELESS_EXT < 17
  28 #define IW_QUAL_QUAL_INVALID   0x10
  29 #define IW_QUAL_LEVEL_INVALID  0x20
  30 #define IW_QUAL_NOISE_INVALID  0x40
  31 #define IW_QUAL_QUAL_UPDATED   0x1
  32 #define IW_QUAL_LEVEL_UPDATED  0x2
  33 #define IW_QUAL_NOISE_UPDATED  0x4
  34 #endif
  35
  36 #define IEEE80211_DATA_LEN              2304
  37 /* Maximum size for the MA-UNITDATA primitive, 802.11 standard section
  38    6.2.1.1.2.
  39
  40    The figure in section 7.1.2 suggests a body size of up to 2312
  41    bytes is allowed, which is a bit confusing, I suspect this
  42    represents the 2304 bytes of real data, plus a possible 8 bytes of
  43    WEP IV and ICV. (this interpretation suggested by Ramiro Barreiro) */
  44
  45
  46 #define IEEE80211_HLEN                  30
  47 #define IEEE80211_FRAME_LEN             (IEEE80211_DATA_LEN + IEEE80211_HLEN)
  48
  49 struct ieee80211_hdr {
  50         __le16 frame_ctl;
  51         __le16 duration_id;
  52         u8 addr1[ETH_ALEN];
  53         u8 addr2[ETH_ALEN];
  54         u8 addr3[ETH_ALEN];
  55         __le16 seq_ctl;
  56         u8 addr4[ETH_ALEN];
  57 } __attribute__ ((packed));
  58
  59 struct ieee80211_hdr_3addr {
  60         __le16 frame_ctl;
  61         __le16 duration_id;
  62         u8 addr1[ETH_ALEN];
  63         u8 addr2[ETH_ALEN];
  64         u8 addr3[ETH_ALEN];
  65         __le16 seq_ctl;
  66 } __attribute__ ((packed));
  67
  68 enum eap_type {
  69         EAP_PACKET = 0,
  70         EAPOL_START,
  71         EAPOL_LOGOFF,
  72         EAPOL_KEY,
  73         EAPOL_ENCAP_ASF_ALERT
  74 };
  75
  76 static const char *eap_types[] = {
  77         [EAP_PACKET]            = "EAP-Packet",
  78         [EAPOL_START]           = "EAPOL-Start",
  79         [EAPOL_LOGOFF]          = "EAPOL-Logoff",
  80         [EAPOL_KEY]             = "EAPOL-Key",
  81         [EAPOL_ENCAP_ASF_ALERT] = "EAPOL-Encap-ASF-Alert"
  82 };
  83
  84 static inline const char *eap_get_type(int type)
  85 {
  86         return (type >= ARRAY_SIZE(eap_types)) ? "Unknown" : eap_types[type];
  87 }
  88
  89 struct eapol {
  90         u8 snap[6];
  91         __be16 ethertype;
  92         u8 version;
  93         u8 type;
  94         __be16 length;
  95 } __attribute__ ((packed));
  96
  97 #define IEEE80211_1ADDR_LEN 10
  98 #define IEEE80211_2ADDR_LEN 16
  99 #define IEEE80211_3ADDR_LEN 24
 100 #define IEEE80211_4ADDR_LEN 30
 101 #define IEEE80211_FCS_LEN    4
 102
 103 #define MIN_FRAG_THRESHOLD     256U
 104 #define MAX_FRAG_THRESHOLD     2346U
 105
 106 /* Frame control field constants */
 107 #define IEEE80211_FCTL_VERS             0x0003
 108 #define IEEE80211_FCTL_FTYPE            0x000c
 109 #define IEEE80211_FCTL_STYPE            0x00f0
 110 #define IEEE80211_FCTL_TODS             0x0100
 111 #define IEEE80211_FCTL_FROMDS           0x0200
 112 #define IEEE80211_FCTL_MOREFRAGS        0x0400
 113 #define IEEE80211_FCTL_RETRY            0x0800
 114 #define IEEE80211_FCTL_PM               0x1000
 115 #define IEEE80211_FCTL_MOREDATA         0x2000
 116 #define IEEE80211_FCTL_PROTECTED        0x4000
 117 #define IEEE80211_FCTL_ORDER            0x8000
 118
 119 #define IEEE80211_FTYPE_MGMT            0x0000
 120 #define IEEE80211_FTYPE_CTL             0x0004
 121 #define IEEE80211_FTYPE_DATA            0x0008
 122
 123 /* management */
 124 #define IEEE80211_STYPE_ASSOC_REQ       0x0000
 125 #define IEEE80211_STYPE_ASSOC_RESP      0x0010
 126 #define IEEE80211_STYPE_REASSOC_REQ     0x0020
 127 #define IEEE80211_STYPE_REASSOC_RESP    0x0030
 128 #define IEEE80211_STYPE_PROBE_REQ       0x0040
 129 #define IEEE80211_STYPE_PROBE_RESP      0x0050
 130 #define IEEE80211_STYPE_BEACON          0x0080
 131 #define IEEE80211_STYPE_ATIM            0x0090
 132 #define IEEE80211_STYPE_DISASSOC        0x00A0
 133 #define IEEE80211_STYPE_AUTH            0x00B0
 134 #define IEEE80211_STYPE_DEAUTH          0x00C0
 135 #define IEEE80211_STYPE_ACTION          0x00D0
 136
 137 /* control */
 138 #define IEEE80211_STYPE_PSPOLL          0x00A0
 139 #define IEEE80211_STYPE_RTS             0x00B0
 140 #define IEEE80211_STYPE_CTS             0x00C0
 141 #define IEEE80211_STYPE_ACK             0x00D0
 142 #define IEEE80211_STYPE_CFEND           0x00E0
 143 #define IEEE80211_STYPE_CFENDACK        0x00F0
 144
 145 /* data */
 146 #define IEEE80211_STYPE_DATA            0x0000
 147 #define IEEE80211_STYPE_DATA_CFACK      0x0010
 148 #define IEEE80211_STYPE_DATA_CFPOLL     0x0020
 149 #define IEEE80211_STYPE_DATA_CFACKPOLL  0x0030
 150 #define IEEE80211_STYPE_NULLFUNC        0x0040
 151 #define IEEE80211_STYPE_CFACK           0x0050
 152 #define IEEE80211_STYPE_CFPOLL          0x0060
 153 #define IEEE80211_STYPE_CFACKPOLL       0x0070
 154
 155 #define IEEE80211_SCTL_FRAG             0x000F
 156 #define IEEE80211_SCTL_SEQ              0xFFF0
 157
 158
 159 /* debug macros */
 160
 161 #ifdef CONFIG_IEEE80211_DEBUG
 162 extern u32 ieee80211_debug_level;
 163 #define IEEE80211_DEBUG(level, fmt, args...) \
 164 do { if (ieee80211_debug_level & (level)) \
 165   printk(KERN_DEBUG "ieee80211: %c %s " fmt, \
 166          in_interrupt() ? 'I' : 'U', __FUNCTION__ , ## args); } while (0)
 167 #else
 168 #define IEEE80211_DEBUG(level, fmt, args...) do {} while (0)
 169 #endif  /* CONFIG_IEEE80211_DEBUG */
 170
 171
 172 /* debug macros not dependent on CONFIG_IEEE80211_DEBUG */
 173
 174 #define MAC_FMT "%02x:%02x:%02x:%02x:%02x:%02x"
 175 #define MAC_ARG(x) ((u8*)(x))[0],((u8*)(x))[1],((u8*)(x))[2],((u8*)(x))[3],((u8*)(x))[4],((u8*)(x))[5]
 176
 177 /* escape_essid() is intended to be used in debug (and possibly error)
 178  * messages. It should never be used for passing essid to user space. */
 179 const char *escape_essid(const char *essid, u8 essid_len);
 180
 181
 182 /*
 183  * To use the debug system:
 184  *
 185  * If you are defining a new debug classification, simply add it to the #define
 186  * list here in the form of:
 187  *
 188  * #define IEEE80211_DL_xxxx VALUE
 189  *
 190  * shifting value to the left one bit from the previous entry.  xxxx should be
 191  * the name of the classification (for example, WEP)
 192  *
 193  * You then need to either add a IEEE80211_xxxx_DEBUG() macro definition for your
 194  * classification, or use IEEE80211_DEBUG(IEEE80211_DL_xxxx, ...) whenever you want
 195  * to send output to that classification.
 196  *
 197  * To add your debug level to the list of levels seen when you perform
 198  *
 199  * % cat /proc/net/ipw/debug_level
 200  *
 201  * you simply need to add your entry to the ipw_debug_levels array.
 202  *
 203  * If you do not see debug_level in /proc/net/ipw then you do not have
 204  * CONFIG_IEEE80211_DEBUG defined in your kernel configuration
 205  *
 206  */
 207
 208 #define IEEE80211_DL_INFO          (1<<0)
 209 #define IEEE80211_DL_WX            (1<<1)
 210 #define IEEE80211_DL_SCAN          (1<<2)
 211 #define IEEE80211_DL_STATE         (1<<3)
 212 #define IEEE80211_DL_MGMT          (1<<4)
 213 #define IEEE80211_DL_FRAG          (1<<5)
 214 #define IEEE80211_DL_EAP           (1<<6)
 215 #define IEEE80211_DL_DROP          (1<<7)
 216
 217 #define IEEE80211_DL_TX            (1<<8)
 218 #define IEEE80211_DL_RX            (1<<9)
 219
 220 #define IEEE80211_ERROR(f, a...) printk(KERN_ERR "ieee80211: " f, ## a)
 221 #define IEEE80211_WARNING(f, a...) printk(KERN_WARNING "ieee80211: " f, ## a)
 222 #define IEEE80211_DEBUG_INFO(f, a...)   IEEE80211_DEBUG(IEEE80211_DL_INFO, f, ## a)
 223
 224 #define IEEE80211_DEBUG_WX(f, a...)     IEEE80211_DEBUG(IEEE80211_DL_WX, f, ## a)
 225 #define IEEE80211_DEBUG_SCAN(f, a...)   IEEE80211_DEBUG(IEEE80211_DL_SCAN, f, ## a)
 226 #define IEEE80211_DEBUG_STATE(f, a...)  IEEE80211_DEBUG(IEEE80211_DL_STATE, f, ## a)
 227 #define IEEE80211_DEBUG_MGMT(f, a...)  IEEE80211_DEBUG(IEEE80211_DL_MGMT, f, ## a)
 228 #define IEEE80211_DEBUG_FRAG(f, a...)  IEEE80211_DEBUG(IEEE80211_DL_FRAG, f, ## a)
 229 #define IEEE80211_DEBUG_EAP(f, a...)  IEEE80211_DEBUG(IEEE80211_DL_EAP, f, ## a)
 230 #define IEEE80211_DEBUG_DROP(f, a...)  IEEE80211_DEBUG(IEEE80211_DL_DROP, f, ## a)
 231 #define IEEE80211_DEBUG_TX(f, a...)  IEEE80211_DEBUG(IEEE80211_DL_TX, f, ## a)
 232 #define IEEE80211_DEBUG_RX(f, a...)  IEEE80211_DEBUG(IEEE80211_DL_RX, f, ## a)
 233 #include <linux/netdevice.h>
 234 #include <linux/wireless.h>
 235 #include <linux/if_arp.h> /* ARPHRD_ETHER */
 236
 237 #ifndef WIRELESS_SPY
 238 #define WIRELESS_SPY            /* enable iwspy support */
 239 #endif
 240 #include <net/iw_handler.h>     /* new driver API */
 241
 242 #ifndef ETH_P_PAE
 243 #define ETH_P_PAE 0x888E /* Port Access Entity (IEEE 802.1X) */
 244 #endif /* ETH_P_PAE */
 245
 246 #define ETH_P_PREAUTH 0x88C7 /* IEEE 802.11i pre-authentication */
 247
 248 #ifndef ETH_P_80211_RAW
 249 #define ETH_P_80211_RAW (ETH_P_ECONET + 1)
 250 #endif
 251
 252 /* IEEE 802.11 defines */
 253
 254 #define P80211_OUI_LEN 3
 255
 256 struct ieee80211_snap_hdr {
 257
 258         u8    dsap;   /* always 0xAA */
 259         u8    ssap;   /* always 0xAA */
 260         u8    ctrl;   /* always 0x03 */
 261         u8    oui[P80211_OUI_LEN];    /* organizational universal id */
 262
 263 } __attribute__ ((packed));
 264
 265 #define SNAP_SIZE sizeof(struct ieee80211_snap_hdr)
 266
 267 #define WLAN_FC_GET_VERS(fc) ((fc) & IEEE80211_FCTL_VERS)
 268 #define WLAN_FC_GET_TYPE(fc) ((fc) & IEEE80211_FCTL_FTYPE)
 269 #define WLAN_FC_GET_STYPE(fc) ((fc) & IEEE80211_FCTL_STYPE)
 270
 271 #define WLAN_GET_SEQ_FRAG(seq) ((seq) & IEEE80211_SCTL_FRAG)
 272 #define WLAN_GET_SEQ_SEQ(seq)  ((seq) & IEEE80211_SCTL_SEQ)
 273
 274 /* Authentication algorithms */
 275 #define WLAN_AUTH_OPEN 0
 276 #define WLAN_AUTH_SHARED_KEY 1
 277
 278 #define WLAN_AUTH_CHALLENGE_LEN 128
 279
 280 #define WLAN_CAPABILITY_ESS (1<<0)
 281 #define WLAN_CAPABILITY_IBSS (1<<1)
 282 #define WLAN_CAPABILITY_CF_POLLABLE (1<<2)
 283 #define WLAN_CAPABILITY_CF_POLL_REQUEST (1<<3)
 284 #define WLAN_CAPABILITY_PRIVACY (1<<4)
 285 #define WLAN_CAPABILITY_SHORT_PREAMBLE (1<<5)
 286 #define WLAN_CAPABILITY_PBCC (1<<6)
 287 #define WLAN_CAPABILITY_CHANNEL_AGILITY (1<<7)
 288 #define WLAN_CAPABILITY_SPECTRUM_MGMT (1<<8)
 289 #define WLAN_CAPABILITY_SHORT_SLOT_TIME (1<<10)
 290 #define WLAN_CAPABILITY_OSSS_OFDM (1<<13)
 291
 292 /* Status codes */
 293 enum ieee80211_statuscode {
 294         WLAN_STATUS_SUCCESS = 0,
 295         WLAN_STATUS_UNSPECIFIED_FAILURE = 1,
 296         WLAN_STATUS_CAPS_UNSUPPORTED = 10,
 297         WLAN_STATUS_REASSOC_NO_ASSOC = 11,
 298         WLAN_STATUS_ASSOC_DENIED_UNSPEC = 12,
 299         WLAN_STATUS_NOT_SUPPORTED_AUTH_ALG = 13,
 300         WLAN_STATUS_UNKNOWN_AUTH_TRANSACTION = 14,
 301         WLAN_STATUS_CHALLENGE_FAIL = 15,
 302         WLAN_STATUS_AUTH_TIMEOUT = 16,
 303         WLAN_STATUS_AP_UNABLE_TO_HANDLE_NEW_STA = 17,
 304         WLAN_STATUS_ASSOC_DENIED_RATES = 18,
 305         /* 802.11b */
 306         WLAN_STATUS_ASSOC_DENIED_NOSHORTPREAMBLE = 19,
 307         WLAN_STATUS_ASSOC_DENIED_NOPBCC = 20,
 308         WLAN_STATUS_ASSOC_DENIED_NOAGILITY = 21,
 309         /* 802.11h */
 310         WLAN_STATUS_ASSOC_DENIED_NOSPECTRUM = 22,
 311         WLAN_STATUS_ASSOC_REJECTED_BAD_POWER = 23,
 312         WLAN_STATUS_ASSOC_REJECTED_BAD_SUPP_CHAN = 24,
 313         /* 802.11g */
 314         WLAN_STATUS_ASSOC_DENIED_NOSHORTTIME = 25,
 315         WLAN_STATUS_ASSOC_DENIED_NODSSSOFDM = 26,
 316         /* 802.11i */
 317         WLAN_STATUS_INVALID_IE = 40,
 318         WLAN_STATUS_INVALID_GROUP_CIPHER = 41,
 319         WLAN_STATUS_INVALID_PAIRWISE_CIPHER = 42,
 320         WLAN_STATUS_INVALID_AKMP = 43,
 321         WLAN_STATUS_UNSUPP_RSN_VERSION = 44,
 322         WLAN_STATUS_INVALID_RSN_IE_CAP = 45,
 323         WLAN_STATUS_CIPHER_SUITE_REJECTED = 46,
 324 };
 325
 326 /* Reason codes */
 327 enum ieee80211_reasoncode {
 328         WLAN_REASON_UNSPECIFIED = 1,
 329         WLAN_REASON_PREV_AUTH_NOT_VALID = 2,
 330         WLAN_REASON_DEAUTH_LEAVING = 3,
 331         WLAN_REASON_DISASSOC_DUE_TO_INACTIVITY = 4,
 332         WLAN_REASON_DISASSOC_AP_BUSY = 5,
 333         WLAN_REASON_CLASS2_FRAME_FROM_NONAUTH_STA = 6,
 334         WLAN_REASON_CLASS3_FRAME_FROM_NONASSOC_STA = 7,
 335         WLAN_REASON_DISASSOC_STA_HAS_LEFT = 8,
 336         WLAN_REASON_STA_REQ_ASSOC_WITHOUT_AUTH = 9,
 337         /* 802.11h */
 338         WLAN_REASON_DISASSOC_BAD_POWER = 10,
 339         WLAN_REASON_DISASSOC_BAD_SUPP_CHAN = 11,
 340         /* 802.11i */
 341         WLAN_REASON_INVALID_IE = 13,
 342         WLAN_REASON_MIC_FAILURE = 14,
 343         WLAN_REASON_4WAY_HANDSHAKE_TIMEOUT = 15,
 344         WLAN_REASON_GROUP_KEY_HANDSHAKE_TIMEOUT = 16,
 345         WLAN_REASON_IE_DIFFERENT = 17,
 346         WLAN_REASON_INVALID_GROUP_CIPHER = 18,
 347         WLAN_REASON_INVALID_PAIRWISE_CIPHER = 19,
 348         WLAN_REASON_INVALID_AKMP = 20,
 349         WLAN_REASON_UNSUPP_RSN_VERSION = 21,
 350         WLAN_REASON_INVALID_RSN_IE_CAP = 22,
 351         WLAN_REASON_IEEE8021X_FAILED = 23,
 352         WLAN_REASON_CIPHER_SUITE_REJECTED = 24,
 353 };
 354
 355
 356 #define IEEE80211_STATMASK_SIGNAL (1<<0)
 357 #define IEEE80211_STATMASK_RSSI (1<<1)
 358 #define IEEE80211_STATMASK_NOISE (1<<2)
 359 #define IEEE80211_STATMASK_RATE (1<<3)
 360 #define IEEE80211_STATMASK_WEMASK 0x7
 361
 362
 363 #define IEEE80211_CCK_MODULATION    (1<<0)
 364 #define IEEE80211_OFDM_MODULATION   (1<<1)
 365
 366 #define IEEE80211_24GHZ_BAND     (1<<0)
 367 #define IEEE80211_52GHZ_BAND     (1<<1)
 368
 369 #define IEEE80211_CCK_RATE_1MB                  0x02
 370 #define IEEE80211_CCK_RATE_2MB                  0x04
 371 #define IEEE80211_CCK_RATE_5MB                  0x0B
 372 #define IEEE80211_CCK_RATE_11MB                 0x16
 373 #define IEEE80211_OFDM_RATE_6MB                 0x0C
 374 #define IEEE80211_OFDM_RATE_9MB                 0x12
 375 #define IEEE80211_OFDM_RATE_12MB                0x18
 376 #define IEEE80211_OFDM_RATE_18MB                0x24
 377 #define IEEE80211_OFDM_RATE_24MB                0x30
 378 #define IEEE80211_OFDM_RATE_36MB                0x48
 379 #define IEEE80211_OFDM_RATE_48MB                0x60
 380 #define IEEE80211_OFDM_RATE_54MB                0x6C
 381 #define IEEE80211_BASIC_RATE_MASK               0x80
 382
 383 #define IEEE80211_CCK_RATE_1MB_MASK             (1<<0)
 384 #define IEEE80211_CCK_RATE_2MB_MASK             (1<<1)
 385 #define IEEE80211_CCK_RATE_5MB_MASK             (1<<2)
 386 #define IEEE80211_CCK_RATE_11MB_MASK            (1<<3)
 387 #define IEEE80211_OFDM_RATE_6MB_MASK            (1<<4)
 388 #define IEEE80211_OFDM_RATE_9MB_MASK            (1<<5)
 389 #define IEEE80211_OFDM_RATE_12MB_MASK           (1<<6)
 390 #define IEEE80211_OFDM_RATE_18MB_MASK           (1<<7)
 391 #define IEEE80211_OFDM_RATE_24MB_MASK           (1<<8)
 392 #define IEEE80211_OFDM_RATE_36MB_MASK           (1<<9)
 393 #define IEEE80211_OFDM_RATE_48MB_MASK           (1<<10)
 394 #define IEEE80211_OFDM_RATE_54MB_MASK           (1<<11)
 395
 396 #define IEEE80211_CCK_RATES_MASK                0x0000000F
 397 #define IEEE80211_CCK_BASIC_RATES_MASK  (IEEE80211_CCK_RATE_1MB_MASK | \
 398         IEEE80211_CCK_RATE_2MB_MASK)
 399 #define IEEE80211_CCK_DEFAULT_RATES_MASK        (IEEE80211_CCK_BASIC_RATES_MASK | \
 400         IEEE80211_CCK_RATE_5MB_MASK | \
 401         IEEE80211_CCK_RATE_11MB_MASK)
 402
 403 #define IEEE80211_OFDM_RATES_MASK               0x00000FF0
 404 #define IEEE80211_OFDM_BASIC_RATES_MASK (IEEE80211_OFDM_RATE_6MB_MASK | \
 405         IEEE80211_OFDM_RATE_12MB_MASK | \
 406         IEEE80211_OFDM_RATE_24MB_MASK)
 407 #define IEEE80211_OFDM_DEFAULT_RATES_MASK       (IEEE80211_OFDM_BASIC_RATES_MASK | \
 408         IEEE80211_OFDM_RATE_9MB_MASK  | \
 409         IEEE80211_OFDM_RATE_18MB_MASK | \
 410         IEEE80211_OFDM_RATE_36MB_MASK | \
 411         IEEE80211_OFDM_RATE_48MB_MASK | \
 412         IEEE80211_OFDM_RATE_54MB_MASK)
 413 #define IEEE80211_DEFAULT_RATES_MASK (IEEE80211_OFDM_DEFAULT_RATES_MASK | \
 414                                 IEEE80211_CCK_DEFAULT_RATES_MASK)
 415
 416 #define IEEE80211_NUM_OFDM_RATES            8
 417 #define IEEE80211_NUM_CCK_RATES             4
 418 #define IEEE80211_OFDM_SHIFT_MASK_A         4
 419
 420
 421
 422
 423 /* NOTE: This data is for statistical purposes; not all hardware provides this
 424  *       information for frames received.  Not setting these will not cause
 425  *       any adverse affects. */
 426 struct ieee80211_rx_stats {
 427         u32 mac_time;
 428         s8 rssi;
 429         u8 signal;
 430         u8 noise;
 431         u16 rate; /* in 100 kbps */
 432         u8 received_channel;
 433         u8 control;
 434         u8 mask;
 435         u8 freq;
 436         u16 len;
 437 };
 438
 439 /* IEEE 802.11 requires that STA supports concurrent reception of at least
 440  * three fragmented frames. This define can be increased to support more
 441  * concurrent frames, but it should be noted that each entry can consume about
 442  * 2 kB of RAM and increasing cache size will slow down frame reassembly. */
 443 #define IEEE80211_FRAG_CACHE_LEN 4
 444
 445 struct ieee80211_frag_entry {
 446         unsigned long first_frag_time;
 447         unsigned int seq;
 448         unsigned int last_frag;
 449         struct sk_buff *skb;
 450         u8 src_addr[ETH_ALEN];
 451         u8 dst_addr[ETH_ALEN];
 452 };
 453
 454 struct ieee80211_stats {
 455         unsigned int tx_unicast_frames;
 456         unsigned int tx_multicast_frames;
 457         unsigned int tx_fragments;
 458         unsigned int tx_unicast_octets;
 459         unsigned int tx_multicast_octets;
 460         unsigned int tx_deferred_transmissions;
 461         unsigned int tx_single_retry_frames;
 462         unsigned int tx_multiple_retry_frames;
 463         unsigned int tx_retry_limit_exceeded;
 464         unsigned int tx_discards;
 465         unsigned int rx_unicast_frames;
 466         unsigned int rx_multicast_frames;
 467         unsigned int rx_fragments;
 468         unsigned int rx_unicast_octets;
 469         unsigned int rx_multicast_octets;
 470         unsigned int rx_fcs_errors;
 471         unsigned int rx_discards_no_buffer;
 472         unsigned int tx_discards_wrong_sa;
 473         unsigned int rx_discards_undecryptable;
 474         unsigned int rx_message_in_msg_fragments;
 475         unsigned int rx_message_in_bad_msg_fragments;
 476 };
 477
 478 struct ieee80211_device;
 479
 480 #include "ieee80211_crypt.h"
 481
 482 #define SEC_KEY_1         (1<<0)
 483 #define SEC_KEY_2         (1<<1)
 484 #define SEC_KEY_3         (1<<2)
 485 #define SEC_KEY_4         (1<<3)
 486 #define SEC_ACTIVE_KEY    (1<<4)
 487 #define SEC_AUTH_MODE     (1<<5)
 488 #define SEC_UNICAST_GROUP (1<<6)
 489 #define SEC_LEVEL         (1<<7)
 490 #define SEC_ENABLED       (1<<8)
 491
 492 #define SEC_LEVEL_0      0 /* None */
 493 #define SEC_LEVEL_1      1 /* WEP 40 and 104 bit */
 494 #define SEC_LEVEL_2      2 /* Level 1 + TKIP */
 495 #define SEC_LEVEL_2_CKIP 3 /* Level 1 + CKIP */
 496 #define SEC_LEVEL_3      4 /* Level 2 + CCMP */
 497
 498 #define WEP_KEYS 4
 499 #define WEP_KEY_LEN 13
 500
 501 struct ieee80211_security {
 502         u16 active_key:2,
 503             enabled:1,
 504             auth_mode:2,
 505             auth_algo:4,
 506             unicast_uses_group:1;
 507         u8 key_sizes[WEP_KEYS];
 508         u8 keys[WEP_KEYS][WEP_KEY_LEN];
 509         u8 level;
 510         u16 flags;
 511 } __attribute__ ((packed));
 512
 513
 514 /*
 515
 516  802.11 data frame from AP
 517
 518       ,-------------------------------------------------------------------.
 519 Bytes |  2   |  2   |    6    |    6    |    6    |  2   | 0..2312 |   4  |
 520       |------|------|---------|---------|---------|------|---------|------|
 521 Desc. | ctrl | dura |  DA/RA  |   TA    |    SA   | Sequ |  frame  |  fcs |
 522       |      | tion | (BSSID) |         |         | ence |  data   |      |
 523       `-------------------------------------------------------------------'
 524
 525 Total: 28-2340 bytes
 526
 527 */
 528
 529 #define BEACON_PROBE_SSID_ID_POSITION 12
 530
 531 /* Management Frame Information Element Types */
 532 enum ieee80211_mfie {
 533         MFIE_TYPE_SSID = 0,
 534         MFIE_TYPE_RATES = 1,
 535         MFIE_TYPE_FH_SET = 2,
 536         MFIE_TYPE_DS_SET = 3,
 537         MFIE_TYPE_CF_SET =  4,
 538         MFIE_TYPE_TIM = 5,
 539         MFIE_TYPE_IBSS_SET = 6,
 540         MFIE_TYPE_COUNTRY = 7,
 541         MFIE_TYPE_HOP_PARAMS = 8,
 542         MFIE_TYPE_HOP_TABLE = 9,
 543         MFIE_TYPE_REQUEST = 10,
 544         MFIE_TYPE_CHALLENGE = 16,
 545         MFIE_TYPE_POWER_CONSTRAINT = 32,
 546         MFIE_TYPE_POWER_CAPABILITY = 33,
 547         MFIE_TYPE_TPC_REQUEST = 34,
 548         MFIE_TYPE_TPC_REPORT = 35,
 549         MFIE_TYPE_SUPP_CHANNELS = 36,
 550         MFIE_TYPE_CSA = 37,
 551         MFIE_TYPE_MEASURE_REQUEST = 38,
 552         MFIE_TYPE_MEASURE_REPORT = 39,
 553         MFIE_TYPE_QUIET = 40,
 554         MFIE_TYPE_IBSS_DFS = 41,
 555         MFIE_TYPE_ERP_INFO = 42,
 556         MFIE_TYPE_RSN = 48,
 557         MFIE_TYPE_RATES_EX = 50,
 558         MFIE_TYPE_GENERIC = 221,
 559 };
 560
 561 struct ieee80211_info_element_hdr {
 562         u8 id;
 563         u8 len;
 564 } __attribute__ ((packed));
 565
 566 struct ieee80211_info_element {
 567         u8 id;
 568         u8 len;
 569         u8 data[0];
 570 } __attribute__ ((packed));
 571
 572 /*
 573  * These are the data types that can make up management packets
 574  *
 575         u16 auth_algorithm;
 576         u16 auth_sequence;
 577         u16 beacon_interval;
 578         u16 capability;
 579         u8 current_ap[ETH_ALEN];
 580         u16 listen_interval;
 581         struct {
 582                 u16 association_id:14, reserved:2;
 583         } __attribute__ ((packed));
 584         u32 time_stamp[2];
 585         u16 reason;
 586         u16 status;
 587 */
 588
 589 struct ieee80211_authentication {
 590         struct ieee80211_hdr_3addr header;
 591         __le16 algorithm;
 592         __le16 transaction;
 593         __le16 status;
 594         struct ieee80211_info_element info_element;
 595 } __attribute__ ((packed));
 596
 597
 598 struct ieee80211_probe_response {
 599         struct ieee80211_hdr_3addr header;
 600         u32 time_stamp[2];
 601         __le16 beacon_interval;
 602         __le16 capability;
 603         struct ieee80211_info_element info_element;
 604 } __attribute__ ((packed));
 605
 606 struct ieee80211_assoc_request_frame {
 607         __le16 capability;
 608         __le16 listen_interval;
 609         u8 current_ap[ETH_ALEN];
 610         struct ieee80211_info_element info_element;
 611 } __attribute__ ((packed));
 612
 613 struct ieee80211_assoc_response_frame {
 614         struct ieee80211_hdr_3addr header;
 615         __le16 capability;
 616         __le16 status;
 617         __le16 aid;
 618         struct ieee80211_info_element info_element; /* supported rates */
 619 } __attribute__ ((packed));
 620
 621
 622 struct ieee80211_txb {
 623         u8 nr_frags;
 624         u8 encrypted;
 625         u16 reserved;
 626         u16 frag_size;
 627         u16 payload_size;
 628         struct sk_buff *fragments[0];
 629 };
 630
 631
 632 /* SWEEP TABLE ENTRIES NUMBER */
 633 #define MAX_SWEEP_TAB_ENTRIES             42
 634 #define MAX_SWEEP_TAB_ENTRIES_PER_PACKET  7
 635 /* MAX_RATES_LENGTH needs to be 12.  The spec says 8, and many APs
 636  * only use 8, and then use extended rates for the remaining supported
 637  * rates.  Other APs, however, stick all of their supported rates on the
 638  * main rates information element... */
 639 #define MAX_RATES_LENGTH                  ((u8)12)
 640 #define MAX_RATES_EX_LENGTH               ((u8)16)
 641 #define MAX_NETWORK_COUNT                  128
 642
 643 #define CRC_LENGTH                 4U
 644
 645 #define MAX_WPA_IE_LEN 64
 646
 647 #define NETWORK_EMPTY_ESSID (1<<0)
 648 #define NETWORK_HAS_OFDM    (1<<1)
 649 #define NETWORK_HAS_CCK     (1<<2)
 650
 651 struct ieee80211_network {
 652         /* These entries are used to identify a unique network */
 653         u8 bssid[ETH_ALEN];
 654         u8 channel;
 655         /* Ensure null-terminated for any debug msgs */
 656         u8 ssid[IW_ESSID_MAX_SIZE + 1];
 657         u8 ssid_len;
 658
 659         /* These are network statistics */
 660         struct ieee80211_rx_stats stats;
 661         u16 capability;
 662         u8 rates[MAX_RATES_LENGTH];
 663         u8 rates_len;
 664         u8 rates_ex[MAX_RATES_EX_LENGTH];
 665         u8 rates_ex_len;
 666         unsigned long last_scanned;
 667         u8 mode;
 668         u8 flags;
 669         u32 last_associate;
 670         u32 time_stamp[2];
 671         u16 beacon_interval;
 672         u16 listen_interval;
 673         u16 atim_window;
 674         u8 wpa_ie[MAX_WPA_IE_LEN];
 675         size_t wpa_ie_len;
 676         u8 rsn_ie[MAX_WPA_IE_LEN];
 677         size_t rsn_ie_len;
 678         struct list_head list;
 679 };
 680
 681 enum ieee80211_state {
 682         IEEE80211_UNINITIALIZED = 0,
 683         IEEE80211_INITIALIZED,
 684         IEEE80211_ASSOCIATING,
 685         IEEE80211_ASSOCIATED,
 686         IEEE80211_AUTHENTICATING,
 687         IEEE80211_AUTHENTICATED,
 688         IEEE80211_SHUTDOWN
 689 };
 690
 691 #define DEFAULT_MAX_SCAN_AGE (15 * HZ)
 692 #define DEFAULT_FTS 2346
 693
 694
 695 #define CFG_IEEE80211_RESERVE_FCS (1<<0)
 696 #define CFG_IEEE80211_COMPUTE_FCS (1<<1)
 697
 698 struct ieee80211_device {
 699         struct net_device *dev;
 700
 701         /* Bookkeeping structures */
 702         struct net_device_stats stats;
 703         struct ieee80211_stats ieee_stats;
 704
 705         /* Probe / Beacon management */
 706         struct list_head network_free_list;
 707         struct list_head network_list;
 708         struct ieee80211_network *networks;
 709         int scans;
 710         int scan_age;
 711
 712         int iw_mode; /* operating mode (IW_MODE_*) */
 713
 714         spinlock_t lock;
 715
 716         int tx_headroom; /* Set to size of any additional room needed at front
 717                           * of allocated Tx SKBs */
 718         u32 config;
 719
 720         /* WEP and other encryption related settings at the device level */
 721         int open_wep; /* Set to 1 to allow unencrypted frames */
 722
 723         int reset_on_keychange; /* Set to 1 if the HW needs to be reset on
 724                                  * WEP key changes */
 725
 726         /* If the host performs {en,de}cryption, then set to 1 */
 727         int host_encrypt;
 728         int host_decrypt;
 729         int ieee802_1x; /* is IEEE 802.1X used */
 730
 731         /* WPA data */
 732         int wpa_enabled;
 733         int drop_unencrypted;
 734         int tkip_countermeasures;
 735         int privacy_invoked;
 736         size_t wpa_ie_len;
 737         u8 *wpa_ie;
 738
 739         struct list_head crypt_deinit_list;
 740         struct ieee80211_crypt_data *crypt[WEP_KEYS];
 741         int tx_keyidx; /* default TX key index (crypt[tx_keyidx]) */
 742         struct timer_list crypt_deinit_timer;
 743
 744         int bcrx_sta_key; /* use individual keys to override default keys even
 745                            * with RX of broad/multicast frames */
 746
 747         /* Fragmentation structures */
 748         struct ieee80211_frag_entry frag_cache[IEEE80211_FRAG_CACHE_LEN];
 749         unsigned int frag_next_idx;
 750         u16 fts; /* Fragmentation Threshold */
 751
 752         /* Association info */
 753         u8 bssid[ETH_ALEN];
 754
 755         enum ieee80211_state state;
 756
 757         int mode;       /* A, B, G */
 758         int modulation; /* CCK, OFDM */
 759         int freq_band;  /* 2.4Ghz, 5.2Ghz, Mixed */
 760         int abg_ture;   /* ABG flag              */
 761
 762         /* Callback functions */
 763         void (*set_security)(struct net_device *dev,
 764                              struct ieee80211_security *sec);
 765         int (*hard_start_xmit)(struct ieee80211_txb *txb,
 766                                struct net_device *dev);
 767         int (*reset_port)(struct net_device *dev);
 768
 769         /* This must be the last item so that it points to the data
 770          * allocated beyond this structure by alloc_ieee80211 */
 771         u8 priv[0];
 772 };
 773
 774 #define IEEE_A            (1<<0)
 775 #define IEEE_B            (1<<1)
 776 #define IEEE_G            (1<<2)
 777 #define IEEE_MODE_MASK    (IEEE_A|IEEE_B|IEEE_G)
 778
 779 extern inline void *ieee80211_priv(struct net_device *dev)
 780 {
 781         return ((struct ieee80211_device *)netdev_priv(dev))->priv;
 782 }
 783
 784 extern inline int ieee80211_is_empty_essid(const char *essid, int essid_len)
 785 {
 786         /* Single white space is for Linksys APs */
 787         if (essid_len == 1 && essid[0] == ' ')
 788                 return 1;
 789
 790         /* Otherwise, if the entire essid is 0, we assume it is hidden */
 791         while (essid_len) {
 792                 essid_len--;
 793                 if (essid[essid_len] != '\0')
 794                         return 0;
 795         }
 796
 797         return 1;
 798 }
 799
 800 extern inline int ieee80211_is_valid_mode(struct ieee80211_device *ieee, int mode)
 801 {
 802         /*
 803          * It is possible for both access points and our device to support
 804          * combinations of modes, so as long as there is one valid combination
 805          * of ap/device supported modes, then return success
 806          *
 807          */
 808         if ((mode & IEEE_A) &&
 809             (ieee->modulation & IEEE80211_OFDM_MODULATION) &&
 810             (ieee->freq_band & IEEE80211_52GHZ_BAND))
 811                 return 1;
 812
 813         if ((mode & IEEE_G) &&
 814             (ieee->modulation & IEEE80211_OFDM_MODULATION) &&
 815             (ieee->freq_band & IEEE80211_24GHZ_BAND))
 816                 return 1;
 817
 818         if ((mode & IEEE_B) &&
 819             (ieee->modulation & IEEE80211_CCK_MODULATION) &&
 820             (ieee->freq_band & IEEE80211_24GHZ_BAND))
 821                 return 1;
 822
 823         return 0;
 824 }
 825
 826 extern inline int ieee80211_get_hdrlen(u16 fc)
 827 {
 828         int hdrlen = IEEE80211_3ADDR_LEN;
 829
 830         switch (WLAN_FC_GET_TYPE(fc)) {
 831         case IEEE80211_FTYPE_DATA:
 832                 if ((fc & IEEE80211_FCTL_FROMDS) && (fc & IEEE80211_FCTL_TODS))
 833                         hdrlen = IEEE80211_4ADDR_LEN;
 834                 break;
 835         case IEEE80211_FTYPE_CTL:
 836                 switch (WLAN_FC_GET_STYPE(fc)) {
 837                 case IEEE80211_STYPE_CTS:
 838                 case IEEE80211_STYPE_ACK:
 839                         hdrlen = IEEE80211_1ADDR_LEN;
 840                         break;
 841                 default:
 842                         hdrlen = IEEE80211_2ADDR_LEN;
 843                         break;
 844                 }
 845                 break;
 846         }
 847
 848         return hdrlen;
 849 }
 850
 851
 852
 853 /* ieee80211.c */
 854 extern void free_ieee80211(struct net_device *dev);
 855 extern struct net_device *alloc_ieee80211(int sizeof_priv);
 856
 857 extern int ieee80211_set_encryption(struct ieee80211_device *ieee);
 858
 859 /* ieee80211_tx.c */
 860 extern int ieee80211_xmit(struct sk_buff *skb,
 861                           struct net_device *dev);
 862 extern void ieee80211_txb_free(struct ieee80211_txb *);
 863
 864
 865 /* ieee80211_rx.c */
 866 extern int ieee80211_rx(struct ieee80211_device *ieee, struct sk_buff *skb,
 867                         struct ieee80211_rx_stats *rx_stats);
 868 extern void ieee80211_rx_mgt(struct ieee80211_device *ieee,
 869                              struct ieee80211_hdr *header,
 870                              struct ieee80211_rx_stats *stats);
 871
 872 /* ieee80211_wx.c */
 873 extern int ieee80211_wx_get_scan(struct ieee80211_device *ieee,
 874                                  struct iw_request_info *info,
 875                                  union iwreq_data *wrqu, char *key);
 876 extern int ieee80211_wx_set_encode(struct ieee80211_device *ieee,
 877                                    struct iw_request_info *info,
 878                                    union iwreq_data *wrqu, char *key);
 879 extern int ieee80211_wx_get_encode(struct ieee80211_device *ieee,
 880                                    struct iw_request_info *info,
 881                                    union iwreq_data *wrqu, char *key);
 882
 883
 884 extern inline void ieee80211_increment_scans(struct ieee80211_device *ieee)
 885 {
 886         ieee->scans++;
 887 }
 888
 889 extern inline int ieee80211_get_scans(struct ieee80211_device *ieee)
 890 {
 891         return ieee->scans;
 892 }
 893
 894
 895 #endif /* IEEE80211_H */