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_work_type {
 231         IEEE80211_WORK_DIRECT_PROBE,
 232         IEEE80211_WORK_AUTH,
 233         IEEE80211_WORK_ASSOC,
 234 };
 235
 236 /**
 237  * enum work_done_result - indicates what to do after work was done
 238  *
 239  * @WORK_DONE_DESTROY: This work item is no longer needed, destroy.
 240  * @WORK_DONE_REQUEUE: This work item was reset to be reused, and
 241  *      should be requeued.
 242  */
 243 enum work_done_result {
 244         WORK_DONE_DESTROY,
 245         WORK_DONE_REQUEUE,
 246 };
 247
 248 struct ieee80211_work {
 249         struct list_head list;
 250
 251         struct rcu_head rcu_head;
 252
 253         struct ieee80211_sub_if_data *sdata;
 254
 255         enum work_done_result (*done)(struct ieee80211_work *wk,
 256                                       struct sk_buff *skb);
 257
 258         struct ieee80211_channel *chan;
 259         /* XXX: chan type? -- right now not really needed */
 260
 261         unsigned long timeout;
 262         enum ieee80211_work_type type;
 263
 264         u8 filter_ta[ETH_ALEN];
 265
 266         union {
 267                 struct {
 268                         int tries;
 269                         u16 algorithm, transaction;
 270                         u8 ssid[IEEE80211_MAX_SSID_LEN];
 271                         u8 ssid_len;
 272                         u8 key[WLAN_KEY_LEN_WEP104];
 273                         u8 key_len, key_idx;
 274                         bool privacy;
 275                 } probe_auth;
 276                 struct {
 277                         struct ieee80211_bss *bss;
 278                         const u8 *supp_rates;
 279                         const u8 *ht_information_ie;
 280                         enum ieee80211_smps_mode smps;
 281                         int tries;
 282                         u16 capability;
 283                         u8 prev_bssid[ETH_ALEN];
 284                         u8 ssid[IEEE80211_MAX_SSID_LEN];
 285                         u8 ssid_len;
 286                         u8 supp_rates_len;
 287                         bool wmm_used, use_11n;
 288                 } assoc;
 289         };
 290
 291         int ie_len;
 292         /* must be last */
 293         u8 ie[0];
 294 };
 295
 296 /* flags used in struct ieee80211_if_managed.flags */
 297 enum ieee80211_sta_flags {
 298         IEEE80211_STA_BEACON_POLL       = BIT(0),
 299         IEEE80211_STA_CONNECTION_POLL   = BIT(1),
 300         IEEE80211_STA_CONTROL_PORT      = BIT(2),
 301         IEEE80211_STA_DISABLE_11N       = BIT(4),
 302         IEEE80211_STA_CSA_RECEIVED      = BIT(5),
 303         IEEE80211_STA_MFP_ENABLED       = BIT(6),
 304 };
 305
 306 struct ieee80211_if_managed {
 307         struct timer_list timer;
 308         struct timer_list conn_mon_timer;
 309         struct timer_list bcn_mon_timer;
 310         struct timer_list chswitch_timer;
 311         struct work_struct work;
 312         struct work_struct monitor_work;
 313         struct work_struct chswitch_work;
 314         struct work_struct beacon_loss_work;
 315
 316         unsigned long probe_timeout;
 317         int probe_send_count;
 318
 319         struct mutex mtx;
 320         struct ieee80211_bss *associated;
 321
 322         u8 bssid[ETH_ALEN];
 323
 324         u16 aid;
 325
 326         struct sk_buff_head skb_queue;
 327
 328         unsigned long timers_running; /* used for quiesce/restart */
 329         bool powersave; /* powersave requested for this iface */
 330         enum ieee80211_smps_mode req_smps, /* requested smps mode */
 331                                  ap_smps; /* smps mode AP thinks we're in */
 332
 333         unsigned int flags;
 334
 335         u32 beacon_crc;
 336
 337         enum {
 338                 IEEE80211_MFP_DISABLED,
 339                 IEEE80211_MFP_OPTIONAL,
 340                 IEEE80211_MFP_REQUIRED
 341         } mfp; /* management frame protection */
 342
 343         int wmm_last_param_set;
 344
 345         u8 use_4addr;
 346 };
 347
 348 enum ieee80211_ibss_request {
 349         IEEE80211_IBSS_REQ_RUN  = 0,
 350 };
 351
 352 struct ieee80211_if_ibss {
 353         struct timer_list timer;
 354         struct work_struct work;
 355
 356         struct sk_buff_head skb_queue;
 357
 358         unsigned long request;
 359         unsigned long last_scan_completed;
 360
 361         bool timer_running;
 362
 363         bool fixed_bssid;
 364         bool fixed_channel;
 365         bool privacy;
 366
 367         u8 bssid[ETH_ALEN];
 368         u8 ssid[IEEE80211_MAX_SSID_LEN];
 369         u8 ssid_len, ie_len;
 370         u8 *ie;
 371         struct ieee80211_channel *channel;
 372
 373         unsigned long ibss_join_req;
 374         /* probe response/beacon for IBSS */
 375         struct sk_buff *presp, *skb;
 376
 377         enum {
 378                 IEEE80211_IBSS_MLME_SEARCH,
 379                 IEEE80211_IBSS_MLME_JOINED,
 380         } state;
 381 };
 382
 383 struct ieee80211_if_mesh {
 384         struct work_struct work;
 385         struct timer_list housekeeping_timer;
 386         struct timer_list mesh_path_timer;
 387         struct timer_list mesh_path_root_timer;
 388         struct sk_buff_head skb_queue;
 389
 390         unsigned long timers_running;
 391
 392         unsigned long wrkq_flags;
 393
 394         u8 mesh_id[IEEE80211_MAX_MESH_ID_LEN];
 395         size_t mesh_id_len;
 396         /* Active Path Selection Protocol Identifier */
 397         u8 mesh_pp_id;
 398         /* Active Path Selection Metric Identifier */
 399         u8 mesh_pm_id;
 400         /* Congestion Control Mode Identifier */
 401         u8 mesh_cc_id;
 402         /* Synchronization Protocol Identifier */
 403         u8 mesh_sp_id;
 404         /* Authentication Protocol Identifier */
 405         u8 mesh_auth_id;
 406         /* Local mesh Sequence Number */
 407         u32 sn;
 408         /* Last used PREQ ID */
 409         u32 preq_id;
 410         atomic_t mpaths;
 411         /* Timestamp of last SN update */
 412         unsigned long last_sn_update;
 413         /* Timestamp of last SN sent */
 414         unsigned long last_preq;
 415         struct mesh_rmc *rmc;
 416         spinlock_t mesh_preq_queue_lock;
 417         struct mesh_preq_queue preq_queue;
 418         int preq_queue_len;
 419         struct mesh_stats mshstats;
 420         struct mesh_config mshcfg;
 421         u32 mesh_seqnum;
 422         bool accepting_plinks;
 423 };
 424
 425 #ifdef CONFIG_MAC80211_MESH
 426 #define IEEE80211_IFSTA_MESH_CTR_INC(msh, name) \
 427         do { (msh)->mshstats.name++; } while (0)
 428 #else
 429 #define IEEE80211_IFSTA_MESH_CTR_INC(msh, name) \
 430         do { } while (0)
 431 #endif
 432
 433 /**
 434  * enum ieee80211_sub_if_data_flags - virtual interface flags
 435  *
 436  * @IEEE80211_SDATA_ALLMULTI: interface wants all multicast packets
 437  * @IEEE80211_SDATA_PROMISC: interface is promisc
 438  * @IEEE80211_SDATA_OPERATING_GMODE: operating in G-only mode
 439  * @IEEE80211_SDATA_DONT_BRIDGE_PACKETS: bridge packets between
 440  *      associated stations and deliver multicast frames both
 441  *      back to wireless media and to the local net stack.
 442  */
 443 enum ieee80211_sub_if_data_flags {
 444         IEEE80211_SDATA_ALLMULTI                = BIT(0),
 445         IEEE80211_SDATA_PROMISC                 = BIT(1),
 446         IEEE80211_SDATA_OPERATING_GMODE         = BIT(2),
 447         IEEE80211_SDATA_DONT_BRIDGE_PACKETS     = BIT(3),
 448 };
 449
 450 struct ieee80211_sub_if_data {
 451         struct list_head list;
 452
 453         struct wireless_dev wdev;
 454
 455         /* keys */
 456         struct list_head key_list;
 457
 458         struct net_device *dev;
 459         struct ieee80211_local *local;
 460
 461         unsigned int flags;
 462
 463         int drop_unencrypted;
 464
 465         char name[IFNAMSIZ];
 466
 467         /*
 468          * keep track of whether the HT opmode (stored in
 469          * vif.bss_info.ht_operation_mode) is valid.
 470          */
 471         bool ht_opmode_valid;
 472
 473         /* Fragment table for host-based reassembly */
 474         struct ieee80211_fragment_entry fragments[IEEE80211_FRAGMENT_MAX];
 475         unsigned int fragment_next;
 476
 477 #define NUM_DEFAULT_KEYS 4
 478 #define NUM_DEFAULT_MGMT_KEYS 2
 479         struct ieee80211_key *keys[NUM_DEFAULT_KEYS + NUM_DEFAULT_MGMT_KEYS];
 480         struct ieee80211_key *default_key;
 481         struct ieee80211_key *default_mgmt_key;
 482
 483         u16 sequence_number;
 484
 485         /*
 486          * AP this belongs to: self in AP mode and
 487          * corresponding AP in VLAN mode, NULL for
 488          * all others (might be needed later in IBSS)
 489          */
 490         struct ieee80211_if_ap *bss;
 491
 492         int force_unicast_rateidx; /* forced TX rateidx for unicast frames */
 493         int max_ratectrl_rateidx; /* max TX rateidx for rate control */
 494
 495         union {
 496                 struct ieee80211_if_ap ap;
 497                 struct ieee80211_if_wds wds;
 498                 struct ieee80211_if_vlan vlan;
 499                 struct ieee80211_if_managed mgd;
 500                 struct ieee80211_if_ibss ibss;
 501 #ifdef CONFIG_MAC80211_MESH
 502                 struct ieee80211_if_mesh mesh;
 503 #endif
 504                 u32 mntr_flags;
 505         } u;
 506
 507 #ifdef CONFIG_MAC80211_DEBUGFS
 508         struct {
 509                 struct dentry *dir;
 510                 struct dentry *default_key;
 511                 struct dentry *default_mgmt_key;
 512         } debugfs;
 513 #endif
 514         /* must be last, dynamically sized area in this! */
 515         struct ieee80211_vif vif;
 516 };
 517
 518 static inline
 519 struct ieee80211_sub_if_data *vif_to_sdata(struct ieee80211_vif *p)
 520 {
 521         return container_of(p, struct ieee80211_sub_if_data, vif);
 522 }
 523
 524 static inline void
 525 ieee80211_sdata_set_mesh_id(struct ieee80211_sub_if_data *sdata,
 526                             u8 mesh_id_len, u8 *mesh_id)
 527 {
 528 #ifdef CONFIG_MAC80211_MESH
 529         struct ieee80211_if_mesh *ifmsh = &sdata->u.mesh;
 530         ifmsh->mesh_id_len = mesh_id_len;
 531         memcpy(ifmsh->mesh_id, mesh_id, mesh_id_len);
 532 #else
 533         WARN_ON(1);
 534 #endif
 535 }
 536
 537 enum {
 538         IEEE80211_RX_MSG        = 1,
 539         IEEE80211_TX_STATUS_MSG = 2,
 540         IEEE80211_DELBA_MSG     = 3,
 541         IEEE80211_ADDBA_MSG     = 4,
 542 };
 543
 544 enum queue_stop_reason {
 545         IEEE80211_QUEUE_STOP_REASON_DRIVER,
 546         IEEE80211_QUEUE_STOP_REASON_PS,
 547         IEEE80211_QUEUE_STOP_REASON_CSA,
 548         IEEE80211_QUEUE_STOP_REASON_AGGREGATION,
 549         IEEE80211_QUEUE_STOP_REASON_SUSPEND,
 550         IEEE80211_QUEUE_STOP_REASON_SKB_ADD,
 551 };
 552
 553 /**
 554  * mac80211 scan flags - currently active scan mode
 555  *
 556  * @SCAN_SW_SCANNING: We're currently in the process of scanning but may as
 557  *      well be on the operating channel
 558  * @SCAN_HW_SCANNING: The hardware is scanning for us, we have no way to
 559  *      determine if we are on the operating channel or not
 560  * @SCAN_OFF_CHANNEL: We're off our operating channel for scanning,
 561  *      gets only set in conjunction with SCAN_SW_SCANNING
 562  */
 563 enum {
 564         SCAN_SW_SCANNING,
 565         SCAN_HW_SCANNING,
 566         SCAN_OFF_CHANNEL,
 567 };
 568
 569 /**
 570  * enum mac80211_scan_state - scan state machine states
 571  *
 572  * @SCAN_DECISION: Main entry point to the scan state machine, this state
 573  *      determines if we should keep on scanning or switch back to the
 574  *      operating channel
 575  * @SCAN_SET_CHANNEL: Set the next channel to be scanned
 576  * @SCAN_SEND_PROBE: Send probe requests and wait for probe responses
 577  * @SCAN_LEAVE_OPER_CHANNEL: Leave the operating channel, notify the AP
 578  *      about us leaving the channel and stop all associated STA interfaces
 579  * @SCAN_ENTER_OPER_CHANNEL: Enter the operating channel again, notify the
 580  *      AP about us being back and restart all associated STA interfaces
 581  */
 582 enum mac80211_scan_state {
 583         SCAN_DECISION,
 584         SCAN_SET_CHANNEL,
 585         SCAN_SEND_PROBE,
 586         SCAN_LEAVE_OPER_CHANNEL,
 587         SCAN_ENTER_OPER_CHANNEL,
 588 };
 589
 590 struct ieee80211_local {
 591         /* embed the driver visible part.
 592          * don't cast (use the static inlines below), but we keep
 593          * it first anyway so they become a no-op */
 594         struct ieee80211_hw hw;
 595
 596         const struct ieee80211_ops *ops;
 597
 598         /*
 599          * work stuff, potentially off-channel (in the future)
 600          */
 601         struct mutex work_mtx;
 602         struct list_head work_list;
 603         struct timer_list work_timer;
 604         struct work_struct work_work;
 605         struct sk_buff_head work_skb_queue;
 606
 607         /*
 608          * private workqueue to mac80211. mac80211 makes this accessible
 609          * via ieee80211_queue_work()
 610          */
 611         struct workqueue_struct *workqueue;
 612
 613         unsigned long queue_stop_reasons[IEEE80211_MAX_QUEUES];
 614         /* also used to protect ampdu_ac_queue and amdpu_ac_stop_refcnt */
 615         spinlock_t queue_stop_reason_lock;
 616
 617         int open_count;
 618         int monitors, cooked_mntrs;
 619         /* number of interfaces with corresponding FIF_ flags */
 620         int fif_fcsfail, fif_plcpfail, fif_control, fif_other_bss, fif_pspoll;
 621         unsigned int filter_flags; /* FIF_* */
 622
 623         /* protects the aggregated multicast list and filter calls */
 624         spinlock_t filter_lock;
 625
 626         /* used for uploading changed mc list */
 627         struct work_struct reconfig_filter;
 628
 629         /* used to reconfigure hardware SM PS */
 630         struct work_struct recalc_smps;
 631
 632         /* aggregated multicast list */
 633         struct dev_addr_list *mc_list;
 634         int mc_count;
 635
 636         bool tim_in_locked_section; /* see ieee80211_beacon_get() */
 637
 638         /*
 639          * suspended is true if we finished all the suspend _and_ we have
 640          * not yet come up from resume. This is to be used by mac80211
 641          * to ensure driver sanity during suspend and mac80211's own
 642          * sanity. It can eventually be used for WoW as well.
 643          */
 644         bool suspended;
 645
 646         /*
 647          * Resuming is true while suspended, but when we're reprogramming the
 648          * hardware -- at that time it's allowed to use ieee80211_queue_work()
 649          * again even though some other parts of the stack are still suspended
 650          * and we still drop received frames to avoid waking the stack.
 651          */
 652         bool resuming;
 653
 654         /*
 655          * quiescing is true during the suspend process _only_ to
 656          * ease timer cancelling etc.
 657          */
 658         bool quiescing;
 659
 660         /* device is started */
 661         bool started;
 662
 663         int tx_headroom; /* required headroom for hardware/radiotap */
 664
 665         /* Tasklet and skb queue to process calls from IRQ mode. All frames
 666          * added to skb_queue will be processed, but frames in
 667          * skb_queue_unreliable may be dropped if the total length of these
 668          * queues increases over the limit. */
 669 #define IEEE80211_IRQSAFE_QUEUE_LIMIT 128
 670         struct tasklet_struct tasklet;
 671         struct sk_buff_head skb_queue;
 672         struct sk_buff_head skb_queue_unreliable;
 673
 674         /* Station data */
 675         /*
 676          * The lock only protects the list, hash, timer and counter
 677          * against manipulation, reads are done in RCU. Additionally,
 678          * the lock protects each BSS's TIM bitmap.
 679          */
 680         spinlock_t sta_lock;
 681         unsigned long num_sta;
 682         struct list_head sta_list;
 683         struct sta_info *sta_hash[STA_HASH_SIZE];
 684         struct timer_list sta_cleanup;
 685         int sta_generation;
 686
 687         struct sk_buff_head pending[IEEE80211_MAX_QUEUES];
 688         struct tasklet_struct tx_pending_tasklet;
 689
 690         /*
 691          * This lock is used to prevent concurrent A-MPDU
 692          * session start/stop processing, this thus also
 693          * synchronises the ->ampdu_action() callback to
 694          * drivers and limits it to one at a time.
 695          */
 696         spinlock_t ampdu_lock;
 697
 698         /* number of interfaces with corresponding IFF_ flags */
 699         atomic_t iff_allmultis, iff_promiscs;
 700
 701         struct rate_control_ref *rate_ctrl;
 702
 703         struct crypto_blkcipher *wep_tx_tfm;
 704         struct crypto_blkcipher *wep_rx_tfm;
 705         u32 wep_iv;
 706
 707         /* see iface.c */
 708         struct list_head interfaces;
 709         struct mutex iflist_mtx;
 710
 711         /*
 712          * Key lock, protects sdata's key_list and sta_info's
 713          * key pointers (write access, they're RCU.)
 714          */
 715         spinlock_t key_lock;
 716
 717
 718         /* Scanning and BSS list */
 719         struct mutex scan_mtx;
 720         unsigned long scanning;
 721         struct cfg80211_ssid scan_ssid;
 722         struct cfg80211_scan_request *int_scan_req;
 723         struct cfg80211_scan_request *scan_req, *hw_scan_req;
 724         struct ieee80211_channel *scan_channel;
 725         enum ieee80211_band hw_scan_band;
 726         int scan_channel_idx;
 727         int scan_ies_len;
 728
 729         enum mac80211_scan_state next_scan_state;
 730         struct delayed_work scan_work;
 731         struct ieee80211_sub_if_data *scan_sdata;
 732         enum nl80211_channel_type oper_channel_type;
 733         struct ieee80211_channel *oper_channel, *csa_channel;
 734
 735         /* SNMP counters */
 736         /* dot11CountersTable */
 737         u32 dot11TransmittedFragmentCount;
 738         u32 dot11MulticastTransmittedFrameCount;
 739         u32 dot11FailedCount;
 740         u32 dot11RetryCount;
 741         u32 dot11MultipleRetryCount;
 742         u32 dot11FrameDuplicateCount;
 743         u32 dot11ReceivedFragmentCount;
 744         u32 dot11MulticastReceivedFrameCount;
 745         u32 dot11TransmittedFrameCount;
 746
 747 #ifdef CONFIG_MAC80211_LEDS
 748         int tx_led_counter, rx_led_counter;
 749         struct led_trigger *tx_led, *rx_led, *assoc_led, *radio_led;
 750         char tx_led_name[32], rx_led_name[32],
 751              assoc_led_name[32], radio_led_name[32];
 752 #endif
 753
 754 #ifdef CONFIG_MAC80211_DEBUGFS
 755         struct work_struct sta_debugfs_add;
 756 #endif
 757
 758 #ifdef CONFIG_MAC80211_DEBUG_COUNTERS
 759         /* TX/RX handler statistics */
 760         unsigned int tx_handlers_drop;
 761         unsigned int tx_handlers_queued;
 762         unsigned int tx_handlers_drop_unencrypted;
 763         unsigned int tx_handlers_drop_fragment;
 764         unsigned int tx_handlers_drop_wep;
 765         unsigned int tx_handlers_drop_not_assoc;
 766         unsigned int tx_handlers_drop_unauth_port;
 767         unsigned int rx_handlers_drop;
 768         unsigned int rx_handlers_queued;
 769         unsigned int rx_handlers_drop_nullfunc;
 770         unsigned int rx_handlers_drop_defrag;
 771         unsigned int rx_handlers_drop_short;
 772         unsigned int rx_handlers_drop_passive_scan;
 773         unsigned int tx_expand_skb_head;
 774         unsigned int tx_expand_skb_head_cloned;
 775         unsigned int rx_expand_skb_head;
 776         unsigned int rx_expand_skb_head2;
 777         unsigned int rx_handlers_fragments;
 778         unsigned int tx_status_drop;
 779 #define I802_DEBUG_INC(c) (c)++
 780 #else /* CONFIG_MAC80211_DEBUG_COUNTERS */
 781 #define I802_DEBUG_INC(c) do { } while (0)
 782 #endif /* CONFIG_MAC80211_DEBUG_COUNTERS */
 783
 784
 785         int total_ps_buffered; /* total number of all buffered unicast and
 786                                 * multicast packets for power saving stations
 787                                 */
 788         int wifi_wme_noack_test;
 789         unsigned int wmm_acm; /* bit field of ACM bits (BIT(802.1D tag)) */
 790
 791         bool pspolling;
 792         bool scan_ps_enabled;
 793         /*
 794          * PS can only be enabled when we have exactly one managed
 795          * interface (and monitors) in PS, this then points there.
 796          */
 797         struct ieee80211_sub_if_data *ps_sdata;
 798         struct work_struct dynamic_ps_enable_work;
 799         struct work_struct dynamic_ps_disable_work;
 800         struct timer_list dynamic_ps_timer;
 801         struct notifier_block network_latency_notifier;
 802
 803         int user_power_level; /* in dBm */
 804         int power_constr_level; /* in dBm */
 805
 806         enum ieee80211_smps_mode smps_mode;
 807
 808         struct work_struct restart_work;
 809
 810 #ifdef CONFIG_MAC80211_DEBUGFS
 811         struct local_debugfsdentries {
 812                 struct dentry *rcdir;
 813                 struct dentry *stations;
 814                 struct dentry *keys;
 815         } debugfs;
 816 #endif
 817 };
 818
 819 static inline struct ieee80211_sub_if_data *
 820 IEEE80211_DEV_TO_SUB_IF(struct net_device *dev)
 821 {
 822         return netdev_priv(dev);
 823 }
 824
 825 /* this struct represents 802.11n's RA/TID combination along with our vif */
 826 struct ieee80211_ra_tid {
 827         struct ieee80211_vif *vif;
 828         u8 ra[ETH_ALEN];
 829         u16 tid;
 830 };
 831
 832 /* Parsed Information Elements */
 833 struct ieee802_11_elems {
 834         u8 *ie_start;
 835         size_t total_len;
 836
 837         /* pointers to IEs */
 838         u8 *ssid;
 839         u8 *supp_rates;
 840         u8 *fh_params;
 841         u8 *ds_params;
 842         u8 *cf_params;
 843         struct ieee80211_tim_ie *tim;
 844         u8 *ibss_params;
 845         u8 *challenge;
 846         u8 *wpa;
 847         u8 *rsn;
 848         u8 *erp_info;
 849         u8 *ext_supp_rates;
 850         u8 *wmm_info;
 851         u8 *wmm_param;
 852         struct ieee80211_ht_cap *ht_cap_elem;
 853         struct ieee80211_ht_info *ht_info_elem;
 854         struct ieee80211_meshconf_ie *mesh_config;
 855         u8 *mesh_id;
 856         u8 *peer_link;
 857         u8 *preq;
 858         u8 *prep;
 859         u8 *perr;
 860         struct ieee80211_rann_ie *rann;
 861         u8 *ch_switch_elem;
 862         u8 *country_elem;
 863         u8 *pwr_constr_elem;
 864         u8 *quiet_elem;         /* first quite element */
 865         u8 *timeout_int;
 866
 867         /* length of them, respectively */
 868         u8 ssid_len;
 869         u8 supp_rates_len;
 870         u8 fh_params_len;
 871         u8 ds_params_len;
 872         u8 cf_params_len;
 873         u8 tim_len;
 874         u8 ibss_params_len;
 875         u8 challenge_len;
 876         u8 wpa_len;
 877         u8 rsn_len;
 878         u8 erp_info_len;
 879         u8 ext_supp_rates_len;
 880         u8 wmm_info_len;
 881         u8 wmm_param_len;
 882         u8 mesh_id_len;
 883         u8 peer_link_len;
 884         u8 preq_len;
 885         u8 prep_len;
 886         u8 perr_len;
 887         u8 ch_switch_elem_len;
 888         u8 country_elem_len;
 889         u8 pwr_constr_elem_len;
 890         u8 quiet_elem_len;
 891         u8 num_of_quiet_elem;   /* can be more the one */
 892         u8 timeout_int_len;
 893 };
 894
 895 static inline struct ieee80211_local *hw_to_local(
 896         struct ieee80211_hw *hw)
 897 {
 898         return container_of(hw, struct ieee80211_local, hw);
 899 }
 900
 901 static inline struct ieee80211_hw *local_to_hw(
 902         struct ieee80211_local *local)
 903 {
 904         return &local->hw;
 905 }
 906
 907
 908 static inline int ieee80211_bssid_match(const u8 *raddr, const u8 *addr)
 909 {
 910         return compare_ether_addr(raddr, addr) == 0 ||
 911                is_broadcast_ether_addr(raddr);
 912 }
 913
 914
 915 int ieee80211_hw_config(struct ieee80211_local *local, u32 changed);
 916 void ieee80211_tx_set_protected(struct ieee80211_tx_data *tx);
 917 void ieee80211_bss_info_change_notify(struct ieee80211_sub_if_data *sdata,
 918                                       u32 changed);
 919 void ieee80211_configure_filter(struct ieee80211_local *local);
 920 u32 ieee80211_reset_erp_info(struct ieee80211_sub_if_data *sdata);
 921
 922 extern bool ieee80211_disable_40mhz_24ghz;
 923
 924 /* STA code */
 925 void ieee80211_sta_setup_sdata(struct ieee80211_sub_if_data *sdata);
 926 int ieee80211_mgd_auth(struct ieee80211_sub_if_data *sdata,
 927                        struct cfg80211_auth_request *req);
 928 int ieee80211_mgd_assoc(struct ieee80211_sub_if_data *sdata,
 929                         struct cfg80211_assoc_request *req);
 930 int ieee80211_mgd_deauth(struct ieee80211_sub_if_data *sdata,
 931                          struct cfg80211_deauth_request *req,
 932                          void *cookie);
 933 int ieee80211_mgd_disassoc(struct ieee80211_sub_if_data *sdata,
 934                            struct cfg80211_disassoc_request *req,
 935                            void *cookie);
 936 ieee80211_rx_result ieee80211_sta_rx_mgmt(struct ieee80211_sub_if_data *sdata,
 937                                           struct sk_buff *skb);
 938 void ieee80211_send_pspoll(struct ieee80211_local *local,
 939                            struct ieee80211_sub_if_data *sdata);
 940 void ieee80211_recalc_ps(struct ieee80211_local *local, s32 latency);
 941 int ieee80211_max_network_latency(struct notifier_block *nb,
 942                                   unsigned long data, void *dummy);
 943 void ieee80211_sta_process_chanswitch(struct ieee80211_sub_if_data *sdata,
 944                                       struct ieee80211_channel_sw_ie *sw_elem,
 945                                       struct ieee80211_bss *bss);
 946 void ieee80211_sta_quiesce(struct ieee80211_sub_if_data *sdata);
 947 void ieee80211_sta_restart(struct ieee80211_sub_if_data *sdata);
 948
 949 /* IBSS code */
 950 void ieee80211_ibss_notify_scan_completed(struct ieee80211_local *local);
 951 void ieee80211_ibss_setup_sdata(struct ieee80211_sub_if_data *sdata);
 952 ieee80211_rx_result
 953 ieee80211_ibss_rx_mgmt(struct ieee80211_sub_if_data *sdata, struct sk_buff *skb);
 954 struct sta_info *ieee80211_ibss_add_sta(struct ieee80211_sub_if_data *sdata,
 955                                         u8 *bssid, u8 *addr, u32 supp_rates);
 956 int ieee80211_ibss_join(struct ieee80211_sub_if_data *sdata,
 957                         struct cfg80211_ibss_params *params);
 958 int ieee80211_ibss_leave(struct ieee80211_sub_if_data *sdata);
 959 void ieee80211_ibss_quiesce(struct ieee80211_sub_if_data *sdata);
 960 void ieee80211_ibss_restart(struct ieee80211_sub_if_data *sdata);
 961
 962 /* scan/BSS handling */
 963 void ieee80211_scan_work(struct work_struct *work);
 964 int ieee80211_request_internal_scan(struct ieee80211_sub_if_data *sdata,
 965                                     const u8 *ssid, u8 ssid_len);
 966 int ieee80211_request_scan(struct ieee80211_sub_if_data *sdata,
 967                            struct cfg80211_scan_request *req);
 968 void ieee80211_scan_cancel(struct ieee80211_local *local);
 969 ieee80211_rx_result
 970 ieee80211_scan_rx(struct ieee80211_sub_if_data *sdata, struct sk_buff *skb);
 971
 972 void ieee80211_mlme_notify_scan_completed(struct ieee80211_local *local);
 973 struct ieee80211_bss *
 974 ieee80211_bss_info_update(struct ieee80211_local *local,
 975                           struct ieee80211_rx_status *rx_status,
 976                           struct ieee80211_mgmt *mgmt,
 977                           size_t len,
 978                           struct ieee802_11_elems *elems,
 979                           struct ieee80211_channel *channel,
 980                           bool beacon);
 981 struct ieee80211_bss *
 982 ieee80211_rx_bss_get(struct ieee80211_local *local, u8 *bssid, int freq,
 983                      u8 *ssid, u8 ssid_len);
 984 void ieee80211_rx_bss_put(struct ieee80211_local *local,
 985                           struct ieee80211_bss *bss);
 986
 987 /* interface handling */
 988 int ieee80211_iface_init(void);
 989 void ieee80211_iface_exit(void);
 990 int ieee80211_if_add(struct ieee80211_local *local, const char *name,
 991                      struct net_device **new_dev, enum nl80211_iftype type,
 992                      struct vif_params *params);
 993 int ieee80211_if_change_type(struct ieee80211_sub_if_data *sdata,
 994                              enum nl80211_iftype type);
 995 void ieee80211_if_remove(struct ieee80211_sub_if_data *sdata);
 996 void ieee80211_remove_interfaces(struct ieee80211_local *local);
 997 u32 __ieee80211_recalc_idle(struct ieee80211_local *local);
 998 void ieee80211_recalc_idle(struct ieee80211_local *local);
 999
