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