net/mac80211/ieee80211_i.h

   1 /*
   2  * Copyright 2002-2005, Instant802 Networks, Inc.
   3  * Copyright 2005, Devicescape Software, Inc.
   4  * Copyright 2006-2007  Jiri Benc <jbenc@suse.cz>
   5  * Copyright 2007-2008  Johannes Berg <johannes@sipsolutions.net>
   6  *
   7  * This program is free software; you can redistribute it and/or modify
   8  * it under the terms of the GNU General Public License version 2 as
   9  * published by the Free Software Foundation.
  10  */
  11
  12 #ifndef IEEE80211_I_H
  13 #define IEEE80211_I_H
  14
  15 #include <linux/kernel.h>
  16 #include <linux/device.h>
  17 #include <linux/if_ether.h>
  18 #include <linux/interrupt.h>
  19 #include <linux/list.h>
  20 #include <linux/netdevice.h>
  21 #include <linux/skbuff.h>
  22 #include <linux/workqueue.h>
  23 #include <linux/types.h>
  24 #include <linux/spinlock.h>
  25 #include <linux/etherdevice.h>
  26 #include <net/ieee80211_radiotap.h>
  27 #include <net/cfg80211.h>
  28 #include <net/mac80211.h>
  29 #include "key.h"
  30 #include "sta_info.h"
  31
  32 struct ieee80211_local;
  33
  34 /* Maximum number of broadcast/multicast frames to buffer when some of the
  35  * associated stations are using power saving. */
  36 #define AP_MAX_BC_BUFFER 128
  37
  38 /* Maximum number of frames buffered to all STAs, including multicast frames.
  39  * Note: increasing this limit increases the potential memory requirement. Each
  40  * frame can be up to about 2 kB long. */
  41 #define TOTAL_MAX_TX_BUFFER 512
  42
  43 /* Required encryption head and tailroom */
  44 #define IEEE80211_ENCRYPT_HEADROOM 8
  45 #define IEEE80211_ENCRYPT_TAILROOM 18
  46
  47 /* IEEE 802.11 (Ch. 9.5 Defragmentation) requires support for concurrent
  48  * reception of at least three fragmented frames. This limit can be increased
  49  * by changing this define, at the cost of slower frame reassembly and
  50  * increased memory use (about 2 kB of RAM per entry). */
  51 #define IEEE80211_FRAGMENT_MAX 4
  52
  53 /*
  54  * Time after which we ignore scan results and no longer report/use
  55  * them in any way.
  56  */
  57 #define IEEE80211_SCAN_RESULT_EXPIRE (10 * HZ)
  58
  59 #define TU_TO_EXP_TIME(x)       (jiffies + usecs_to_jiffies((x) * 1024))
  60
  61 struct ieee80211_fragment_entry {
  62         unsigned long first_frag_time;
  63         unsigned int seq;
  64         unsigned int rx_queue;
  65         unsigned int last_frag;
  66         unsigned int extra_len;
  67         struct sk_buff_head skb_list;
  68         int ccmp; /* Whether fragments were encrypted with CCMP */
  69         u8 last_pn[6]; /* PN of the last fragment if CCMP was used */
  70 };
  71
  72
  73 struct ieee80211_bss {
  74         /* Yes, this is a hack */
  75         struct cfg80211_bss cbss;
  76
  77         /* don't want to look up all the time */
  78         size_t ssid_len;
  79         u8 ssid[IEEE80211_MAX_SSID_LEN];
  80
  81         u8 dtim_period;
  82
  83         bool wmm_used;
  84
  85         unsigned long last_probe_resp;
  86
  87 #ifdef CONFIG_MAC80211_MESH
  88         u8 *mesh_id;
  89         size_t mesh_id_len;
  90         u8 *mesh_cfg;
  91 #endif
  92
  93 #define IEEE80211_MAX_SUPP_RATES 32
  94         u8 supp_rates[IEEE80211_MAX_SUPP_RATES];
  95         size_t supp_rates_len;
  96
  97         /*
  98          * During assocation, we save an ERP value from a probe response so
  99          * that we can feed ERP info to the driver when handling the
 100          * association completes. these fields probably won't be up-to-date
 101          * otherwise, you probably don't want to use them.
 102          */
 103         bool has_erp_value;
 104         u8 erp_value;
 105 };
 106
 107 static inline u8 *bss_mesh_cfg(struct ieee80211_bss *bss)
 108 {
 109 #ifdef CONFIG_MAC80211_MESH
 110         return bss->mesh_cfg;
 111 #endif
 112         return NULL;
 113 }
 114
 115 static inline u8 *bss_mesh_id(struct ieee80211_bss *bss)
 116 {
 117 #ifdef CONFIG_MAC80211_MESH
 118         return bss->mesh_id;
 119 #endif
 120         return NULL;
 121 }
 122
 123 static inline u8 bss_mesh_id_len(struct ieee80211_bss *bss)
 124 {
 125 #ifdef CONFIG_MAC80211_MESH
 126         return bss->mesh_id_len;
 127 #endif
 128         return 0;
 129 }
 130
 131
 132 typedef unsigned __bitwise__ ieee80211_tx_result;
 133 #define TX_CONTINUE     ((__force ieee80211_tx_result) 0u)
 134 #define TX_DROP         ((__force ieee80211_tx_result) 1u)
 135 #define TX_QUEUED       ((__force ieee80211_tx_result) 2u)
 136
 137 #define IEEE80211_TX_FRAGMENTED         BIT(0)
 138 #define IEEE80211_TX_UNICAST            BIT(1)
 139 #define IEEE80211_TX_PS_BUFFERED        BIT(2)
 140
 141 struct ieee80211_tx_data {
 142         struct sk_buff *skb;
 143         struct ieee80211_local *local;
 144         struct ieee80211_sub_if_data *sdata;
 145         struct sta_info *sta;
 146         struct ieee80211_key *key;
 147
 148         struct ieee80211_channel *channel;
 149
 150         u16 ethertype;
 151         unsigned int flags;
 152 };
 153
 154
 155 typedef unsigned __bitwise__ ieee80211_rx_result;
 156 #define RX_CONTINUE             ((__force ieee80211_rx_result) 0u)
 157 #define RX_DROP_UNUSABLE        ((__force ieee80211_rx_result) 1u)
 158 #define RX_DROP_MONITOR         ((__force ieee80211_rx_result) 2u)
 159 #define RX_QUEUED               ((__force ieee80211_rx_result) 3u)
 160
 161 #define IEEE80211_RX_IN_SCAN            BIT(0)
 162 /* frame is destined to interface currently processed (incl. multicast frames) */
 163 #define IEEE80211_RX_RA_MATCH           BIT(1)
 164 #define IEEE80211_RX_AMSDU              BIT(2)
 165 #define IEEE80211_RX_FRAGMENTED         BIT(3)
 166 /* only add flags here that do not change with subframes of an aMPDU */
 167
 168 struct ieee80211_rx_data {
 169         struct sk_buff *skb;
 170         struct ieee80211_local *local;
 171         struct ieee80211_sub_if_data *sdata;
 172         struct sta_info *sta;
 173         struct ieee80211_key *key;
 174
 175         unsigned int flags;
 176         int queue;
 177         u32 tkip_iv32;
 178         u16 tkip_iv16;
 179 };
 180
 181 struct beacon_data {
 182         u8 *head, *tail;
 183         int head_len, tail_len;
 184         int dtim_period;
 185 };
 186
 187 struct ieee80211_if_ap {
 188         struct beacon_data *beacon;
 189
 190         struct list_head vlans;
 191
 192         /* yes, this looks ugly, but guarantees that we can later use
 193          * bitmap_empty :)
 194          * NB: don't touch this bitmap, use sta_info_{set,clear}_tim_bit */
 195         u8 tim[sizeof(unsigned long) * BITS_TO_LONGS(IEEE80211_MAX_AID + 1)];
 196         struct sk_buff_head ps_bc_buf;
 197         atomic_t num_sta_ps; /* number of stations in PS mode */
 198         int dtim_count;
 199 };
 200
 201 struct ieee80211_if_wds {
 202         struct sta_info *sta;
 203         u8 remote_addr[ETH_ALEN];
 204 };
 205
 206 struct ieee80211_if_vlan {
 207         struct list_head list;
 208
 209         /* used for all tx if the VLAN is configured to 4-addr mode */
 210         struct sta_info *sta;
 211 };
 212
 213 struct mesh_stats {
 214         __u32 fwded_mcast;              /* Mesh forwarded multicast frames */
 215         __u32 fwded_unicast;            /* Mesh forwarded unicast frames */
 216         __u32 fwded_frames;             /* Mesh total forwarded frames */
 217         __u32 dropped_frames_ttl;       /* Not transmitted since mesh_ttl == 0*/
 218         __u32 dropped_frames_no_route;  /* Not transmitted, no route found */
 219         atomic_t estab_plinks;
 220 };
 221
 222 #define PREQ_Q_F_START          0x1
 223 #define PREQ_Q_F_REFRESH        0x2
 224 struct mesh_preq_queue {
 225         struct list_head list;
 226         u8 dst[ETH_ALEN];
 227         u8 flags;
 228 };
 229
 230 enum ieee80211_mgd_state {
 231         IEEE80211_MGD_STATE_IDLE,
 232         IEEE80211_MGD_STATE_PROBE,
 233         IEEE80211_MGD_STATE_AUTH,
 234         IEEE80211_MGD_STATE_ASSOC,
 235 };
 236
 237 struct ieee80211_mgd_work {
 238         struct list_head list;
 239         struct ieee80211_bss *bss;
 240         int ie_len;
 241         u8 prev_bssid[ETH_ALEN];
 242         u8 ssid[IEEE80211_MAX_SSID_LEN];
 243         u8 ssid_len;
 244         unsigned long timeout;
 245         enum ieee80211_mgd_state state;
 246         u16 auth_alg, auth_transaction;
 247
 248         int tries;
 249
 250         u8 key[WLAN_KEY_LEN_WEP104];
 251         u8 key_len, key_idx;
 252
 253         /* must be last */
 254         u8 ie[0]; /* for auth or assoc frame, not probe */
 255 };
 256
 257 /* flags used in struct ieee80211_if_managed.flags */
 258 enum ieee80211_sta_flags {
 259         IEEE80211_STA_BEACON_POLL       = BIT(0),
 260         IEEE80211_STA_CONNECTION_POLL   = BIT(1),
 261         IEEE80211_STA_CONTROL_PORT      = BIT(2),
 262         IEEE80211_STA_WMM_ENABLED       = BIT(3),
 263         IEEE80211_STA_DISABLE_11N       = BIT(4),
 264         IEEE80211_STA_CSA_RECEIVED      = BIT(5),
 265         IEEE80211_STA_MFP_ENABLED       = BIT(6),
 266 };
 267
 268 /* flags for MLME request */
 269 enum ieee80211_sta_request {
 270         IEEE80211_STA_REQ_SCAN,
 271 };
 272
 273 struct ieee80211_if_managed {
 274         struct timer_list timer;
 275         struct timer_list conn_mon_timer;
 276         struct timer_list bcn_mon_timer;
 277         struct timer_list chswitch_timer;
 278         struct work_struct work;
 279         struct work_struct monitor_work;
 280         struct work_struct chswitch_work;
 281         struct work_struct beacon_loss_work;
 282
 283         unsigned long probe_timeout;
 284         int probe_send_count;
 285
 286         struct mutex mtx;
 287         struct ieee80211_bss *associated;
 288         struct ieee80211_mgd_work *old_associate_work;
 289         struct list_head work_list;
 290
 291         u8 bssid[ETH_ALEN];
 292
 293         u16 aid;
 294         u16 capab;
 295
 296         struct sk_buff_head skb_queue;
 297
 298         unsigned long timers_running; /* used for quiesce/restart */
 299         bool powersave; /* powersave requested for this iface */
 300         enum ieee80211_smps_mode req_smps, /* requested smps mode */
 301                                  ap_smps; /* smps mode AP thinks we're in */
 302
 303         unsigned long request;
 304
 305         unsigned int flags;
 306
 307         u32 beacon_crc;
 308
 309         enum {
 310                 IEEE80211_MFP_DISABLED,
 311                 IEEE80211_MFP_OPTIONAL,
 312                 IEEE80211_MFP_REQUIRED
 313         } mfp; /* management frame protection */
 314
 315         int wmm_last_param_set;
 316
 317         u8 use_4addr;
 318 };
 319
 320 enum ieee80211_ibss_request {
 321         IEEE80211_IBSS_REQ_RUN  = 0,
 322 };
 323
 324 struct ieee80211_if_ibss {
 325         struct timer_list timer;
 326         struct work_struct work;
 327
 328         struct sk_buff_head skb_queue;
 329
 330         unsigned long request;
 331         unsigned long last_scan_completed;
 332
 333         bool timer_running;
 334
 335         bool fixed_bssid;
 336         bool fixed_channel;
 337         bool privacy;
 338
 339         u8 bssid[ETH_ALEN];
 340         u8 ssid[IEEE80211_MAX_SSID_LEN];
 341         u8 ssid_len, ie_len;
 342         u8 *ie;
 343         struct ieee80211_channel *channel;
 344
 345         unsigned long ibss_join_req;
 346         /* probe response/beacon for IBSS */
 347         struct sk_buff *presp, *skb;
 348
 349         enum {
 350                 IEEE80211_IBSS_MLME_SEARCH,
 351                 IEEE80211_IBSS_MLME_JOINED,
 352         } state;
 353 };
 354
 355 struct ieee80211_if_mesh {
 356         struct work_struct work;
 357         struct timer_list housekeeping_timer;
 358         struct timer_list mesh_path_timer;
 359         struct timer_list mesh_path_root_timer;
 360         struct sk_buff_head skb_queue;
 361
 362         unsigned long timers_running;
 363
 364         unsigned long wrkq_flags;
 365
 366         u8 mesh_id[IEEE80211_MAX_MESH_ID_LEN];
 367         size_t mesh_id_len;
 368         /* Active Path Selection Protocol Identifier */
 369         u8 mesh_pp_id;
 370         /* Active Path Selection Metric Identifier */
 371         u8 mesh_pm_id;
 372         /* Congestion Control Mode Identifier */
 373         u8 mesh_cc_id;
 374         /* Synchronization Protocol Identifier */
 375         u8 mesh_sp_id;
 376         /* Authentication Protocol Identifier */
 377         u8 mesh_auth_id;
 378         /* Local mesh Sequence Number */
 379         u32 sn;
 380         /* Last used PREQ ID */
 381         u32 preq_id;
 382         atomic_t mpaths;
 383         /* Timestamp of last SN update */
 384         unsigned long last_sn_update;
 385         /* Timestamp of last SN sent */
 386         unsigned long last_preq;
 387         struct mesh_rmc *rmc;
 388         spinlock_t mesh_preq_queue_lock;
 389         struct mesh_preq_queue preq_queue;
 390         int preq_queue_len;
 391         struct mesh_stats mshstats;
 392         struct mesh_config mshcfg;
 393         u32 mesh_seqnum;
 394         bool accepting_plinks;
 395 };
 396
 397 #ifdef CONFIG_MAC80211_MESH
 398 #define IEEE80211_IFSTA_MESH_CTR_INC(msh, name) \
 399         do { (msh)->mshstats.name++; } while (0)
 400 #else
 401 #define IEEE80211_IFSTA_MESH_CTR_INC(msh, name) \
 402         do { } while (0)
 403 #endif
 404
 405 /**
 406  * enum ieee80211_sub_if_data_flags - virtual interface flags
 407  *
 408  * @IEEE80211_SDATA_ALLMULTI: interface wants all multicast packets
 409  * @IEEE80211_SDATA_PROMISC: interface is promisc
 410  * @IEEE80211_SDATA_OPERATING_GMODE: operating in G-only mode
 411  * @IEEE80211_SDATA_DONT_BRIDGE_PACKETS: bridge packets between
 412  *      associated stations and deliver multicast frames both
 413  *      back to wireless media and to the local net stack.
 414  */
 415 enum ieee80211_sub_if_data_flags {
 416         IEEE80211_SDATA_ALLMULTI                = BIT(0),
 417         IEEE80211_SDATA_PROMISC                 = BIT(1),
 418         IEEE80211_SDATA_OPERATING_GMODE         = BIT(2),
 419         IEEE80211_SDATA_DONT_BRIDGE_PACKETS     = BIT(3),
 420 };
 421
 422 struct ieee80211_sub_if_data {
 423         struct list_head list;
 424
 425         struct wireless_dev wdev;
 426
 427         /* keys */
 428         struct list_head key_list;
 429
 430         struct net_device *dev;
 431         struct ieee80211_local *local;
 432
 433         unsigned int flags;
 434
 435         int drop_unencrypted;
 436
 437         char name[IFNAMSIZ];
 438
 439         /*
 440          * keep track of whether the HT opmode (stored in
 441          * vif.bss_info.ht_operation_mode) is valid.
 442          */
 443         bool ht_opmode_valid;
 444
 445         /* Fragment table for host-based reassembly */
 446         struct ieee80211_fragment_entry fragments[IEEE80211_FRAGMENT_MAX];
 447         unsigned int fragment_next;
 448
 449 #define NUM_DEFAULT_KEYS 4
 450 #define NUM_DEFAULT_MGMT_KEYS 2
 451         struct ieee80211_key *keys[NUM_DEFAULT_KEYS + NUM_DEFAULT_MGMT_KEYS];
 452         struct ieee80211_key *default_key;
 453         struct ieee80211_key *default_mgmt_key;
 454
 455         u16 sequence_number;
 456
 457         /*
 458          * AP this belongs to: self in AP mode and
 459          * corresponding AP in VLAN mode, NULL for
 460          * all others (might be needed later in IBSS)
 461          */
 462         struct ieee80211_if_ap *bss;
 463
 464         int force_unicast_rateidx; /* forced TX rateidx for unicast frames */
 465         int max_ratectrl_rateidx; /* max TX rateidx for rate control */
 466
 467         union {
 468                 struct ieee80211_if_ap ap;
 469                 struct ieee80211_if_wds wds;
 470                 struct ieee80211_if_vlan vlan;
 471                 struct ieee80211_if_managed mgd;
 472                 struct ieee80211_if_ibss ibss;
 473 #ifdef CONFIG_MAC80211_MESH
 474                 struct ieee80211_if_mesh mesh;
 475 #endif
 476                 u32 mntr_flags;
 477         } u;
 478
 479 #ifdef CONFIG_MAC80211_DEBUGFS
 480         struct {
 481                 struct dentry *dir;
 482                 struct dentry *default_key;
 483                 struct dentry *default_mgmt_key;
 484         } debugfs;
 485 #endif
 486         /* must be last, dynamically sized area in this! */
 487         struct ieee80211_vif vif;
 488 };
 489
 490 static inline
 491 struct ieee80211_sub_if_data *vif_to_sdata(struct ieee80211_vif *p)
 492 {
 493         return container_of(p, struct ieee80211_sub_if_data, vif);
 494 }
 495
 496 static inline void
 497 ieee80211_sdata_set_mesh_id(struct ieee80211_sub_if_data *sdata,
 498                             u8 mesh_id_len, u8 *mesh_id)
 499 {
 500 #ifdef CONFIG_MAC80211_MESH
 501         struct ieee80211_if_mesh *ifmsh = &sdata->u.mesh;
 502         ifmsh->mesh_id_len = mesh_id_len;
 503         memcpy(ifmsh->mesh_id, mesh_id, mesh_id_len);
 504 #else
 505         WARN_ON(1);
 506 #endif
 507 }
 508
 509 enum {
 510         IEEE80211_RX_MSG        = 1,
 511         IEEE80211_TX_STATUS_MSG = 2,
 512         IEEE80211_DELBA_MSG     = 3,
 513         IEEE80211_ADDBA_MSG     = 4,
 514 };
 515
 516 enum queue_stop_reason {
 517         IEEE80211_QUEUE_STOP_REASON_DRIVER,
 518         IEEE80211_QUEUE_STOP_REASON_PS,
 519         IEEE80211_QUEUE_STOP_REASON_CSA,
 520         IEEE80211_QUEUE_STOP_REASON_AGGREGATION,
 521         IEEE80211_QUEUE_STOP_REASON_SUSPEND,
 522         IEEE80211_QUEUE_STOP_REASON_SKB_ADD,
 523 };
 524
 525 /**
 526  * mac80211 scan flags - currently active scan mode
 527  *
 528  * @SCAN_SW_SCANNING: We're currently in the process of scanning but may as
 529  *      well be on the operating channel
 530  * @SCAN_HW_SCANNING: The hardware is scanning for us, we have no way to
 531  *      determine if we are on the operating channel or not
 532  * @SCAN_OFF_CHANNEL: We're off our operating channel for scanning,
 533  *      gets only set in conjunction with SCAN_SW_SCANNING
 534  */
 535 enum {
 536         SCAN_SW_SCANNING,
 537         SCAN_HW_SCANNING,
 538         SCAN_OFF_CHANNEL,
 539 };
 540
 541 /**
 542  * enum mac80211_scan_state - scan state machine states
 543  *
 544  * @SCAN_DECISION: Main entry point to the scan state machine, this state
 545  *      determines if we should keep on scanning or switch back to the
 546  *      operating channel
 547  * @SCAN_SET_CHANNEL: Set the next channel to be scanned
 548  * @SCAN_SEND_PROBE: Send probe requests and wait for probe responses
 549  * @SCAN_LEAVE_OPER_CHANNEL: Leave the operating channel, notify the AP
 550  *      about us leaving the channel and stop all associated STA interfaces
 551  * @SCAN_ENTER_OPER_CHANNEL: Enter the operating channel again, notify the
 552  *      AP about us being back and restart all associated STA interfaces
 553  */
 554 enum mac80211_scan_state {
 555         SCAN_DECISION,
 556         SCAN_SET_CHANNEL,
 557         SCAN_SEND_PROBE,
 558         SCAN_LEAVE_OPER_CHANNEL,
 559         SCAN_ENTER_OPER_CHANNEL,
 560 };
 561
 562 struct ieee80211_local {
 563         /* embed the driver visible part.
 564          * don't cast (use the static inlines below), but we keep
 565          * it first anyway so they become a no-op */
 566         struct ieee80211_hw hw;
 567
 568         const struct ieee80211_ops *ops;
 569
 570         /*
 571          * private workqueue to mac80211. mac80211 makes this accessible
 572          * via ieee80211_queue_work()
 573          */
 574         struct workqueue_struct *workqueue;
 575
 576         unsigned long queue_stop_reasons[IEEE80211_MAX_QUEUES];
 577         /* also used to protect ampdu_ac_queue and amdpu_ac_stop_refcnt */
 578         spinlock_t queue_stop_reason_lock;
 579
 580         int open_count;
 581         int monitors, cooked_mntrs;
 582         /* number of interfaces with corresponding FIF_ flags */
 583         int fif_fcsfail, fif_plcpfail, fif_control, fif_other_bss, fif_pspoll;
 584         unsigned int filter_flags; /* FIF_* */
 585
 586         /* protects the aggregated multicast list and filter calls */
 587         spinlock_t filter_lock;
 588
 589         /* used for uploading changed mc list */
 590         struct work_struct reconfig_filter;
 591
 592         /* used to reconfigure hardware SM PS */
 593         struct work_struct recalc_smps;
 594
 595         /* aggregated multicast list */
 596         struct dev_addr_list *mc_list;
 597         int mc_count;
 598
 599         bool tim_in_locked_section; /* see ieee80211_beacon_get() */
 600
 601         /*
 602          * suspended is true if we finished all the suspend _and_ we have
 603          * not yet come up from resume. This is to be used by mac80211
 604          * to ensure driver sanity during suspend and mac80211's own
 605          * sanity. It can eventually be used for WoW as well.
 606          */
 607         bool suspended;
 608
 609         /*
 610          * Resuming is true while suspended, but when we're reprogramming the
 611          * hardware -- at that time it's allowed to use ieee80211_queue_work()
 612          * again even though some other parts of the stack are still suspended
 613          * and we still drop received frames to avoid waking the stack.
 614          */
 615         bool resuming;
 616
 617         /*
 618          * quiescing is true during the suspend process _only_ to
 619          * ease timer cancelling etc.
 620          */
 621         bool quiescing;
 622
 623         /* device is started */
 624         bool started;
 625
 626         int tx_headroom; /* required headroom for hardware/radiotap */
 627
 628         /* Tasklet and skb queue to process calls from IRQ mode. All frames
 629          * added to skb_queue will be processed, but frames in
 630          * skb_queue_unreliable may be dropped if the total length of these
 631          * queues increases over the limit. */
 632 #define IEEE80211_IRQSAFE_QUEUE_LIMIT 128
 633         struct tasklet_struct tasklet;
 634         struct sk_buff_head skb_queue;
 635         struct sk_buff_head skb_queue_unreliable;
 636
 637         /* Station data */
 638         /*
 639          * The lock only protects the list, hash, timer and counter
 640          * against manipulation, reads are done in RCU. Additionally,
 641          * the lock protects each BSS's TIM bitmap.
 642          */
 643         spinlock_t sta_lock;
 644         unsigned long num_sta;
 645         struct list_head sta_list;
 646         struct sta_info *sta_hash[STA_HASH_SIZE];
 647         struct timer_list sta_cleanup;
 648         int sta_generation;
 649
 650         struct sk_buff_head pending[IEEE80211_MAX_QUEUES];
 651         struct tasklet_struct tx_pending_tasklet;
 652
 653         /*
 654          * This lock is used to prevent concurrent A-MPDU
 655          * session start/stop processing, this thus also
 656          * synchronises the ->ampdu_action() callback to
 657          * drivers and limits it to one at a time.
 658          */
 659         spinlock_t ampdu_lock;
 660
 661         /* number of interfaces with corresponding IFF_ flags */
 662         atomic_t iff_allmultis, iff_promiscs;
 663
 664         struct rate_control_ref *rate_ctrl;
 665
 666         struct crypto_blkcipher *wep_tx_tfm;
 667         struct crypto_blkcipher *wep_rx_tfm;
 668         u32 wep_iv;
 669
 670         /* see iface.c */
 671         struct list_head interfaces;
 672         struct mutex iflist_mtx;
 673
 674         /*
 675          * Key lock, protects sdata's key_list and sta_info's
 676          * key pointers (write access, they're RCU.)
 677          */
 678         spinlock_t key_lock;
 679
 680
 681         /* Scanning and BSS list */
 682         struct mutex scan_mtx;
 683         unsigned long scanning;
 684         struct cfg80211_ssid scan_ssid;
 685         struct cfg80211_scan_request *int_scan_req;
 686         struct cfg80211_scan_request *scan_req, *hw_scan_req;
 687         struct ieee80211_channel *scan_channel;
 688         enum ieee80211_band hw_scan_band;
 689         int scan_channel_idx;
 690         int scan_ies_len;
 691
 692         enum mac80211_scan_state next_scan_state;
 693         struct delayed_work scan_work;
 694         struct ieee80211_sub_if_data *scan_sdata;
 695         enum nl80211_channel_type oper_channel_type;
 696         struct ieee80211_channel *oper_channel, *csa_channel;
 697
 698         /* SNMP counters */
 699         /* dot11CountersTable */
 700         u32 dot11TransmittedFragmentCount;
 701         u32 dot11MulticastTransmittedFrameCount;
 702         u32 dot11FailedCount;
 703         u32 dot11RetryCount;
 704         u32 dot11MultipleRetryCount;
 705         u32 dot11FrameDuplicateCount;
 706         u32 dot11ReceivedFragmentCount;
 707         u32 dot11MulticastReceivedFrameCount;
 708         u32 dot11TransmittedFrameCount;
 709
 710 #ifdef CONFIG_MAC80211_LEDS
 711         int tx_led_counter, rx_led_counter;
 712         struct led_trigger *tx_led, *rx_led, *assoc_led, *radio_led;
 713         char tx_led_name[32], rx_led_name[32],
 714              assoc_led_name[32], radio_led_name[32];
 715 #endif
 716
 717 #ifdef CONFIG_MAC80211_DEBUGFS
 718         struct work_struct sta_debugfs_add;
 719 #endif
 720
 721 #ifdef CONFIG_MAC80211_DEBUG_COUNTERS
 722         /* TX/RX handler statistics */
 723         unsigned int tx_handlers_drop;
 724         unsigned int tx_handlers_queued;
 725         unsigned int tx_handlers_drop_unencrypted;
 726         unsigned int tx_handlers_drop_fragment;
 727         unsigned int tx_handlers_drop_wep;
 728         unsigned int tx_handlers_drop_not_assoc;
 729         unsigned int tx_handlers_drop_unauth_port;
 730         unsigned int rx_handlers_drop;
 731         unsigned int rx_handlers_queued;
 732         unsigned int rx_handlers_drop_nullfunc;
 733         unsigned int rx_handlers_drop_defrag;
 734         unsigned int rx_handlers_drop_short;
 735         unsigned int rx_handlers_drop_passive_scan;
 736         unsigned int tx_expand_skb_head;
 737         unsigned int tx_expand_skb_head_cloned;
 738         unsigned int rx_expand_skb_head;
 739         unsigned int rx_expand_skb_head2;
 740         unsigned int rx_handlers_fragments;
 741         unsigned int tx_status_drop;
 742 #define I802_DEBUG_INC(c) (c)++
 743 #else /* CONFIG_MAC80211_DEBUG_COUNTERS */
 744 #define I802_DEBUG_INC(c) do { } while (0)
 745 #endif /* CONFIG_MAC80211_DEBUG_COUNTERS */
 746
 747
 748         int total_ps_buffered; /* total number of all buffered unicast and
 749                                 * multicast packets for power saving stations
 750                                 */
 751         int wifi_wme_noack_test;
 752         unsigned int wmm_acm; /* bit field of ACM bits (BIT(802.1D tag)) */
 753
 754         bool pspolling;
 755         /*
 756          * PS can only be enabled when we have exactly one managed
 757          * interface (and monitors) in PS, this then points there.
 758          */
 759         struct ieee80211_sub_if_data *ps_sdata;
 760         struct work_struct dynamic_ps_enable_work;
 761         struct work_struct dynamic_ps_disable_work;
 762         struct timer_list dynamic_ps_timer;
 763         struct notifier_block network_latency_notifier;
 764
 765         int user_power_level; /* in dBm */
 766         int power_constr_level; /* in dBm */
 767
 768         enum ieee80211_smps_mode smps_mode;
 769
 770         struct work_struct restart_work;
 771
 772 #ifdef CONFIG_MAC80211_DEBUGFS
 773         struct local_debugfsdentries {
 774                 struct dentry *rcdir;
 775                 struct dentry *stations;
 776                 struct dentry *keys;
 777         } debugfs;
 778 #endif
 779 };
 780
 781 static inline struct ieee80211_sub_if_data *
 782 IEEE80211_DEV_TO_SUB_IF(struct net_device *dev)
 783 {
 784         return netdev_priv(dev);
 785 }
 786
 787 /* this struct represents 802.11n's RA/TID combination along with our vif */
 788 struct ieee80211_ra_tid {
 789         struct ieee80211_vif *vif;
 790         u8 ra[ETH_ALEN];
 791         u16 tid;
 792 };
 793
 794 /* Parsed Information Elements */
 795 struct ieee802_11_elems {
 796         u8 *ie_start;
 797         size_t total_len;
 798
 799         /* pointers to IEs */
 800         u8 *ssid;
 801         u8 *supp_rates;
 802         u8 *fh_params;
 803         u8 *ds_params;
 804         u8 *cf_params;
 805         struct ieee80211_tim_ie *tim;
 806         u8 *ibss_params;
 807         u8 *challenge;
 808         u8 *wpa;
 809         u8 *rsn;
 810         u8 *erp_info;
 811         u8 *ext_supp_rates;
 812         u8 *wmm_info;
 813         u8 *wmm_param;
 814         struct ieee80211_ht_cap *ht_cap_elem;
 815         struct ieee80211_ht_info *ht_info_elem;
 816         struct ieee80211_meshconf_ie *mesh_config;
 817         u8 *mesh_id;
 818         u8 *peer_link;
 819         u8 *preq;
 820         u8 *prep;
 821         u8 *perr;
 822         struct ieee80211_rann_ie *rann;
 823         u8 *ch_switch_elem;
 824         u8 *country_elem;
 825         u8 *pwr_constr_elem;
 826         u8 *quiet_elem;         /* first quite element */
 827         u8 *timeout_int;
 828
 829         /* length of them, respectively */
 830         u8 ssid_len;
 831         u8 supp_rates_len;
 832         u8 fh_params_len;
 833         u8 ds_params_len;
 834         u8 cf_params_len;
 835         u8 tim_len;
 836         u8 ibss_params_len;
 837         u8 challenge_len;
 838         u8 wpa_len;
 839         u8 rsn_len;
 840         u8 erp_info_len;
 841         u8 ext_supp_rates_len;
 842         u8 wmm_info_len;
 843         u8 wmm_param_len;
 844         u8 mesh_id_len;
 845         u8 peer_link_len;
 846         u8 preq_len;
 847         u8 prep_len;
 848         u8 perr_len;
 849         u8 ch_switch_elem_len;
 850         u8 country_elem_len;
 851         u8 pwr_constr_elem_len;
 852         u8 quiet_elem_len;
 853         u8 num_of_quiet_elem;   /* can be more the one */
 854         u8 timeout_int_len;
 855 };
 856
 857 static inline struct ieee80211_local *hw_to_local(
 858         struct ieee80211_hw *hw)
 859 {
 860         return container_of(hw, struct ieee80211_local, hw);
 861 }
 862
 863 static inline struct ieee80211_hw *local_to_hw(
 864         struct ieee80211_local *local)
 865 {
 866         return &local->hw;
 867 }
 868
 869
 870 static inline int ieee80211_bssid_match(const u8 *raddr, const u8 *addr)
 871 {
 872         return compare_ether_addr(raddr, addr) == 0 ||
 873                is_broadcast_ether_addr(raddr);
 874 }
 875
 876
 877 int ieee80211_hw_config(struct ieee80211_local *local, u32 changed);
 878 void ieee80211_tx_set_protected(struct ieee80211_tx_data *tx);
 879 void ieee80211_bss_info_change_notify(struct ieee80211_sub_if_data *sdata,
 880                                       u32 changed);
 881 void ieee80211_configure_filter(struct ieee80211_local *local);
 882 u32 ieee80211_reset_erp_info(struct ieee80211_sub_if_data *sdata);
 883
 884 /* STA code */
 885 void ieee80211_sta_setup_sdata(struct ieee80211_sub_if_data *sdata);
 886 int ieee80211_mgd_auth(struct ieee80211_sub_if_data *sdata,
 887                        struct cfg80211_auth_request *req);
 888 int ieee80211_mgd_assoc(struct ieee80211_sub_if_data *sdata,
 889                         struct cfg80211_assoc_request *req);
 890 int ieee80211_mgd_deauth(struct ieee80211_sub_if_data *sdata,
 891                          struct cfg80211_deauth_request *req,
 892                          void *cookie);
 893 int ieee80211_mgd_disassoc(struct ieee80211_sub_if_data *sdata,
 894                            struct cfg80211_disassoc_request *req,
 895                            void *cookie);
 896 ieee80211_rx_result ieee80211_sta_rx_mgmt(struct ieee80211_sub_if_data *sdata,
 897                                           struct sk_buff *skb);
 898 void ieee80211_send_pspoll(struct ieee80211_local *local,
 899                            struct ieee80211_sub_if_data *sdata);
 900 void ieee80211_recalc_ps(struct ieee80211_local *local, s32 latency);
 901 int ieee80211_max_network_latency(struct notifier_block *nb,
 902                                   unsigned long data, void *dummy);
 903 void ieee80211_sta_process_chanswitch(struct ieee80211_sub_if_data *sdata,
 904                                       struct ieee80211_channel_sw_ie *sw_elem,
 905                                       struct ieee80211_bss *bss);
 906 void ieee80211_sta_quiesce(struct ieee80211_sub_if_data *sdata);
 907 void ieee80211_sta_restart(struct ieee80211_sub_if_data *sdata);
 908
 909 /* IBSS code */
 910 void ieee80211_ibss_notify_scan_completed(struct ieee80211_local *local);
 911 void ieee80211_ibss_setup_sdata(struct ieee80211_sub_if_data *sdata);
 912 ieee80211_rx_result
 913 ieee80211_ibss_rx_mgmt(struct ieee80211_sub_if_data *sdata, struct sk_buff *skb);
 914 struct sta_info *ieee80211_ibss_add_sta(struct ieee80211_sub_if_data *sdata,
 915                                         u8 *bssid, u8 *addr, u32 supp_rates);
 916 int ieee80211_ibss_join(struct ieee80211_sub_if_data *sdata,
 917                         struct cfg80211_ibss_params *params);
 918 int ieee80211_ibss_leave(struct ieee80211_sub_if_data *sdata);
 919 void ieee80211_ibss_quiesce(struct ieee80211_sub_if_data *sdata);
 920 void ieee80211_ibss_restart(struct ieee80211_sub_if_data *sdata);
 921
 922 /* scan/BSS handling */
 923 void ieee80211_scan_work(struct work_struct *work);
 924 int ieee80211_request_internal_scan(struct ieee80211_sub_if_data *sdata,
 925                                     const u8 *ssid, u8 ssid_len);
 926 int ieee80211_request_scan(struct ieee80211_sub_if_data *sdata,
 927                            struct cfg80211_scan_request *req);
 928 void ieee80211_scan_cancel(struct ieee80211_local *local);
 929 ieee80211_rx_result
 930 ieee80211_scan_rx(struct ieee80211_sub_if_data *sdata, struct sk_buff *skb);
 931
 932 void ieee80211_mlme_notify_scan_completed(struct ieee80211_local *local);
 933 struct ieee80211_bss *
 934 ieee80211_bss_info_update(struct ieee80211_local *local,
 935                           struct ieee80211_rx_status *rx_status,
 936                           struct ieee80211_mgmt *mgmt,
 937                           size_t len,
 938                           struct ieee802_11_elems *elems,
 939                           struct ieee80211_channel *channel,
 940                           bool beacon);
 941 struct ieee80211_bss *
 942 ieee80211_rx_bss_get(struct ieee80211_local *local, u8 *bssid, int freq,
 943                      u8 *ssid, u8 ssid_len);
 944 void ieee80211_rx_bss_put(struct ieee80211_local *local,
 945                           struct ieee80211_bss *bss);
 946
 947 /* interface handling */
 948 int ieee80211_iface_init(void);
 949 void ieee80211_iface_exit(void);
 950 int ieee80211_if_add(struct ieee80211_local *local, const char *name,
 951                      struct net_device **new_dev, enum nl80211_iftype type,
 952                      struct vif_params *params);
 953 int ieee80211_if_change_type(struct ieee80211_sub_if_data *sdata,
 954                              enum nl80211_iftype type);
 955 void ieee80211_if_remove(struct ieee80211_sub_if_data *sdata);
 956 void ieee80211_remove_interfaces(struct ieee80211_local *local);
 957 u32 __ieee80211_recalc_idle(struct ieee80211_local *local);
 958 void ieee80211_recalc_idle(struct ieee80211_local *local);
 959
 960 /* tx handling */
 961 void ieee80211_clear_tx_pending(struct ieee80211_local *local);
 962 void ieee80211_tx_pending(unsigned long data);
 963 netdev_tx_t ieee80211_monitor_start_xmit(struct sk_buff *skb,
 964                                          struct net_device *dev);
 965 netdev_tx_t ieee80211_subif_start_xmit(struct sk_buff *skb,
 966                                        struct net_device *dev);
 967
 968 /*
 969  * radiotap header for status frames
 970  */
 971 struct ieee80211_tx_status_rtap_hdr {
 972         struct ieee80211_radiotap_header hdr;
 973         u8 rate;
 974         u8 padding_for_rate;
 975         __le16 tx_flags;
 976         u8 data_retries;
 977 } __attribute__ ((packed));
 978
 979
 980 /* HT */
 981 void ieee80211_ht_cap_ie_to_sta_ht_cap(struct ieee80211_supported_band *sband,
 982                                        struct ieee80211_ht_cap *ht_cap_ie,
 983                                        struct ieee80211_sta_ht_cap *ht_cap);
 984 void ieee80211_send_bar(struct ieee80211_sub_if_data *sdata, u8 *ra, u16 tid, u16 ssn);
 985 void ieee80211_send_delba(struct ieee80211_sub_if_data *sdata,
 986                           const u8 *da, u16 tid,
 987                           u16 initiator, u16 reason_code);
 988 int ieee80211_send_smps_action(struct ieee80211_sub_if_data *sdata,
 989                                enum ieee80211_smps_mode smps, const u8 *da,
 990                                const u8 *bssid);
 991
 992 void ieee80211_sta_stop_rx_ba_session(struct ieee80211_sub_if_data *sdata, u8 *da,
 993                                 u16 tid, u16 initiator, u16 reason);
 994 void __ieee80211_stop_rx_ba_session(struct sta_info *sta, u16 tid,
 995                                     u16 initiator, u16 reason);
 996 void ieee80211_sta_tear_down_BA_sessions(struct sta_info *sta);
 997 void ieee80211_process_delba(struct ieee80211_sub_if_data *sdata,
 998                              struct sta_info *sta,
 999                              struct ieee80211_mgmt *mgmt, size_t len);