1000 static inline bool ieee80211_sdata_running(struct ieee80211_sub_if_data *sdata)
1001 {
1002         return netif_running(sdata->dev);
1003 }
1004
1005 /* tx handling */
1006 void ieee80211_clear_tx_pending(struct ieee80211_local *local);
1007 void ieee80211_tx_pending(unsigned long data);
1008 netdev_tx_t ieee80211_monitor_start_xmit(struct sk_buff *skb,
1009                                          struct net_device *dev);
1010 netdev_tx_t ieee80211_subif_start_xmit(struct sk_buff *skb,
1011                                        struct net_device *dev);
1012
1013 /*
1014  * radiotap header for status frames
1015  */
1016 struct ieee80211_tx_status_rtap_hdr {
1017         struct ieee80211_radiotap_header hdr;
1018         u8 rate;
1019         u8 padding_for_rate;
1020         __le16 tx_flags;
1021         u8 data_retries;
1022 } __attribute__ ((packed));
1023
1024
1025 /* HT */
1026 void ieee80211_ht_cap_ie_to_sta_ht_cap(struct ieee80211_supported_band *sband,
1027                                        struct ieee80211_ht_cap *ht_cap_ie,
1028                                        struct ieee80211_sta_ht_cap *ht_cap);
1029 void ieee80211_send_bar(struct ieee80211_sub_if_data *sdata, u8 *ra, u16 tid, u16 ssn);
1030 void ieee80211_send_delba(struct ieee80211_sub_if_data *sdata,
1031                           const u8 *da, u16 tid,
1032                           u16 initiator, u16 reason_code);
1033 int ieee80211_send_smps_action(struct ieee80211_sub_if_data *sdata,
1034                                enum ieee80211_smps_mode smps, const u8 *da,
1035                                const u8 *bssid);
1036
1037 void ieee80211_sta_stop_rx_ba_session(struct ieee80211_sub_if_data *sdata, u8 *da,
1038                                 u16 tid, u16 initiator, u16 reason);
1039 void __ieee80211_stop_rx_ba_session(struct sta_info *sta, u16 tid,
1040                                     u16 initiator, u16 reason);
1041 void ieee80211_sta_tear_down_BA_sessions(struct sta_info *sta);
1042 void ieee80211_process_delba(struct ieee80211_sub_if_data *sdata,
1043                              struct sta_info *sta,
1044                              struct ieee80211_mgmt *mgmt, size_t len);
1045 void ieee80211_process_addba_resp(struct ieee80211_local *local,
1046                                   struct sta_info *sta,
1047                                   struct ieee80211_mgmt *mgmt,
1048                                   size_t len);
1049 void ieee80211_process_addba_request(struct ieee80211_local *local,
1050                                      struct sta_info *sta,
1051                                      struct ieee80211_mgmt *mgmt,
1052                                      size_t len);
1053
1054 int __ieee80211_stop_tx_ba_session(struct sta_info *sta, u16 tid,
1055                                    enum ieee80211_back_parties initiator);
1056 int ___ieee80211_stop_tx_ba_session(struct sta_info *sta, u16 tid,
1057                                     enum ieee80211_back_parties initiator);
1058
1059 /* Spectrum management */
1060 void ieee80211_process_measurement_req(struct ieee80211_sub_if_data *sdata,
1061                                        struct ieee80211_mgmt *mgmt,
1062                                        size_t len);
1063
1064 /* Suspend/resume and hw reconfiguration */
1065 int ieee80211_reconfig(struct ieee80211_local *local);
1066 void ieee80211_stop_device(struct ieee80211_local *local);
1067
1068 #ifdef CONFIG_PM
1069 int __ieee80211_suspend(struct ieee80211_hw *hw);
1070
1071 static inline int __ieee80211_resume(struct ieee80211_hw *hw)
1072 {
1073         return ieee80211_reconfig(hw_to_local(hw));
1074 }
1075 #else
1076 static inline int __ieee80211_suspend(struct ieee80211_hw *hw)
1077 {
1078         return 0;
1079 }
1080
1081 static inline int __ieee80211_resume(struct ieee80211_hw *hw)
1082 {
1083         return 0;
1084 }
1085 #endif
1086
1087 /* utility functions/constants */
1088 extern void *mac80211_wiphy_privid; /* for wiphy privid */
1089 u8 *ieee80211_get_bssid(struct ieee80211_hdr *hdr, size_t len,
1090                         enum nl80211_iftype type);
1091 int ieee80211_frame_duration(struct ieee80211_local *local, size_t len,
1092                              int rate, int erp, int short_preamble);
1093 void mac80211_ev_michael_mic_failure(struct ieee80211_sub_if_data *sdata, int keyidx,
1094                                      struct ieee80211_hdr *hdr, const u8 *tsc,
1095                                      gfp_t gfp);
1096 void ieee80211_set_wmm_default(struct ieee80211_sub_if_data *sdata);
1097 void ieee80211_tx_skb(struct ieee80211_sub_if_data *sdata, struct sk_buff *skb);
1098 void ieee802_11_parse_elems(u8 *start, size_t len,
1099                             struct ieee802_11_elems *elems);
1100 u32 ieee802_11_parse_elems_crc(u8 *start, size_t len,
1101                                struct ieee802_11_elems *elems,
1102                                u64 filter, u32 crc);
1103 u32 ieee80211_mandatory_rates(struct ieee80211_local *local,
1104                               enum ieee80211_band band);
1105
1106 void ieee80211_dynamic_ps_enable_work(struct work_struct *work);
1107 void ieee80211_dynamic_ps_disable_work(struct work_struct *work);
1108 void ieee80211_dynamic_ps_timer(unsigned long data);
1109 void ieee80211_send_nullfunc(struct ieee80211_local *local,
1110                              struct ieee80211_sub_if_data *sdata,
1111                              int powersave);
1112 void ieee80211_sta_rx_notify(struct ieee80211_sub_if_data *sdata,
1113                              struct ieee80211_hdr *hdr);
1114 void ieee80211_beacon_loss_work(struct work_struct *work);
1115
1116 void ieee80211_wake_queues_by_reason(struct ieee80211_hw *hw,
1117                                      enum queue_stop_reason reason);
1118 void ieee80211_stop_queues_by_reason(struct ieee80211_hw *hw,
1119                                      enum queue_stop_reason reason);
1120 void ieee80211_wake_queue_by_reason(struct ieee80211_hw *hw, int queue,
1121                                     enum queue_stop_reason reason);
1122 void ieee80211_stop_queue_by_reason(struct ieee80211_hw *hw, int queue,
1123                                     enum queue_stop_reason reason);
1124 void ieee80211_add_pending_skb(struct ieee80211_local *local,
1125                                struct sk_buff *skb);
1126 int ieee80211_add_pending_skbs(struct ieee80211_local *local,
1127                                struct sk_buff_head *skbs);
1128
1129 void ieee80211_send_auth(struct ieee80211_sub_if_data *sdata,
1130                          u16 transaction, u16 auth_alg,
1131                          u8 *extra, size_t extra_len, const u8 *bssid,
1132                          const u8 *key, u8 key_len, u8 key_idx);
1133 int ieee80211_build_preq_ies(struct ieee80211_local *local, u8 *buffer,
1134                              const u8 *ie, size_t ie_len,
1135                              enum ieee80211_band band);
1136 void ieee80211_send_probe_req(struct ieee80211_sub_if_data *sdata, u8 *dst,
1137                               const u8 *ssid, size_t ssid_len,
1138                               const u8 *ie, size_t ie_len);
1139
1140 void ieee80211_sta_def_wmm_params(struct ieee80211_sub_if_data *sdata,
1141                                   const size_t supp_rates_len,
1142                                   const u8 *supp_rates);
1143 u32 ieee80211_sta_get_rates(struct ieee80211_local *local,
1144                             struct ieee802_11_elems *elems,
1145                             enum ieee80211_band band);
1146 int __ieee80211_request_smps(struct ieee80211_sub_if_data *sdata,
1147                              enum ieee80211_smps_mode smps_mode);
1148 void ieee80211_recalc_smps(struct ieee80211_local *local,
1149                            struct ieee80211_sub_if_data *forsdata);
1150
1151 /* internal work items */
1152 void ieee80211_work_init(struct ieee80211_local *local);
1153 void ieee80211_add_work(struct ieee80211_work *wk);
1154 void free_work(struct ieee80211_work *wk);
1155 void ieee80211_work_purge(struct ieee80211_sub_if_data *sdata);
1156 ieee80211_rx_result ieee80211_work_rx_mgmt(struct ieee80211_sub_if_data *sdata,
1157                                            struct sk_buff *skb);
1158
1159 #ifdef CONFIG_MAC80211_NOINLINE
1160 #define debug_noinline noinline
1161 #else
1162 #define debug_noinline
1163 #endif
1164
1165 #endif /* IEEE80211_I_H */