xref: /openbmc/linux/net/mac80211/ieee80211_i.h (revision df2634f43f5106947f3735a0b61a6527a4b278cd)
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-2010	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 <linux/leds.h>
27 #include <net/ieee80211_radiotap.h>
28 #include <net/cfg80211.h>
29 #include <net/mac80211.h>
30 #include "key.h"
31 #include "sta_info.h"
32 
33 struct ieee80211_local;
34 
35 /* Maximum number of broadcast/multicast frames to buffer when some of the
36  * associated stations are using power saving. */
37 #define AP_MAX_BC_BUFFER 128
38 
39 /* Maximum number of frames buffered to all STAs, including multicast frames.
40  * Note: increasing this limit increases the potential memory requirement. Each
41  * frame can be up to about 2 kB long. */
42 #define TOTAL_MAX_TX_BUFFER 512
43 
44 /* Required encryption head and tailroom */
45 #define IEEE80211_ENCRYPT_HEADROOM 8
46 #define IEEE80211_ENCRYPT_TAILROOM 18
47 
48 /* IEEE 802.11 (Ch. 9.5 Defragmentation) requires support for concurrent
49  * reception of at least three fragmented frames. This limit can be increased
50  * by changing this define, at the cost of slower frame reassembly and
51  * increased memory use (about 2 kB of RAM per entry). */
52 #define IEEE80211_FRAGMENT_MAX 4
53 
54 #define TU_TO_EXP_TIME(x)	(jiffies + usecs_to_jiffies((x) * 1024))
55 
56 #define IEEE80211_DEFAULT_UAPSD_QUEUES \
57 	(IEEE80211_WMM_IE_STA_QOSINFO_AC_BK |	\
58 	 IEEE80211_WMM_IE_STA_QOSINFO_AC_BE |	\
59 	 IEEE80211_WMM_IE_STA_QOSINFO_AC_VI |	\
60 	 IEEE80211_WMM_IE_STA_QOSINFO_AC_VO)
61 
62 #define IEEE80211_DEFAULT_MAX_SP_LEN		\
63 	IEEE80211_WMM_IE_STA_QOSINFO_SP_ALL
64 
65 struct ieee80211_fragment_entry {
66 	unsigned long first_frag_time;
67 	unsigned int seq;
68 	unsigned int rx_queue;
69 	unsigned int last_frag;
70 	unsigned int extra_len;
71 	struct sk_buff_head skb_list;
72 	int ccmp; /* Whether fragments were encrypted with CCMP */
73 	u8 last_pn[6]; /* PN of the last fragment if CCMP was used */
74 };
75 
76 
77 struct ieee80211_bss {
78 	/* don't want to look up all the time */
79 	size_t ssid_len;
80 	u8 ssid[IEEE80211_MAX_SSID_LEN];
81 
82 	u8 dtim_period;
83 
84 	bool wmm_used;
85 	bool uapsd_supported;
86 
87 	unsigned long last_probe_resp;
88 
89 #ifdef CONFIG_MAC80211_MESH
90 	u8 *mesh_id;
91 	size_t mesh_id_len;
92 	u8 *mesh_cfg;
93 #endif
94 
95 #define IEEE80211_MAX_SUPP_RATES 32
96 	u8 supp_rates[IEEE80211_MAX_SUPP_RATES];
97 	size_t supp_rates_len;
98 
99 	/*
100 	 * During assocation, we save an ERP value from a probe response so
101 	 * that we can feed ERP info to the driver when handling the
102 	 * association completes. these fields probably won't be up-to-date
103 	 * otherwise, you probably don't want to use them.
104 	 */
105 	bool has_erp_value;
106 	u8 erp_value;
107 };
108 
109 static inline u8 *bss_mesh_cfg(struct ieee80211_bss *bss)
110 {
111 #ifdef CONFIG_MAC80211_MESH
112 	return bss->mesh_cfg;
113 #endif
114 	return NULL;
115 }
116 
117 static inline u8 *bss_mesh_id(struct ieee80211_bss *bss)
118 {
119 #ifdef CONFIG_MAC80211_MESH
120 	return bss->mesh_id;
121 #endif
122 	return NULL;
123 }
124 
125 static inline u8 bss_mesh_id_len(struct ieee80211_bss *bss)
126 {
127 #ifdef CONFIG_MAC80211_MESH
128 	return bss->mesh_id_len;
129 #endif
130 	return 0;
131 }
132 
133 
134 typedef unsigned __bitwise__ ieee80211_tx_result;
135 #define TX_CONTINUE	((__force ieee80211_tx_result) 0u)
136 #define TX_DROP		((__force ieee80211_tx_result) 1u)
137 #define TX_QUEUED	((__force ieee80211_tx_result) 2u)
138 
139 #define IEEE80211_TX_FRAGMENTED		BIT(0)
140 #define IEEE80211_TX_UNICAST		BIT(1)
141 #define IEEE80211_TX_PS_BUFFERED	BIT(2)
142 
143 struct ieee80211_tx_data {
144 	struct sk_buff *skb;
145 	struct ieee80211_local *local;
146 	struct ieee80211_sub_if_data *sdata;
147 	struct sta_info *sta;
148 	struct ieee80211_key *key;
149 
150 	struct ieee80211_channel *channel;
151 
152 	u16 ethertype;
153 	unsigned int flags;
154 };
155 
156 
157 typedef unsigned __bitwise__ ieee80211_rx_result;
158 #define RX_CONTINUE		((__force ieee80211_rx_result) 0u)
159 #define RX_DROP_UNUSABLE	((__force ieee80211_rx_result) 1u)
160 #define RX_DROP_MONITOR		((__force ieee80211_rx_result) 2u)
161 #define RX_QUEUED		((__force ieee80211_rx_result) 3u)
162 
163 /**
164  * enum ieee80211_packet_rx_flags - packet RX flags
165  * @IEEE80211_RX_RA_MATCH: frame is destined to interface currently processed
166  *	(incl. multicast frames)
167  * @IEEE80211_RX_IN_SCAN: received while scanning
168  * @IEEE80211_RX_FRAGMENTED: fragmented frame
169  * @IEEE80211_RX_AMSDU: a-MSDU packet
170  * @IEEE80211_RX_MALFORMED_ACTION_FRM: action frame is malformed
171  * @IEEE80211_RX_DEFERRED_RELEASE: frame was subjected to receive reordering
172  *
173  * These are per-frame flags that are attached to a frame in the
174  * @rx_flags field of &struct ieee80211_rx_status.
175  */
176 enum ieee80211_packet_rx_flags {
177 	IEEE80211_RX_IN_SCAN			= BIT(0),
178 	IEEE80211_RX_RA_MATCH			= BIT(1),
179 	IEEE80211_RX_FRAGMENTED			= BIT(2),
180 	IEEE80211_RX_AMSDU			= BIT(3),
181 	IEEE80211_RX_MALFORMED_ACTION_FRM	= BIT(4),
182 	IEEE80211_RX_DEFERRED_RELEASE		= BIT(5),
183 };
184 
185 /**
186  * enum ieee80211_rx_flags - RX data flags
187  *
188  * @IEEE80211_RX_CMNTR: received on cooked monitor already
189  *
190  * These flags are used across handling multiple interfaces
191  * for a single frame.
192  */
193 enum ieee80211_rx_flags {
194 	IEEE80211_RX_CMNTR		= BIT(0),
195 };
196 
197 struct ieee80211_rx_data {
198 	struct sk_buff *skb;
199 	struct ieee80211_local *local;
200 	struct ieee80211_sub_if_data *sdata;
201 	struct sta_info *sta;
202 	struct ieee80211_key *key;
203 
204 	unsigned int flags;
205 	int queue;
206 	u32 tkip_iv32;
207 	u16 tkip_iv16;
208 };
209 
210 struct beacon_data {
211 	u8 *head, *tail;
212 	int head_len, tail_len;
213 	int dtim_period;
214 };
215 
216 struct ieee80211_if_ap {
217 	struct beacon_data *beacon;
218 
219 	struct list_head vlans;
220 
221 	/* yes, this looks ugly, but guarantees that we can later use
222 	 * bitmap_empty :)
223 	 * NB: don't touch this bitmap, use sta_info_{set,clear}_tim_bit */
224 	u8 tim[sizeof(unsigned long) * BITS_TO_LONGS(IEEE80211_MAX_AID + 1)];
225 	struct sk_buff_head ps_bc_buf;
226 	atomic_t num_sta_ps; /* number of stations in PS mode */
227 	int dtim_count;
228 };
229 
230 struct ieee80211_if_wds {
231 	struct sta_info *sta;
232 	u8 remote_addr[ETH_ALEN];
233 };
234 
235 struct ieee80211_if_vlan {
236 	struct list_head list;
237 
238 	/* used for all tx if the VLAN is configured to 4-addr mode */
239 	struct sta_info *sta;
240 };
241 
242 struct mesh_stats {
243 	__u32 fwded_mcast;		/* Mesh forwarded multicast frames */
244 	__u32 fwded_unicast;		/* Mesh forwarded unicast frames */
245 	__u32 fwded_frames;		/* Mesh total forwarded frames */
246 	__u32 dropped_frames_ttl;	/* Not transmitted since mesh_ttl == 0*/
247 	__u32 dropped_frames_no_route;	/* Not transmitted, no route found */
248 	atomic_t estab_plinks;
249 };
250 
251 #define PREQ_Q_F_START		0x1
252 #define PREQ_Q_F_REFRESH	0x2
253 struct mesh_preq_queue {
254 	struct list_head list;
255 	u8 dst[ETH_ALEN];
256 	u8 flags;
257 };
258 
259 enum ieee80211_work_type {
260 	IEEE80211_WORK_ABORT,
261 	IEEE80211_WORK_DIRECT_PROBE,
262 	IEEE80211_WORK_AUTH,
263 	IEEE80211_WORK_ASSOC_BEACON_WAIT,
264 	IEEE80211_WORK_ASSOC,
265 	IEEE80211_WORK_REMAIN_ON_CHANNEL,
266 	IEEE80211_WORK_OFFCHANNEL_TX,
267 };
268 
269 /**
270  * enum work_done_result - indicates what to do after work was done
271  *
272  * @WORK_DONE_DESTROY: This work item is no longer needed, destroy.
273  * @WORK_DONE_REQUEUE: This work item was reset to be reused, and
274  *	should be requeued.
275  */
276 enum work_done_result {
277 	WORK_DONE_DESTROY,
278 	WORK_DONE_REQUEUE,
279 };
280 
281 struct ieee80211_work {
282 	struct list_head list;
283 
284 	struct rcu_head rcu_head;
285 
286 	struct ieee80211_sub_if_data *sdata;
287 
288 	enum work_done_result (*done)(struct ieee80211_work *wk,
289 				      struct sk_buff *skb);
290 
291 	struct ieee80211_channel *chan;
292 	enum nl80211_channel_type chan_type;
293 
294 	unsigned long timeout;
295 	enum ieee80211_work_type type;
296 
297 	u8 filter_ta[ETH_ALEN];
298 
299 	bool started;
300 
301 	union {
302 		struct {
303 			int tries;
304 			u16 algorithm, transaction;
305 			u8 ssid[IEEE80211_MAX_SSID_LEN];
306 			u8 ssid_len;
307 			u8 key[WLAN_KEY_LEN_WEP104];
308 			u8 key_len, key_idx;
309 			bool privacy;
310 		} probe_auth;
311 		struct {
312 			struct cfg80211_bss *bss;
313 			const u8 *supp_rates;
314 			const u8 *ht_information_ie;
315 			enum ieee80211_smps_mode smps;
316 			int tries;
317 			u16 capability;
318 			u8 prev_bssid[ETH_ALEN];
319 			u8 ssid[IEEE80211_MAX_SSID_LEN];
320 			u8 ssid_len;
321 			u8 supp_rates_len;
322 			bool wmm_used, use_11n, uapsd_used;
323 		} assoc;
324 		struct {
325 			u32 duration;
326 		} remain;
327 		struct {
328 			struct sk_buff *frame;
329 			u32 wait;
330 		} offchan_tx;
331 	};
332 
333 	int ie_len;
334 	/* must be last */
335 	u8 ie[0];
336 };
337 
338 /* flags used in struct ieee80211_if_managed.flags */
339 enum ieee80211_sta_flags {
340 	IEEE80211_STA_BEACON_POLL	= BIT(0),
341 	IEEE80211_STA_CONNECTION_POLL	= BIT(1),
342 	IEEE80211_STA_CONTROL_PORT	= BIT(2),
343 	IEEE80211_STA_DISABLE_11N	= BIT(4),
344 	IEEE80211_STA_CSA_RECEIVED	= BIT(5),
345 	IEEE80211_STA_MFP_ENABLED	= BIT(6),
346 	IEEE80211_STA_UAPSD_ENABLED	= BIT(7),
347 	IEEE80211_STA_NULLFUNC_ACKED	= BIT(8),
348 	IEEE80211_STA_RESET_SIGNAL_AVE	= BIT(9),
349 };
350 
351 struct ieee80211_if_managed {
352 	struct timer_list timer;
353 	struct timer_list conn_mon_timer;
354 	struct timer_list bcn_mon_timer;
355 	struct timer_list chswitch_timer;
356 	struct work_struct monitor_work;
357 	struct work_struct chswitch_work;
358 	struct work_struct beacon_connection_loss_work;
359 
360 	unsigned long beacon_timeout;
361 	unsigned long probe_timeout;
362 	int probe_send_count;
363 	bool nullfunc_failed;
364 
365 	struct mutex mtx;
366 	struct cfg80211_bss *associated;
367 
368 	u8 bssid[ETH_ALEN];
369 
370 	u16 aid;
371 
372 	unsigned long timers_running; /* used for quiesce/restart */
373 	bool powersave; /* powersave requested for this iface */
374 	enum ieee80211_smps_mode req_smps, /* requested smps mode */
375 				 ap_smps, /* smps mode AP thinks we're in */
376 				 driver_smps_mode; /* smps mode request */
377 
378 	struct work_struct request_smps_work;
379 
380 	unsigned int flags;
381 
382 	bool beacon_crc_valid;
383 	u32 beacon_crc;
384 
385 	enum {
386 		IEEE80211_MFP_DISABLED,
387 		IEEE80211_MFP_OPTIONAL,
388 		IEEE80211_MFP_REQUIRED
389 	} mfp; /* management frame protection */
390 
391 	int wmm_last_param_set;
392 
393 	u8 use_4addr;
394 
395 	/* Signal strength from the last Beacon frame in the current BSS. */
396 	int last_beacon_signal;
397 
398 	/*
399 	 * Weighted average of the signal strength from Beacon frames in the
400 	 * current BSS. This is in units of 1/16 of the signal unit to maintain
401 	 * accuracy and to speed up calculations, i.e., the value need to be
402 	 * divided by 16 to get the actual value.
403 	 */
404 	int ave_beacon_signal;
405 
406 	/*
407 	 * Number of Beacon frames used in ave_beacon_signal. This can be used
408 	 * to avoid generating less reliable cqm events that would be based
409 	 * only on couple of received frames.
410 	 */
411 	unsigned int count_beacon_signal;
412 
413 	/*
414 	 * Last Beacon frame signal strength average (ave_beacon_signal / 16)
415 	 * that triggered a cqm event. 0 indicates that no event has been
416 	 * generated for the current association.
417 	 */
418 	int last_cqm_event_signal;
419 };
420 
421 struct ieee80211_if_ibss {
422 	struct timer_list timer;
423 
424 	struct mutex mtx;
425 
426 	unsigned long last_scan_completed;
427 
428 	u32 basic_rates;
429 
430 	bool timer_running;
431 
432 	bool fixed_bssid;
433 	bool fixed_channel;
434 	bool privacy;
435 
436 	u8 bssid[ETH_ALEN];
437 	u8 ssid[IEEE80211_MAX_SSID_LEN];
438 	u8 ssid_len, ie_len;
439 	u8 *ie;
440 	struct ieee80211_channel *channel;
441 
442 	unsigned long ibss_join_req;
443 	/* probe response/beacon for IBSS */
444 	struct sk_buff *presp, *skb;
445 
446 	enum {
447 		IEEE80211_IBSS_MLME_SEARCH,
448 		IEEE80211_IBSS_MLME_JOINED,
449 	} state;
450 };
451 
452 struct ieee80211_if_mesh {
453 	struct timer_list housekeeping_timer;
454 	struct timer_list mesh_path_timer;
455 	struct timer_list mesh_path_root_timer;
456 
457 	unsigned long timers_running;
458 
459 	unsigned long wrkq_flags;
460 
461 	u8 mesh_id[IEEE80211_MAX_MESH_ID_LEN];
462 	size_t mesh_id_len;
463 	/* Active Path Selection Protocol Identifier */
464 	u8 mesh_pp_id;
465 	/* Active Path Selection Metric Identifier */
466 	u8 mesh_pm_id;
467 	/* Congestion Control Mode Identifier */
468 	u8 mesh_cc_id;
469 	/* Synchronization Protocol Identifier */
470 	u8 mesh_sp_id;
471 	/* Authentication Protocol Identifier */
472 	u8 mesh_auth_id;
473 	/* Local mesh Sequence Number */
474 	u32 sn;
475 	/* Last used PREQ ID */
476 	u32 preq_id;
477 	atomic_t mpaths;
478 	/* Timestamp of last SN update */
479 	unsigned long last_sn_update;
480 	/* Timestamp of last SN sent */
481 	unsigned long last_preq;
482 	struct mesh_rmc *rmc;
483 	spinlock_t mesh_preq_queue_lock;
484 	struct mesh_preq_queue preq_queue;
485 	int preq_queue_len;
486 	struct mesh_stats mshstats;
487 	struct mesh_config mshcfg;
488 	u32 mesh_seqnum;
489 	bool accepting_plinks;
490 	const u8 *vendor_ie;
491 	u8 vendor_ie_len;
492 };
493 
494 #ifdef CONFIG_MAC80211_MESH
495 #define IEEE80211_IFSTA_MESH_CTR_INC(msh, name)	\
496 	do { (msh)->mshstats.name++; } while (0)
497 #else
498 #define IEEE80211_IFSTA_MESH_CTR_INC(msh, name) \
499 	do { } while (0)
500 #endif
501 
502 /**
503  * enum ieee80211_sub_if_data_flags - virtual interface flags
504  *
505  * @IEEE80211_SDATA_ALLMULTI: interface wants all multicast packets
506  * @IEEE80211_SDATA_PROMISC: interface is promisc
507  * @IEEE80211_SDATA_OPERATING_GMODE: operating in G-only mode
508  * @IEEE80211_SDATA_DONT_BRIDGE_PACKETS: bridge packets between
509  *	associated stations and deliver multicast frames both
510  *	back to wireless media and to the local net stack.
511  */
512 enum ieee80211_sub_if_data_flags {
513 	IEEE80211_SDATA_ALLMULTI		= BIT(0),
514 	IEEE80211_SDATA_PROMISC			= BIT(1),
515 	IEEE80211_SDATA_OPERATING_GMODE		= BIT(2),
516 	IEEE80211_SDATA_DONT_BRIDGE_PACKETS	= BIT(3),
517 };
518 
519 /**
520  * enum ieee80211_sdata_state_bits - virtual interface state bits
521  * @SDATA_STATE_RUNNING: virtual interface is up & running; this
522  *	mirrors netif_running() but is separate for interface type
523  *	change handling while the interface is up
524  * @SDATA_STATE_OFFCHANNEL: This interface is currently in offchannel
525  *	mode, so queues are stopped
526  */
527 enum ieee80211_sdata_state_bits {
528 	SDATA_STATE_RUNNING,
529 	SDATA_STATE_OFFCHANNEL,
530 };
531 
532 struct ieee80211_sub_if_data {
533 	struct list_head list;
534 
535 	struct wireless_dev wdev;
536 
537 	/* keys */
538 	struct list_head key_list;
539 
540 	struct net_device *dev;
541 	struct ieee80211_local *local;
542 
543 	unsigned int flags;
544 
545 	unsigned long state;
546 
547 	int drop_unencrypted;
548 
549 	char name[IFNAMSIZ];
550 
551 	/*
552 	 * keep track of whether the HT opmode (stored in
553 	 * vif.bss_info.ht_operation_mode) is valid.
554 	 */
555 	bool ht_opmode_valid;
556 
557 	/* to detect idle changes */
558 	bool old_idle;
559 
560 	/* Fragment table for host-based reassembly */
561 	struct ieee80211_fragment_entry	fragments[IEEE80211_FRAGMENT_MAX];
562 	unsigned int fragment_next;
563 
564 	struct ieee80211_key *keys[NUM_DEFAULT_KEYS + NUM_DEFAULT_MGMT_KEYS];
565 	struct ieee80211_key *default_unicast_key, *default_multicast_key;
566 	struct ieee80211_key *default_mgmt_key;
567 
568 	u16 sequence_number;
569 	__be16 control_port_protocol;
570 	bool control_port_no_encrypt;
571 
572 	struct work_struct work;
573 	struct sk_buff_head skb_queue;
574 
575 	bool arp_filter_state;
576 
577 	/*
578 	 * AP this belongs to: self in AP mode and
579 	 * corresponding AP in VLAN mode, NULL for
580 	 * all others (might be needed later in IBSS)
581 	 */
582 	struct ieee80211_if_ap *bss;
583 
584 	/* bitmap of allowed (non-MCS) rate indexes for rate control */
585 	u32 rc_rateidx_mask[IEEE80211_NUM_BANDS];
586 
587 	union {
588 		struct ieee80211_if_ap ap;
589 		struct ieee80211_if_wds wds;
590 		struct ieee80211_if_vlan vlan;
591 		struct ieee80211_if_managed mgd;
592 		struct ieee80211_if_ibss ibss;
593 		struct ieee80211_if_mesh mesh;
594 		u32 mntr_flags;
595 	} u;
596 
597 #ifdef CONFIG_MAC80211_DEBUGFS
598 	struct {
599 		struct dentry *dir;
600 		struct dentry *subdir_stations;
601 		struct dentry *default_unicast_key;
602 		struct dentry *default_multicast_key;
603 		struct dentry *default_mgmt_key;
604 	} debugfs;
605 #endif
606 	/* must be last, dynamically sized area in this! */
607 	struct ieee80211_vif vif;
608 };
609 
610 static inline
611 struct ieee80211_sub_if_data *vif_to_sdata(struct ieee80211_vif *p)
612 {
613 	return container_of(p, struct ieee80211_sub_if_data, vif);
614 }
615 
616 enum sdata_queue_type {
617 	IEEE80211_SDATA_QUEUE_TYPE_FRAME	= 0,
618 	IEEE80211_SDATA_QUEUE_AGG_START		= 1,
619 	IEEE80211_SDATA_QUEUE_AGG_STOP		= 2,
620 };
621 
622 enum {
623 	IEEE80211_RX_MSG	= 1,
624 	IEEE80211_TX_STATUS_MSG	= 2,
625 };
626 
627 enum queue_stop_reason {
628 	IEEE80211_QUEUE_STOP_REASON_DRIVER,
629 	IEEE80211_QUEUE_STOP_REASON_PS,
630 	IEEE80211_QUEUE_STOP_REASON_CSA,
631 	IEEE80211_QUEUE_STOP_REASON_AGGREGATION,
632 	IEEE80211_QUEUE_STOP_REASON_SUSPEND,
633 	IEEE80211_QUEUE_STOP_REASON_SKB_ADD,
634 };
635 
636 #ifdef CONFIG_MAC80211_LEDS
637 struct tpt_led_trigger {
638 	struct led_trigger trig;
639 	char name[32];
640 	const struct ieee80211_tpt_blink *blink_table;
641 	unsigned int blink_table_len;
642 	struct timer_list timer;
643 	unsigned long prev_traffic;
644 	unsigned long tx_bytes, rx_bytes;
645 	unsigned int active, want;
646 	bool running;
647 };
648 #endif
649 
650 /**
651  * mac80211 scan flags - currently active scan mode
652  *
653  * @SCAN_SW_SCANNING: We're currently in the process of scanning but may as
654  *	well be on the operating channel
655  * @SCAN_HW_SCANNING: The hardware is scanning for us, we have no way to
656  *	determine if we are on the operating channel or not
657  * @SCAN_OFF_CHANNEL: We're off our operating channel for scanning,
658  *	gets only set in conjunction with SCAN_SW_SCANNING
659  * @SCAN_COMPLETED: Set for our scan work function when the driver reported
660  *	that the scan completed.
661  * @SCAN_ABORTED: Set for our scan work function when the driver reported
662  *	a scan complete for an aborted scan.
663  */
664 enum {
665 	SCAN_SW_SCANNING,
666 	SCAN_HW_SCANNING,
667 	SCAN_OFF_CHANNEL,
668 	SCAN_COMPLETED,
669 	SCAN_ABORTED,
670 };
671 
672 /**
673  * enum mac80211_scan_state - scan state machine states
674  *
675  * @SCAN_DECISION: Main entry point to the scan state machine, this state
676  *	determines if we should keep on scanning or switch back to the
677  *	operating channel
678  * @SCAN_SET_CHANNEL: Set the next channel to be scanned
679  * @SCAN_SEND_PROBE: Send probe requests and wait for probe responses
680  * @SCAN_LEAVE_OPER_CHANNEL: Leave the operating channel, notify the AP
681  *	about us leaving the channel and stop all associated STA interfaces
682  * @SCAN_ENTER_OPER_CHANNEL: Enter the operating channel again, notify the
683  *	AP about us being back and restart all associated STA interfaces
684  */
685 enum mac80211_scan_state {
686 	SCAN_DECISION,
687 	SCAN_SET_CHANNEL,
688 	SCAN_SEND_PROBE,
689 	SCAN_LEAVE_OPER_CHANNEL,
690 	SCAN_ENTER_OPER_CHANNEL,
691 };
692 
693 struct ieee80211_local {
694 	/* embed the driver visible part.
695 	 * don't cast (use the static inlines below), but we keep
696 	 * it first anyway so they become a no-op */
697 	struct ieee80211_hw hw;
698 
699 	const struct ieee80211_ops *ops;
700 
701 	/*
702 	 * work stuff, potentially off-channel (in the future)
703 	 */
704 	struct list_head work_list;
705 	struct timer_list work_timer;
706 	struct work_struct work_work;
707 	struct sk_buff_head work_skb_queue;
708 
709 	/*
710 	 * private workqueue to mac80211. mac80211 makes this accessible
711 	 * via ieee80211_queue_work()
712 	 */
713 	struct workqueue_struct *workqueue;
714 
715 	unsigned long queue_stop_reasons[IEEE80211_MAX_QUEUES];
716 	/* also used to protect ampdu_ac_queue and amdpu_ac_stop_refcnt */
717 	spinlock_t queue_stop_reason_lock;
718 
719 	int open_count;
720 	int monitors, cooked_mntrs;
721 	/* number of interfaces with corresponding FIF_ flags */
722 	int fif_fcsfail, fif_plcpfail, fif_control, fif_other_bss, fif_pspoll,
723 	    fif_probe_req;
724 	int probe_req_reg;
725 	unsigned int filter_flags; /* FIF_* */
726 
727 	bool wiphy_ciphers_allocated;
728 
729 	/* protects the aggregated multicast list and filter calls */
730 	spinlock_t filter_lock;
731 
732 	/* used for uploading changed mc list */
733 	struct work_struct reconfig_filter;
734 
735 	/* used to reconfigure hardware SM PS */
736 	struct work_struct recalc_smps;
737 
738 	/* aggregated multicast list */
739 	struct netdev_hw_addr_list mc_list;
740 
741 	bool tim_in_locked_section; /* see ieee80211_beacon_get() */
742 
743 	/*
744 	 * suspended is true if we finished all the suspend _and_ we have
745 	 * not yet come up from resume. This is to be used by mac80211
746 	 * to ensure driver sanity during suspend and mac80211's own
747 	 * sanity. It can eventually be used for WoW as well.
748 	 */
749 	bool suspended;
750 
751 	/*
752 	 * Resuming is true while suspended, but when we're reprogramming the
753 	 * hardware -- at that time it's allowed to use ieee80211_queue_work()
754 	 * again even though some other parts of the stack are still suspended
755 	 * and we still drop received frames to avoid waking the stack.
756 	 */
757 	bool resuming;
758 
759 	/*
760 	 * quiescing is true during the suspend process _only_ to
761 	 * ease timer cancelling etc.
762 	 */
763 	bool quiescing;
764 
765 	/* device is started */
766 	bool started;
767 
768 	int tx_headroom; /* required headroom for hardware/radiotap */
769 
770 	/* Tasklet and skb queue to process calls from IRQ mode. All frames
771 	 * added to skb_queue will be processed, but frames in
772 	 * skb_queue_unreliable may be dropped if the total length of these
773 	 * queues increases over the limit. */
774 #define IEEE80211_IRQSAFE_QUEUE_LIMIT 128
775 	struct tasklet_struct tasklet;
776 	struct sk_buff_head skb_queue;
777 	struct sk_buff_head skb_queue_unreliable;
778 
779 	/*
780 	 * Internal FIFO queue which is shared between multiple rx path
781 	 * stages. Its main task is to provide a serialization mechanism,
782 	 * so all rx handlers can enjoy having exclusive access to their
783 	 * private data structures.
784 	 */
785 	struct sk_buff_head rx_skb_queue;
786 	bool running_rx_handler;	/* protected by rx_skb_queue.lock */
787 
788 	/* Station data */
789 	/*
790 	 * The mutex only protects the list and counter,
791 	 * reads are done in RCU.
792 	 * Additionally, the lock protects the hash table,
793 	 * the pending list and each BSS's TIM bitmap.
794 	 */
795 	struct mutex sta_mtx;
796 	spinlock_t sta_lock;
797 	unsigned long num_sta;
798 	struct list_head sta_list, sta_pending_list;
799 	struct sta_info *sta_hash[STA_HASH_SIZE];
800 	struct timer_list sta_cleanup;
801 	struct work_struct sta_finish_work;
802 	int sta_generation;
803 
804 	struct sk_buff_head pending[IEEE80211_MAX_QUEUES];
805 	struct tasklet_struct tx_pending_tasklet;
806 
807 	atomic_t agg_queue_stop[IEEE80211_MAX_QUEUES];
808 
809 	/* number of interfaces with corresponding IFF_ flags */
810 	atomic_t iff_allmultis, iff_promiscs;
811 
812 	struct rate_control_ref *rate_ctrl;
813 
814 	struct crypto_blkcipher *wep_tx_tfm;
815 	struct crypto_blkcipher *wep_rx_tfm;
816 	u32 wep_iv;
817 
818 	/* see iface.c */
819 	struct list_head interfaces;
820 	struct mutex iflist_mtx;
821 
822 	/*
823 	 * Key mutex, protects sdata's key_list and sta_info's
824 	 * key pointers (write access, they're RCU.)
825 	 */
826 	struct mutex key_mtx;
827 
828 	/* mutex for scan and work locking */
829 	struct mutex mtx;
830 
831 	/* Scanning and BSS list */
832 	unsigned long scanning;
833 	struct cfg80211_ssid scan_ssid;
834 	struct cfg80211_scan_request *int_scan_req;
835 	struct cfg80211_scan_request *scan_req, *hw_scan_req;
836 	struct ieee80211_channel *scan_channel;
837 	enum ieee80211_band hw_scan_band;
838 	int scan_channel_idx;
839 	int scan_ies_len;
840 
841 	unsigned long leave_oper_channel_time;
842 	enum mac80211_scan_state next_scan_state;
843 	struct delayed_work scan_work;
844 	struct ieee80211_sub_if_data *scan_sdata;
845 	enum nl80211_channel_type _oper_channel_type;
846 	struct ieee80211_channel *oper_channel, *csa_channel;
847 
848 	/* Temporary remain-on-channel for off-channel operations */
849 	struct ieee80211_channel *tmp_channel;
850 	enum nl80211_channel_type tmp_channel_type;
851 
852 	/* SNMP counters */
853 	/* dot11CountersTable */
854 	u32 dot11TransmittedFragmentCount;
855 	u32 dot11MulticastTransmittedFrameCount;
856 	u32 dot11FailedCount;
857 	u32 dot11RetryCount;
858 	u32 dot11MultipleRetryCount;
859 	u32 dot11FrameDuplicateCount;
860 	u32 dot11ReceivedFragmentCount;
861 	u32 dot11MulticastReceivedFrameCount;
862 	u32 dot11TransmittedFrameCount;
863 
864 #ifdef CONFIG_MAC80211_LEDS
865 	int tx_led_counter, rx_led_counter;
866 	struct led_trigger *tx_led, *rx_led, *assoc_led, *radio_led;
867 	struct tpt_led_trigger *tpt_led_trigger;
868 	char tx_led_name[32], rx_led_name[32],
869 	     assoc_led_name[32], radio_led_name[32];
870 #endif
871 
872 #ifdef CONFIG_MAC80211_DEBUG_COUNTERS
873 	/* TX/RX handler statistics */
874 	unsigned int tx_handlers_drop;
875 	unsigned int tx_handlers_queued;
876 	unsigned int tx_handlers_drop_unencrypted;
877 	unsigned int tx_handlers_drop_fragment;
878 	unsigned int tx_handlers_drop_wep;
879 	unsigned int tx_handlers_drop_not_assoc;
880 	unsigned int tx_handlers_drop_unauth_port;
881 	unsigned int rx_handlers_drop;
882 	unsigned int rx_handlers_queued;
883 	unsigned int rx_handlers_drop_nullfunc;
884 	unsigned int rx_handlers_drop_defrag;
885 	unsigned int rx_handlers_drop_short;
886 	unsigned int rx_handlers_drop_passive_scan;
887 	unsigned int tx_expand_skb_head;
888 	unsigned int tx_expand_skb_head_cloned;
889 	unsigned int rx_expand_skb_head;
890 	unsigned int rx_expand_skb_head2;
891 	unsigned int rx_handlers_fragments;
892 	unsigned int tx_status_drop;
893 #define I802_DEBUG_INC(c) (c)++
894 #else /* CONFIG_MAC80211_DEBUG_COUNTERS */
895 #define I802_DEBUG_INC(c) do { } while (0)
896 #endif /* CONFIG_MAC80211_DEBUG_COUNTERS */
897 
898 
899 	int total_ps_buffered; /* total number of all buffered unicast and
900 				* multicast packets for power saving stations
901 				*/
902 	int wifi_wme_noack_test;
903 	unsigned int wmm_acm; /* bit field of ACM bits (BIT(802.1D tag)) */
904 
905 	/*
906 	 * Bitmask of enabled u-apsd queues,
907 	 * IEEE80211_WMM_IE_STA_QOSINFO_AC_BE & co. Needs a new association
908 	 * to take effect.
909 	 */
910 	unsigned int uapsd_queues;
911 
912 	/*
913 	 * Maximum number of buffered frames AP can deliver during a
914 	 * service period, IEEE80211_WMM_IE_STA_QOSINFO_SP_ALL or similar.
915 	 * Needs a new association to take effect.
916 	 */
917 	unsigned int uapsd_max_sp_len;
918 
919 	bool pspolling;
920 	bool offchannel_ps_enabled;
921 	/*
922 	 * PS can only be enabled when we have exactly one managed
923 	 * interface (and monitors) in PS, this then points there.
924 	 */
925 	struct ieee80211_sub_if_data *ps_sdata;
926 	struct work_struct dynamic_ps_enable_work;
927 	struct work_struct dynamic_ps_disable_work;
928 	struct timer_list dynamic_ps_timer;
929 	struct notifier_block network_latency_notifier;
930 	struct notifier_block ifa_notifier;
931 
932 	/*
933 	 * The dynamic ps timeout configured from user space via WEXT -
934 	 * this will override whatever chosen by mac80211 internally.
935 	 */
936 	int dynamic_ps_forced_timeout;
937 	int dynamic_ps_user_timeout;
938 	bool disable_dynamic_ps;
939 
940 	int user_power_level; /* in dBm */
941 	int power_constr_level; /* in dBm */
942 
943 	enum ieee80211_smps_mode smps_mode;
944 
945 	struct work_struct restart_work;
946 
947 #ifdef CONFIG_MAC80211_DEBUGFS
948 	struct local_debugfsdentries {
949 		struct dentry *rcdir;
950 		struct dentry *keys;
951 	} debugfs;
952 #endif
953 
954 	struct ieee80211_channel *hw_roc_channel;
955 	struct net_device *hw_roc_dev;
956 	struct sk_buff *hw_roc_skb, *hw_roc_skb_for_status;
957 	struct work_struct hw_roc_start, hw_roc_done;
958 	enum nl80211_channel_type hw_roc_channel_type;
959 	unsigned int hw_roc_duration;
960 	u32 hw_roc_cookie;
961 	bool hw_roc_for_tx;
962 
963 	/* dummy netdev for use w/ NAPI */
964 	struct net_device napi_dev;
965 
966 	struct napi_struct napi;
967 };
968 
969 static inline struct ieee80211_sub_if_data *
970 IEEE80211_DEV_TO_SUB_IF(struct net_device *dev)
971 {
972 	return netdev_priv(dev);
973 }
974 
975 /* this struct represents 802.11n's RA/TID combination */
976 struct ieee80211_ra_tid {
977 	u8 ra[ETH_ALEN];
978 	u16 tid;
979 };
980 
981 /* Parsed Information Elements */
982 struct ieee802_11_elems {
983 	u8 *ie_start;
984 	size_t total_len;
985 
986 	/* pointers to IEs */
987 	u8 *ssid;
988 	u8 *supp_rates;
989 	u8 *fh_params;
990 	u8 *ds_params;
991 	u8 *cf_params;
992 	struct ieee80211_tim_ie *tim;
993 	u8 *ibss_params;
994 	u8 *challenge;
995 	u8 *wpa;
996 	u8 *rsn;
997 	u8 *erp_info;
998 	u8 *ext_supp_rates;
999 	u8 *wmm_info;
1000 	u8 *wmm_param;
1001 	struct ieee80211_ht_cap *ht_cap_elem;
1002 	struct ieee80211_ht_info *ht_info_elem;
1003 	struct ieee80211_meshconf_ie *mesh_config;
1004 	u8 *mesh_id;
1005 	u8 *peer_link;
1006 	u8 *preq;
1007 	u8 *prep;
1008 	u8 *perr;
1009 	struct ieee80211_rann_ie *rann;
1010 	u8 *ch_switch_elem;
1011 	u8 *country_elem;
1012 	u8 *pwr_constr_elem;
1013 	u8 *quiet_elem; 	/* first quite element */
1014 	u8 *timeout_int;
1015 
1016 	/* length of them, respectively */
1017 	u8 ssid_len;
1018 	u8 supp_rates_len;
1019 	u8 fh_params_len;
1020 	u8 ds_params_len;
1021 	u8 cf_params_len;
1022 	u8 tim_len;
1023 	u8 ibss_params_len;
1024 	u8 challenge_len;
1025 	u8 wpa_len;
1026 	u8 rsn_len;
1027 	u8 erp_info_len;
1028 	u8 ext_supp_rates_len;
1029 	u8 wmm_info_len;
1030 	u8 wmm_param_len;
1031 	u8 mesh_id_len;
1032 	u8 peer_link_len;
1033 	u8 preq_len;
1034 	u8 prep_len;
1035 	u8 perr_len;
1036 	u8 ch_switch_elem_len;
1037 	u8 country_elem_len;
1038 	u8 pwr_constr_elem_len;
1039 	u8 quiet_elem_len;
1040 	u8 num_of_quiet_elem;	/* can be more the one */
1041 	u8 timeout_int_len;
1042 };
1043 
1044 static inline struct ieee80211_local *hw_to_local(
1045 	struct ieee80211_hw *hw)
1046 {
1047 	return container_of(hw, struct ieee80211_local, hw);
1048 }
1049 
1050 static inline struct ieee80211_hw *local_to_hw(
1051 	struct ieee80211_local *local)
1052 {
1053 	return &local->hw;
1054 }
1055 
1056 
1057 static inline int ieee80211_bssid_match(const u8 *raddr, const u8 *addr)
1058 {
1059 	return compare_ether_addr(raddr, addr) == 0 ||
1060 	       is_broadcast_ether_addr(raddr);
1061 }
1062 
1063 
1064 int ieee80211_hw_config(struct ieee80211_local *local, u32 changed);
1065 void ieee80211_tx_set_protected(struct ieee80211_tx_data *tx);
1066 void ieee80211_bss_info_change_notify(struct ieee80211_sub_if_data *sdata,
1067 				      u32 changed);
1068 void ieee80211_configure_filter(struct ieee80211_local *local);
1069 u32 ieee80211_reset_erp_info(struct ieee80211_sub_if_data *sdata);
1070 
1071 extern bool ieee80211_disable_40mhz_24ghz;
1072 
1073 /* STA code */
1074 void ieee80211_sta_setup_sdata(struct ieee80211_sub_if_data *sdata);
1075 int ieee80211_mgd_auth(struct ieee80211_sub_if_data *sdata,
1076 		       struct cfg80211_auth_request *req);
1077 int ieee80211_mgd_assoc(struct ieee80211_sub_if_data *sdata,
1078 			struct cfg80211_assoc_request *req);
1079 int ieee80211_mgd_deauth(struct ieee80211_sub_if_data *sdata,
1080 			 struct cfg80211_deauth_request *req,
1081 			 void *cookie);
1082 int ieee80211_mgd_disassoc(struct ieee80211_sub_if_data *sdata,
1083 			   struct cfg80211_disassoc_request *req,
1084 			   void *cookie);
1085 void ieee80211_send_pspoll(struct ieee80211_local *local,
1086 			   struct ieee80211_sub_if_data *sdata);
1087 void ieee80211_recalc_ps(struct ieee80211_local *local, s32 latency);
1088 int ieee80211_max_network_latency(struct notifier_block *nb,
1089 				  unsigned long data, void *dummy);
1090 int ieee80211_set_arp_filter(struct ieee80211_sub_if_data *sdata);
1091 void ieee80211_sta_process_chanswitch(struct ieee80211_sub_if_data *sdata,
1092 				      struct ieee80211_channel_sw_ie *sw_elem,
1093 				      struct ieee80211_bss *bss,
1094 				      u64 timestamp);
1095 void ieee80211_sta_quiesce(struct ieee80211_sub_if_data *sdata);
1096 void ieee80211_sta_restart(struct ieee80211_sub_if_data *sdata);
1097 void ieee80211_sta_work(struct ieee80211_sub_if_data *sdata);
1098 void ieee80211_sta_rx_queued_mgmt(struct ieee80211_sub_if_data *sdata,
1099 				  struct sk_buff *skb);
1100 void ieee80211_sta_reset_beacon_monitor(struct ieee80211_sub_if_data *sdata);
1101 void ieee80211_sta_reset_conn_monitor(struct ieee80211_sub_if_data *sdata);
1102 
1103 /* IBSS code */
1104 void ieee80211_ibss_notify_scan_completed(struct ieee80211_local *local);
1105 void ieee80211_ibss_setup_sdata(struct ieee80211_sub_if_data *sdata);
1106 struct sta_info *ieee80211_ibss_add_sta(struct ieee80211_sub_if_data *sdata,
1107 					u8 *bssid, u8 *addr, u32 supp_rates,
1108 					gfp_t gfp);
1109 int ieee80211_ibss_join(struct ieee80211_sub_if_data *sdata,
1110 			struct cfg80211_ibss_params *params);
1111 int ieee80211_ibss_leave(struct ieee80211_sub_if_data *sdata);
1112 void ieee80211_ibss_quiesce(struct ieee80211_sub_if_data *sdata);
1113 void ieee80211_ibss_restart(struct ieee80211_sub_if_data *sdata);
1114 void ieee80211_ibss_work(struct ieee80211_sub_if_data *sdata);
1115 void ieee80211_ibss_rx_queued_mgmt(struct ieee80211_sub_if_data *sdata,
1116 				   struct sk_buff *skb);
1117 
1118 /* mesh code */
1119 void ieee80211_mesh_work(struct ieee80211_sub_if_data *sdata);
1120 void ieee80211_mesh_rx_queued_mgmt(struct ieee80211_sub_if_data *sdata,
1121 				   struct sk_buff *skb);
1122 
1123 /* scan/BSS handling */
1124 void ieee80211_scan_work(struct work_struct *work);
1125 int ieee80211_request_internal_scan(struct ieee80211_sub_if_data *sdata,
1126 				    const u8 *ssid, u8 ssid_len,
1127 				    struct ieee80211_channel *chan);
1128 int ieee80211_request_scan(struct ieee80211_sub_if_data *sdata,
1129 			   struct cfg80211_scan_request *req);
1130 void ieee80211_scan_cancel(struct ieee80211_local *local);
1131 ieee80211_rx_result
1132 ieee80211_scan_rx(struct ieee80211_sub_if_data *sdata, struct sk_buff *skb);
1133 
1134 void ieee80211_mlme_notify_scan_completed(struct ieee80211_local *local);
1135 struct ieee80211_bss *
1136 ieee80211_bss_info_update(struct ieee80211_local *local,
1137 			  struct ieee80211_rx_status *rx_status,
1138 			  struct ieee80211_mgmt *mgmt,
1139 			  size_t len,
1140 			  struct ieee802_11_elems *elems,
1141 			  struct ieee80211_channel *channel,
1142 			  bool beacon);
1143 struct ieee80211_bss *
1144 ieee80211_rx_bss_get(struct ieee80211_local *local, u8 *bssid, int freq,
1145 		     u8 *ssid, u8 ssid_len);
1146 void ieee80211_rx_bss_put(struct ieee80211_local *local,
1147 			  struct ieee80211_bss *bss);
1148 
1149 /* off-channel helpers */
1150 void ieee80211_offchannel_stop_beaconing(struct ieee80211_local *local);
1151 void ieee80211_offchannel_stop_station(struct ieee80211_local *local);
1152 void ieee80211_offchannel_return(struct ieee80211_local *local,
1153 				 bool enable_beaconing);
1154 void ieee80211_hw_roc_setup(struct ieee80211_local *local);
1155 
1156 /* interface handling */
1157 int ieee80211_iface_init(void);
1158 void ieee80211_iface_exit(void);
1159 int ieee80211_if_add(struct ieee80211_local *local, const char *name,
1160 		     struct net_device **new_dev, enum nl80211_iftype type,
1161 		     struct vif_params *params);
1162 int ieee80211_if_change_type(struct ieee80211_sub_if_data *sdata,
1163 			     enum nl80211_iftype type);
1164 void ieee80211_if_remove(struct ieee80211_sub_if_data *sdata);
1165 void ieee80211_remove_interfaces(struct ieee80211_local *local);
1166 u32 __ieee80211_recalc_idle(struct ieee80211_local *local);
1167 void ieee80211_recalc_idle(struct ieee80211_local *local);
1168 void ieee80211_adjust_monitor_flags(struct ieee80211_sub_if_data *sdata,
1169 				    const int offset);
1170 
1171 static inline bool ieee80211_sdata_running(struct ieee80211_sub_if_data *sdata)
1172 {
1173 	return test_bit(SDATA_STATE_RUNNING, &sdata->state);
1174 }
1175 
1176 /* tx handling */
1177 void ieee80211_clear_tx_pending(struct ieee80211_local *local);
1178 void ieee80211_tx_pending(unsigned long data);
1179 netdev_tx_t ieee80211_monitor_start_xmit(struct sk_buff *skb,
1180 					 struct net_device *dev);
1181 netdev_tx_t ieee80211_subif_start_xmit(struct sk_buff *skb,
1182 				       struct net_device *dev);
1183 
1184 /*
1185  * radiotap header for status frames
1186  */
1187 struct ieee80211_tx_status_rtap_hdr {
1188 	struct ieee80211_radiotap_header hdr;
1189 	u8 rate;
1190 	u8 padding_for_rate;
1191 	__le16 tx_flags;
1192 	u8 data_retries;
1193 } __packed;
1194 
1195 
1196 /* HT */
1197 void ieee80211_ht_cap_ie_to_sta_ht_cap(struct ieee80211_supported_band *sband,
1198 				       struct ieee80211_ht_cap *ht_cap_ie,
1199 				       struct ieee80211_sta_ht_cap *ht_cap);
1200 void ieee80211_send_bar(struct ieee80211_sub_if_data *sdata, u8 *ra, u16 tid, u16 ssn);
1201 void ieee80211_send_delba(struct ieee80211_sub_if_data *sdata,
1202 			  const u8 *da, u16 tid,
1203 			  u16 initiator, u16 reason_code);
1204 int ieee80211_send_smps_action(struct ieee80211_sub_if_data *sdata,
1205 			       enum ieee80211_smps_mode smps, const u8 *da,
1206 			       const u8 *bssid);
1207 void ieee80211_request_smps_work(struct work_struct *work);
1208 
1209 void ___ieee80211_stop_rx_ba_session(struct sta_info *sta, u16 tid,
1210 				     u16 initiator, u16 reason, bool stop);
1211 void __ieee80211_stop_rx_ba_session(struct sta_info *sta, u16 tid,
1212 				    u16 initiator, u16 reason, bool stop);
1213 void ieee80211_sta_tear_down_BA_sessions(struct sta_info *sta, bool tx);
1214 void ieee80211_process_delba(struct ieee80211_sub_if_data *sdata,
1215 			     struct sta_info *sta,
1216 			     struct ieee80211_mgmt *mgmt, size_t len);
1217 void ieee80211_process_addba_resp(struct ieee80211_local *local,
1218 				  struct sta_info *sta,
1219 				  struct ieee80211_mgmt *mgmt,
1220 				  size_t len);
1221 void ieee80211_process_addba_request(struct ieee80211_local *local,
1222 				     struct sta_info *sta,
1223 				     struct ieee80211_mgmt *mgmt,
1224 				     size_t len);
1225 
1226 int __ieee80211_stop_tx_ba_session(struct sta_info *sta, u16 tid,
1227 				   enum ieee80211_back_parties initiator,
1228 				   bool tx);
1229 int ___ieee80211_stop_tx_ba_session(struct sta_info *sta, u16 tid,
1230 				    enum ieee80211_back_parties initiator,
1231 				    bool tx);
1232 void ieee80211_start_tx_ba_cb(struct ieee80211_vif *vif, u8 *ra, u16 tid);
1233 void ieee80211_stop_tx_ba_cb(struct ieee80211_vif *vif, u8 *ra, u8 tid);
1234 void ieee80211_ba_session_work(struct work_struct *work);
1235 void ieee80211_tx_ba_session_handle_start(struct sta_info *sta, int tid);
1236 void ieee80211_release_reorder_timeout(struct sta_info *sta, int tid);
1237 
1238 /* Spectrum management */
1239 void ieee80211_process_measurement_req(struct ieee80211_sub_if_data *sdata,
1240 				       struct ieee80211_mgmt *mgmt,
1241 				       size_t len);
1242 
1243 /* Suspend/resume and hw reconfiguration */
1244 int ieee80211_reconfig(struct ieee80211_local *local);
1245 void ieee80211_stop_device(struct ieee80211_local *local);
1246 
1247 #ifdef CONFIG_PM
1248 int __ieee80211_suspend(struct ieee80211_hw *hw);
1249 
1250 static inline int __ieee80211_resume(struct ieee80211_hw *hw)
1251 {
1252 	struct ieee80211_local *local = hw_to_local(hw);
1253 
1254 	WARN(test_bit(SCAN_HW_SCANNING, &local->scanning),
1255 		"%s: resume with hardware scan still in progress\n",
1256 		wiphy_name(hw->wiphy));
1257 
1258 	return ieee80211_reconfig(hw_to_local(hw));
1259 }
1260 #else
1261 static inline int __ieee80211_suspend(struct ieee80211_hw *hw)
1262 {
1263 	return 0;
1264 }
1265 
1266 static inline int __ieee80211_resume(struct ieee80211_hw *hw)
1267 {
1268 	return 0;
1269 }
1270 #endif
1271 
1272 /* utility functions/constants */
1273 extern void *mac80211_wiphy_privid; /* for wiphy privid */
1274 u8 *ieee80211_get_bssid(struct ieee80211_hdr *hdr, size_t len,
1275 			enum nl80211_iftype type);
1276 int ieee80211_frame_duration(struct ieee80211_local *local, size_t len,
1277 			     int rate, int erp, int short_preamble);
1278 void mac80211_ev_michael_mic_failure(struct ieee80211_sub_if_data *sdata, int keyidx,
1279 				     struct ieee80211_hdr *hdr, const u8 *tsc,
1280 				     gfp_t gfp);
1281 void ieee80211_set_wmm_default(struct ieee80211_sub_if_data *sdata);
1282 void ieee80211_tx_skb(struct ieee80211_sub_if_data *sdata, struct sk_buff *skb);
1283 void ieee802_11_parse_elems(u8 *start, size_t len,
1284 			    struct ieee802_11_elems *elems);
1285 u32 ieee802_11_parse_elems_crc(u8 *start, size_t len,
1286 			       struct ieee802_11_elems *elems,
1287 			       u64 filter, u32 crc);
1288 u32 ieee80211_mandatory_rates(struct ieee80211_local *local,
1289 			      enum ieee80211_band band);
1290 
1291 void ieee80211_dynamic_ps_enable_work(struct work_struct *work);
1292 void ieee80211_dynamic_ps_disable_work(struct work_struct *work);
1293 void ieee80211_dynamic_ps_timer(unsigned long data);
1294 void ieee80211_send_nullfunc(struct ieee80211_local *local,
1295 			     struct ieee80211_sub_if_data *sdata,
1296 			     int powersave);
1297 void ieee80211_sta_rx_notify(struct ieee80211_sub_if_data *sdata,
1298 			     struct ieee80211_hdr *hdr);
1299 void ieee80211_sta_tx_notify(struct ieee80211_sub_if_data *sdata,
1300 			     struct ieee80211_hdr *hdr, bool ack);
1301 void ieee80211_beacon_connection_loss_work(struct work_struct *work);
1302 
1303 void ieee80211_wake_queues_by_reason(struct ieee80211_hw *hw,
1304 				     enum queue_stop_reason reason);
1305 void ieee80211_stop_queues_by_reason(struct ieee80211_hw *hw,
1306 				     enum queue_stop_reason reason);
1307 void ieee80211_wake_queue_by_reason(struct ieee80211_hw *hw, int queue,
1308 				    enum queue_stop_reason reason);
1309 void ieee80211_stop_queue_by_reason(struct ieee80211_hw *hw, int queue,
1310 				    enum queue_stop_reason reason);
1311 void ieee80211_add_pending_skb(struct ieee80211_local *local,
1312 			       struct sk_buff *skb);
1313 int ieee80211_add_pending_skbs(struct ieee80211_local *local,
1314 			       struct sk_buff_head *skbs);
1315 int ieee80211_add_pending_skbs_fn(struct ieee80211_local *local,
1316 				  struct sk_buff_head *skbs,
1317 				  void (*fn)(void *data), void *data);
1318 
1319 void ieee80211_send_auth(struct ieee80211_sub_if_data *sdata,
1320 			 u16 transaction, u16 auth_alg,
1321 			 u8 *extra, size_t extra_len, const u8 *bssid,
1322 			 const u8 *key, u8 key_len, u8 key_idx);
1323 int ieee80211_build_preq_ies(struct ieee80211_local *local, u8 *buffer,
1324 			     const u8 *ie, size_t ie_len,
1325 			     enum ieee80211_band band, u32 rate_mask,
1326 			     u8 channel);
1327 struct sk_buff *ieee80211_build_probe_req(struct ieee80211_sub_if_data *sdata,
1328 					  u8 *dst,
1329 					  const u8 *ssid, size_t ssid_len,
1330 					  const u8 *ie, size_t ie_len);
1331 void ieee80211_send_probe_req(struct ieee80211_sub_if_data *sdata, u8 *dst,
1332 			      const u8 *ssid, size_t ssid_len,
1333 			      const u8 *ie, size_t ie_len);
1334 
1335 void ieee80211_sta_def_wmm_params(struct ieee80211_sub_if_data *sdata,
1336 				  const size_t supp_rates_len,
1337 				  const u8 *supp_rates);
1338 u32 ieee80211_sta_get_rates(struct ieee80211_local *local,
1339 			    struct ieee802_11_elems *elems,
1340 			    enum ieee80211_band band);
1341 int __ieee80211_request_smps(struct ieee80211_sub_if_data *sdata,
1342 			     enum ieee80211_smps_mode smps_mode);
1343 void ieee80211_recalc_smps(struct ieee80211_local *local);
1344 
1345 size_t ieee80211_ie_split(const u8 *ies, size_t ielen,
1346 			  const u8 *ids, int n_ids, size_t offset);
1347 size_t ieee80211_ie_split_vendor(const u8 *ies, size_t ielen, size_t offset);
1348 
1349 /* internal work items */
1350 void ieee80211_work_init(struct ieee80211_local *local);
1351 void ieee80211_add_work(struct ieee80211_work *wk);
1352 void free_work(struct ieee80211_work *wk);
1353 void ieee80211_work_purge(struct ieee80211_sub_if_data *sdata);
1354 ieee80211_rx_result ieee80211_work_rx_mgmt(struct ieee80211_sub_if_data *sdata,
1355 					   struct sk_buff *skb);
1356 int ieee80211_wk_remain_on_channel(struct ieee80211_sub_if_data *sdata,
1357 				   struct ieee80211_channel *chan,
1358 				   enum nl80211_channel_type channel_type,
1359 				   unsigned int duration, u64 *cookie);
1360 int ieee80211_wk_cancel_remain_on_channel(
1361 	struct ieee80211_sub_if_data *sdata, u64 cookie);
1362 
1363 /* channel management */
1364 enum ieee80211_chan_mode {
1365 	CHAN_MODE_UNDEFINED,
1366 	CHAN_MODE_HOPPING,
1367 	CHAN_MODE_FIXED,
1368 };
1369 
1370 enum ieee80211_chan_mode
1371 ieee80211_get_channel_mode(struct ieee80211_local *local,
1372 			   struct ieee80211_sub_if_data *ignore);
1373 bool ieee80211_set_channel_type(struct ieee80211_local *local,
1374 				struct ieee80211_sub_if_data *sdata,
1375 				enum nl80211_channel_type chantype);
1376 
1377 #ifdef CONFIG_MAC80211_NOINLINE
1378 #define debug_noinline noinline
1379 #else
1380 #define debug_noinline
1381 #endif
1382 
1383 #endif /* IEEE80211_I_H */
1384