1000 void ieee80211_process_addba_resp(struct ieee80211_local *local,
1001                                   struct sta_info *sta,
1002                                   struct ieee80211_mgmt *mgmt,
1003                                   size_t len);
1004 void ieee80211_process_addba_request(struct ieee80211_local *local,
1005                                      struct sta_info *sta,
1006                                      struct ieee80211_mgmt *mgmt,
1007                                      size_t len);
1008
1009 int __ieee80211_stop_tx_ba_session(struct sta_info *sta, u16 tid,
1010                                    enum ieee80211_back_parties initiator);
1011 int ___ieee80211_stop_tx_ba_session(struct sta_info *sta, u16 tid,
1012                                     enum ieee80211_back_parties initiator);
1013
1014 /* Spectrum management */
1015 void ieee80211_process_measurement_req(struct ieee80211_sub_if_data *sdata,
1016                                        struct ieee80211_mgmt *mgmt,
1017                                        size_t len);
1018
1019 /* Suspend/resume and hw reconfiguration */
1020 int ieee80211_reconfig(struct ieee80211_local *local);
1021 void ieee80211_stop_device(struct ieee80211_local *local);
1022
1023 #ifdef CONFIG_PM
1024 int __ieee80211_suspend(struct ieee80211_hw *hw);
1025
1026 static inline int __ieee80211_resume(struct ieee80211_hw *hw)
1027 {
1028         return ieee80211_reconfig(hw_to_local(hw));
1029 }
1030 #else
1031 static inline int __ieee80211_suspend(struct ieee80211_hw *hw)
1032 {
1033         return 0;
1034 }
1035
1036 static inline int __ieee80211_resume(struct ieee80211_hw *hw)
1037 {
1038         return 0;
1039 }
1040 #endif
1041
1042 /* utility functions/constants */
1043 extern void *mac80211_wiphy_privid; /* for wiphy privid */
1044 u8 *ieee80211_get_bssid(struct ieee80211_hdr *hdr, size_t len,
1045                         enum nl80211_iftype type);
1046 int ieee80211_frame_duration(struct ieee80211_local *local, size_t len,
1047                              int rate, int erp, int short_preamble);
1048 void mac80211_ev_michael_mic_failure(struct ieee80211_sub_if_data *sdata, int keyidx,
1049                                      struct ieee80211_hdr *hdr, const u8 *tsc,
1050                                      gfp_t gfp);
1051 void ieee80211_set_wmm_default(struct ieee80211_sub_if_data *sdata);
1052 void ieee80211_tx_skb(struct ieee80211_sub_if_data *sdata, struct sk_buff *skb);
1053 void ieee802_11_parse_elems(u8 *start, size_t len,
1054                             struct ieee802_11_elems *elems);
1055 u32 ieee802_11_parse_elems_crc(u8 *start, size_t len,
1056                                struct ieee802_11_elems *elems,
1057                                u64 filter, u32 crc);
1058 u32 ieee80211_mandatory_rates(struct ieee80211_local *local,
1059                               enum ieee80211_band band);
1060
1061 void ieee80211_dynamic_ps_enable_work(struct work_struct *work);
1062 void ieee80211_dynamic_ps_disable_work(struct work_struct *work);
1063 void ieee80211_dynamic_ps_timer(unsigned long data);
1064 void ieee80211_send_nullfunc(struct ieee80211_local *local,
1065                              struct ieee80211_sub_if_data *sdata,
1066                              int powersave);
1067 void ieee80211_sta_rx_notify(struct ieee80211_sub_if_data *sdata,
1068                              struct ieee80211_hdr *hdr);
1069 void ieee80211_beacon_loss_work(struct work_struct *work);
1070
1071 void ieee80211_wake_queues_by_reason(struct ieee80211_hw *hw,
1072                                      enum queue_stop_reason reason);
1073 void ieee80211_stop_queues_by_reason(struct ieee80211_hw *hw,
1074                                      enum queue_stop_reason reason);
1075 void ieee80211_wake_queue_by_reason(struct ieee80211_hw *hw, int queue,
1076                                     enum queue_stop_reason reason);
1077 void ieee80211_stop_queue_by_reason(struct ieee80211_hw *hw, int queue,
1078                                     enum queue_stop_reason reason);
1079 void ieee80211_add_pending_skb(struct ieee80211_local *local,
1080                                struct sk_buff *skb);
1081 int ieee80211_add_pending_skbs(struct ieee80211_local *local,
1082                                struct sk_buff_head *skbs);
1083
1084 void ieee80211_send_auth(struct ieee80211_sub_if_data *sdata,
1085                          u16 transaction, u16 auth_alg,
1086                          u8 *extra, size_t extra_len, const u8 *bssid,
1087                          const u8 *key, u8 key_len, u8 key_idx);
1088 int ieee80211_build_preq_ies(struct ieee80211_local *local, u8 *buffer,
1089                              const u8 *ie, size_t ie_len,
1090                              enum ieee80211_band band);
1091 void ieee80211_send_probe_req(struct ieee80211_sub_if_data *sdata, u8 *dst,
1092                               const u8 *ssid, size_t ssid_len,
1093                               const u8 *ie, size_t ie_len);
1094
1095 void ieee80211_sta_def_wmm_params(struct ieee80211_sub_if_data *sdata,
1096                                   const size_t supp_rates_len,
1097                                   const u8 *supp_rates);
1098 u32 ieee80211_sta_get_rates(struct ieee80211_local *local,
1099                             struct ieee802_11_elems *elems,
1100                             enum ieee80211_band band);
1101 int __ieee80211_request_smps(struct ieee80211_sub_if_data *sdata,
1102                              enum ieee80211_smps_mode smps_mode);
1103 void ieee80211_recalc_smps(struct ieee80211_local *local,
1104                            struct ieee80211_sub_if_data *forsdata);
1105
1106 #ifdef CONFIG_MAC80211_NOINLINE
1107 #define debug_noinline noinline
1108 #else
1109 #define debug_noinline
1110 #endif
1111
1112 #endif /* IEEE80211_I_H */