Linux Audio

Check our new training course

Loading...
v5.14.15
   1/* SPDX-License-Identifier: GPL-2.0-only */
   2/*
   3 * Copyright 2002-2005, Instant802 Networks, Inc.
   4 * Copyright 2005, Devicescape Software, Inc.
   5 * Copyright 2006-2007	Jiri Benc <jbenc@suse.cz>
   6 * Copyright 2007-2010	Johannes Berg <johannes@sipsolutions.net>
   7 * Copyright 2013-2015  Intel Mobile Communications GmbH
   8 * Copyright (C) 2018-2021 Intel Corporation
   9 */
  10
  11#ifndef IEEE80211_I_H
  12#define IEEE80211_I_H
  13
  14#include <linux/kernel.h>
  15#include <linux/device.h>
  16#include <linux/if_ether.h>
  17#include <linux/interrupt.h>
  18#include <linux/list.h>
  19#include <linux/netdevice.h>
  20#include <linux/skbuff.h>
  21#include <linux/workqueue.h>
  22#include <linux/types.h>
  23#include <linux/spinlock.h>
  24#include <linux/etherdevice.h>
  25#include <linux/leds.h>
  26#include <linux/idr.h>
  27#include <linux/rhashtable.h>
  28#include <net/ieee80211_radiotap.h>
  29#include <net/cfg80211.h>
  30#include <net/mac80211.h>
  31#include <net/fq.h>
  32#include "key.h"
  33#include "sta_info.h"
  34#include "debug.h"
  35
  36extern const struct cfg80211_ops mac80211_config_ops;
  37
  38struct ieee80211_local;
  39
  40/* Maximum number of broadcast/multicast frames to buffer when some of the
  41 * associated stations are using power saving. */
  42#define AP_MAX_BC_BUFFER 128
  43
  44/* Maximum number of frames buffered to all STAs, including multicast frames.
  45 * Note: increasing this limit increases the potential memory requirement. Each
  46 * frame can be up to about 2 kB long. */
  47#define TOTAL_MAX_TX_BUFFER 512
  48
  49/* Required encryption head and tailroom */
  50#define IEEE80211_ENCRYPT_HEADROOM 8
  51#define IEEE80211_ENCRYPT_TAILROOM 18
  52
 
 
 
 
 
 
  53/* power level hasn't been configured (or set to automatic) */
  54#define IEEE80211_UNSET_POWER_LEVEL	INT_MIN
  55
  56/*
  57 * Some APs experience problems when working with U-APSD. Decreasing the
  58 * probability of that happening by using legacy mode for all ACs but VO isn't
  59 * enough.
  60 *
  61 * Cisco 4410N originally forced us to enable VO by default only because it
  62 * treated non-VO ACs as legacy.
  63 *
  64 * However some APs (notably Netgear R7000) silently reclassify packets to
  65 * different ACs. Since u-APSD ACs require trigger frames for frame retrieval
  66 * clients would never see some frames (e.g. ARP responses) or would fetch them
  67 * accidentally after a long time.
  68 *
  69 * It makes little sense to enable u-APSD queues by default because it needs
  70 * userspace applications to be aware of it to actually take advantage of the
  71 * possible additional powersavings. Implicitly depending on driver autotrigger
  72 * frame support doesn't make much sense.
  73 */
  74#define IEEE80211_DEFAULT_UAPSD_QUEUES 0
  75
  76#define IEEE80211_DEFAULT_MAX_SP_LEN		\
  77	IEEE80211_WMM_IE_STA_QOSINFO_SP_ALL
  78
  79extern const u8 ieee80211_ac_to_qos_mask[IEEE80211_NUM_ACS];
  80
  81#define IEEE80211_DEAUTH_FRAME_LEN	(24 /* hdr */ + 2 /* reason */)
  82
  83#define IEEE80211_MAX_NAN_INSTANCE_ID 255
  84
 
 
 
 
 
 
 
 
 
 
 
 
  85struct ieee80211_bss {
  86	u32 device_ts_beacon, device_ts_presp;
  87
  88	bool wmm_used;
  89	bool uapsd_supported;
  90
  91#define IEEE80211_MAX_SUPP_RATES 32
  92	u8 supp_rates[IEEE80211_MAX_SUPP_RATES];
  93	size_t supp_rates_len;
  94	struct ieee80211_rate *beacon_rate;
  95
  96	u32 vht_cap_info;
  97
  98	/*
  99	 * During association, we save an ERP value from a probe response so
 100	 * that we can feed ERP info to the driver when handling the
 101	 * association completes. these fields probably won't be up-to-date
 102	 * otherwise, you probably don't want to use them.
 103	 */
 104	bool has_erp_value;
 105	u8 erp_value;
 106
 107	/* Keep track of the corruption of the last beacon/probe response. */
 108	u8 corrupt_data;
 109
 110	/* Keep track of what bits of information we have valid info for. */
 111	u8 valid_data;
 112};
 113
 114/**
 115 * enum ieee80211_corrupt_data_flags - BSS data corruption flags
 116 * @IEEE80211_BSS_CORRUPT_BEACON: last beacon frame received was corrupted
 117 * @IEEE80211_BSS_CORRUPT_PROBE_RESP: last probe response received was corrupted
 118 *
 119 * These are bss flags that are attached to a bss in the
 120 * @corrupt_data field of &struct ieee80211_bss.
 121 */
 122enum ieee80211_bss_corrupt_data_flags {
 123	IEEE80211_BSS_CORRUPT_BEACON		= BIT(0),
 124	IEEE80211_BSS_CORRUPT_PROBE_RESP	= BIT(1)
 125};
 126
 127/**
 128 * enum ieee80211_valid_data_flags - BSS valid data flags
 129 * @IEEE80211_BSS_VALID_WMM: WMM/UAPSD data was gathered from non-corrupt IE
 130 * @IEEE80211_BSS_VALID_RATES: Supported rates were gathered from non-corrupt IE
 131 * @IEEE80211_BSS_VALID_ERP: ERP flag was gathered from non-corrupt IE
 132 *
 133 * These are bss flags that are attached to a bss in the
 134 * @valid_data field of &struct ieee80211_bss.  They show which parts
 135 * of the data structure were received as a result of an un-corrupted
 136 * beacon/probe response.
 137 */
 138enum ieee80211_bss_valid_data_flags {
 139	IEEE80211_BSS_VALID_WMM			= BIT(1),
 140	IEEE80211_BSS_VALID_RATES		= BIT(2),
 141	IEEE80211_BSS_VALID_ERP			= BIT(3)
 142};
 143
 144typedef unsigned __bitwise ieee80211_tx_result;
 145#define TX_CONTINUE	((__force ieee80211_tx_result) 0u)
 146#define TX_DROP		((__force ieee80211_tx_result) 1u)
 147#define TX_QUEUED	((__force ieee80211_tx_result) 2u)
 148
 149#define IEEE80211_TX_UNICAST		BIT(1)
 150#define IEEE80211_TX_PS_BUFFERED	BIT(2)
 151
 152struct ieee80211_tx_data {
 153	struct sk_buff *skb;
 154	struct sk_buff_head skbs;
 155	struct ieee80211_local *local;
 156	struct ieee80211_sub_if_data *sdata;
 157	struct sta_info *sta;
 158	struct ieee80211_key *key;
 159	struct ieee80211_tx_rate rate;
 160
 161	unsigned int flags;
 162};
 163
 164
 165typedef unsigned __bitwise ieee80211_rx_result;
 166#define RX_CONTINUE		((__force ieee80211_rx_result) 0u)
 167#define RX_DROP_UNUSABLE	((__force ieee80211_rx_result) 1u)
 168#define RX_DROP_MONITOR		((__force ieee80211_rx_result) 2u)
 169#define RX_QUEUED		((__force ieee80211_rx_result) 3u)
 170
 171/**
 172 * enum ieee80211_packet_rx_flags - packet RX flags
 173 * @IEEE80211_RX_AMSDU: a-MSDU packet
 174 * @IEEE80211_RX_MALFORMED_ACTION_FRM: action frame is malformed
 175 * @IEEE80211_RX_DEFERRED_RELEASE: frame was subjected to receive reordering
 176 *
 177 * These are per-frame flags that are attached to a frame in the
 178 * @rx_flags field of &struct ieee80211_rx_status.
 179 */
 180enum ieee80211_packet_rx_flags {
 181	IEEE80211_RX_AMSDU			= BIT(3),
 182	IEEE80211_RX_MALFORMED_ACTION_FRM	= BIT(4),
 183	IEEE80211_RX_DEFERRED_RELEASE		= BIT(5),
 184};
 185
 186/**
 187 * enum ieee80211_rx_flags - RX data flags
 188 *
 189 * @IEEE80211_RX_CMNTR: received on cooked monitor already
 190 * @IEEE80211_RX_BEACON_REPORTED: This frame was already reported
 191 *	to cfg80211_report_obss_beacon().
 192 *
 193 * These flags are used across handling multiple interfaces
 194 * for a single frame.
 195 */
 196enum ieee80211_rx_flags {
 197	IEEE80211_RX_CMNTR		= BIT(0),
 198	IEEE80211_RX_BEACON_REPORTED	= BIT(1),
 199};
 200
 201struct ieee80211_rx_data {
 202	struct list_head *list;
 203	struct sk_buff *skb;
 204	struct ieee80211_local *local;
 205	struct ieee80211_sub_if_data *sdata;
 206	struct sta_info *sta;
 207	struct ieee80211_key *key;
 208
 209	unsigned int flags;
 210
 211	/*
 212	 * Index into sequence numbers array, 0..16
 213	 * since the last (16) is used for non-QoS,
 214	 * will be 16 on non-QoS frames.
 215	 */
 216	int seqno_idx;
 217
 218	/*
 219	 * Index into the security IV/PN arrays, 0..16
 220	 * since the last (16) is used for CCMP-encrypted
 221	 * management frames, will be set to 16 on mgmt
 222	 * frames and 0 on non-QoS frames.
 223	 */
 224	int security_idx;
 225
 226	union {
 227		struct {
 228			u32 iv32;
 229			u16 iv16;
 230		} tkip;
 231		struct {
 232			u8 pn[IEEE80211_CCMP_PN_LEN];
 233		} ccm_gcm;
 234	};
 235};
 236
 237struct ieee80211_csa_settings {
 238	const u16 *counter_offsets_beacon;
 239	const u16 *counter_offsets_presp;
 240
 241	int n_counter_offsets_beacon;
 242	int n_counter_offsets_presp;
 243
 244	u8 count;
 245};
 246
 247struct beacon_data {
 248	u8 *head, *tail;
 249	int head_len, tail_len;
 250	struct ieee80211_meshconf_ie *meshconf;
 251	u16 cntdwn_counter_offsets[IEEE80211_MAX_CNTDWN_COUNTERS_NUM];
 252	u8 cntdwn_current_counter;
 253	struct rcu_head rcu_head;
 254};
 255
 256struct probe_resp {
 257	struct rcu_head rcu_head;
 258	int len;
 259	u16 cntdwn_counter_offsets[IEEE80211_MAX_CNTDWN_COUNTERS_NUM];
 260	u8 data[];
 261};
 262
 263struct fils_discovery_data {
 264	struct rcu_head rcu_head;
 265	int len;
 266	u8 data[];
 267};
 268
 269struct unsol_bcast_probe_resp_data {
 270	struct rcu_head rcu_head;
 271	int len;
 272	u8 data[];
 273};
 274
 275struct ps_data {
 276	/* yes, this looks ugly, but guarantees that we can later use
 277	 * bitmap_empty :)
 278	 * NB: don't touch this bitmap, use sta_info_{set,clear}_tim_bit */
 279	u8 tim[sizeof(unsigned long) * BITS_TO_LONGS(IEEE80211_MAX_AID + 1)]
 280			__aligned(__alignof__(unsigned long));
 281	struct sk_buff_head bc_buf;
 282	atomic_t num_sta_ps; /* number of stations in PS mode */
 283	int dtim_count;
 284	bool dtim_bc_mc;
 285};
 286
 287struct ieee80211_if_ap {
 288	struct beacon_data __rcu *beacon;
 289	struct probe_resp __rcu *probe_resp;
 290	struct fils_discovery_data __rcu *fils_discovery;
 291	struct unsol_bcast_probe_resp_data __rcu *unsol_bcast_probe_resp;
 292
 293	/* to be used after channel switch. */
 294	struct cfg80211_beacon_data *next_beacon;
 295	struct list_head vlans; /* write-protected with RTNL and local->mtx */
 296
 297	struct ps_data ps;
 298	atomic_t num_mcast_sta; /* number of stations receiving multicast */
 299
 300	bool multicast_to_unicast;
 301};
 302
 
 
 
 
 
 303struct ieee80211_if_vlan {
 304	struct list_head list; /* write-protected with RTNL and local->mtx */
 305
 306	/* used for all tx if the VLAN is configured to 4-addr mode */
 307	struct sta_info __rcu *sta;
 308	atomic_t num_mcast_sta; /* number of stations receiving multicast */
 309};
 310
 311struct mesh_stats {
 312	__u32 fwded_mcast;		/* Mesh forwarded multicast frames */
 313	__u32 fwded_unicast;		/* Mesh forwarded unicast frames */
 314	__u32 fwded_frames;		/* Mesh total forwarded frames */
 315	__u32 dropped_frames_ttl;	/* Not transmitted since mesh_ttl == 0*/
 316	__u32 dropped_frames_no_route;	/* Not transmitted, no route found */
 317	__u32 dropped_frames_congestion;/* Not forwarded due to congestion */
 318};
 319
 320#define PREQ_Q_F_START		0x1
 321#define PREQ_Q_F_REFRESH	0x2
 322struct mesh_preq_queue {
 323	struct list_head list;
 324	u8 dst[ETH_ALEN];
 325	u8 flags;
 326};
 327
 328struct ieee80211_roc_work {
 329	struct list_head list;
 330
 331	struct ieee80211_sub_if_data *sdata;
 332
 333	struct ieee80211_channel *chan;
 334
 335	bool started, abort, hw_begun, notified;
 336	bool on_channel;
 337
 338	unsigned long start_time;
 339
 340	u32 duration, req_duration;
 341	struct sk_buff *frame;
 342	u64 cookie, mgmt_tx_cookie;
 343	enum ieee80211_roc_type type;
 344};
 345
 346/* flags used in struct ieee80211_if_managed.flags */
 347enum ieee80211_sta_flags {
 348	IEEE80211_STA_CONNECTION_POLL	= BIT(1),
 349	IEEE80211_STA_CONTROL_PORT	= BIT(2),
 350	IEEE80211_STA_DISABLE_HT	= BIT(4),
 351	IEEE80211_STA_MFP_ENABLED	= BIT(6),
 352	IEEE80211_STA_UAPSD_ENABLED	= BIT(7),
 353	IEEE80211_STA_NULLFUNC_ACKED	= BIT(8),
 354	IEEE80211_STA_RESET_SIGNAL_AVE	= BIT(9),
 355	IEEE80211_STA_DISABLE_40MHZ	= BIT(10),
 356	IEEE80211_STA_DISABLE_VHT	= BIT(11),
 357	IEEE80211_STA_DISABLE_80P80MHZ	= BIT(12),
 358	IEEE80211_STA_DISABLE_160MHZ	= BIT(13),
 359	IEEE80211_STA_DISABLE_WMM	= BIT(14),
 360	IEEE80211_STA_ENABLE_RRM	= BIT(15),
 361	IEEE80211_STA_DISABLE_HE	= BIT(16),
 362};
 363
 364struct ieee80211_mgd_auth_data {
 365	struct cfg80211_bss *bss;
 366	unsigned long timeout;
 367	int tries;
 368	u16 algorithm, expected_transaction;
 369
 370	u8 key[WLAN_KEY_LEN_WEP104];
 371	u8 key_len, key_idx;
 372	bool done;
 373	bool peer_confirmed;
 374	bool timeout_started;
 375
 376	u16 sae_trans, sae_status;
 377	size_t data_len;
 378	u8 data[];
 379};
 380
 381struct ieee80211_mgd_assoc_data {
 382	struct cfg80211_bss *bss;
 383	const u8 *supp_rates;
 384
 385	unsigned long timeout;
 386	int tries;
 387
 388	u16 capability;
 389	u8 prev_bssid[ETH_ALEN];
 390	u8 ssid[IEEE80211_MAX_SSID_LEN];
 391	u8 ssid_len;
 392	u8 supp_rates_len;
 393	bool wmm, uapsd;
 394	bool need_beacon;
 395	bool synced;
 396	bool timeout_started;
 397
 398	u8 ap_ht_param;
 399
 400	struct ieee80211_vht_cap ap_vht_cap;
 401
 402	u8 fils_nonces[2 * FILS_NONCE_LEN];
 403	u8 fils_kek[FILS_MAX_KEK_LEN];
 404	size_t fils_kek_len;
 405
 406	size_t ie_len;
 407	u8 ie[];
 408};
 409
 410struct ieee80211_sta_tx_tspec {
 411	/* timestamp of the first packet in the time slice */
 412	unsigned long time_slice_start;
 413
 414	u32 admitted_time; /* in usecs, unlike over the air */
 415	u8 tsid;
 416	s8 up; /* signed to be able to invalidate with -1 during teardown */
 417
 418	/* consumed TX time in microseconds in the time slice */
 419	u32 consumed_tx_time;
 420	enum {
 421		TX_TSPEC_ACTION_NONE = 0,
 422		TX_TSPEC_ACTION_DOWNGRADE,
 423		TX_TSPEC_ACTION_STOP_DOWNGRADE,
 424	} action;
 425	bool downgraded;
 426};
 427
 428DECLARE_EWMA(beacon_signal, 4, 4)
 429
 430struct ieee80211_if_managed {
 431	struct timer_list timer;
 432	struct timer_list conn_mon_timer;
 433	struct timer_list bcn_mon_timer;
 434	struct timer_list chswitch_timer;
 435	struct work_struct monitor_work;
 436	struct work_struct chswitch_work;
 437	struct work_struct beacon_connection_loss_work;
 438	struct work_struct csa_connection_drop_work;
 439
 440	unsigned long beacon_timeout;
 441	unsigned long probe_timeout;
 442	int probe_send_count;
 443	bool nullfunc_failed;
 444	u8 connection_loss:1,
 445	   driver_disconnect:1,
 446	   reconnect:1;
 447
 448	struct cfg80211_bss *associated;
 449	struct ieee80211_mgd_auth_data *auth_data;
 450	struct ieee80211_mgd_assoc_data *assoc_data;
 451
 452	u8 bssid[ETH_ALEN] __aligned(2);
 453
 454	bool powersave; /* powersave requested for this iface */
 455	bool broken_ap; /* AP is broken -- turn off powersave */
 456	bool have_beacon;
 457	u8 dtim_period;
 458	enum ieee80211_smps_mode req_smps, /* requested smps mode */
 459				 driver_smps_mode; /* smps mode request */
 460
 461	struct work_struct request_smps_work;
 462
 463	unsigned int flags;
 464
 465	bool csa_waiting_bcn;
 466	bool csa_ignored_same_chan;
 467
 468	bool beacon_crc_valid;
 469	u32 beacon_crc;
 470
 471	bool status_acked;
 472	bool status_received;
 473	__le16 status_fc;
 474
 475	enum {
 476		IEEE80211_MFP_DISABLED,
 477		IEEE80211_MFP_OPTIONAL,
 478		IEEE80211_MFP_REQUIRED
 479	} mfp; /* management frame protection */
 480
 481	/*
 482	 * Bitmask of enabled u-apsd queues,
 483	 * IEEE80211_WMM_IE_STA_QOSINFO_AC_BE & co. Needs a new association
 484	 * to take effect.
 485	 */
 486	unsigned int uapsd_queues;
 487
 488	/*
 489	 * Maximum number of buffered frames AP can deliver during a
 490	 * service period, IEEE80211_WMM_IE_STA_QOSINFO_SP_ALL or similar.
 491	 * Needs a new association to take effect.
 492	 */
 493	unsigned int uapsd_max_sp_len;
 494
 495	int wmm_last_param_set;
 496	int mu_edca_last_param_set;
 497
 498	u8 use_4addr;
 499
 500	s16 p2p_noa_index;
 501
 502	struct ewma_beacon_signal ave_beacon_signal;
 503
 504	/*
 505	 * Number of Beacon frames used in ave_beacon_signal. This can be used
 506	 * to avoid generating less reliable cqm events that would be based
 507	 * only on couple of received frames.
 508	 */
 509	unsigned int count_beacon_signal;
 510
 511	/* Number of times beacon loss was invoked. */
 512	unsigned int beacon_loss_count;
 513
 514	/*
 515	 * Last Beacon frame signal strength average (ave_beacon_signal / 16)
 516	 * that triggered a cqm event. 0 indicates that no event has been
 517	 * generated for the current association.
 518	 */
 519	int last_cqm_event_signal;
 520
 521	/*
 522	 * State variables for keeping track of RSSI of the AP currently
 523	 * connected to and informing driver when RSSI has gone
 524	 * below/above a certain threshold.
 525	 */
 526	int rssi_min_thold, rssi_max_thold;
 527	int last_ave_beacon_signal;
 528
 529	struct ieee80211_ht_cap ht_capa; /* configured ht-cap over-rides */
 530	struct ieee80211_ht_cap ht_capa_mask; /* Valid parts of ht_capa */
 531	struct ieee80211_vht_cap vht_capa; /* configured VHT overrides */
 532	struct ieee80211_vht_cap vht_capa_mask; /* Valid parts of vht_capa */
 533	struct ieee80211_s1g_cap s1g_capa; /* configured S1G overrides */
 534	struct ieee80211_s1g_cap s1g_capa_mask; /* valid s1g_capa bits */
 535
 536	/* TDLS support */
 537	u8 tdls_peer[ETH_ALEN] __aligned(2);
 538	struct delayed_work tdls_peer_del_work;
 539	struct sk_buff *orig_teardown_skb; /* The original teardown skb */
 540	struct sk_buff *teardown_skb; /* A copy to send through the AP */
 541	spinlock_t teardown_lock; /* To lock changing teardown_skb */
 542	bool tdls_chan_switch_prohibited;
 543	bool tdls_wider_bw_prohibited;
 544
 545	/* WMM-AC TSPEC support */
 546	struct ieee80211_sta_tx_tspec tx_tspec[IEEE80211_NUM_ACS];
 547	/* Use a separate work struct so that we can do something here
 548	 * while the sdata->work is flushing the queues, for example.
 549	 * otherwise, in scenarios where we hardly get any traffic out
 550	 * on the BE queue, but there's a lot of VO traffic, we might
 551	 * get stuck in a downgraded situation and flush takes forever.
 552	 */
 553	struct delayed_work tx_tspec_wk;
 554
 555	/* Information elements from the last transmitted (Re)Association
 556	 * Request frame.
 557	 */
 558	u8 *assoc_req_ies;
 559	size_t assoc_req_ies_len;
 560};
 561
 562struct ieee80211_if_ibss {
 563	struct timer_list timer;
 564	struct work_struct csa_connection_drop_work;
 565
 566	unsigned long last_scan_completed;
 567
 568	u32 basic_rates;
 569
 570	bool fixed_bssid;
 571	bool fixed_channel;
 572	bool privacy;
 573
 574	bool control_port;
 575	bool userspace_handles_dfs;
 576
 577	u8 bssid[ETH_ALEN] __aligned(2);
 578	u8 ssid[IEEE80211_MAX_SSID_LEN];
 579	u8 ssid_len, ie_len;
 580	u8 *ie;
 581	struct cfg80211_chan_def chandef;
 582
 583	unsigned long ibss_join_req;
 584	/* probe response/beacon for IBSS */
 585	struct beacon_data __rcu *presp;
 586
 587	struct ieee80211_ht_cap ht_capa; /* configured ht-cap over-rides */
 588	struct ieee80211_ht_cap ht_capa_mask; /* Valid parts of ht_capa */
 589
 590	spinlock_t incomplete_lock;
 591	struct list_head incomplete_stations;
 592
 593	enum {
 594		IEEE80211_IBSS_MLME_SEARCH,
 595		IEEE80211_IBSS_MLME_JOINED,
 596	} state;
 597};
 598
 599/**
 600 * struct ieee80211_if_ocb - OCB mode state
 601 *
 602 * @housekeeping_timer: timer for periodic invocation of a housekeeping task
 603 * @wrkq_flags: OCB deferred task action
 604 * @incomplete_lock: delayed STA insertion lock
 605 * @incomplete_stations: list of STAs waiting for delayed insertion
 606 * @joined: indication if the interface is connected to an OCB network
 607 */
 608struct ieee80211_if_ocb {
 609	struct timer_list housekeeping_timer;
 610	unsigned long wrkq_flags;
 611
 612	spinlock_t incomplete_lock;
 613	struct list_head incomplete_stations;
 614
 615	bool joined;
 616};
 617
 618/**
 619 * struct ieee80211_mesh_sync_ops - Extensible synchronization framework interface
 620 *
 621 * these declarations define the interface, which enables
 622 * vendor-specific mesh synchronization
 623 *
 624 */
 625struct ieee802_11_elems;
 626struct ieee80211_mesh_sync_ops {
 627	void (*rx_bcn_presp)(struct ieee80211_sub_if_data *sdata,
 628			     u16 stype,
 629			     struct ieee80211_mgmt *mgmt,
 630			     struct ieee802_11_elems *elems,
 631			     struct ieee80211_rx_status *rx_status);
 632
 633	/* should be called with beacon_data under RCU read lock */
 634	void (*adjust_tsf)(struct ieee80211_sub_if_data *sdata,
 635			   struct beacon_data *beacon);
 636	/* add other framework functions here */
 637};
 638
 639struct mesh_csa_settings {
 640	struct rcu_head rcu_head;
 641	struct cfg80211_csa_settings settings;
 642};
 643
 644struct ieee80211_if_mesh {
 645	struct timer_list housekeeping_timer;
 646	struct timer_list mesh_path_timer;
 647	struct timer_list mesh_path_root_timer;
 648
 649	unsigned long wrkq_flags;
 650	unsigned long mbss_changed;
 651
 652	bool userspace_handles_dfs;
 653
 654	u8 mesh_id[IEEE80211_MAX_MESH_ID_LEN];
 655	size_t mesh_id_len;
 656	/* Active Path Selection Protocol Identifier */
 657	u8 mesh_pp_id;
 658	/* Active Path Selection Metric Identifier */
 659	u8 mesh_pm_id;
 660	/* Congestion Control Mode Identifier */
 661	u8 mesh_cc_id;
 662	/* Synchronization Protocol Identifier */
 663	u8 mesh_sp_id;
 664	/* Authentication Protocol Identifier */
 665	u8 mesh_auth_id;
 666	/* Local mesh Sequence Number */
 667	u32 sn;
 668	/* Last used PREQ ID */
 669	u32 preq_id;
 670	atomic_t mpaths;
 671	/* Timestamp of last SN update */
 672	unsigned long last_sn_update;
 673	/* Time when it's ok to send next PERR */
 674	unsigned long next_perr;
 675	/* Timestamp of last PREQ sent */
 676	unsigned long last_preq;
 677	struct mesh_rmc *rmc;
 678	spinlock_t mesh_preq_queue_lock;
 679	struct mesh_preq_queue preq_queue;
 680	int preq_queue_len;
 681	struct mesh_stats mshstats;
 682	struct mesh_config mshcfg;
 683	atomic_t estab_plinks;
 684	u32 mesh_seqnum;
 685	bool accepting_plinks;
 686	int num_gates;
 687	struct beacon_data __rcu *beacon;
 688	const u8 *ie;
 689	u8 ie_len;
 690	enum {
 691		IEEE80211_MESH_SEC_NONE = 0x0,
 692		IEEE80211_MESH_SEC_AUTHED = 0x1,
 693		IEEE80211_MESH_SEC_SECURED = 0x2,
 694	} security;
 695	bool user_mpm;
 696	/* Extensible Synchronization Framework */
 697	const struct ieee80211_mesh_sync_ops *sync_ops;
 698	s64 sync_offset_clockdrift_max;
 699	spinlock_t sync_offset_lock;
 700	/* mesh power save */
 701	enum nl80211_mesh_power_mode nonpeer_pm;
 702	int ps_peers_light_sleep;
 703	int ps_peers_deep_sleep;
 704	struct ps_data ps;
 705	/* Channel Switching Support */
 706	struct mesh_csa_settings __rcu *csa;
 707	enum {
 708		IEEE80211_MESH_CSA_ROLE_NONE,
 709		IEEE80211_MESH_CSA_ROLE_INIT,
 710		IEEE80211_MESH_CSA_ROLE_REPEATER,
 711	} csa_role;
 712	u8 chsw_ttl;
 713	u16 pre_value;
 714
 715	/* offset from skb->data while building IE */
 716	int meshconf_offset;
 717
 718	struct mesh_table *mesh_paths;
 719	struct mesh_table *mpp_paths; /* Store paths for MPP&MAP */
 720	int mesh_paths_generation;
 721	int mpp_paths_generation;
 722};
 723
 724#ifdef CONFIG_MAC80211_MESH
 725#define IEEE80211_IFSTA_MESH_CTR_INC(msh, name)	\
 726	do { (msh)->mshstats.name++; } while (0)
 727#else
 728#define IEEE80211_IFSTA_MESH_CTR_INC(msh, name) \
 729	do { } while (0)
 730#endif
 731
 732/**
 733 * enum ieee80211_sub_if_data_flags - virtual interface flags
 734 *
 735 * @IEEE80211_SDATA_ALLMULTI: interface wants all multicast packets
 736 * @IEEE80211_SDATA_OPERATING_GMODE: operating in G-only mode
 737 * @IEEE80211_SDATA_DONT_BRIDGE_PACKETS: bridge packets between
 738 *	associated stations and deliver multicast frames both
 739 *	back to wireless media and to the local net stack.
 740 * @IEEE80211_SDATA_DISCONNECT_RESUME: Disconnect after resume.
 741 * @IEEE80211_SDATA_IN_DRIVER: indicates interface was added to driver
 742 */
 743enum ieee80211_sub_if_data_flags {
 744	IEEE80211_SDATA_ALLMULTI		= BIT(0),
 745	IEEE80211_SDATA_OPERATING_GMODE		= BIT(2),
 746	IEEE80211_SDATA_DONT_BRIDGE_PACKETS	= BIT(3),
 747	IEEE80211_SDATA_DISCONNECT_RESUME	= BIT(4),
 748	IEEE80211_SDATA_IN_DRIVER		= BIT(5),
 749};
 750
 751/**
 752 * enum ieee80211_sdata_state_bits - virtual interface state bits
 753 * @SDATA_STATE_RUNNING: virtual interface is up & running; this
 754 *	mirrors netif_running() but is separate for interface type
 755 *	change handling while the interface is up
 756 * @SDATA_STATE_OFFCHANNEL: This interface is currently in offchannel
 757 *	mode, so queues are stopped
 758 * @SDATA_STATE_OFFCHANNEL_BEACON_STOPPED: Beaconing was stopped due
 759 *	to offchannel, reset when offchannel returns
 760 */
 761enum ieee80211_sdata_state_bits {
 762	SDATA_STATE_RUNNING,
 763	SDATA_STATE_OFFCHANNEL,
 764	SDATA_STATE_OFFCHANNEL_BEACON_STOPPED,
 765};
 766
 767/**
 768 * enum ieee80211_chanctx_mode - channel context configuration mode
 769 *
 770 * @IEEE80211_CHANCTX_SHARED: channel context may be used by
 771 *	multiple interfaces
 772 * @IEEE80211_CHANCTX_EXCLUSIVE: channel context can be used
 773 *	only by a single interface. This can be used for example for
 774 *	non-fixed channel IBSS.
 775 */
 776enum ieee80211_chanctx_mode {
 777	IEEE80211_CHANCTX_SHARED,
 778	IEEE80211_CHANCTX_EXCLUSIVE
 779};
 780
 781/**
 782 * enum ieee80211_chanctx_replace_state - channel context replacement state
 783 *
 784 * This is used for channel context in-place reservations that require channel
 785 * context switch/swap.
 786 *
 787 * @IEEE80211_CHANCTX_REPLACE_NONE: no replacement is taking place
 788 * @IEEE80211_CHANCTX_WILL_BE_REPLACED: this channel context will be replaced
 789 *	by a (not yet registered) channel context pointed by %replace_ctx.
 790 * @IEEE80211_CHANCTX_REPLACES_OTHER: this (not yet registered) channel context
 791 *	replaces an existing channel context pointed to by %replace_ctx.
 792 */
 793enum ieee80211_chanctx_replace_state {
 794	IEEE80211_CHANCTX_REPLACE_NONE,
 795	IEEE80211_CHANCTX_WILL_BE_REPLACED,
 796	IEEE80211_CHANCTX_REPLACES_OTHER,
 797};
 798
 799struct ieee80211_chanctx {
 800	struct list_head list;
 801	struct rcu_head rcu_head;
 802
 803	struct list_head assigned_vifs;
 804	struct list_head reserved_vifs;
 805
 806	enum ieee80211_chanctx_replace_state replace_state;
 807	struct ieee80211_chanctx *replace_ctx;
 808
 809	enum ieee80211_chanctx_mode mode;
 810	bool driver_present;
 811
 812	struct ieee80211_chanctx_conf conf;
 813};
 814
 815struct mac80211_qos_map {
 816	struct cfg80211_qos_map qos_map;
 817	struct rcu_head rcu_head;
 818};
 819
 820enum txq_info_flags {
 821	IEEE80211_TXQ_STOP,
 822	IEEE80211_TXQ_AMPDU,
 823	IEEE80211_TXQ_NO_AMSDU,
 824	IEEE80211_TXQ_STOP_NETIF_TX,
 825};
 826
 827/**
 828 * struct txq_info - per tid queue
 829 *
 830 * @tin: contains packets split into multiple flows
 831 * @def_flow: used as a fallback flow when a packet destined to @tin hashes to
 832 *	a fq_flow which is already owned by a different tin
 833 * @def_cvars: codel vars for @def_flow
 834 * @schedule_order: used with ieee80211_local->active_txqs
 835 * @frags: used to keep fragments created after dequeue
 
 
 836 */
 837struct txq_info {
 838	struct fq_tin tin;
 
 839	struct codel_vars def_cvars;
 840	struct codel_stats cstats;
 841	struct rb_node schedule_order;
 842
 843	struct sk_buff_head frags;
 
 
 844	unsigned long flags;
 845
 846	/* keep last! */
 847	struct ieee80211_txq txq;
 848};
 849
 850struct ieee80211_if_mntr {
 851	u32 flags;
 852	u8 mu_follow_addr[ETH_ALEN] __aligned(2);
 853
 854	struct list_head list;
 855};
 856
 857/**
 858 * struct ieee80211_if_nan - NAN state
 859 *
 860 * @conf: current NAN configuration
 861 * @func_ids: a bitmap of available instance_id's
 862 */
 863struct ieee80211_if_nan {
 864	struct cfg80211_nan_conf conf;
 865
 866	/* protects function_inst_ids */
 867	spinlock_t func_lock;
 868	struct idr function_inst_ids;
 869};
 870
 871struct ieee80211_sub_if_data {
 872	struct list_head list;
 873
 874	struct wireless_dev wdev;
 875
 876	/* keys */
 877	struct list_head key_list;
 878
 879	/* count for keys needing tailroom space allocation */
 880	int crypto_tx_tailroom_needed_cnt;
 881	int crypto_tx_tailroom_pending_dec;
 882	struct delayed_work dec_tailroom_needed_wk;
 883
 884	struct net_device *dev;
 885	struct ieee80211_local *local;
 886
 887	unsigned int flags;
 888
 889	unsigned long state;
 890
 891	char name[IFNAMSIZ];
 892
 893	struct ieee80211_fragment_cache frags;
 
 
 894
 895	/* TID bitmap for NoAck policy */
 896	u16 noack_map;
 897
 898	/* bit field of ACM bits (BIT(802.1D tag)) */
 899	u8 wmm_acm;
 900
 901	struct ieee80211_key __rcu *keys[NUM_DEFAULT_KEYS +
 902					 NUM_DEFAULT_MGMT_KEYS +
 903					 NUM_DEFAULT_BEACON_KEYS];
 904	struct ieee80211_key __rcu *default_unicast_key;
 905	struct ieee80211_key __rcu *default_multicast_key;
 906	struct ieee80211_key __rcu *default_mgmt_key;
 907	struct ieee80211_key __rcu *default_beacon_key;
 908
 909	u16 sequence_number;
 910	__be16 control_port_protocol;
 911	bool control_port_no_encrypt;
 912	bool control_port_no_preauth;
 913	bool control_port_over_nl80211;
 914	int encrypt_headroom;
 915
 916	atomic_t num_tx_queued;
 917	struct ieee80211_tx_queue_params tx_conf[IEEE80211_NUM_ACS];
 918	struct mac80211_qos_map __rcu *qos_map;
 919
 920	struct airtime_info airtime[IEEE80211_NUM_ACS];
 921
 922	struct work_struct csa_finalize_work;
 923	bool csa_block_tx; /* write-protected by sdata_lock and local->mtx */
 924	struct cfg80211_chan_def csa_chandef;
 925
 926	struct list_head assigned_chanctx_list; /* protected by chanctx_mtx */
 927	struct list_head reserved_chanctx_list; /* protected by chanctx_mtx */
 928
 929	/* context reservation -- protected with chanctx_mtx */
 930	struct ieee80211_chanctx *reserved_chanctx;
 931	struct cfg80211_chan_def reserved_chandef;
 932	bool reserved_radar_required;
 933	bool reserved_ready;
 934
 935	/* used to reconfigure hardware SM PS */
 936	struct work_struct recalc_smps;
 937
 938	struct work_struct work;
 939	struct sk_buff_head skb_queue;
 940
 941	u8 needed_rx_chains;
 942	enum ieee80211_smps_mode smps_mode;
 943
 944	int user_power_level; /* in dBm */
 945	int ap_power_level; /* in dBm */
 946
 947	bool radar_required;
 948	struct delayed_work dfs_cac_timer_work;
 949
 950	/*
 951	 * AP this belongs to: self in AP mode and
 952	 * corresponding AP in VLAN mode, NULL for
 953	 * all others (might be needed later in IBSS)
 954	 */
 955	struct ieee80211_if_ap *bss;
 956
 957	/* bitmap of allowed (non-MCS) rate indexes for rate control */
 958	u32 rc_rateidx_mask[NUM_NL80211_BANDS];
 959
 960	bool rc_has_mcs_mask[NUM_NL80211_BANDS];
 961	u8  rc_rateidx_mcs_mask[NUM_NL80211_BANDS][IEEE80211_HT_MCS_MASK_LEN];
 962
 963	bool rc_has_vht_mcs_mask[NUM_NL80211_BANDS];
 964	u16 rc_rateidx_vht_mcs_mask[NUM_NL80211_BANDS][NL80211_VHT_NSS_MAX];
 965
 966	/* Beacon frame (non-MCS) rate (as a bitmap) */
 967	u32 beacon_rateidx_mask[NUM_NL80211_BANDS];
 968	bool beacon_rate_set;
 969
 970	union {
 971		struct ieee80211_if_ap ap;
 
 972		struct ieee80211_if_vlan vlan;
 973		struct ieee80211_if_managed mgd;
 974		struct ieee80211_if_ibss ibss;
 975		struct ieee80211_if_mesh mesh;
 976		struct ieee80211_if_ocb ocb;
 977		struct ieee80211_if_mntr mntr;
 978		struct ieee80211_if_nan nan;
 979	} u;
 980
 981#ifdef CONFIG_MAC80211_DEBUGFS
 982	struct {
 983		struct dentry *subdir_stations;
 984		struct dentry *default_unicast_key;
 985		struct dentry *default_multicast_key;
 986		struct dentry *default_mgmt_key;
 987		struct dentry *default_beacon_key;
 988	} debugfs;
 989#endif
 990
 
 
 991	/* must be last, dynamically sized area in this! */
 992	struct ieee80211_vif vif;
 993};
 994
 995static inline
 996struct ieee80211_sub_if_data *vif_to_sdata(struct ieee80211_vif *p)
 997{
 998	return container_of(p, struct ieee80211_sub_if_data, vif);
 999}
1000
1001static inline void sdata_lock(struct ieee80211_sub_if_data *sdata)
1002	__acquires(&sdata->wdev.mtx)
1003{
1004	mutex_lock(&sdata->wdev.mtx);
1005	__acquire(&sdata->wdev.mtx);
1006}
1007
1008static inline void sdata_unlock(struct ieee80211_sub_if_data *sdata)
1009	__releases(&sdata->wdev.mtx)
1010{
1011	mutex_unlock(&sdata->wdev.mtx);
1012	__release(&sdata->wdev.mtx);
1013}
1014
1015#define sdata_dereference(p, sdata) \
1016	rcu_dereference_protected(p, lockdep_is_held(&sdata->wdev.mtx))
1017
1018static inline void
1019sdata_assert_lock(struct ieee80211_sub_if_data *sdata)
1020{
1021	lockdep_assert_held(&sdata->wdev.mtx);
1022}
1023
1024static inline int
1025ieee80211_chandef_get_shift(struct cfg80211_chan_def *chandef)
1026{
1027	switch (chandef->width) {
1028	case NL80211_CHAN_WIDTH_5:
1029		return 2;
1030	case NL80211_CHAN_WIDTH_10:
1031		return 1;
1032	default:
1033		return 0;
1034	}
1035}
1036
1037static inline int
1038ieee80211_vif_get_shift(struct ieee80211_vif *vif)
1039{
1040	struct ieee80211_chanctx_conf *chanctx_conf;
1041	int shift = 0;
1042
1043	rcu_read_lock();
1044	chanctx_conf = rcu_dereference(vif->chanctx_conf);
1045	if (chanctx_conf)
1046		shift = ieee80211_chandef_get_shift(&chanctx_conf->def);
1047	rcu_read_unlock();
1048
1049	return shift;
1050}
1051
1052enum {
1053	IEEE80211_RX_MSG	= 1,
1054	IEEE80211_TX_STATUS_MSG	= 2,
1055};
1056
1057enum queue_stop_reason {
1058	IEEE80211_QUEUE_STOP_REASON_DRIVER,
1059	IEEE80211_QUEUE_STOP_REASON_PS,
1060	IEEE80211_QUEUE_STOP_REASON_CSA,
1061	IEEE80211_QUEUE_STOP_REASON_AGGREGATION,
1062	IEEE80211_QUEUE_STOP_REASON_SUSPEND,
1063	IEEE80211_QUEUE_STOP_REASON_SKB_ADD,
1064	IEEE80211_QUEUE_STOP_REASON_OFFCHANNEL,
1065	IEEE80211_QUEUE_STOP_REASON_FLUSH,
1066	IEEE80211_QUEUE_STOP_REASON_TDLS_TEARDOWN,
1067	IEEE80211_QUEUE_STOP_REASON_RESERVE_TID,
1068	IEEE80211_QUEUE_STOP_REASON_IFTYPE_CHANGE,
1069
1070	IEEE80211_QUEUE_STOP_REASONS,
1071};
1072
1073#ifdef CONFIG_MAC80211_LEDS
1074struct tpt_led_trigger {
1075	char name[32];
1076	const struct ieee80211_tpt_blink *blink_table;
1077	unsigned int blink_table_len;
1078	struct timer_list timer;
1079	struct ieee80211_local *local;
1080	unsigned long prev_traffic;
1081	unsigned long tx_bytes, rx_bytes;
1082	unsigned int active, want;
1083	bool running;
1084};
1085#endif
1086
1087/**
1088 * mac80211 scan flags - currently active scan mode
1089 *
1090 * @SCAN_SW_SCANNING: We're currently in the process of scanning but may as
1091 *	well be on the operating channel
1092 * @SCAN_HW_SCANNING: The hardware is scanning for us, we have no way to
1093 *	determine if we are on the operating channel or not
1094 * @SCAN_ONCHANNEL_SCANNING:  Do a software scan on only the current operating
1095 *	channel. This should not interrupt normal traffic.
1096 * @SCAN_COMPLETED: Set for our scan work function when the driver reported
1097 *	that the scan completed.
1098 * @SCAN_ABORTED: Set for our scan work function when the driver reported
1099 *	a scan complete for an aborted scan.
1100 * @SCAN_HW_CANCELLED: Set for our scan work function when the scan is being
1101 *	cancelled.
1102 */
1103enum {
1104	SCAN_SW_SCANNING,
1105	SCAN_HW_SCANNING,
1106	SCAN_ONCHANNEL_SCANNING,
1107	SCAN_COMPLETED,
1108	SCAN_ABORTED,
1109	SCAN_HW_CANCELLED,
1110};
1111
1112/**
1113 * enum mac80211_scan_state - scan state machine states
1114 *
1115 * @SCAN_DECISION: Main entry point to the scan state machine, this state
1116 *	determines if we should keep on scanning or switch back to the
1117 *	operating channel
1118 * @SCAN_SET_CHANNEL: Set the next channel to be scanned
1119 * @SCAN_SEND_PROBE: Send probe requests and wait for probe responses
1120 * @SCAN_SUSPEND: Suspend the scan and go back to operating channel to
1121 *	send out data
1122 * @SCAN_RESUME: Resume the scan and scan the next channel
1123 * @SCAN_ABORT: Abort the scan and go back to operating channel
1124 */
1125enum mac80211_scan_state {
1126	SCAN_DECISION,
1127	SCAN_SET_CHANNEL,
1128	SCAN_SEND_PROBE,
1129	SCAN_SUSPEND,
1130	SCAN_RESUME,
1131	SCAN_ABORT,
1132};
1133
1134/**
1135 * struct airtime_sched_info - state used for airtime scheduling and AQL
1136 *
1137 * @lock: spinlock that protects all the fields in this struct
1138 * @active_txqs: rbtree of currently backlogged queues, sorted by virtual time
1139 * @schedule_pos: the current position maintained while a driver walks the tree
1140 *                with ieee80211_next_txq()
1141 * @active_list: list of struct airtime_info structs that were active within
1142 *               the last AIRTIME_ACTIVE_DURATION (100 ms), used to compute
1143 *               weight_sum
1144 * @last_weight_update: used for rate limiting walking active_list
1145 * @last_schedule_time: tracks the last time a transmission was scheduled; used
1146 *                      for catching up v_t if no stations are eligible for
1147 *                      transmission.
1148 * @v_t: global virtual time; queues with v_t < this are eligible for
1149 *       transmission
1150 * @weight_sum: total sum of all active stations used for dividing airtime
1151 * @weight_sum_reciprocal: reciprocal of weight_sum (to avoid divisions in fast
1152 *                         path - see comment above
1153 *                         IEEE80211_RECIPROCAL_DIVISOR_64)
1154 * @aql_txq_limit_low: AQL limit when total outstanding airtime
1155 *                     is < IEEE80211_AQL_THRESHOLD
1156 * @aql_txq_limit_high: AQL limit when total outstanding airtime
1157 *                      is > IEEE80211_AQL_THRESHOLD
1158 */
1159struct airtime_sched_info {
1160	spinlock_t lock;
1161	struct rb_root_cached active_txqs;
1162	struct rb_node *schedule_pos;
1163	struct list_head active_list;
1164	u64 last_weight_update;
1165	u64 last_schedule_activity;
1166	u64 v_t;
1167	u64 weight_sum;
1168	u64 weight_sum_reciprocal;
1169	u32 aql_txq_limit_low;
1170	u32 aql_txq_limit_high;
1171};
1172DECLARE_STATIC_KEY_FALSE(aql_disable);
1173
1174struct ieee80211_local {
1175	/* embed the driver visible part.
1176	 * don't cast (use the static inlines below), but we keep
1177	 * it first anyway so they become a no-op */
1178	struct ieee80211_hw hw;
1179
1180	struct fq fq;
1181	struct codel_vars *cvars;
1182	struct codel_params cparams;
1183
1184	/* protects active_txqs and txqi->schedule_order */
1185	struct airtime_sched_info airtime[IEEE80211_NUM_ACS];
 
 
 
1186	u16 airtime_flags;
 
 
1187	u32 aql_threshold;
1188	atomic_t aql_total_pending_airtime;
1189
1190	const struct ieee80211_ops *ops;
1191
1192	/*
1193	 * private workqueue to mac80211. mac80211 makes this accessible
1194	 * via ieee80211_queue_work()
1195	 */
1196	struct workqueue_struct *workqueue;
1197
1198	unsigned long queue_stop_reasons[IEEE80211_MAX_QUEUES];
1199	int q_stop_reasons[IEEE80211_MAX_QUEUES][IEEE80211_QUEUE_STOP_REASONS];
1200	/* also used to protect ampdu_ac_queue and amdpu_ac_stop_refcnt */
1201	spinlock_t queue_stop_reason_lock;
1202
1203	int open_count;
1204	int monitors, cooked_mntrs;
1205	/* number of interfaces with corresponding FIF_ flags */
1206	int fif_fcsfail, fif_plcpfail, fif_control, fif_other_bss, fif_pspoll,
1207	    fif_probe_req;
1208	bool probe_req_reg;
1209	bool rx_mcast_action_reg;
1210	unsigned int filter_flags; /* FIF_* */
1211
1212	bool wiphy_ciphers_allocated;
1213
1214	bool use_chanctx;
1215
1216	/* protects the aggregated multicast list and filter calls */
1217	spinlock_t filter_lock;
1218
1219	/* used for uploading changed mc list */
1220	struct work_struct reconfig_filter;
1221
1222	/* aggregated multicast list */
1223	struct netdev_hw_addr_list mc_list;
1224
1225	bool tim_in_locked_section; /* see ieee80211_beacon_get() */
1226
1227	/*
1228	 * suspended is true if we finished all the suspend _and_ we have
1229	 * not yet come up from resume. This is to be used by mac80211
1230	 * to ensure driver sanity during suspend and mac80211's own
1231	 * sanity. It can eventually be used for WoW as well.
1232	 */
1233	bool suspended;
1234
1235	/*
1236	 * Resuming is true while suspended, but when we're reprogramming the
1237	 * hardware -- at that time it's allowed to use ieee80211_queue_work()
1238	 * again even though some other parts of the stack are still suspended
1239	 * and we still drop received frames to avoid waking the stack.
1240	 */
1241	bool resuming;
1242
1243	/*
1244	 * quiescing is true during the suspend process _only_ to
1245	 * ease timer cancelling etc.
1246	 */
1247	bool quiescing;
1248
1249	/* device is started */
1250	bool started;
1251
1252	/* device is during a HW reconfig */
1253	bool in_reconfig;
1254
1255	/* wowlan is enabled -- don't reconfig on resume */
1256	bool wowlan;
1257
1258	struct work_struct radar_detected_work;
1259
1260	/* number of RX chains the hardware has */
1261	u8 rx_chains;
1262
1263	/* bitmap of which sbands were copied */
1264	u8 sband_allocated;
1265
1266	int tx_headroom; /* required headroom for hardware/radiotap */
1267
1268	/* Tasklet and skb queue to process calls from IRQ mode. All frames
1269	 * added to skb_queue will be processed, but frames in
1270	 * skb_queue_unreliable may be dropped if the total length of these
1271	 * queues increases over the limit. */
1272#define IEEE80211_IRQSAFE_QUEUE_LIMIT 128
1273	struct tasklet_struct tasklet;
1274	struct sk_buff_head skb_queue;
1275	struct sk_buff_head skb_queue_unreliable;
1276
1277	spinlock_t rx_path_lock;
1278
1279	/* Station data */
1280	/*
1281	 * The mutex only protects the list, hash table and
1282	 * counter, reads are done with RCU.
1283	 */
1284	struct mutex sta_mtx;
1285	spinlock_t tim_lock;
1286	unsigned long num_sta;
1287	struct list_head sta_list;
1288	struct rhltable sta_hash;
1289	struct timer_list sta_cleanup;
1290	int sta_generation;
1291
1292	struct sk_buff_head pending[IEEE80211_MAX_QUEUES];
1293	struct tasklet_struct tx_pending_tasklet;
1294	struct tasklet_struct wake_txqs_tasklet;
1295
1296	atomic_t agg_queue_stop[IEEE80211_MAX_QUEUES];
1297
1298	/* number of interfaces with allmulti RX */
1299	atomic_t iff_allmultis;
1300
1301	struct rate_control_ref *rate_ctrl;
1302
1303	struct arc4_ctx wep_tx_ctx;
1304	struct arc4_ctx wep_rx_ctx;
1305	u32 wep_iv;
1306
1307	/* see iface.c */
1308	struct list_head interfaces;
1309	struct list_head mon_list; /* only that are IFF_UP && !cooked */
1310	struct mutex iflist_mtx;
1311
1312	/*
1313	 * Key mutex, protects sdata's key_list and sta_info's
1314	 * key pointers and ptk_idx (write access, they're RCU.)
1315	 */
1316	struct mutex key_mtx;
1317
1318	/* mutex for scan and work locking */
1319	struct mutex mtx;
1320
1321	/* Scanning and BSS list */
1322	unsigned long scanning;
1323	struct cfg80211_ssid scan_ssid;
1324	struct cfg80211_scan_request *int_scan_req;
1325	struct cfg80211_scan_request __rcu *scan_req;
1326	struct ieee80211_scan_request *hw_scan_req;
1327	struct cfg80211_chan_def scan_chandef;
1328	enum nl80211_band hw_scan_band;
1329	int scan_channel_idx;
1330	int scan_ies_len;
1331	int hw_scan_ies_bufsize;
1332	struct cfg80211_scan_info scan_info;
1333
1334	struct work_struct sched_scan_stopped_work;
1335	struct ieee80211_sub_if_data __rcu *sched_scan_sdata;
1336	struct cfg80211_sched_scan_request __rcu *sched_scan_req;
1337	u8 scan_addr[ETH_ALEN];
1338
1339	unsigned long leave_oper_channel_time;
1340	enum mac80211_scan_state next_scan_state;
1341	struct delayed_work scan_work;
1342	struct ieee80211_sub_if_data __rcu *scan_sdata;
1343	/* For backward compatibility only -- do not use */
1344	struct cfg80211_chan_def _oper_chandef;
1345
1346	/* Temporary remain-on-channel for off-channel operations */
1347	struct ieee80211_channel *tmp_channel;
1348
1349	/* channel contexts */
1350	struct list_head chanctx_list;
1351	struct mutex chanctx_mtx;
1352
1353#ifdef CONFIG_MAC80211_LEDS
1354	struct led_trigger tx_led, rx_led, assoc_led, radio_led;
1355	struct led_trigger tpt_led;
1356	atomic_t tx_led_active, rx_led_active, assoc_led_active;
1357	atomic_t radio_led_active, tpt_led_active;
1358	struct tpt_led_trigger *tpt_led_trigger;
1359#endif
1360
1361#ifdef CONFIG_MAC80211_DEBUG_COUNTERS
1362	/* SNMP counters */
1363	/* dot11CountersTable */
1364	u32 dot11TransmittedFragmentCount;
1365	u32 dot11MulticastTransmittedFrameCount;
1366	u32 dot11FailedCount;
1367	u32 dot11RetryCount;
1368	u32 dot11MultipleRetryCount;
1369	u32 dot11FrameDuplicateCount;
1370	u32 dot11ReceivedFragmentCount;
1371	u32 dot11MulticastReceivedFrameCount;
1372	u32 dot11TransmittedFrameCount;
1373
1374	/* TX/RX handler statistics */
1375	unsigned int tx_handlers_drop;
1376	unsigned int tx_handlers_queued;
1377	unsigned int tx_handlers_drop_wep;
1378	unsigned int tx_handlers_drop_not_assoc;
1379	unsigned int tx_handlers_drop_unauth_port;
1380	unsigned int rx_handlers_drop;
1381	unsigned int rx_handlers_queued;
1382	unsigned int rx_handlers_drop_nullfunc;
1383	unsigned int rx_handlers_drop_defrag;
1384	unsigned int tx_expand_skb_head;
1385	unsigned int tx_expand_skb_head_cloned;
1386	unsigned int rx_expand_skb_head_defrag;
1387	unsigned int rx_handlers_fragments;
1388	unsigned int tx_status_drop;
1389#define I802_DEBUG_INC(c) (c)++
1390#else /* CONFIG_MAC80211_DEBUG_COUNTERS */
1391#define I802_DEBUG_INC(c) do { } while (0)
1392#endif /* CONFIG_MAC80211_DEBUG_COUNTERS */
1393
1394
1395	int total_ps_buffered; /* total number of all buffered unicast and
1396				* multicast packets for power saving stations
1397				*/
1398
1399	bool pspolling;
 
1400	/*
1401	 * PS can only be enabled when we have exactly one managed
1402	 * interface (and monitors) in PS, this then points there.
1403	 */
1404	struct ieee80211_sub_if_data *ps_sdata;
1405	struct work_struct dynamic_ps_enable_work;
1406	struct work_struct dynamic_ps_disable_work;
1407	struct timer_list dynamic_ps_timer;
1408	struct notifier_block ifa_notifier;
1409	struct notifier_block ifa6_notifier;
1410
1411	/*
1412	 * The dynamic ps timeout configured from user space via WEXT -
1413	 * this will override whatever chosen by mac80211 internally.
1414	 */
1415	int dynamic_ps_forced_timeout;
1416
1417	int user_power_level; /* in dBm, for all interfaces */
1418
1419	enum ieee80211_smps_mode smps_mode;
1420
1421	struct work_struct restart_work;
1422
1423#ifdef CONFIG_MAC80211_DEBUGFS
1424	struct local_debugfsdentries {
1425		struct dentry *rcdir;
1426		struct dentry *keys;
1427	} debugfs;
1428	bool force_tx_status;
1429#endif
1430
1431	/*
1432	 * Remain-on-channel support
1433	 */
1434	struct delayed_work roc_work;
1435	struct list_head roc_list;
1436	struct work_struct hw_roc_start, hw_roc_done;
1437	unsigned long hw_roc_start_time;
1438	u64 roc_cookie_counter;
1439
1440	struct idr ack_status_frames;
1441	spinlock_t ack_status_lock;
1442
1443	struct ieee80211_sub_if_data __rcu *p2p_sdata;
1444
1445	/* virtual monitor interface */
1446	struct ieee80211_sub_if_data __rcu *monitor_sdata;
1447	struct cfg80211_chan_def monitor_chandef;
1448
1449	/* extended capabilities provided by mac80211 */
1450	u8 ext_capa[8];
 
 
 
 
1451};
1452
1453static inline struct ieee80211_sub_if_data *
1454IEEE80211_DEV_TO_SUB_IF(struct net_device *dev)
1455{
1456	return netdev_priv(dev);
1457}
1458
1459static inline struct ieee80211_sub_if_data *
1460IEEE80211_WDEV_TO_SUB_IF(struct wireless_dev *wdev)
1461{
1462	return container_of(wdev, struct ieee80211_sub_if_data, wdev);
1463}
1464
1465static inline struct ieee80211_supported_band *
1466ieee80211_get_sband(struct ieee80211_sub_if_data *sdata)
1467{
1468	struct ieee80211_local *local = sdata->local;
1469	struct ieee80211_chanctx_conf *chanctx_conf;
1470	enum nl80211_band band;
1471
1472	rcu_read_lock();
1473	chanctx_conf = rcu_dereference(sdata->vif.chanctx_conf);
1474
1475	if (!chanctx_conf) {
1476		rcu_read_unlock();
1477		return NULL;
1478	}
1479
1480	band = chanctx_conf->def.chan->band;
1481	rcu_read_unlock();
1482
1483	return local->hw.wiphy->bands[band];
1484}
1485
1486/* this struct holds the value parsing from channel switch IE  */
1487struct ieee80211_csa_ie {
1488	struct cfg80211_chan_def chandef;
1489	u8 mode;
1490	u8 count;
1491	u8 ttl;
1492	u16 pre_value;
1493	u16 reason_code;
1494	u32 max_switch_time;
1495};
1496
1497/* Parsed Information Elements */
1498struct ieee802_11_elems {
1499	const u8 *ie_start;
1500	size_t total_len;
1501
1502	/* pointers to IEs */
1503	const struct ieee80211_tdls_lnkie *lnk_id;
1504	const struct ieee80211_ch_switch_timing *ch_sw_timing;
1505	const u8 *ext_capab;
1506	const u8 *ssid;
1507	const u8 *supp_rates;
1508	const u8 *ds_params;
1509	const struct ieee80211_tim_ie *tim;
1510	const u8 *challenge;
1511	const u8 *rsn;
1512	const u8 *rsnx;
1513	const u8 *erp_info;
1514	const u8 *ext_supp_rates;
1515	const u8 *wmm_info;
1516	const u8 *wmm_param;
1517	const struct ieee80211_ht_cap *ht_cap_elem;
1518	const struct ieee80211_ht_operation *ht_operation;
1519	const struct ieee80211_vht_cap *vht_cap_elem;
1520	const struct ieee80211_vht_operation *vht_operation;
1521	const struct ieee80211_meshconf_ie *mesh_config;
1522	const u8 *he_cap;
1523	const struct ieee80211_he_operation *he_operation;
1524	const struct ieee80211_he_spr *he_spr;
1525	const struct ieee80211_mu_edca_param_set *mu_edca_param_set;
1526	const struct ieee80211_he_6ghz_capa *he_6ghz_capa;
1527	const u8 *uora_element;
1528	const u8 *mesh_id;
1529	const u8 *peering;
1530	const __le16 *awake_window;
1531	const u8 *preq;
1532	const u8 *prep;
1533	const u8 *perr;
1534	const struct ieee80211_rann_ie *rann;
1535	const struct ieee80211_channel_sw_ie *ch_switch_ie;
1536	const struct ieee80211_ext_chansw_ie *ext_chansw_ie;
1537	const struct ieee80211_wide_bw_chansw_ie *wide_bw_chansw_ie;
1538	const u8 *max_channel_switch_time;
1539	const u8 *country_elem;
1540	const u8 *pwr_constr_elem;
1541	const u8 *cisco_dtpc_elem;
1542	const struct ieee80211_timeout_interval_ie *timeout_int;
1543	const u8 *opmode_notif;
1544	const struct ieee80211_sec_chan_offs_ie *sec_chan_offs;
1545	struct ieee80211_mesh_chansw_params_ie *mesh_chansw_params_ie;
1546	const struct ieee80211_bss_max_idle_period_ie *max_idle_period_ie;
1547	const struct ieee80211_multiple_bssid_configuration *mbssid_config_ie;
1548	const struct ieee80211_bssid_index *bssid_index;
1549	u8 max_bssid_indicator;
1550	u8 dtim_count;
1551	u8 dtim_period;
1552	const struct ieee80211_addba_ext_ie *addba_ext_ie;
1553	const struct ieee80211_s1g_cap *s1g_capab;
1554	const struct ieee80211_s1g_oper_ie *s1g_oper;
1555	const struct ieee80211_s1g_bcn_compat_ie *s1g_bcn_compat;
1556	const struct ieee80211_aid_response_ie *aid_resp;
1557
1558	/* length of them, respectively */
1559	u8 ext_capab_len;
1560	u8 ssid_len;
1561	u8 supp_rates_len;
1562	u8 tim_len;
1563	u8 challenge_len;
1564	u8 rsn_len;
1565	u8 rsnx_len;
1566	u8 ext_supp_rates_len;
1567	u8 wmm_info_len;
1568	u8 wmm_param_len;
1569	u8 he_cap_len;
1570	u8 mesh_id_len;
1571	u8 peering_len;
1572	u8 preq_len;
1573	u8 prep_len;
1574	u8 perr_len;
1575	u8 country_elem_len;
1576	u8 bssid_index_len;
1577
1578	/* whether a parse error occurred while retrieving these elements */
1579	bool parse_error;
1580};
1581
1582static inline struct ieee80211_local *hw_to_local(
1583	struct ieee80211_hw *hw)
1584{
1585	return container_of(hw, struct ieee80211_local, hw);
1586}
1587
1588static inline struct txq_info *to_txq_info(struct ieee80211_txq *txq)
1589{
1590	return container_of(txq, struct txq_info, txq);
1591}
1592
1593static inline bool txq_has_queue(struct ieee80211_txq *txq)
1594{
1595	struct txq_info *txqi = to_txq_info(txq);
1596
1597	return !(skb_queue_empty(&txqi->frags) && !txqi->tin.backlog_packets);
1598}
1599
1600static inline struct airtime_info *to_airtime_info(struct ieee80211_txq *txq)
1601{
1602	struct ieee80211_sub_if_data *sdata;
1603	struct sta_info *sta;
1604
1605	if (txq->sta) {
1606		sta = container_of(txq->sta, struct sta_info, sta);
1607		return &sta->airtime[txq->ac];
1608	}
1609
1610	sdata = vif_to_sdata(txq->vif);
1611	return &sdata->airtime[txq->ac];
1612}
1613
1614/* To avoid divisions in the fast path, we keep pre-computed reciprocals for
1615 * airtime weight calculations. There are two different weights to keep track
1616 * of: The per-station weight and the sum of weights per phy.
1617 *
1618 * For the per-station weights (kept in airtime_info below), we use 32-bit
1619 * reciprocals with a devisor of 2^19. This lets us keep the multiplications and
1620 * divisions for the station weights as 32-bit operations at the cost of a bit
1621 * of rounding error for high weights; but the choice of divisor keeps rounding
1622 * errors <10% for weights <2^15, assuming no more than 8ms of airtime is
1623 * reported at a time.
1624 *
1625 * For the per-phy sum of weights the values can get higher, so we use 64-bit
1626 * operations for those with a 32-bit divisor, which should avoid any
1627 * significant rounding errors.
1628 */
1629#define IEEE80211_RECIPROCAL_DIVISOR_64 0x100000000ULL
1630#define IEEE80211_RECIPROCAL_SHIFT_64 32
1631#define IEEE80211_RECIPROCAL_DIVISOR_32 0x80000U
1632#define IEEE80211_RECIPROCAL_SHIFT_32 19
1633
1634static inline void airtime_weight_set(struct airtime_info *air_info, u16 weight)
1635{
1636	if (air_info->weight == weight)
1637		return;
1638
1639	air_info->weight = weight;
1640	if (weight) {
1641		air_info->weight_reciprocal =
1642			IEEE80211_RECIPROCAL_DIVISOR_32 / weight;
1643	} else {
1644		air_info->weight_reciprocal = 0;
1645	}
1646}
1647
1648static inline void airtime_weight_sum_set(struct airtime_sched_info *air_sched,
1649					  int weight_sum)
1650{
1651	if (air_sched->weight_sum == weight_sum)
1652		return;
1653
1654	air_sched->weight_sum = weight_sum;
1655	if (air_sched->weight_sum) {
1656		air_sched->weight_sum_reciprocal = IEEE80211_RECIPROCAL_DIVISOR_64;
1657		do_div(air_sched->weight_sum_reciprocal, air_sched->weight_sum);
1658	} else {
1659		air_sched->weight_sum_reciprocal = 0;
1660	}
1661}
1662
1663/* A problem when trying to enforce airtime fairness is that we want to divide
1664 * the airtime between the currently *active* stations. However, basing this on
1665 * the instantaneous queue state of stations doesn't work, as queues tend to
1666 * oscillate very quickly between empty and occupied, leading to the scheduler
1667 * thinking only a single station is active when deciding whether to allow
1668 * transmission (and thus not throttling correctly).
1669 *
1670 * To fix this we use a timer-based notion of activity: a station is considered
1671 * active if it has been scheduled within the last 100 ms; we keep a separate
1672 * list of all the stations considered active in this manner, and lazily update
1673 * the total weight of active stations from this list (filtering the stations in
1674 * the list by their 'last active' time).
1675 *
1676 * We add one additional safeguard to guard against stations that manage to get
1677 * scheduled every 100 ms but don't transmit a lot of data, and thus don't use
1678 * up any airtime. Such stations would be able to get priority for an extended
1679 * period of time if they do start transmitting at full capacity again, and so
1680 * we add an explicit maximum for how far behind a station is allowed to fall in
1681 * the virtual airtime domain. This limit is set to a relatively high value of
1682 * 20 ms because the main mechanism for catching up idle stations is the active
1683 * state as described above; i.e., the hard limit should only be hit in
1684 * pathological cases.
1685 */
1686#define AIRTIME_ACTIVE_DURATION (100 * NSEC_PER_MSEC)
1687#define AIRTIME_MAX_BEHIND 20000 /* 20 ms */
1688
1689static inline bool airtime_is_active(struct airtime_info *air_info, u64 now)
1690{
1691	return air_info->last_scheduled >= now - AIRTIME_ACTIVE_DURATION;
1692}
1693
1694static inline void airtime_set_active(struct airtime_sched_info *air_sched,
1695				      struct airtime_info *air_info, u64 now)
1696{
1697	air_info->last_scheduled = now;
1698	air_sched->last_schedule_activity = now;
1699	list_move_tail(&air_info->list, &air_sched->active_list);
1700}
1701
1702static inline bool airtime_catchup_v_t(struct airtime_sched_info *air_sched,
1703				       u64 v_t, u64 now)
1704{
1705	air_sched->v_t = v_t;
1706	return true;
1707}
1708
1709static inline void init_airtime_info(struct airtime_info *air_info,
1710				     struct airtime_sched_info *air_sched)
1711{
1712	atomic_set(&air_info->aql_tx_pending, 0);
1713	air_info->aql_limit_low = air_sched->aql_txq_limit_low;
1714	air_info->aql_limit_high = air_sched->aql_txq_limit_high;
1715	airtime_weight_set(air_info, IEEE80211_DEFAULT_AIRTIME_WEIGHT);
1716	INIT_LIST_HEAD(&air_info->list);
1717}
1718
1719static inline int ieee80211_bssid_match(const u8 *raddr, const u8 *addr)
1720{
1721	return ether_addr_equal(raddr, addr) ||
1722	       is_broadcast_ether_addr(raddr);
1723}
1724
1725static inline bool
1726ieee80211_have_rx_timestamp(struct ieee80211_rx_status *status)
1727{
1728	WARN_ON_ONCE(status->flag & RX_FLAG_MACTIME_START &&
1729		     status->flag & RX_FLAG_MACTIME_END);
1730	return !!(status->flag & (RX_FLAG_MACTIME_START | RX_FLAG_MACTIME_END |
1731				  RX_FLAG_MACTIME_PLCP_START));
 
 
 
 
 
1732}
1733
1734void ieee80211_vif_inc_num_mcast(struct ieee80211_sub_if_data *sdata);
1735void ieee80211_vif_dec_num_mcast(struct ieee80211_sub_if_data *sdata);
1736
1737/* This function returns the number of multicast stations connected to this
1738 * interface. It returns -1 if that number is not tracked, that is for netdevs
1739 * not in AP or AP_VLAN mode or when using 4addr.
1740 */
1741static inline int
1742ieee80211_vif_get_num_mcast_if(struct ieee80211_sub_if_data *sdata)
1743{
1744	if (sdata->vif.type == NL80211_IFTYPE_AP)
1745		return atomic_read(&sdata->u.ap.num_mcast_sta);
1746	if (sdata->vif.type == NL80211_IFTYPE_AP_VLAN && !sdata->u.vlan.sta)
1747		return atomic_read(&sdata->u.vlan.num_mcast_sta);
1748	return -1;
1749}
1750
1751u64 ieee80211_calculate_rx_timestamp(struct ieee80211_local *local,
1752				     struct ieee80211_rx_status *status,
1753				     unsigned int mpdu_len,
1754				     unsigned int mpdu_offset);
1755int ieee80211_hw_config(struct ieee80211_local *local, u32 changed);
1756void ieee80211_tx_set_protected(struct ieee80211_tx_data *tx);
1757void ieee80211_bss_info_change_notify(struct ieee80211_sub_if_data *sdata,
1758				      u32 changed);
1759void ieee80211_configure_filter(struct ieee80211_local *local);
1760u32 ieee80211_reset_erp_info(struct ieee80211_sub_if_data *sdata);
1761
1762u64 ieee80211_mgmt_tx_cookie(struct ieee80211_local *local);
1763int ieee80211_attach_ack_skb(struct ieee80211_local *local, struct sk_buff *skb,
1764			     u64 *cookie, gfp_t gfp);
1765
1766void ieee80211_check_fast_rx(struct sta_info *sta);
1767void __ieee80211_check_fast_rx_iface(struct ieee80211_sub_if_data *sdata);
1768void ieee80211_check_fast_rx_iface(struct ieee80211_sub_if_data *sdata);
1769void ieee80211_clear_fast_rx(struct sta_info *sta);
1770
1771/* STA code */
1772void ieee80211_sta_setup_sdata(struct ieee80211_sub_if_data *sdata);
1773int ieee80211_mgd_auth(struct ieee80211_sub_if_data *sdata,
1774		       struct cfg80211_auth_request *req);
1775int ieee80211_mgd_assoc(struct ieee80211_sub_if_data *sdata,
1776			struct cfg80211_assoc_request *req);
1777int ieee80211_mgd_deauth(struct ieee80211_sub_if_data *sdata,
1778			 struct cfg80211_deauth_request *req);
1779int ieee80211_mgd_disassoc(struct ieee80211_sub_if_data *sdata,
1780			   struct cfg80211_disassoc_request *req);
1781void ieee80211_send_pspoll(struct ieee80211_local *local,
1782			   struct ieee80211_sub_if_data *sdata);
1783void ieee80211_recalc_ps(struct ieee80211_local *local);
1784void ieee80211_recalc_ps_vif(struct ieee80211_sub_if_data *sdata);
1785int ieee80211_set_arp_filter(struct ieee80211_sub_if_data *sdata);
1786void ieee80211_sta_work(struct ieee80211_sub_if_data *sdata);
1787void ieee80211_sta_rx_queued_mgmt(struct ieee80211_sub_if_data *sdata,
1788				  struct sk_buff *skb);
1789void ieee80211_sta_rx_queued_ext(struct ieee80211_sub_if_data *sdata,
1790				 struct sk_buff *skb);
1791void ieee80211_sta_reset_beacon_monitor(struct ieee80211_sub_if_data *sdata);
1792void ieee80211_sta_reset_conn_monitor(struct ieee80211_sub_if_data *sdata);
1793void ieee80211_mgd_stop(struct ieee80211_sub_if_data *sdata);
1794void ieee80211_mgd_conn_tx_status(struct ieee80211_sub_if_data *sdata,
1795				  __le16 fc, bool acked);
1796void ieee80211_mgd_quiesce(struct ieee80211_sub_if_data *sdata);
1797void ieee80211_sta_restart(struct ieee80211_sub_if_data *sdata);
1798void ieee80211_sta_handle_tspec_ac_params(struct ieee80211_sub_if_data *sdata);
1799void ieee80211_sta_connection_lost(struct ieee80211_sub_if_data *sdata,
1800				   u8 *bssid, u8 reason, bool tx);
1801
1802/* IBSS code */
1803void ieee80211_ibss_notify_scan_completed(struct ieee80211_local *local);
1804void ieee80211_ibss_setup_sdata(struct ieee80211_sub_if_data *sdata);
1805void ieee80211_ibss_rx_no_sta(struct ieee80211_sub_if_data *sdata,
1806			      const u8 *bssid, const u8 *addr, u32 supp_rates);
1807int ieee80211_ibss_join(struct ieee80211_sub_if_data *sdata,
1808			struct cfg80211_ibss_params *params);
1809int ieee80211_ibss_leave(struct ieee80211_sub_if_data *sdata);
1810void ieee80211_ibss_work(struct ieee80211_sub_if_data *sdata);
1811void ieee80211_ibss_rx_queued_mgmt(struct ieee80211_sub_if_data *sdata,
1812				   struct sk_buff *skb);
1813int ieee80211_ibss_csa_beacon(struct ieee80211_sub_if_data *sdata,
1814			      struct cfg80211_csa_settings *csa_settings);
1815int ieee80211_ibss_finish_csa(struct ieee80211_sub_if_data *sdata);
1816void ieee80211_ibss_stop(struct ieee80211_sub_if_data *sdata);
1817
1818/* OCB code */
1819void ieee80211_ocb_work(struct ieee80211_sub_if_data *sdata);
1820void ieee80211_ocb_rx_no_sta(struct ieee80211_sub_if_data *sdata,
1821			     const u8 *bssid, const u8 *addr, u32 supp_rates);
1822void ieee80211_ocb_setup_sdata(struct ieee80211_sub_if_data *sdata);
1823int ieee80211_ocb_join(struct ieee80211_sub_if_data *sdata,
1824		       struct ocb_setup *setup);
1825int ieee80211_ocb_leave(struct ieee80211_sub_if_data *sdata);
1826
1827/* mesh code */
1828void ieee80211_mesh_work(struct ieee80211_sub_if_data *sdata);
1829void ieee80211_mesh_rx_queued_mgmt(struct ieee80211_sub_if_data *sdata,
1830				   struct sk_buff *skb);
1831int ieee80211_mesh_csa_beacon(struct ieee80211_sub_if_data *sdata,
1832			      struct cfg80211_csa_settings *csa_settings);
1833int ieee80211_mesh_finish_csa(struct ieee80211_sub_if_data *sdata);
1834
1835/* scan/BSS handling */
1836void ieee80211_scan_work(struct work_struct *work);
1837int ieee80211_request_ibss_scan(struct ieee80211_sub_if_data *sdata,
1838				const u8 *ssid, u8 ssid_len,
1839				struct ieee80211_channel **channels,
1840				unsigned int n_channels,
1841				enum nl80211_bss_scan_width scan_width);
1842int ieee80211_request_scan(struct ieee80211_sub_if_data *sdata,
1843			   struct cfg80211_scan_request *req);
1844void ieee80211_scan_cancel(struct ieee80211_local *local);
1845void ieee80211_run_deferred_scan(struct ieee80211_local *local);
1846void ieee80211_scan_rx(struct ieee80211_local *local, struct sk_buff *skb);
1847
1848void ieee80211_mlme_notify_scan_completed(struct ieee80211_local *local);
1849struct ieee80211_bss *
1850ieee80211_bss_info_update(struct ieee80211_local *local,
1851			  struct ieee80211_rx_status *rx_status,
1852			  struct ieee80211_mgmt *mgmt,
1853			  size_t len,
1854			  struct ieee80211_channel *channel);
1855void ieee80211_rx_bss_put(struct ieee80211_local *local,
1856			  struct ieee80211_bss *bss);
1857
1858/* scheduled scan handling */
1859int
1860__ieee80211_request_sched_scan_start(struct ieee80211_sub_if_data *sdata,
1861				     struct cfg80211_sched_scan_request *req);
1862int ieee80211_request_sched_scan_start(struct ieee80211_sub_if_data *sdata,
1863				       struct cfg80211_sched_scan_request *req);
1864int ieee80211_request_sched_scan_stop(struct ieee80211_local *local);
1865void ieee80211_sched_scan_end(struct ieee80211_local *local);
1866void ieee80211_sched_scan_stopped_work(struct work_struct *work);
1867
1868/* off-channel/mgmt-tx */
1869void ieee80211_offchannel_stop_vifs(struct ieee80211_local *local);
1870void ieee80211_offchannel_return(struct ieee80211_local *local);
1871void ieee80211_roc_setup(struct ieee80211_local *local);
1872void ieee80211_start_next_roc(struct ieee80211_local *local);
1873void ieee80211_roc_purge(struct ieee80211_local *local,
1874			 struct ieee80211_sub_if_data *sdata);
1875int ieee80211_remain_on_channel(struct wiphy *wiphy, struct wireless_dev *wdev,
1876				struct ieee80211_channel *chan,
1877				unsigned int duration, u64 *cookie);
1878int ieee80211_cancel_remain_on_channel(struct wiphy *wiphy,
1879				       struct wireless_dev *wdev, u64 cookie);
1880int ieee80211_mgmt_tx(struct wiphy *wiphy, struct wireless_dev *wdev,
1881		      struct cfg80211_mgmt_tx_params *params, u64 *cookie);
1882int ieee80211_mgmt_tx_cancel_wait(struct wiphy *wiphy,
1883				  struct wireless_dev *wdev, u64 cookie);
1884
1885/* channel switch handling */
1886void ieee80211_csa_finalize_work(struct work_struct *work);
1887int ieee80211_channel_switch(struct wiphy *wiphy, struct net_device *dev,
1888			     struct cfg80211_csa_settings *params);
1889
1890/* interface handling */
1891#define MAC80211_SUPPORTED_FEATURES_TX	(NETIF_F_IP_CSUM | NETIF_F_IPV6_CSUM | \
1892					 NETIF_F_HW_CSUM | NETIF_F_SG | \
1893					 NETIF_F_HIGHDMA | NETIF_F_GSO_SOFTWARE)
1894#define MAC80211_SUPPORTED_FEATURES_RX	(NETIF_F_RXCSUM)
1895#define MAC80211_SUPPORTED_FEATURES	(MAC80211_SUPPORTED_FEATURES_TX | \
1896					 MAC80211_SUPPORTED_FEATURES_RX)
1897
1898int ieee80211_iface_init(void);
1899void ieee80211_iface_exit(void);
1900int ieee80211_if_add(struct ieee80211_local *local, const char *name,
1901		     unsigned char name_assign_type,
1902		     struct wireless_dev **new_wdev, enum nl80211_iftype type,
1903		     struct vif_params *params);
1904int ieee80211_if_change_type(struct ieee80211_sub_if_data *sdata,
1905			     enum nl80211_iftype type);
1906void ieee80211_if_remove(struct ieee80211_sub_if_data *sdata);
1907void ieee80211_remove_interfaces(struct ieee80211_local *local);
1908u32 ieee80211_idle_off(struct ieee80211_local *local);
1909void ieee80211_recalc_idle(struct ieee80211_local *local);
1910void ieee80211_adjust_monitor_flags(struct ieee80211_sub_if_data *sdata,
1911				    const int offset);
1912int ieee80211_do_open(struct wireless_dev *wdev, bool coming_up);
1913void ieee80211_sdata_stop(struct ieee80211_sub_if_data *sdata);
1914int ieee80211_add_virtual_monitor(struct ieee80211_local *local);
1915void ieee80211_del_virtual_monitor(struct ieee80211_local *local);
1916
1917bool __ieee80211_recalc_txpower(struct ieee80211_sub_if_data *sdata);
1918void ieee80211_recalc_txpower(struct ieee80211_sub_if_data *sdata,
1919			      bool update_bss);
1920void ieee80211_recalc_offload(struct ieee80211_local *local);
1921
1922static inline bool ieee80211_sdata_running(struct ieee80211_sub_if_data *sdata)
1923{
1924	return test_bit(SDATA_STATE_RUNNING, &sdata->state);
1925}
1926
1927/* tx handling */
1928void ieee80211_clear_tx_pending(struct ieee80211_local *local);
1929void ieee80211_tx_pending(struct tasklet_struct *t);
1930netdev_tx_t ieee80211_monitor_start_xmit(struct sk_buff *skb,
1931					 struct net_device *dev);
1932netdev_tx_t ieee80211_subif_start_xmit(struct sk_buff *skb,
1933				       struct net_device *dev);
1934netdev_tx_t ieee80211_subif_start_xmit_8023(struct sk_buff *skb,
1935					    struct net_device *dev);
1936void __ieee80211_subif_start_xmit(struct sk_buff *skb,
1937				  struct net_device *dev,
1938				  u32 info_flags,
1939				  u32 ctrl_flags,
1940				  u64 *cookie);
1941void ieee80211_purge_tx_queue(struct ieee80211_hw *hw,
1942			      struct sk_buff_head *skbs);
1943struct sk_buff *
1944ieee80211_build_data_template(struct ieee80211_sub_if_data *sdata,
1945			      struct sk_buff *skb, u32 info_flags);
1946void ieee80211_tx_monitor(struct ieee80211_local *local, struct sk_buff *skb,
1947			  struct ieee80211_supported_band *sband,
1948			  int retry_count, int shift, bool send_to_cooked,
1949			  struct ieee80211_tx_status *status);
1950
1951void ieee80211_check_fast_xmit(struct sta_info *sta);
1952void ieee80211_check_fast_xmit_all(struct ieee80211_local *local);
1953void ieee80211_check_fast_xmit_iface(struct ieee80211_sub_if_data *sdata);
1954void ieee80211_clear_fast_xmit(struct sta_info *sta);
1955int ieee80211_tx_control_port(struct wiphy *wiphy, struct net_device *dev,
1956			      const u8 *buf, size_t len,
1957			      const u8 *dest, __be16 proto, bool unencrypted,
1958			      u64 *cookie);
1959int ieee80211_probe_mesh_link(struct wiphy *wiphy, struct net_device *dev,
1960			      const u8 *buf, size_t len);
1961void ieee80211_resort_txq(struct ieee80211_hw *hw,
1962			  struct ieee80211_txq *txq);
1963void ieee80211_unschedule_txq(struct ieee80211_hw *hw,
1964			      struct ieee80211_txq *txq,
1965			      bool purge);
1966void ieee80211_update_airtime_weight(struct ieee80211_local *local,
1967				     struct airtime_sched_info *air_sched,
1968				     u64 now, bool force);
1969
1970/* HT */
1971void ieee80211_apply_htcap_overrides(struct ieee80211_sub_if_data *sdata,
1972				     struct ieee80211_sta_ht_cap *ht_cap);
1973bool ieee80211_ht_cap_ie_to_sta_ht_cap(struct ieee80211_sub_if_data *sdata,
1974				       struct ieee80211_supported_band *sband,
1975				       const struct ieee80211_ht_cap *ht_cap_ie,
1976				       struct sta_info *sta);
1977void ieee80211_send_delba(struct ieee80211_sub_if_data *sdata,
1978			  const u8 *da, u16 tid,
1979			  u16 initiator, u16 reason_code);
1980int ieee80211_send_smps_action(struct ieee80211_sub_if_data *sdata,
1981			       enum ieee80211_smps_mode smps, const u8 *da,
1982			       const u8 *bssid);
1983void ieee80211_request_smps_ap_work(struct work_struct *work);
1984void ieee80211_request_smps_mgd_work(struct work_struct *work);
1985bool ieee80211_smps_is_restrictive(enum ieee80211_smps_mode smps_mode_old,
1986				   enum ieee80211_smps_mode smps_mode_new);
1987
1988void ___ieee80211_stop_rx_ba_session(struct sta_info *sta, u16 tid,
1989				     u16 initiator, u16 reason, bool stop);
1990void __ieee80211_stop_rx_ba_session(struct sta_info *sta, u16 tid,
1991				    u16 initiator, u16 reason, bool stop);
1992void ___ieee80211_start_rx_ba_session(struct sta_info *sta,
1993				      u8 dialog_token, u16 timeout,
1994				      u16 start_seq_num, u16 ba_policy, u16 tid,
1995				      u16 buf_size, bool tx, bool auto_seq,
1996				      const struct ieee80211_addba_ext_ie *addbaext);
1997void ieee80211_sta_tear_down_BA_sessions(struct sta_info *sta,
1998					 enum ieee80211_agg_stop_reason reason);
1999void ieee80211_process_delba(struct ieee80211_sub_if_data *sdata,
2000			     struct sta_info *sta,
2001			     struct ieee80211_mgmt *mgmt, size_t len);
2002void ieee80211_process_addba_resp(struct ieee80211_local *local,
2003				  struct sta_info *sta,
2004				  struct ieee80211_mgmt *mgmt,
2005				  size_t len);
2006void ieee80211_process_addba_request(struct ieee80211_local *local,
2007				     struct sta_info *sta,
2008				     struct ieee80211_mgmt *mgmt,
2009				     size_t len);
2010
2011int __ieee80211_stop_tx_ba_session(struct sta_info *sta, u16 tid,
2012				   enum ieee80211_agg_stop_reason reason);
2013int ___ieee80211_stop_tx_ba_session(struct sta_info *sta, u16 tid,
2014				    enum ieee80211_agg_stop_reason reason);
2015void ieee80211_start_tx_ba_cb(struct sta_info *sta, int tid,
2016			      struct tid_ampdu_tx *tid_tx);
2017void ieee80211_stop_tx_ba_cb(struct sta_info *sta, int tid,
2018			     struct tid_ampdu_tx *tid_tx);
2019void ieee80211_ba_session_work(struct work_struct *work);
2020void ieee80211_tx_ba_session_handle_start(struct sta_info *sta, int tid);
2021void ieee80211_release_reorder_timeout(struct sta_info *sta, int tid);
2022
2023u8 ieee80211_mcs_to_chains(const struct ieee80211_mcs_info *mcs);
2024enum nl80211_smps_mode
2025ieee80211_smps_mode_to_smps_mode(enum ieee80211_smps_mode smps);
2026
2027/* VHT */
2028void
2029ieee80211_vht_cap_ie_to_sta_vht_cap(struct ieee80211_sub_if_data *sdata,
2030				    struct ieee80211_supported_band *sband,
2031				    const struct ieee80211_vht_cap *vht_cap_ie,
2032				    struct sta_info *sta);
2033enum ieee80211_sta_rx_bandwidth ieee80211_sta_cap_rx_bw(struct sta_info *sta);
2034enum ieee80211_sta_rx_bandwidth ieee80211_sta_cur_vht_bw(struct sta_info *sta);
2035void ieee80211_sta_set_rx_nss(struct sta_info *sta);
2036enum ieee80211_sta_rx_bandwidth
2037ieee80211_chan_width_to_rx_bw(enum nl80211_chan_width width);
2038enum nl80211_chan_width ieee80211_sta_cap_chan_bw(struct sta_info *sta);
 
2039void ieee80211_process_mu_groups(struct ieee80211_sub_if_data *sdata,
2040				 struct ieee80211_mgmt *mgmt);
2041u32 __ieee80211_vht_handle_opmode(struct ieee80211_sub_if_data *sdata,
2042                                  struct sta_info *sta, u8 opmode,
2043				  enum nl80211_band band);
2044void ieee80211_vht_handle_opmode(struct ieee80211_sub_if_data *sdata,
2045				 struct sta_info *sta, u8 opmode,
2046				 enum nl80211_band band);
2047void ieee80211_apply_vhtcap_overrides(struct ieee80211_sub_if_data *sdata,
2048				      struct ieee80211_sta_vht_cap *vht_cap);
2049void ieee80211_get_vht_mask_from_cap(__le16 vht_cap,
2050				     u16 vht_mask[NL80211_VHT_NSS_MAX]);
2051enum nl80211_chan_width
2052ieee80211_sta_rx_bw_to_chan_width(struct sta_info *sta);
2053
2054/* HE */
2055void
2056ieee80211_he_cap_ie_to_sta_he_cap(struct ieee80211_sub_if_data *sdata,
2057				  struct ieee80211_supported_band *sband,
2058				  const u8 *he_cap_ie, u8 he_cap_len,
2059				  const struct ieee80211_he_6ghz_capa *he_6ghz_capa,
2060				  struct sta_info *sta);
2061void
2062ieee80211_he_spr_ie_to_bss_conf(struct ieee80211_vif *vif,
2063				const struct ieee80211_he_spr *he_spr_ie_elem);
2064
2065void
2066ieee80211_he_op_ie_to_bss_conf(struct ieee80211_vif *vif,
2067			const struct ieee80211_he_operation *he_op_ie_elem);
2068
2069/* S1G */
2070void ieee80211_s1g_sta_rate_init(struct sta_info *sta);
2071
2072/* Spectrum management */
2073void ieee80211_process_measurement_req(struct ieee80211_sub_if_data *sdata,
2074				       struct ieee80211_mgmt *mgmt,
2075				       size_t len);
2076/**
2077 * ieee80211_parse_ch_switch_ie - parses channel switch IEs
2078 * @sdata: the sdata of the interface which has received the frame
2079 * @elems: parsed 802.11 elements received with the frame
2080 * @current_band: indicates the current band
2081 * @vht_cap_info: VHT capabilities of the transmitter
2082 * @sta_flags: contains information about own capabilities and restrictions
2083 *	to decide which channel switch announcements can be accepted. Only the
2084 *	following subset of &enum ieee80211_sta_flags are evaluated:
2085 *	%IEEE80211_STA_DISABLE_HT, %IEEE80211_STA_DISABLE_VHT,
2086 *	%IEEE80211_STA_DISABLE_40MHZ, %IEEE80211_STA_DISABLE_80P80MHZ,
2087 *	%IEEE80211_STA_DISABLE_160MHZ.
2088 * @bssid: the currently connected bssid (for reporting)
2089 * @csa_ie: parsed 802.11 csa elements on count, mode, chandef and mesh ttl.
2090	All of them will be filled with if success only.
2091 * Return: 0 on success, <0 on error and >0 if there is nothing to parse.
2092 */
2093int ieee80211_parse_ch_switch_ie(struct ieee80211_sub_if_data *sdata,
2094				 struct ieee802_11_elems *elems,
2095				 enum nl80211_band current_band,
2096				 u32 vht_cap_info,
2097				 u32 sta_flags, u8 *bssid,
2098				 struct ieee80211_csa_ie *csa_ie);
2099
2100/* Suspend/resume and hw reconfiguration */
2101int ieee80211_reconfig(struct ieee80211_local *local);
2102void ieee80211_stop_device(struct ieee80211_local *local);
2103
2104int __ieee80211_suspend(struct ieee80211_hw *hw,
2105			struct cfg80211_wowlan *wowlan);
2106
2107static inline int __ieee80211_resume(struct ieee80211_hw *hw)
2108{
2109	struct ieee80211_local *local = hw_to_local(hw);
2110
2111	WARN(test_bit(SCAN_HW_SCANNING, &local->scanning) &&
2112	     !test_bit(SCAN_COMPLETED, &local->scanning),
2113		"%s: resume with hardware scan still in progress\n",
2114		wiphy_name(hw->wiphy));
2115
2116	return ieee80211_reconfig(hw_to_local(hw));
2117}
2118
2119/* utility functions/constants */
2120extern const void *const mac80211_wiphy_privid; /* for wiphy privid */
2121int ieee80211_frame_duration(enum nl80211_band band, size_t len,
2122			     int rate, int erp, int short_preamble,
2123			     int shift);
2124void ieee80211_regulatory_limit_wmm_params(struct ieee80211_sub_if_data *sdata,
2125					   struct ieee80211_tx_queue_params *qparam,
2126					   int ac);
2127void ieee80211_set_wmm_default(struct ieee80211_sub_if_data *sdata,
2128			       bool bss_notify, bool enable_qos);
2129void ieee80211_xmit(struct ieee80211_sub_if_data *sdata,
2130		    struct sta_info *sta, struct sk_buff *skb);
2131
2132void __ieee80211_tx_skb_tid_band(struct ieee80211_sub_if_data *sdata,
2133				 struct sk_buff *skb, int tid,
2134				 enum nl80211_band band);
2135
2136/* sta_out needs to be checked for ERR_PTR() before using */
2137int ieee80211_lookup_ra_sta(struct ieee80211_sub_if_data *sdata,
2138			    struct sk_buff *skb,
2139			    struct sta_info **sta_out);
2140
2141static inline void
2142ieee80211_tx_skb_tid_band(struct ieee80211_sub_if_data *sdata,
2143			  struct sk_buff *skb, int tid,
2144			  enum nl80211_band band)
2145{
2146	rcu_read_lock();
2147	__ieee80211_tx_skb_tid_band(sdata, skb, tid, band);
2148	rcu_read_unlock();
2149}
2150
2151static inline void ieee80211_tx_skb_tid(struct ieee80211_sub_if_data *sdata,
2152					struct sk_buff *skb, int tid)
2153{
2154	struct ieee80211_chanctx_conf *chanctx_conf;
2155
2156	rcu_read_lock();
2157	chanctx_conf = rcu_dereference(sdata->vif.chanctx_conf);
2158	if (WARN_ON(!chanctx_conf)) {
2159		rcu_read_unlock();
2160		kfree_skb(skb);
2161		return;
2162	}
2163
2164	__ieee80211_tx_skb_tid_band(sdata, skb, tid,
2165				    chanctx_conf->def.chan->band);
2166	rcu_read_unlock();
2167}
2168
2169static inline void ieee80211_tx_skb(struct ieee80211_sub_if_data *sdata,
2170				    struct sk_buff *skb)
2171{
2172	/* Send all internal mgmt frames on VO. Accordingly set TID to 7. */
2173	ieee80211_tx_skb_tid(sdata, skb, 7);
2174}
2175
2176u32 ieee802_11_parse_elems_crc(const u8 *start, size_t len, bool action,
2177			       struct ieee802_11_elems *elems,
2178			       u64 filter, u32 crc, u8 *transmitter_bssid,
2179			       u8 *bss_bssid);
2180static inline void ieee802_11_parse_elems(const u8 *start, size_t len,
2181					  bool action,
2182					  struct ieee802_11_elems *elems,
2183					  u8 *transmitter_bssid,
2184					  u8 *bss_bssid)
2185{
2186	ieee802_11_parse_elems_crc(start, len, action, elems, 0, 0,
2187				   transmitter_bssid, bss_bssid);
2188}
2189
2190
2191extern const int ieee802_1d_to_ac[8];
2192
2193static inline int ieee80211_ac_from_tid(int tid)
2194{
2195	return ieee802_1d_to_ac[tid & 7];
2196}
2197
2198void ieee80211_dynamic_ps_enable_work(struct work_struct *work);
2199void ieee80211_dynamic_ps_disable_work(struct work_struct *work);
2200void ieee80211_dynamic_ps_timer(struct timer_list *t);
2201void ieee80211_send_nullfunc(struct ieee80211_local *local,
2202			     struct ieee80211_sub_if_data *sdata,
2203			     bool powersave);
2204void ieee80211_send_4addr_nullfunc(struct ieee80211_local *local,
2205				   struct ieee80211_sub_if_data *sdata);
2206void ieee80211_sta_tx_notify(struct ieee80211_sub_if_data *sdata,
2207			     struct ieee80211_hdr *hdr, bool ack, u16 tx_time);
2208
2209void ieee80211_wake_queues_by_reason(struct ieee80211_hw *hw,
2210				     unsigned long queues,
2211				     enum queue_stop_reason reason,
2212				     bool refcounted);
2213void ieee80211_stop_vif_queues(struct ieee80211_local *local,
2214			       struct ieee80211_sub_if_data *sdata,
2215			       enum queue_stop_reason reason);
2216void ieee80211_wake_vif_queues(struct ieee80211_local *local,
2217			       struct ieee80211_sub_if_data *sdata,
2218			       enum queue_stop_reason reason);
2219void ieee80211_stop_queues_by_reason(struct ieee80211_hw *hw,
2220				     unsigned long queues,
2221				     enum queue_stop_reason reason,
2222				     bool refcounted);
2223void ieee80211_wake_queue_by_reason(struct ieee80211_hw *hw, int queue,
2224				    enum queue_stop_reason reason,
2225				    bool refcounted);
2226void ieee80211_stop_queue_by_reason(struct ieee80211_hw *hw, int queue,
2227				    enum queue_stop_reason reason,
2228				    bool refcounted);
2229void ieee80211_propagate_queue_wake(struct ieee80211_local *local, int queue);
2230void ieee80211_add_pending_skb(struct ieee80211_local *local,
2231			       struct sk_buff *skb);
2232void ieee80211_add_pending_skbs(struct ieee80211_local *local,
2233				struct sk_buff_head *skbs);
2234void ieee80211_flush_queues(struct ieee80211_local *local,
2235			    struct ieee80211_sub_if_data *sdata, bool drop);
2236void __ieee80211_flush_queues(struct ieee80211_local *local,
2237			      struct ieee80211_sub_if_data *sdata,
2238			      unsigned int queues, bool drop);
2239
2240static inline bool ieee80211_can_run_worker(struct ieee80211_local *local)
2241{
2242	/*
2243	 * It's unsafe to try to do any work during reconfigure flow.
2244	 * When the flow ends the work will be requeued.
2245	 */
2246	if (local->in_reconfig)
2247		return false;
2248
2249	/*
2250	 * If quiescing is set, we are racing with __ieee80211_suspend.
2251	 * __ieee80211_suspend flushes the workers after setting quiescing,
2252	 * and we check quiescing / suspended before enqueing new workers.
2253	 * We should abort the worker to avoid the races below.
2254	 */
2255	if (local->quiescing)
2256		return false;
2257
2258	/*
2259	 * We might already be suspended if the following scenario occurs:
2260	 * __ieee80211_suspend		Control path
2261	 *
2262	 *				if (local->quiescing)
2263	 *					return;
2264	 * local->quiescing = true;
2265	 * flush_workqueue();
2266	 *				queue_work(...);
2267	 * local->suspended = true;
2268	 * local->quiescing = false;
2269	 *				worker starts running...
2270	 */
2271	if (local->suspended)
2272		return false;
2273
2274	return true;
2275}
2276
2277int ieee80211_txq_setup_flows(struct ieee80211_local *local);
2278void ieee80211_txq_set_params(struct ieee80211_local *local);
2279void ieee80211_txq_teardown_flows(struct ieee80211_local *local);
2280void ieee80211_txq_init(struct ieee80211_sub_if_data *sdata,
2281			struct sta_info *sta,
2282			struct txq_info *txq, int tid);
2283void ieee80211_txq_purge(struct ieee80211_local *local,
2284			 struct txq_info *txqi);
2285void ieee80211_txq_remove_vlan(struct ieee80211_local *local,
2286			       struct ieee80211_sub_if_data *sdata);
2287void ieee80211_fill_txq_stats(struct cfg80211_txq_stats *txqstats,
2288			      struct txq_info *txqi);
2289void ieee80211_wake_txqs(struct tasklet_struct *t);
2290void ieee80211_send_auth(struct ieee80211_sub_if_data *sdata,
2291			 u16 transaction, u16 auth_alg, u16 status,
2292			 const u8 *extra, size_t extra_len, const u8 *bssid,
2293			 const u8 *da, const u8 *key, u8 key_len, u8 key_idx,
2294			 u32 tx_flags);
2295void ieee80211_send_deauth_disassoc(struct ieee80211_sub_if_data *sdata,
2296				    const u8 *da, const u8 *bssid,
2297				    u16 stype, u16 reason,
2298				    bool send_frame, u8 *frame_buf);
2299
2300enum {
2301	IEEE80211_PROBE_FLAG_DIRECTED		= BIT(0),
2302	IEEE80211_PROBE_FLAG_MIN_CONTENT	= BIT(1),
2303	IEEE80211_PROBE_FLAG_RANDOM_SN		= BIT(2),
2304};
2305
2306int ieee80211_build_preq_ies(struct ieee80211_sub_if_data *sdata, u8 *buffer,
2307			     size_t buffer_len,
2308			     struct ieee80211_scan_ies *ie_desc,
2309			     const u8 *ie, size_t ie_len,
2310			     u8 bands_used, u32 *rate_masks,
2311			     struct cfg80211_chan_def *chandef,
2312			     u32 flags);
2313struct sk_buff *ieee80211_build_probe_req(struct ieee80211_sub_if_data *sdata,
2314					  const u8 *src, const u8 *dst,
2315					  u32 ratemask,
2316					  struct ieee80211_channel *chan,
2317					  const u8 *ssid, size_t ssid_len,
2318					  const u8 *ie, size_t ie_len,
2319					  u32 flags);
2320u32 ieee80211_sta_get_rates(struct ieee80211_sub_if_data *sdata,
2321			    struct ieee802_11_elems *elems,
2322			    enum nl80211_band band, u32 *basic_rates);
2323int __ieee80211_request_smps_mgd(struct ieee80211_sub_if_data *sdata,
2324				 enum ieee80211_smps_mode smps_mode);
2325void ieee80211_recalc_smps(struct ieee80211_sub_if_data *sdata);
2326void ieee80211_recalc_min_chandef(struct ieee80211_sub_if_data *sdata);
2327
2328size_t ieee80211_ie_split_vendor(const u8 *ies, size_t ielen, size_t offset);
2329u8 *ieee80211_ie_build_ht_cap(u8 *pos, struct ieee80211_sta_ht_cap *ht_cap,
2330			      u16 cap);
2331u8 *ieee80211_ie_build_ht_oper(u8 *pos, struct ieee80211_sta_ht_cap *ht_cap,
2332			       const struct cfg80211_chan_def *chandef,
2333			       u16 prot_mode, bool rifs_mode);
2334void ieee80211_ie_build_wide_bw_cs(u8 *pos,
2335				   const struct cfg80211_chan_def *chandef);
2336u8 *ieee80211_ie_build_vht_cap(u8 *pos, struct ieee80211_sta_vht_cap *vht_cap,
2337			       u32 cap);
2338u8 *ieee80211_ie_build_vht_oper(u8 *pos, struct ieee80211_sta_vht_cap *vht_cap,
2339				const struct cfg80211_chan_def *chandef);
2340u8 ieee80211_ie_len_he_cap(struct ieee80211_sub_if_data *sdata, u8 iftype);
2341u8 *ieee80211_ie_build_he_cap(u8 *pos,
2342			      const struct ieee80211_sta_he_cap *he_cap,
2343			      u8 *end);
2344void ieee80211_ie_build_he_6ghz_cap(struct ieee80211_sub_if_data *sdata,
2345				    struct sk_buff *skb);
2346u8 *ieee80211_ie_build_he_oper(u8 *pos, struct cfg80211_chan_def *chandef);
2347int ieee80211_parse_bitrates(struct cfg80211_chan_def *chandef,
2348			     const struct ieee80211_supported_band *sband,
2349			     const u8 *srates, int srates_len, u32 *rates);
2350int ieee80211_add_srates_ie(struct ieee80211_sub_if_data *sdata,
2351			    struct sk_buff *skb, bool need_basic,
2352			    enum nl80211_band band);
2353int ieee80211_add_ext_srates_ie(struct ieee80211_sub_if_data *sdata,
2354				struct sk_buff *skb, bool need_basic,
2355				enum nl80211_band band);
2356u8 *ieee80211_add_wmm_info_ie(u8 *buf, u8 qosinfo);
2357void ieee80211_add_s1g_capab_ie(struct ieee80211_sub_if_data *sdata,
2358				struct ieee80211_sta_s1g_cap *caps,
2359				struct sk_buff *skb);
2360void ieee80211_add_aid_request_ie(struct ieee80211_sub_if_data *sdata,
2361				  struct sk_buff *skb);
2362
2363/* channel management */
2364bool ieee80211_chandef_ht_oper(const struct ieee80211_ht_operation *ht_oper,
2365			       struct cfg80211_chan_def *chandef);
2366bool ieee80211_chandef_vht_oper(struct ieee80211_hw *hw, u32 vht_cap_info,
2367				const struct ieee80211_vht_operation *oper,
2368				const struct ieee80211_ht_operation *htop,
2369				struct cfg80211_chan_def *chandef);
2370bool ieee80211_chandef_he_6ghz_oper(struct ieee80211_sub_if_data *sdata,
2371				    const struct ieee80211_he_operation *he_oper,
2372				    struct cfg80211_chan_def *chandef);
2373bool ieee80211_chandef_s1g_oper(const struct ieee80211_s1g_oper_ie *oper,
2374				struct cfg80211_chan_def *chandef);
2375u32 ieee80211_chandef_downgrade(struct cfg80211_chan_def *c);
2376
2377int __must_check
2378ieee80211_vif_use_channel(struct ieee80211_sub_if_data *sdata,
2379			  const struct cfg80211_chan_def *chandef,
2380			  enum ieee80211_chanctx_mode mode);
2381int __must_check
2382ieee80211_vif_reserve_chanctx(struct ieee80211_sub_if_data *sdata,
2383			      const struct cfg80211_chan_def *chandef,
2384			      enum ieee80211_chanctx_mode mode,
2385			      bool radar_required);
2386int __must_check
2387ieee80211_vif_use_reserved_context(struct ieee80211_sub_if_data *sdata);
2388int ieee80211_vif_unreserve_chanctx(struct ieee80211_sub_if_data *sdata);
2389
2390int __must_check
2391ieee80211_vif_change_bandwidth(struct ieee80211_sub_if_data *sdata,
2392			       const struct cfg80211_chan_def *chandef,
2393			       u32 *changed);
2394void ieee80211_vif_release_channel(struct ieee80211_sub_if_data *sdata);
2395void ieee80211_vif_vlan_copy_chanctx(struct ieee80211_sub_if_data *sdata);
2396void ieee80211_vif_copy_chanctx_to_vlans(struct ieee80211_sub_if_data *sdata,
2397					 bool clear);
2398int ieee80211_chanctx_refcount(struct ieee80211_local *local,
2399			       struct ieee80211_chanctx *ctx);
2400
2401void ieee80211_recalc_smps_chanctx(struct ieee80211_local *local,
2402				   struct ieee80211_chanctx *chanctx);
2403void ieee80211_recalc_chanctx_min_def(struct ieee80211_local *local,
2404				      struct ieee80211_chanctx *ctx);
2405bool ieee80211_is_radar_required(struct ieee80211_local *local);
2406
2407void ieee80211_dfs_cac_timer(unsigned long data);
2408void ieee80211_dfs_cac_timer_work(struct work_struct *work);
2409void ieee80211_dfs_cac_cancel(struct ieee80211_local *local);
2410void ieee80211_dfs_radar_detected_work(struct work_struct *work);
2411int ieee80211_send_action_csa(struct ieee80211_sub_if_data *sdata,
2412			      struct cfg80211_csa_settings *csa_settings);
2413
2414bool ieee80211_cs_valid(const struct ieee80211_cipher_scheme *cs);
2415bool ieee80211_cs_list_valid(const struct ieee80211_cipher_scheme *cs, int n);
2416const struct ieee80211_cipher_scheme *
2417ieee80211_cs_get(struct ieee80211_local *local, u32 cipher,
2418		 enum nl80211_iftype iftype);
2419int ieee80211_cs_headroom(struct ieee80211_local *local,
2420			  struct cfg80211_crypto_settings *crypto,
2421			  enum nl80211_iftype iftype);
2422void ieee80211_recalc_dtim(struct ieee80211_local *local,
2423			   struct ieee80211_sub_if_data *sdata);
2424int ieee80211_check_combinations(struct ieee80211_sub_if_data *sdata,
2425				 const struct cfg80211_chan_def *chandef,
2426				 enum ieee80211_chanctx_mode chanmode,
2427				 u8 radar_detect);
2428int ieee80211_max_num_channels(struct ieee80211_local *local);
 
2429void ieee80211_recalc_chanctx_chantype(struct ieee80211_local *local,
2430				       struct ieee80211_chanctx *ctx);
2431
2432/* TDLS */
2433int ieee80211_tdls_mgmt(struct wiphy *wiphy, struct net_device *dev,
2434			const u8 *peer, u8 action_code, u8 dialog_token,
2435			u16 status_code, u32 peer_capability,
2436			bool initiator, const u8 *extra_ies,
2437			size_t extra_ies_len);
2438int ieee80211_tdls_oper(struct wiphy *wiphy, struct net_device *dev,
2439			const u8 *peer, enum nl80211_tdls_operation oper);
2440void ieee80211_tdls_peer_del_work(struct work_struct *wk);
2441int ieee80211_tdls_channel_switch(struct wiphy *wiphy, struct net_device *dev,
2442				  const u8 *addr, u8 oper_class,
2443				  struct cfg80211_chan_def *chandef);
2444void ieee80211_tdls_cancel_channel_switch(struct wiphy *wiphy,
2445					  struct net_device *dev,
2446					  const u8 *addr);
2447void ieee80211_teardown_tdls_peers(struct ieee80211_sub_if_data *sdata);
 
2448void ieee80211_tdls_handle_disconnect(struct ieee80211_sub_if_data *sdata,
2449				      const u8 *peer, u16 reason);
2450void
2451ieee80211_process_tdls_channel_switch(struct ieee80211_sub_if_data *sdata,
2452				      struct sk_buff *skb);
2453
2454
2455const char *ieee80211_get_reason_code_string(u16 reason_code);
2456u16 ieee80211_encode_usf(int val);
2457u8 *ieee80211_get_bssid(struct ieee80211_hdr *hdr, size_t len,
2458			enum nl80211_iftype type);
2459
2460extern const struct ethtool_ops ieee80211_ethtool_ops;
2461
2462u32 ieee80211_calc_expected_tx_airtime(struct ieee80211_hw *hw,
2463				       struct ieee80211_vif *vif,
2464				       struct ieee80211_sta *pubsta,
2465				       int len, bool ampdu);
2466#ifdef CONFIG_MAC80211_NOINLINE
2467#define debug_noinline noinline
2468#else
2469#define debug_noinline
2470#endif
2471
2472void ieee80211_init_frag_cache(struct ieee80211_fragment_cache *cache);
2473void ieee80211_destroy_frag_cache(struct ieee80211_fragment_cache *cache);
2474
2475#endif /* IEEE80211_I_H */
v5.9
   1/* SPDX-License-Identifier: GPL-2.0-only */
   2/*
   3 * Copyright 2002-2005, Instant802 Networks, Inc.
   4 * Copyright 2005, Devicescape Software, Inc.
   5 * Copyright 2006-2007	Jiri Benc <jbenc@suse.cz>
   6 * Copyright 2007-2010	Johannes Berg <johannes@sipsolutions.net>
   7 * Copyright 2013-2015  Intel Mobile Communications GmbH
   8 * Copyright (C) 2018-2020 Intel Corporation
   9 */
  10
  11#ifndef IEEE80211_I_H
  12#define IEEE80211_I_H
  13
  14#include <linux/kernel.h>
  15#include <linux/device.h>
  16#include <linux/if_ether.h>
  17#include <linux/interrupt.h>
  18#include <linux/list.h>
  19#include <linux/netdevice.h>
  20#include <linux/skbuff.h>
  21#include <linux/workqueue.h>
  22#include <linux/types.h>
  23#include <linux/spinlock.h>
  24#include <linux/etherdevice.h>
  25#include <linux/leds.h>
  26#include <linux/idr.h>
  27#include <linux/rhashtable.h>
  28#include <net/ieee80211_radiotap.h>
  29#include <net/cfg80211.h>
  30#include <net/mac80211.h>
  31#include <net/fq.h>
  32#include "key.h"
  33#include "sta_info.h"
  34#include "debug.h"
  35
  36extern const struct cfg80211_ops mac80211_config_ops;
  37
  38struct ieee80211_local;
  39
  40/* Maximum number of broadcast/multicast frames to buffer when some of the
  41 * associated stations are using power saving. */
  42#define AP_MAX_BC_BUFFER 128
  43
  44/* Maximum number of frames buffered to all STAs, including multicast frames.
  45 * Note: increasing this limit increases the potential memory requirement. Each
  46 * frame can be up to about 2 kB long. */
  47#define TOTAL_MAX_TX_BUFFER 512
  48
  49/* Required encryption head and tailroom */
  50#define IEEE80211_ENCRYPT_HEADROOM 8
  51#define IEEE80211_ENCRYPT_TAILROOM 18
  52
  53/* IEEE 802.11 (Ch. 9.5 Defragmentation) requires support for concurrent
  54 * reception of at least three fragmented frames. This limit can be increased
  55 * by changing this define, at the cost of slower frame reassembly and
  56 * increased memory use (about 2 kB of RAM per entry). */
  57#define IEEE80211_FRAGMENT_MAX 4
  58
  59/* power level hasn't been configured (or set to automatic) */
  60#define IEEE80211_UNSET_POWER_LEVEL	INT_MIN
  61
  62/*
  63 * Some APs experience problems when working with U-APSD. Decreasing the
  64 * probability of that happening by using legacy mode for all ACs but VO isn't
  65 * enough.
  66 *
  67 * Cisco 4410N originally forced us to enable VO by default only because it
  68 * treated non-VO ACs as legacy.
  69 *
  70 * However some APs (notably Netgear R7000) silently reclassify packets to
  71 * different ACs. Since u-APSD ACs require trigger frames for frame retrieval
  72 * clients would never see some frames (e.g. ARP responses) or would fetch them
  73 * accidentally after a long time.
  74 *
  75 * It makes little sense to enable u-APSD queues by default because it needs
  76 * userspace applications to be aware of it to actually take advantage of the
  77 * possible additional powersavings. Implicitly depending on driver autotrigger
  78 * frame support doesn't make much sense.
  79 */
  80#define IEEE80211_DEFAULT_UAPSD_QUEUES 0
  81
  82#define IEEE80211_DEFAULT_MAX_SP_LEN		\
  83	IEEE80211_WMM_IE_STA_QOSINFO_SP_ALL
  84
  85extern const u8 ieee80211_ac_to_qos_mask[IEEE80211_NUM_ACS];
  86
  87#define IEEE80211_DEAUTH_FRAME_LEN	(24 /* hdr */ + 2 /* reason */)
  88
  89#define IEEE80211_MAX_NAN_INSTANCE_ID 255
  90
  91struct ieee80211_fragment_entry {
  92	struct sk_buff_head skb_list;
  93	unsigned long first_frag_time;
  94	u16 seq;
  95	u16 extra_len;
  96	u16 last_frag;
  97	u8 rx_queue;
  98	bool check_sequential_pn; /* needed for CCMP/GCMP */
  99	u8 last_pn[6]; /* PN of the last fragment if CCMP was used */
 100};
 101
 102
 103struct ieee80211_bss {
 104	u32 device_ts_beacon, device_ts_presp;
 105
 106	bool wmm_used;
 107	bool uapsd_supported;
 108
 109#define IEEE80211_MAX_SUPP_RATES 32
 110	u8 supp_rates[IEEE80211_MAX_SUPP_RATES];
 111	size_t supp_rates_len;
 112	struct ieee80211_rate *beacon_rate;
 113
 114	u32 vht_cap_info;
 115
 116	/*
 117	 * During association, we save an ERP value from a probe response so
 118	 * that we can feed ERP info to the driver when handling the
 119	 * association completes. these fields probably won't be up-to-date
 120	 * otherwise, you probably don't want to use them.
 121	 */
 122	bool has_erp_value;
 123	u8 erp_value;
 124
 125	/* Keep track of the corruption of the last beacon/probe response. */
 126	u8 corrupt_data;
 127
 128	/* Keep track of what bits of information we have valid info for. */
 129	u8 valid_data;
 130};
 131
 132/**
 133 * enum ieee80211_corrupt_data_flags - BSS data corruption flags
 134 * @IEEE80211_BSS_CORRUPT_BEACON: last beacon frame received was corrupted
 135 * @IEEE80211_BSS_CORRUPT_PROBE_RESP: last probe response received was corrupted
 136 *
 137 * These are bss flags that are attached to a bss in the
 138 * @corrupt_data field of &struct ieee80211_bss.
 139 */
 140enum ieee80211_bss_corrupt_data_flags {
 141	IEEE80211_BSS_CORRUPT_BEACON		= BIT(0),
 142	IEEE80211_BSS_CORRUPT_PROBE_RESP	= BIT(1)
 143};
 144
 145/**
 146 * enum ieee80211_valid_data_flags - BSS valid data flags
 147 * @IEEE80211_BSS_VALID_WMM: WMM/UAPSD data was gathered from non-corrupt IE
 148 * @IEEE80211_BSS_VALID_RATES: Supported rates were gathered from non-corrupt IE
 149 * @IEEE80211_BSS_VALID_ERP: ERP flag was gathered from non-corrupt IE
 150 *
 151 * These are bss flags that are attached to a bss in the
 152 * @valid_data field of &struct ieee80211_bss.  They show which parts
 153 * of the data structure were received as a result of an un-corrupted
 154 * beacon/probe response.
 155 */
 156enum ieee80211_bss_valid_data_flags {
 157	IEEE80211_BSS_VALID_WMM			= BIT(1),
 158	IEEE80211_BSS_VALID_RATES		= BIT(2),
 159	IEEE80211_BSS_VALID_ERP			= BIT(3)
 160};
 161
 162typedef unsigned __bitwise ieee80211_tx_result;
 163#define TX_CONTINUE	((__force ieee80211_tx_result) 0u)
 164#define TX_DROP		((__force ieee80211_tx_result) 1u)
 165#define TX_QUEUED	((__force ieee80211_tx_result) 2u)
 166
 167#define IEEE80211_TX_UNICAST		BIT(1)
 168#define IEEE80211_TX_PS_BUFFERED	BIT(2)
 169
 170struct ieee80211_tx_data {
 171	struct sk_buff *skb;
 172	struct sk_buff_head skbs;
 173	struct ieee80211_local *local;
 174	struct ieee80211_sub_if_data *sdata;
 175	struct sta_info *sta;
 176	struct ieee80211_key *key;
 177	struct ieee80211_tx_rate rate;
 178
 179	unsigned int flags;
 180};
 181
 182
 183typedef unsigned __bitwise ieee80211_rx_result;
 184#define RX_CONTINUE		((__force ieee80211_rx_result) 0u)
 185#define RX_DROP_UNUSABLE	((__force ieee80211_rx_result) 1u)
 186#define RX_DROP_MONITOR		((__force ieee80211_rx_result) 2u)
 187#define RX_QUEUED		((__force ieee80211_rx_result) 3u)
 188
 189/**
 190 * enum ieee80211_packet_rx_flags - packet RX flags
 191 * @IEEE80211_RX_AMSDU: a-MSDU packet
 192 * @IEEE80211_RX_MALFORMED_ACTION_FRM: action frame is malformed
 193 * @IEEE80211_RX_DEFERRED_RELEASE: frame was subjected to receive reordering
 194 *
 195 * These are per-frame flags that are attached to a frame in the
 196 * @rx_flags field of &struct ieee80211_rx_status.
 197 */
 198enum ieee80211_packet_rx_flags {
 199	IEEE80211_RX_AMSDU			= BIT(3),
 200	IEEE80211_RX_MALFORMED_ACTION_FRM	= BIT(4),
 201	IEEE80211_RX_DEFERRED_RELEASE		= BIT(5),
 202};
 203
 204/**
 205 * enum ieee80211_rx_flags - RX data flags
 206 *
 207 * @IEEE80211_RX_CMNTR: received on cooked monitor already
 208 * @IEEE80211_RX_BEACON_REPORTED: This frame was already reported
 209 *	to cfg80211_report_obss_beacon().
 210 *
 211 * These flags are used across handling multiple interfaces
 212 * for a single frame.
 213 */
 214enum ieee80211_rx_flags {
 215	IEEE80211_RX_CMNTR		= BIT(0),
 216	IEEE80211_RX_BEACON_REPORTED	= BIT(1),
 217};
 218
 219struct ieee80211_rx_data {
 220	struct list_head *list;
 221	struct sk_buff *skb;
 222	struct ieee80211_local *local;
 223	struct ieee80211_sub_if_data *sdata;
 224	struct sta_info *sta;
 225	struct ieee80211_key *key;
 226
 227	unsigned int flags;
 228
 229	/*
 230	 * Index into sequence numbers array, 0..16
 231	 * since the last (16) is used for non-QoS,
 232	 * will be 16 on non-QoS frames.
 233	 */
 234	int seqno_idx;
 235
 236	/*
 237	 * Index into the security IV/PN arrays, 0..16
 238	 * since the last (16) is used for CCMP-encrypted
 239	 * management frames, will be set to 16 on mgmt
 240	 * frames and 0 on non-QoS frames.
 241	 */
 242	int security_idx;
 243
 244	u32 tkip_iv32;
 245	u16 tkip_iv16;
 
 
 
 
 
 
 
 246};
 247
 248struct ieee80211_csa_settings {
 249	const u16 *counter_offsets_beacon;
 250	const u16 *counter_offsets_presp;
 251
 252	int n_counter_offsets_beacon;
 253	int n_counter_offsets_presp;
 254
 255	u8 count;
 256};
 257
 258struct beacon_data {
 259	u8 *head, *tail;
 260	int head_len, tail_len;
 261	struct ieee80211_meshconf_ie *meshconf;
 262	u16 csa_counter_offsets[IEEE80211_MAX_CSA_COUNTERS_NUM];
 263	u8 csa_current_counter;
 264	struct rcu_head rcu_head;
 265};
 266
 267struct probe_resp {
 268	struct rcu_head rcu_head;
 269	int len;
 270	u16 csa_counter_offsets[IEEE80211_MAX_CSA_COUNTERS_NUM];
 
 
 
 
 
 
 
 
 
 
 
 
 271	u8 data[];
 272};
 273
 274struct ps_data {
 275	/* yes, this looks ugly, but guarantees that we can later use
 276	 * bitmap_empty :)
 277	 * NB: don't touch this bitmap, use sta_info_{set,clear}_tim_bit */
 278	u8 tim[sizeof(unsigned long) * BITS_TO_LONGS(IEEE80211_MAX_AID + 1)]
 279			__aligned(__alignof__(unsigned long));
 280	struct sk_buff_head bc_buf;
 281	atomic_t num_sta_ps; /* number of stations in PS mode */
 282	int dtim_count;
 283	bool dtim_bc_mc;
 284};
 285
 286struct ieee80211_if_ap {
 287	struct beacon_data __rcu *beacon;
 288	struct probe_resp __rcu *probe_resp;
 
 
 289
 290	/* to be used after channel switch. */
 291	struct cfg80211_beacon_data *next_beacon;
 292	struct list_head vlans; /* write-protected with RTNL and local->mtx */
 293
 294	struct ps_data ps;
 295	atomic_t num_mcast_sta; /* number of stations receiving multicast */
 296
 297	bool multicast_to_unicast;
 298};
 299
 300struct ieee80211_if_wds {
 301	struct sta_info *sta;
 302	u8 remote_addr[ETH_ALEN];
 303};
 304
 305struct ieee80211_if_vlan {
 306	struct list_head list; /* write-protected with RTNL and local->mtx */
 307
 308	/* used for all tx if the VLAN is configured to 4-addr mode */
 309	struct sta_info __rcu *sta;
 310	atomic_t num_mcast_sta; /* number of stations receiving multicast */
 311};
 312
 313struct mesh_stats {
 314	__u32 fwded_mcast;		/* Mesh forwarded multicast frames */
 315	__u32 fwded_unicast;		/* Mesh forwarded unicast frames */
 316	__u32 fwded_frames;		/* Mesh total forwarded frames */
 317	__u32 dropped_frames_ttl;	/* Not transmitted since mesh_ttl == 0*/
 318	__u32 dropped_frames_no_route;	/* Not transmitted, no route found */
 319	__u32 dropped_frames_congestion;/* Not forwarded due to congestion */
 320};
 321
 322#define PREQ_Q_F_START		0x1
 323#define PREQ_Q_F_REFRESH	0x2
 324struct mesh_preq_queue {
 325	struct list_head list;
 326	u8 dst[ETH_ALEN];
 327	u8 flags;
 328};
 329
 330struct ieee80211_roc_work {
 331	struct list_head list;
 332
 333	struct ieee80211_sub_if_data *sdata;
 334
 335	struct ieee80211_channel *chan;
 336
 337	bool started, abort, hw_begun, notified;
 338	bool on_channel;
 339
 340	unsigned long start_time;
 341
 342	u32 duration, req_duration;
 343	struct sk_buff *frame;
 344	u64 cookie, mgmt_tx_cookie;
 345	enum ieee80211_roc_type type;
 346};
 347
 348/* flags used in struct ieee80211_if_managed.flags */
 349enum ieee80211_sta_flags {
 350	IEEE80211_STA_CONNECTION_POLL	= BIT(1),
 351	IEEE80211_STA_CONTROL_PORT	= BIT(2),
 352	IEEE80211_STA_DISABLE_HT	= BIT(4),
 353	IEEE80211_STA_MFP_ENABLED	= BIT(6),
 354	IEEE80211_STA_UAPSD_ENABLED	= BIT(7),
 355	IEEE80211_STA_NULLFUNC_ACKED	= BIT(8),
 356	IEEE80211_STA_RESET_SIGNAL_AVE	= BIT(9),
 357	IEEE80211_STA_DISABLE_40MHZ	= BIT(10),
 358	IEEE80211_STA_DISABLE_VHT	= BIT(11),
 359	IEEE80211_STA_DISABLE_80P80MHZ	= BIT(12),
 360	IEEE80211_STA_DISABLE_160MHZ	= BIT(13),
 361	IEEE80211_STA_DISABLE_WMM	= BIT(14),
 362	IEEE80211_STA_ENABLE_RRM	= BIT(15),
 363	IEEE80211_STA_DISABLE_HE	= BIT(16),
 364};
 365
 366struct ieee80211_mgd_auth_data {
 367	struct cfg80211_bss *bss;
 368	unsigned long timeout;
 369	int tries;
 370	u16 algorithm, expected_transaction;
 371
 372	u8 key[WLAN_KEY_LEN_WEP104];
 373	u8 key_len, key_idx;
 374	bool done;
 375	bool peer_confirmed;
 376	bool timeout_started;
 377
 378	u16 sae_trans, sae_status;
 379	size_t data_len;
 380	u8 data[];
 381};
 382
 383struct ieee80211_mgd_assoc_data {
 384	struct cfg80211_bss *bss;
 385	const u8 *supp_rates;
 386
 387	unsigned long timeout;
 388	int tries;
 389
 390	u16 capability;
 391	u8 prev_bssid[ETH_ALEN];
 392	u8 ssid[IEEE80211_MAX_SSID_LEN];
 393	u8 ssid_len;
 394	u8 supp_rates_len;
 395	bool wmm, uapsd;
 396	bool need_beacon;
 397	bool synced;
 398	bool timeout_started;
 399
 400	u8 ap_ht_param;
 401
 402	struct ieee80211_vht_cap ap_vht_cap;
 403
 404	u8 fils_nonces[2 * FILS_NONCE_LEN];
 405	u8 fils_kek[FILS_MAX_KEK_LEN];
 406	size_t fils_kek_len;
 407
 408	size_t ie_len;
 409	u8 ie[];
 410};
 411
 412struct ieee80211_sta_tx_tspec {
 413	/* timestamp of the first packet in the time slice */
 414	unsigned long time_slice_start;
 415
 416	u32 admitted_time; /* in usecs, unlike over the air */
 417	u8 tsid;
 418	s8 up; /* signed to be able to invalidate with -1 during teardown */
 419
 420	/* consumed TX time in microseconds in the time slice */
 421	u32 consumed_tx_time;
 422	enum {
 423		TX_TSPEC_ACTION_NONE = 0,
 424		TX_TSPEC_ACTION_DOWNGRADE,
 425		TX_TSPEC_ACTION_STOP_DOWNGRADE,
 426	} action;
 427	bool downgraded;
 428};
 429
 430DECLARE_EWMA(beacon_signal, 4, 4)
 431
 432struct ieee80211_if_managed {
 433	struct timer_list timer;
 434	struct timer_list conn_mon_timer;
 435	struct timer_list bcn_mon_timer;
 436	struct timer_list chswitch_timer;
 437	struct work_struct monitor_work;
 438	struct work_struct chswitch_work;
 439	struct work_struct beacon_connection_loss_work;
 440	struct work_struct csa_connection_drop_work;
 441
 442	unsigned long beacon_timeout;
 443	unsigned long probe_timeout;
 444	int probe_send_count;
 445	bool nullfunc_failed;
 446	bool connection_loss;
 
 
 447
 448	struct cfg80211_bss *associated;
 449	struct ieee80211_mgd_auth_data *auth_data;
 450	struct ieee80211_mgd_assoc_data *assoc_data;
 451
 452	u8 bssid[ETH_ALEN] __aligned(2);
 453
 454	bool powersave; /* powersave requested for this iface */
 455	bool broken_ap; /* AP is broken -- turn off powersave */
 456	bool have_beacon;
 457	u8 dtim_period;
 458	enum ieee80211_smps_mode req_smps, /* requested smps mode */
 459				 driver_smps_mode; /* smps mode request */
 460
 461	struct work_struct request_smps_work;
 462
 463	unsigned int flags;
 464
 465	bool csa_waiting_bcn;
 466	bool csa_ignored_same_chan;
 467
 468	bool beacon_crc_valid;
 469	u32 beacon_crc;
 470
 471	bool status_acked;
 472	bool status_received;
 473	__le16 status_fc;
 474
 475	enum {
 476		IEEE80211_MFP_DISABLED,
 477		IEEE80211_MFP_OPTIONAL,
 478		IEEE80211_MFP_REQUIRED
 479	} mfp; /* management frame protection */
 480
 481	/*
 482	 * Bitmask of enabled u-apsd queues,
 483	 * IEEE80211_WMM_IE_STA_QOSINFO_AC_BE & co. Needs a new association
 484	 * to take effect.
 485	 */
 486	unsigned int uapsd_queues;
 487
 488	/*
 489	 * Maximum number of buffered frames AP can deliver during a
 490	 * service period, IEEE80211_WMM_IE_STA_QOSINFO_SP_ALL or similar.
 491	 * Needs a new association to take effect.
 492	 */
 493	unsigned int uapsd_max_sp_len;
 494
 495	int wmm_last_param_set;
 496	int mu_edca_last_param_set;
 497
 498	u8 use_4addr;
 499
 500	s16 p2p_noa_index;
 501
 502	struct ewma_beacon_signal ave_beacon_signal;
 503
 504	/*
 505	 * Number of Beacon frames used in ave_beacon_signal. This can be used
 506	 * to avoid generating less reliable cqm events that would be based
 507	 * only on couple of received frames.
 508	 */
 509	unsigned int count_beacon_signal;
 510
 511	/* Number of times beacon loss was invoked. */
 512	unsigned int beacon_loss_count;
 513
 514	/*
 515	 * Last Beacon frame signal strength average (ave_beacon_signal / 16)
 516	 * that triggered a cqm event. 0 indicates that no event has been
 517	 * generated for the current association.
 518	 */
 519	int last_cqm_event_signal;
 520
 521	/*
 522	 * State variables for keeping track of RSSI of the AP currently
 523	 * connected to and informing driver when RSSI has gone
 524	 * below/above a certain threshold.
 525	 */
 526	int rssi_min_thold, rssi_max_thold;
 527	int last_ave_beacon_signal;
 528
 529	struct ieee80211_ht_cap ht_capa; /* configured ht-cap over-rides */
 530	struct ieee80211_ht_cap ht_capa_mask; /* Valid parts of ht_capa */
 531	struct ieee80211_vht_cap vht_capa; /* configured VHT overrides */
 532	struct ieee80211_vht_cap vht_capa_mask; /* Valid parts of vht_capa */
 
 
 533
 534	/* TDLS support */
 535	u8 tdls_peer[ETH_ALEN] __aligned(2);
 536	struct delayed_work tdls_peer_del_work;
 537	struct sk_buff *orig_teardown_skb; /* The original teardown skb */
 538	struct sk_buff *teardown_skb; /* A copy to send through the AP */
 539	spinlock_t teardown_lock; /* To lock changing teardown_skb */
 540	bool tdls_chan_switch_prohibited;
 541	bool tdls_wider_bw_prohibited;
 542
 543	/* WMM-AC TSPEC support */
 544	struct ieee80211_sta_tx_tspec tx_tspec[IEEE80211_NUM_ACS];
 545	/* Use a separate work struct so that we can do something here
 546	 * while the sdata->work is flushing the queues, for example.
 547	 * otherwise, in scenarios where we hardly get any traffic out
 548	 * on the BE queue, but there's a lot of VO traffic, we might
 549	 * get stuck in a downgraded situation and flush takes forever.
 550	 */
 551	struct delayed_work tx_tspec_wk;
 552
 553	/* Information elements from the last transmitted (Re)Association
 554	 * Request frame.
 555	 */
 556	u8 *assoc_req_ies;
 557	size_t assoc_req_ies_len;
 558};
 559
 560struct ieee80211_if_ibss {
 561	struct timer_list timer;
 562	struct work_struct csa_connection_drop_work;
 563
 564	unsigned long last_scan_completed;
 565
 566	u32 basic_rates;
 567
 568	bool fixed_bssid;
 569	bool fixed_channel;
 570	bool privacy;
 571
 572	bool control_port;
 573	bool userspace_handles_dfs;
 574
 575	u8 bssid[ETH_ALEN] __aligned(2);
 576	u8 ssid[IEEE80211_MAX_SSID_LEN];
 577	u8 ssid_len, ie_len;
 578	u8 *ie;
 579	struct cfg80211_chan_def chandef;
 580
 581	unsigned long ibss_join_req;
 582	/* probe response/beacon for IBSS */
 583	struct beacon_data __rcu *presp;
 584
 585	struct ieee80211_ht_cap ht_capa; /* configured ht-cap over-rides */
 586	struct ieee80211_ht_cap ht_capa_mask; /* Valid parts of ht_capa */
 587
 588	spinlock_t incomplete_lock;
 589	struct list_head incomplete_stations;
 590
 591	enum {
 592		IEEE80211_IBSS_MLME_SEARCH,
 593		IEEE80211_IBSS_MLME_JOINED,
 594	} state;
 595};
 596
 597/**
 598 * struct ieee80211_if_ocb - OCB mode state
 599 *
 600 * @housekeeping_timer: timer for periodic invocation of a housekeeping task
 601 * @wrkq_flags: OCB deferred task action
 602 * @incomplete_lock: delayed STA insertion lock
 603 * @incomplete_stations: list of STAs waiting for delayed insertion
 604 * @joined: indication if the interface is connected to an OCB network
 605 */
 606struct ieee80211_if_ocb {
 607	struct timer_list housekeeping_timer;
 608	unsigned long wrkq_flags;
 609
 610	spinlock_t incomplete_lock;
 611	struct list_head incomplete_stations;
 612
 613	bool joined;
 614};
 615
 616/**
 617 * struct ieee80211_mesh_sync_ops - Extensible synchronization framework interface
 618 *
 619 * these declarations define the interface, which enables
 620 * vendor-specific mesh synchronization
 621 *
 622 */
 623struct ieee802_11_elems;
 624struct ieee80211_mesh_sync_ops {
 625	void (*rx_bcn_presp)(struct ieee80211_sub_if_data *sdata,
 626			     u16 stype,
 627			     struct ieee80211_mgmt *mgmt,
 628			     struct ieee802_11_elems *elems,
 629			     struct ieee80211_rx_status *rx_status);
 630
 631	/* should be called with beacon_data under RCU read lock */
 632	void (*adjust_tsf)(struct ieee80211_sub_if_data *sdata,
 633			   struct beacon_data *beacon);
 634	/* add other framework functions here */
 635};
 636
 637struct mesh_csa_settings {
 638	struct rcu_head rcu_head;
 639	struct cfg80211_csa_settings settings;
 640};
 641
 642struct ieee80211_if_mesh {
 643	struct timer_list housekeeping_timer;
 644	struct timer_list mesh_path_timer;
 645	struct timer_list mesh_path_root_timer;
 646
 647	unsigned long wrkq_flags;
 648	unsigned long mbss_changed;
 649
 650	bool userspace_handles_dfs;
 651
 652	u8 mesh_id[IEEE80211_MAX_MESH_ID_LEN];
 653	size_t mesh_id_len;
 654	/* Active Path Selection Protocol Identifier */
 655	u8 mesh_pp_id;
 656	/* Active Path Selection Metric Identifier */
 657	u8 mesh_pm_id;
 658	/* Congestion Control Mode Identifier */
 659	u8 mesh_cc_id;
 660	/* Synchronization Protocol Identifier */
 661	u8 mesh_sp_id;
 662	/* Authentication Protocol Identifier */
 663	u8 mesh_auth_id;
 664	/* Local mesh Sequence Number */
 665	u32 sn;
 666	/* Last used PREQ ID */
 667	u32 preq_id;
 668	atomic_t mpaths;
 669	/* Timestamp of last SN update */
 670	unsigned long last_sn_update;
 671	/* Time when it's ok to send next PERR */
 672	unsigned long next_perr;
 673	/* Timestamp of last PREQ sent */
 674	unsigned long last_preq;
 675	struct mesh_rmc *rmc;
 676	spinlock_t mesh_preq_queue_lock;
 677	struct mesh_preq_queue preq_queue;
 678	int preq_queue_len;
 679	struct mesh_stats mshstats;
 680	struct mesh_config mshcfg;
 681	atomic_t estab_plinks;
 682	u32 mesh_seqnum;
 683	bool accepting_plinks;
 684	int num_gates;
 685	struct beacon_data __rcu *beacon;
 686	const u8 *ie;
 687	u8 ie_len;
 688	enum {
 689		IEEE80211_MESH_SEC_NONE = 0x0,
 690		IEEE80211_MESH_SEC_AUTHED = 0x1,
 691		IEEE80211_MESH_SEC_SECURED = 0x2,
 692	} security;
 693	bool user_mpm;
 694	/* Extensible Synchronization Framework */
 695	const struct ieee80211_mesh_sync_ops *sync_ops;
 696	s64 sync_offset_clockdrift_max;
 697	spinlock_t sync_offset_lock;
 698	/* mesh power save */
 699	enum nl80211_mesh_power_mode nonpeer_pm;
 700	int ps_peers_light_sleep;
 701	int ps_peers_deep_sleep;
 702	struct ps_data ps;
 703	/* Channel Switching Support */
 704	struct mesh_csa_settings __rcu *csa;
 705	enum {
 706		IEEE80211_MESH_CSA_ROLE_NONE,
 707		IEEE80211_MESH_CSA_ROLE_INIT,
 708		IEEE80211_MESH_CSA_ROLE_REPEATER,
 709	} csa_role;
 710	u8 chsw_ttl;
 711	u16 pre_value;
 712
 713	/* offset from skb->data while building IE */
 714	int meshconf_offset;
 715
 716	struct mesh_table *mesh_paths;
 717	struct mesh_table *mpp_paths; /* Store paths for MPP&MAP */
 718	int mesh_paths_generation;
 719	int mpp_paths_generation;
 720};
 721
 722#ifdef CONFIG_MAC80211_MESH
 723#define IEEE80211_IFSTA_MESH_CTR_INC(msh, name)	\
 724	do { (msh)->mshstats.name++; } while (0)
 725#else
 726#define IEEE80211_IFSTA_MESH_CTR_INC(msh, name) \
 727	do { } while (0)
 728#endif
 729
 730/**
 731 * enum ieee80211_sub_if_data_flags - virtual interface flags
 732 *
 733 * @IEEE80211_SDATA_ALLMULTI: interface wants all multicast packets
 734 * @IEEE80211_SDATA_OPERATING_GMODE: operating in G-only mode
 735 * @IEEE80211_SDATA_DONT_BRIDGE_PACKETS: bridge packets between
 736 *	associated stations and deliver multicast frames both
 737 *	back to wireless media and to the local net stack.
 738 * @IEEE80211_SDATA_DISCONNECT_RESUME: Disconnect after resume.
 739 * @IEEE80211_SDATA_IN_DRIVER: indicates interface was added to driver
 740 */
 741enum ieee80211_sub_if_data_flags {
 742	IEEE80211_SDATA_ALLMULTI		= BIT(0),
 743	IEEE80211_SDATA_OPERATING_GMODE		= BIT(2),
 744	IEEE80211_SDATA_DONT_BRIDGE_PACKETS	= BIT(3),
 745	IEEE80211_SDATA_DISCONNECT_RESUME	= BIT(4),
 746	IEEE80211_SDATA_IN_DRIVER		= BIT(5),
 747};
 748
 749/**
 750 * enum ieee80211_sdata_state_bits - virtual interface state bits
 751 * @SDATA_STATE_RUNNING: virtual interface is up & running; this
 752 *	mirrors netif_running() but is separate for interface type
 753 *	change handling while the interface is up
 754 * @SDATA_STATE_OFFCHANNEL: This interface is currently in offchannel
 755 *	mode, so queues are stopped
 756 * @SDATA_STATE_OFFCHANNEL_BEACON_STOPPED: Beaconing was stopped due
 757 *	to offchannel, reset when offchannel returns
 758 */
 759enum ieee80211_sdata_state_bits {
 760	SDATA_STATE_RUNNING,
 761	SDATA_STATE_OFFCHANNEL,
 762	SDATA_STATE_OFFCHANNEL_BEACON_STOPPED,
 763};
 764
 765/**
 766 * enum ieee80211_chanctx_mode - channel context configuration mode
 767 *
 768 * @IEEE80211_CHANCTX_SHARED: channel context may be used by
 769 *	multiple interfaces
 770 * @IEEE80211_CHANCTX_EXCLUSIVE: channel context can be used
 771 *	only by a single interface. This can be used for example for
 772 *	non-fixed channel IBSS.
 773 */
 774enum ieee80211_chanctx_mode {
 775	IEEE80211_CHANCTX_SHARED,
 776	IEEE80211_CHANCTX_EXCLUSIVE
 777};
 778
 779/**
 780 * enum ieee80211_chanctx_replace_state - channel context replacement state
 781 *
 782 * This is used for channel context in-place reservations that require channel
 783 * context switch/swap.
 784 *
 785 * @IEEE80211_CHANCTX_REPLACE_NONE: no replacement is taking place
 786 * @IEEE80211_CHANCTX_WILL_BE_REPLACED: this channel context will be replaced
 787 *	by a (not yet registered) channel context pointed by %replace_ctx.
 788 * @IEEE80211_CHANCTX_REPLACES_OTHER: this (not yet registered) channel context
 789 *	replaces an existing channel context pointed to by %replace_ctx.
 790 */
 791enum ieee80211_chanctx_replace_state {
 792	IEEE80211_CHANCTX_REPLACE_NONE,
 793	IEEE80211_CHANCTX_WILL_BE_REPLACED,
 794	IEEE80211_CHANCTX_REPLACES_OTHER,
 795};
 796
 797struct ieee80211_chanctx {
 798	struct list_head list;
 799	struct rcu_head rcu_head;
 800
 801	struct list_head assigned_vifs;
 802	struct list_head reserved_vifs;
 803
 804	enum ieee80211_chanctx_replace_state replace_state;
 805	struct ieee80211_chanctx *replace_ctx;
 806
 807	enum ieee80211_chanctx_mode mode;
 808	bool driver_present;
 809
 810	struct ieee80211_chanctx_conf conf;
 811};
 812
 813struct mac80211_qos_map {
 814	struct cfg80211_qos_map qos_map;
 815	struct rcu_head rcu_head;
 816};
 817
 818enum txq_info_flags {
 819	IEEE80211_TXQ_STOP,
 820	IEEE80211_TXQ_AMPDU,
 821	IEEE80211_TXQ_NO_AMSDU,
 822	IEEE80211_TXQ_STOP_NETIF_TX,
 823};
 824
 825/**
 826 * struct txq_info - per tid queue
 827 *
 828 * @tin: contains packets split into multiple flows
 829 * @def_flow: used as a fallback flow when a packet destined to @tin hashes to
 830 *	a fq_flow which is already owned by a different tin
 831 * @def_cvars: codel vars for @def_flow
 
 832 * @frags: used to keep fragments created after dequeue
 833 * @schedule_order: used with ieee80211_local->active_txqs
 834 * @schedule_round: counter to prevent infinite loops on TXQ scheduling
 835 */
 836struct txq_info {
 837	struct fq_tin tin;
 838	struct fq_flow def_flow;
 839	struct codel_vars def_cvars;
 840	struct codel_stats cstats;
 
 
 841	struct sk_buff_head frags;
 842	struct list_head schedule_order;
 843	u16 schedule_round;
 844	unsigned long flags;
 845
 846	/* keep last! */
 847	struct ieee80211_txq txq;
 848};
 849
 850struct ieee80211_if_mntr {
 851	u32 flags;
 852	u8 mu_follow_addr[ETH_ALEN] __aligned(2);
 853
 854	struct list_head list;
 855};
 856
 857/**
 858 * struct ieee80211_if_nan - NAN state
 859 *
 860 * @conf: current NAN configuration
 861 * @func_ids: a bitmap of available instance_id's
 862 */
 863struct ieee80211_if_nan {
 864	struct cfg80211_nan_conf conf;
 865
 866	/* protects function_inst_ids */
 867	spinlock_t func_lock;
 868	struct idr function_inst_ids;
 869};
 870
 871struct ieee80211_sub_if_data {
 872	struct list_head list;
 873
 874	struct wireless_dev wdev;
 875
 876	/* keys */
 877	struct list_head key_list;
 878
 879	/* count for keys needing tailroom space allocation */
 880	int crypto_tx_tailroom_needed_cnt;
 881	int crypto_tx_tailroom_pending_dec;
 882	struct delayed_work dec_tailroom_needed_wk;
 883
 884	struct net_device *dev;
 885	struct ieee80211_local *local;
 886
 887	unsigned int flags;
 888
 889	unsigned long state;
 890
 891	char name[IFNAMSIZ];
 892
 893	/* Fragment table for host-based reassembly */
 894	struct ieee80211_fragment_entry	fragments[IEEE80211_FRAGMENT_MAX];
 895	unsigned int fragment_next;
 896
 897	/* TID bitmap for NoAck policy */
 898	u16 noack_map;
 899
 900	/* bit field of ACM bits (BIT(802.1D tag)) */
 901	u8 wmm_acm;
 902
 903	struct ieee80211_key __rcu *keys[NUM_DEFAULT_KEYS +
 904					 NUM_DEFAULT_MGMT_KEYS +
 905					 NUM_DEFAULT_BEACON_KEYS];
 906	struct ieee80211_key __rcu *default_unicast_key;
 907	struct ieee80211_key __rcu *default_multicast_key;
 908	struct ieee80211_key __rcu *default_mgmt_key;
 909	struct ieee80211_key __rcu *default_beacon_key;
 910
 911	u16 sequence_number;
 912	__be16 control_port_protocol;
 913	bool control_port_no_encrypt;
 914	bool control_port_no_preauth;
 915	bool control_port_over_nl80211;
 916	int encrypt_headroom;
 917
 918	atomic_t num_tx_queued;
 919	struct ieee80211_tx_queue_params tx_conf[IEEE80211_NUM_ACS];
 920	struct mac80211_qos_map __rcu *qos_map;
 921
 
 
 922	struct work_struct csa_finalize_work;
 923	bool csa_block_tx; /* write-protected by sdata_lock and local->mtx */
 924	struct cfg80211_chan_def csa_chandef;
 925
 926	struct list_head assigned_chanctx_list; /* protected by chanctx_mtx */
 927	struct list_head reserved_chanctx_list; /* protected by chanctx_mtx */
 928
 929	/* context reservation -- protected with chanctx_mtx */
 930	struct ieee80211_chanctx *reserved_chanctx;
 931	struct cfg80211_chan_def reserved_chandef;
 932	bool reserved_radar_required;
 933	bool reserved_ready;
 934
 935	/* used to reconfigure hardware SM PS */
 936	struct work_struct recalc_smps;
 937
 938	struct work_struct work;
 939	struct sk_buff_head skb_queue;
 940
 941	u8 needed_rx_chains;
 942	enum ieee80211_smps_mode smps_mode;
 943
 944	int user_power_level; /* in dBm */
 945	int ap_power_level; /* in dBm */
 946
 947	bool radar_required;
 948	struct delayed_work dfs_cac_timer_work;
 949
 950	/*
 951	 * AP this belongs to: self in AP mode and
 952	 * corresponding AP in VLAN mode, NULL for
 953	 * all others (might be needed later in IBSS)
 954	 */
 955	struct ieee80211_if_ap *bss;
 956
 957	/* bitmap of allowed (non-MCS) rate indexes for rate control */
 958	u32 rc_rateidx_mask[NUM_NL80211_BANDS];
 959
 960	bool rc_has_mcs_mask[NUM_NL80211_BANDS];
 961	u8  rc_rateidx_mcs_mask[NUM_NL80211_BANDS][IEEE80211_HT_MCS_MASK_LEN];
 962
 963	bool rc_has_vht_mcs_mask[NUM_NL80211_BANDS];
 964	u16 rc_rateidx_vht_mcs_mask[NUM_NL80211_BANDS][NL80211_VHT_NSS_MAX];
 965
 966	/* Beacon frame (non-MCS) rate (as a bitmap) */
 967	u32 beacon_rateidx_mask[NUM_NL80211_BANDS];
 968	bool beacon_rate_set;
 969
 970	union {
 971		struct ieee80211_if_ap ap;
 972		struct ieee80211_if_wds wds;
 973		struct ieee80211_if_vlan vlan;
 974		struct ieee80211_if_managed mgd;
 975		struct ieee80211_if_ibss ibss;
 976		struct ieee80211_if_mesh mesh;
 977		struct ieee80211_if_ocb ocb;
 978		struct ieee80211_if_mntr mntr;
 979		struct ieee80211_if_nan nan;
 980	} u;
 981
 982#ifdef CONFIG_MAC80211_DEBUGFS
 983	struct {
 984		struct dentry *subdir_stations;
 985		struct dentry *default_unicast_key;
 986		struct dentry *default_multicast_key;
 987		struct dentry *default_mgmt_key;
 988		struct dentry *default_beacon_key;
 989	} debugfs;
 990#endif
 991
 992	bool hw_80211_encap;
 993
 994	/* must be last, dynamically sized area in this! */
 995	struct ieee80211_vif vif;
 996};
 997
 998static inline
 999struct ieee80211_sub_if_data *vif_to_sdata(struct ieee80211_vif *p)
1000{
1001	return container_of(p, struct ieee80211_sub_if_data, vif);
1002}
1003
1004static inline void sdata_lock(struct ieee80211_sub_if_data *sdata)
1005	__acquires(&sdata->wdev.mtx)
1006{
1007	mutex_lock(&sdata->wdev.mtx);
1008	__acquire(&sdata->wdev.mtx);
1009}
1010
1011static inline void sdata_unlock(struct ieee80211_sub_if_data *sdata)
1012	__releases(&sdata->wdev.mtx)
1013{
1014	mutex_unlock(&sdata->wdev.mtx);
1015	__release(&sdata->wdev.mtx);
1016}
1017
1018#define sdata_dereference(p, sdata) \
1019	rcu_dereference_protected(p, lockdep_is_held(&sdata->wdev.mtx))
1020
1021static inline void
1022sdata_assert_lock(struct ieee80211_sub_if_data *sdata)
1023{
1024	lockdep_assert_held(&sdata->wdev.mtx);
1025}
1026
1027static inline int
1028ieee80211_chandef_get_shift(struct cfg80211_chan_def *chandef)
1029{
1030	switch (chandef->width) {
1031	case NL80211_CHAN_WIDTH_5:
1032		return 2;
1033	case NL80211_CHAN_WIDTH_10:
1034		return 1;
1035	default:
1036		return 0;
1037	}
1038}
1039
1040static inline int
1041ieee80211_vif_get_shift(struct ieee80211_vif *vif)
1042{
1043	struct ieee80211_chanctx_conf *chanctx_conf;
1044	int shift = 0;
1045
1046	rcu_read_lock();
1047	chanctx_conf = rcu_dereference(vif->chanctx_conf);
1048	if (chanctx_conf)
1049		shift = ieee80211_chandef_get_shift(&chanctx_conf->def);
1050	rcu_read_unlock();
1051
1052	return shift;
1053}
1054
1055enum {
1056	IEEE80211_RX_MSG	= 1,
1057	IEEE80211_TX_STATUS_MSG	= 2,
1058};
1059
1060enum queue_stop_reason {
1061	IEEE80211_QUEUE_STOP_REASON_DRIVER,
1062	IEEE80211_QUEUE_STOP_REASON_PS,
1063	IEEE80211_QUEUE_STOP_REASON_CSA,
1064	IEEE80211_QUEUE_STOP_REASON_AGGREGATION,
1065	IEEE80211_QUEUE_STOP_REASON_SUSPEND,
1066	IEEE80211_QUEUE_STOP_REASON_SKB_ADD,
1067	IEEE80211_QUEUE_STOP_REASON_OFFCHANNEL,
1068	IEEE80211_QUEUE_STOP_REASON_FLUSH,
1069	IEEE80211_QUEUE_STOP_REASON_TDLS_TEARDOWN,
1070	IEEE80211_QUEUE_STOP_REASON_RESERVE_TID,
 
1071
1072	IEEE80211_QUEUE_STOP_REASONS,
1073};
1074
1075#ifdef CONFIG_MAC80211_LEDS
1076struct tpt_led_trigger {
1077	char name[32];
1078	const struct ieee80211_tpt_blink *blink_table;
1079	unsigned int blink_table_len;
1080	struct timer_list timer;
1081	struct ieee80211_local *local;
1082	unsigned long prev_traffic;
1083	unsigned long tx_bytes, rx_bytes;
1084	unsigned int active, want;
1085	bool running;
1086};
1087#endif
1088
1089/**
1090 * mac80211 scan flags - currently active scan mode
1091 *
1092 * @SCAN_SW_SCANNING: We're currently in the process of scanning but may as
1093 *	well be on the operating channel
1094 * @SCAN_HW_SCANNING: The hardware is scanning for us, we have no way to
1095 *	determine if we are on the operating channel or not
1096 * @SCAN_ONCHANNEL_SCANNING:  Do a software scan on only the current operating
1097 *	channel. This should not interrupt normal traffic.
1098 * @SCAN_COMPLETED: Set for our scan work function when the driver reported
1099 *	that the scan completed.
1100 * @SCAN_ABORTED: Set for our scan work function when the driver reported
1101 *	a scan complete for an aborted scan.
1102 * @SCAN_HW_CANCELLED: Set for our scan work function when the scan is being
1103 *	cancelled.
1104 */
1105enum {
1106	SCAN_SW_SCANNING,
1107	SCAN_HW_SCANNING,
1108	SCAN_ONCHANNEL_SCANNING,
1109	SCAN_COMPLETED,
1110	SCAN_ABORTED,
1111	SCAN_HW_CANCELLED,
1112};
1113
1114/**
1115 * enum mac80211_scan_state - scan state machine states
1116 *
1117 * @SCAN_DECISION: Main entry point to the scan state machine, this state
1118 *	determines if we should keep on scanning or switch back to the
1119 *	operating channel
1120 * @SCAN_SET_CHANNEL: Set the next channel to be scanned
1121 * @SCAN_SEND_PROBE: Send probe requests and wait for probe responses
1122 * @SCAN_SUSPEND: Suspend the scan and go back to operating channel to
1123 *	send out data
1124 * @SCAN_RESUME: Resume the scan and scan the next channel
1125 * @SCAN_ABORT: Abort the scan and go back to operating channel
1126 */
1127enum mac80211_scan_state {
1128	SCAN_DECISION,
1129	SCAN_SET_CHANNEL,
1130	SCAN_SEND_PROBE,
1131	SCAN_SUSPEND,
1132	SCAN_RESUME,
1133	SCAN_ABORT,
1134};
1135
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1136struct ieee80211_local {
1137	/* embed the driver visible part.
1138	 * don't cast (use the static inlines below), but we keep
1139	 * it first anyway so they become a no-op */
1140	struct ieee80211_hw hw;
1141
1142	struct fq fq;
1143	struct codel_vars *cvars;
1144	struct codel_params cparams;
1145
1146	/* protects active_txqs and txqi->schedule_order */
1147	spinlock_t active_txq_lock[IEEE80211_NUM_ACS];
1148	struct list_head active_txqs[IEEE80211_NUM_ACS];
1149	u16 schedule_round[IEEE80211_NUM_ACS];
1150
1151	u16 airtime_flags;
1152	u32 aql_txq_limit_low[IEEE80211_NUM_ACS];
1153	u32 aql_txq_limit_high[IEEE80211_NUM_ACS];
1154	u32 aql_threshold;
1155	atomic_t aql_total_pending_airtime;
1156
1157	const struct ieee80211_ops *ops;
1158
1159	/*
1160	 * private workqueue to mac80211. mac80211 makes this accessible
1161	 * via ieee80211_queue_work()
1162	 */
1163	struct workqueue_struct *workqueue;
1164
1165	unsigned long queue_stop_reasons[IEEE80211_MAX_QUEUES];
1166	int q_stop_reasons[IEEE80211_MAX_QUEUES][IEEE80211_QUEUE_STOP_REASONS];
1167	/* also used to protect ampdu_ac_queue and amdpu_ac_stop_refcnt */
1168	spinlock_t queue_stop_reason_lock;
1169
1170	int open_count;
1171	int monitors, cooked_mntrs;
1172	/* number of interfaces with corresponding FIF_ flags */
1173	int fif_fcsfail, fif_plcpfail, fif_control, fif_other_bss, fif_pspoll,
1174	    fif_probe_req;
1175	bool probe_req_reg;
1176	bool rx_mcast_action_reg;
1177	unsigned int filter_flags; /* FIF_* */
1178
1179	bool wiphy_ciphers_allocated;
1180
1181	bool use_chanctx;
1182
1183	/* protects the aggregated multicast list and filter calls */
1184	spinlock_t filter_lock;
1185
1186	/* used for uploading changed mc list */
1187	struct work_struct reconfig_filter;
1188
1189	/* aggregated multicast list */
1190	struct netdev_hw_addr_list mc_list;
1191
1192	bool tim_in_locked_section; /* see ieee80211_beacon_get() */
1193
1194	/*
1195	 * suspended is true if we finished all the suspend _and_ we have
1196	 * not yet come up from resume. This is to be used by mac80211
1197	 * to ensure driver sanity during suspend and mac80211's own
1198	 * sanity. It can eventually be used for WoW as well.
1199	 */
1200	bool suspended;
1201
1202	/*
1203	 * Resuming is true while suspended, but when we're reprogramming the
1204	 * hardware -- at that time it's allowed to use ieee80211_queue_work()
1205	 * again even though some other parts of the stack are still suspended
1206	 * and we still drop received frames to avoid waking the stack.
1207	 */
1208	bool resuming;
1209
1210	/*
1211	 * quiescing is true during the suspend process _only_ to
1212	 * ease timer cancelling etc.
1213	 */
1214	bool quiescing;
1215
1216	/* device is started */
1217	bool started;
1218
1219	/* device is during a HW reconfig */
1220	bool in_reconfig;
1221
1222	/* wowlan is enabled -- don't reconfig on resume */
1223	bool wowlan;
1224
1225	struct work_struct radar_detected_work;
1226
1227	/* number of RX chains the hardware has */
1228	u8 rx_chains;
1229
1230	/* bitmap of which sbands were copied */
1231	u8 sband_allocated;
1232
1233	int tx_headroom; /* required headroom for hardware/radiotap */
1234
1235	/* Tasklet and skb queue to process calls from IRQ mode. All frames
1236	 * added to skb_queue will be processed, but frames in
1237	 * skb_queue_unreliable may be dropped if the total length of these
1238	 * queues increases over the limit. */
1239#define IEEE80211_IRQSAFE_QUEUE_LIMIT 128
1240	struct tasklet_struct tasklet;
1241	struct sk_buff_head skb_queue;
1242	struct sk_buff_head skb_queue_unreliable;
1243
1244	spinlock_t rx_path_lock;
1245
1246	/* Station data */
1247	/*
1248	 * The mutex only protects the list, hash table and
1249	 * counter, reads are done with RCU.
1250	 */
1251	struct mutex sta_mtx;
1252	spinlock_t tim_lock;
1253	unsigned long num_sta;
1254	struct list_head sta_list;
1255	struct rhltable sta_hash;
1256	struct timer_list sta_cleanup;
1257	int sta_generation;
1258
1259	struct sk_buff_head pending[IEEE80211_MAX_QUEUES];
1260	struct tasklet_struct tx_pending_tasklet;
1261	struct tasklet_struct wake_txqs_tasklet;
1262
1263	atomic_t agg_queue_stop[IEEE80211_MAX_QUEUES];
1264
1265	/* number of interfaces with allmulti RX */
1266	atomic_t iff_allmultis;
1267
1268	struct rate_control_ref *rate_ctrl;
1269
1270	struct arc4_ctx wep_tx_ctx;
1271	struct arc4_ctx wep_rx_ctx;
1272	u32 wep_iv;
1273
1274	/* see iface.c */
1275	struct list_head interfaces;
1276	struct list_head mon_list; /* only that are IFF_UP && !cooked */
1277	struct mutex iflist_mtx;
1278
1279	/*
1280	 * Key mutex, protects sdata's key_list and sta_info's
1281	 * key pointers and ptk_idx (write access, they're RCU.)
1282	 */
1283	struct mutex key_mtx;
1284
1285	/* mutex for scan and work locking */
1286	struct mutex mtx;
1287
1288	/* Scanning and BSS list */
1289	unsigned long scanning;
1290	struct cfg80211_ssid scan_ssid;
1291	struct cfg80211_scan_request *int_scan_req;
1292	struct cfg80211_scan_request __rcu *scan_req;
1293	struct ieee80211_scan_request *hw_scan_req;
1294	struct cfg80211_chan_def scan_chandef;
1295	enum nl80211_band hw_scan_band;
1296	int scan_channel_idx;
1297	int scan_ies_len;
1298	int hw_scan_ies_bufsize;
1299	struct cfg80211_scan_info scan_info;
1300
1301	struct work_struct sched_scan_stopped_work;
1302	struct ieee80211_sub_if_data __rcu *sched_scan_sdata;
1303	struct cfg80211_sched_scan_request __rcu *sched_scan_req;
1304	u8 scan_addr[ETH_ALEN];
1305
1306	unsigned long leave_oper_channel_time;
1307	enum mac80211_scan_state next_scan_state;
1308	struct delayed_work scan_work;
1309	struct ieee80211_sub_if_data __rcu *scan_sdata;
1310	/* For backward compatibility only -- do not use */
1311	struct cfg80211_chan_def _oper_chandef;
1312
1313	/* Temporary remain-on-channel for off-channel operations */
1314	struct ieee80211_channel *tmp_channel;
1315
1316	/* channel contexts */
1317	struct list_head chanctx_list;
1318	struct mutex chanctx_mtx;
1319
1320#ifdef CONFIG_MAC80211_LEDS
1321	struct led_trigger tx_led, rx_led, assoc_led, radio_led;
1322	struct led_trigger tpt_led;
1323	atomic_t tx_led_active, rx_led_active, assoc_led_active;
1324	atomic_t radio_led_active, tpt_led_active;
1325	struct tpt_led_trigger *tpt_led_trigger;
1326#endif
1327
1328#ifdef CONFIG_MAC80211_DEBUG_COUNTERS
1329	/* SNMP counters */
1330	/* dot11CountersTable */
1331	u32 dot11TransmittedFragmentCount;
1332	u32 dot11MulticastTransmittedFrameCount;
1333	u32 dot11FailedCount;
1334	u32 dot11RetryCount;
1335	u32 dot11MultipleRetryCount;
1336	u32 dot11FrameDuplicateCount;
1337	u32 dot11ReceivedFragmentCount;
1338	u32 dot11MulticastReceivedFrameCount;
1339	u32 dot11TransmittedFrameCount;
1340
1341	/* TX/RX handler statistics */
1342	unsigned int tx_handlers_drop;
1343	unsigned int tx_handlers_queued;
1344	unsigned int tx_handlers_drop_wep;
1345	unsigned int tx_handlers_drop_not_assoc;
1346	unsigned int tx_handlers_drop_unauth_port;
1347	unsigned int rx_handlers_drop;
1348	unsigned int rx_handlers_queued;
1349	unsigned int rx_handlers_drop_nullfunc;
1350	unsigned int rx_handlers_drop_defrag;
1351	unsigned int tx_expand_skb_head;
1352	unsigned int tx_expand_skb_head_cloned;
1353	unsigned int rx_expand_skb_head_defrag;
1354	unsigned int rx_handlers_fragments;
1355	unsigned int tx_status_drop;
1356#define I802_DEBUG_INC(c) (c)++
1357#else /* CONFIG_MAC80211_DEBUG_COUNTERS */
1358#define I802_DEBUG_INC(c) do { } while (0)
1359#endif /* CONFIG_MAC80211_DEBUG_COUNTERS */
1360
1361
1362	int total_ps_buffered; /* total number of all buffered unicast and
1363				* multicast packets for power saving stations
1364				*/
1365
1366	bool pspolling;
1367	bool offchannel_ps_enabled;
1368	/*
1369	 * PS can only be enabled when we have exactly one managed
1370	 * interface (and monitors) in PS, this then points there.
1371	 */
1372	struct ieee80211_sub_if_data *ps_sdata;
1373	struct work_struct dynamic_ps_enable_work;
1374	struct work_struct dynamic_ps_disable_work;
1375	struct timer_list dynamic_ps_timer;
1376	struct notifier_block ifa_notifier;
1377	struct notifier_block ifa6_notifier;
1378
1379	/*
1380	 * The dynamic ps timeout configured from user space via WEXT -
1381	 * this will override whatever chosen by mac80211 internally.
1382	 */
1383	int dynamic_ps_forced_timeout;
1384
1385	int user_power_level; /* in dBm, for all interfaces */
1386
1387	enum ieee80211_smps_mode smps_mode;
1388
1389	struct work_struct restart_work;
1390
1391#ifdef CONFIG_MAC80211_DEBUGFS
1392	struct local_debugfsdentries {
1393		struct dentry *rcdir;
1394		struct dentry *keys;
1395	} debugfs;
1396	bool force_tx_status;
1397#endif
1398
1399	/*
1400	 * Remain-on-channel support
1401	 */
1402	struct delayed_work roc_work;
1403	struct list_head roc_list;
1404	struct work_struct hw_roc_start, hw_roc_done;
1405	unsigned long hw_roc_start_time;
1406	u64 roc_cookie_counter;
1407
1408	struct idr ack_status_frames;
1409	spinlock_t ack_status_lock;
1410
1411	struct ieee80211_sub_if_data __rcu *p2p_sdata;
1412
1413	/* virtual monitor interface */
1414	struct ieee80211_sub_if_data __rcu *monitor_sdata;
1415	struct cfg80211_chan_def monitor_chandef;
1416
1417	/* extended capabilities provided by mac80211 */
1418	u8 ext_capa[8];
1419
1420	/* TDLS channel switch */
1421	struct work_struct tdls_chsw_work;
1422	struct sk_buff_head skb_queue_tdls_chsw;
1423};
1424
1425static inline struct ieee80211_sub_if_data *
1426IEEE80211_DEV_TO_SUB_IF(struct net_device *dev)
1427{
1428	return netdev_priv(dev);
1429}
1430
1431static inline struct ieee80211_sub_if_data *
1432IEEE80211_WDEV_TO_SUB_IF(struct wireless_dev *wdev)
1433{
1434	return container_of(wdev, struct ieee80211_sub_if_data, wdev);
1435}
1436
1437static inline struct ieee80211_supported_band *
1438ieee80211_get_sband(struct ieee80211_sub_if_data *sdata)
1439{
1440	struct ieee80211_local *local = sdata->local;
1441	struct ieee80211_chanctx_conf *chanctx_conf;
1442	enum nl80211_band band;
1443
1444	rcu_read_lock();
1445	chanctx_conf = rcu_dereference(sdata->vif.chanctx_conf);
1446
1447	if (WARN_ON_ONCE(!chanctx_conf)) {
1448		rcu_read_unlock();
1449		return NULL;
1450	}
1451
1452	band = chanctx_conf->def.chan->band;
1453	rcu_read_unlock();
1454
1455	return local->hw.wiphy->bands[band];
1456}
1457
1458/* this struct holds the value parsing from channel switch IE  */
1459struct ieee80211_csa_ie {
1460	struct cfg80211_chan_def chandef;
1461	u8 mode;
1462	u8 count;
1463	u8 ttl;
1464	u16 pre_value;
1465	u16 reason_code;
1466	u32 max_switch_time;
1467};
1468
1469/* Parsed Information Elements */
1470struct ieee802_11_elems {
1471	const u8 *ie_start;
1472	size_t total_len;
1473
1474	/* pointers to IEs */
1475	const struct ieee80211_tdls_lnkie *lnk_id;
1476	const struct ieee80211_ch_switch_timing *ch_sw_timing;
1477	const u8 *ext_capab;
1478	const u8 *ssid;
1479	const u8 *supp_rates;
1480	const u8 *ds_params;
1481	const struct ieee80211_tim_ie *tim;
1482	const u8 *challenge;
1483	const u8 *rsn;
1484	const u8 *rsnx;
1485	const u8 *erp_info;
1486	const u8 *ext_supp_rates;
1487	const u8 *wmm_info;
1488	const u8 *wmm_param;
1489	const struct ieee80211_ht_cap *ht_cap_elem;
1490	const struct ieee80211_ht_operation *ht_operation;
1491	const struct ieee80211_vht_cap *vht_cap_elem;
1492	const struct ieee80211_vht_operation *vht_operation;
1493	const struct ieee80211_meshconf_ie *mesh_config;
1494	const u8 *he_cap;
1495	const struct ieee80211_he_operation *he_operation;
1496	const struct ieee80211_he_spr *he_spr;
1497	const struct ieee80211_mu_edca_param_set *mu_edca_param_set;
1498	const struct ieee80211_he_6ghz_capa *he_6ghz_capa;
1499	const u8 *uora_element;
1500	const u8 *mesh_id;
1501	const u8 *peering;
1502	const __le16 *awake_window;
1503	const u8 *preq;
1504	const u8 *prep;
1505	const u8 *perr;
1506	const struct ieee80211_rann_ie *rann;
1507	const struct ieee80211_channel_sw_ie *ch_switch_ie;
1508	const struct ieee80211_ext_chansw_ie *ext_chansw_ie;
1509	const struct ieee80211_wide_bw_chansw_ie *wide_bw_chansw_ie;
1510	const u8 *max_channel_switch_time;
1511	const u8 *country_elem;
1512	const u8 *pwr_constr_elem;
1513	const u8 *cisco_dtpc_elem;
1514	const struct ieee80211_timeout_interval_ie *timeout_int;
1515	const u8 *opmode_notif;
1516	const struct ieee80211_sec_chan_offs_ie *sec_chan_offs;
1517	struct ieee80211_mesh_chansw_params_ie *mesh_chansw_params_ie;
1518	const struct ieee80211_bss_max_idle_period_ie *max_idle_period_ie;
1519	const struct ieee80211_multiple_bssid_configuration *mbssid_config_ie;
1520	const struct ieee80211_bssid_index *bssid_index;
1521	u8 max_bssid_indicator;
1522	u8 dtim_count;
1523	u8 dtim_period;
1524	const struct ieee80211_addba_ext_ie *addba_ext_ie;
 
 
 
 
1525
1526	/* length of them, respectively */
1527	u8 ext_capab_len;
1528	u8 ssid_len;
1529	u8 supp_rates_len;
1530	u8 tim_len;
1531	u8 challenge_len;
1532	u8 rsn_len;
1533	u8 rsnx_len;
1534	u8 ext_supp_rates_len;
1535	u8 wmm_info_len;
1536	u8 wmm_param_len;
1537	u8 he_cap_len;
1538	u8 mesh_id_len;
1539	u8 peering_len;
1540	u8 preq_len;
1541	u8 prep_len;
1542	u8 perr_len;
1543	u8 country_elem_len;
1544	u8 bssid_index_len;
1545
1546	/* whether a parse error occurred while retrieving these elements */
1547	bool parse_error;
1548};
1549
1550static inline struct ieee80211_local *hw_to_local(
1551	struct ieee80211_hw *hw)
1552{
1553	return container_of(hw, struct ieee80211_local, hw);
1554}
1555
1556static inline struct txq_info *to_txq_info(struct ieee80211_txq *txq)
1557{
1558	return container_of(txq, struct txq_info, txq);
1559}
1560
1561static inline bool txq_has_queue(struct ieee80211_txq *txq)
1562{
1563	struct txq_info *txqi = to_txq_info(txq);
1564
1565	return !(skb_queue_empty(&txqi->frags) && !txqi->tin.backlog_packets);
1566}
1567
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1568static inline int ieee80211_bssid_match(const u8 *raddr, const u8 *addr)
1569{
1570	return ether_addr_equal(raddr, addr) ||
1571	       is_broadcast_ether_addr(raddr);
1572}
1573
1574static inline bool
1575ieee80211_have_rx_timestamp(struct ieee80211_rx_status *status)
1576{
1577	WARN_ON_ONCE(status->flag & RX_FLAG_MACTIME_START &&
1578		     status->flag & RX_FLAG_MACTIME_END);
1579	if (status->flag & (RX_FLAG_MACTIME_START | RX_FLAG_MACTIME_END))
1580		return true;
1581	/* can't handle non-legacy preamble yet */
1582	if (status->flag & RX_FLAG_MACTIME_PLCP_START &&
1583	    status->encoding == RX_ENC_LEGACY)
1584		return true;
1585	return false;
1586}
1587
1588void ieee80211_vif_inc_num_mcast(struct ieee80211_sub_if_data *sdata);
1589void ieee80211_vif_dec_num_mcast(struct ieee80211_sub_if_data *sdata);
1590
1591/* This function returns the number of multicast stations connected to this
1592 * interface. It returns -1 if that number is not tracked, that is for netdevs
1593 * not in AP or AP_VLAN mode or when using 4addr.
1594 */
1595static inline int
1596ieee80211_vif_get_num_mcast_if(struct ieee80211_sub_if_data *sdata)
1597{
1598	if (sdata->vif.type == NL80211_IFTYPE_AP)
1599		return atomic_read(&sdata->u.ap.num_mcast_sta);
1600	if (sdata->vif.type == NL80211_IFTYPE_AP_VLAN && !sdata->u.vlan.sta)
1601		return atomic_read(&sdata->u.vlan.num_mcast_sta);
1602	return -1;
1603}
1604
1605u64 ieee80211_calculate_rx_timestamp(struct ieee80211_local *local,
1606				     struct ieee80211_rx_status *status,
1607				     unsigned int mpdu_len,
1608				     unsigned int mpdu_offset);
1609int ieee80211_hw_config(struct ieee80211_local *local, u32 changed);
1610void ieee80211_tx_set_protected(struct ieee80211_tx_data *tx);
1611void ieee80211_bss_info_change_notify(struct ieee80211_sub_if_data *sdata,
1612				      u32 changed);
1613void ieee80211_configure_filter(struct ieee80211_local *local);
1614u32 ieee80211_reset_erp_info(struct ieee80211_sub_if_data *sdata);
1615
1616u64 ieee80211_mgmt_tx_cookie(struct ieee80211_local *local);
1617int ieee80211_attach_ack_skb(struct ieee80211_local *local, struct sk_buff *skb,
1618			     u64 *cookie, gfp_t gfp);
1619
1620void ieee80211_check_fast_rx(struct sta_info *sta);
1621void __ieee80211_check_fast_rx_iface(struct ieee80211_sub_if_data *sdata);
1622void ieee80211_check_fast_rx_iface(struct ieee80211_sub_if_data *sdata);
1623void ieee80211_clear_fast_rx(struct sta_info *sta);
1624
1625/* STA code */
1626void ieee80211_sta_setup_sdata(struct ieee80211_sub_if_data *sdata);
1627int ieee80211_mgd_auth(struct ieee80211_sub_if_data *sdata,
1628		       struct cfg80211_auth_request *req);
1629int ieee80211_mgd_assoc(struct ieee80211_sub_if_data *sdata,
1630			struct cfg80211_assoc_request *req);
1631int ieee80211_mgd_deauth(struct ieee80211_sub_if_data *sdata,
1632			 struct cfg80211_deauth_request *req);
1633int ieee80211_mgd_disassoc(struct ieee80211_sub_if_data *sdata,
1634			   struct cfg80211_disassoc_request *req);
1635void ieee80211_send_pspoll(struct ieee80211_local *local,
1636			   struct ieee80211_sub_if_data *sdata);
1637void ieee80211_recalc_ps(struct ieee80211_local *local);
1638void ieee80211_recalc_ps_vif(struct ieee80211_sub_if_data *sdata);
1639int ieee80211_set_arp_filter(struct ieee80211_sub_if_data *sdata);
1640void ieee80211_sta_work(struct ieee80211_sub_if_data *sdata);
1641void ieee80211_sta_rx_queued_mgmt(struct ieee80211_sub_if_data *sdata,
1642				  struct sk_buff *skb);
 
 
1643void ieee80211_sta_reset_beacon_monitor(struct ieee80211_sub_if_data *sdata);
1644void ieee80211_sta_reset_conn_monitor(struct ieee80211_sub_if_data *sdata);
1645void ieee80211_mgd_stop(struct ieee80211_sub_if_data *sdata);
1646void ieee80211_mgd_conn_tx_status(struct ieee80211_sub_if_data *sdata,
1647				  __le16 fc, bool acked);
1648void ieee80211_mgd_quiesce(struct ieee80211_sub_if_data *sdata);
1649void ieee80211_sta_restart(struct ieee80211_sub_if_data *sdata);
1650void ieee80211_sta_handle_tspec_ac_params(struct ieee80211_sub_if_data *sdata);
 
 
1651
1652/* IBSS code */
1653void ieee80211_ibss_notify_scan_completed(struct ieee80211_local *local);
1654void ieee80211_ibss_setup_sdata(struct ieee80211_sub_if_data *sdata);
1655void ieee80211_ibss_rx_no_sta(struct ieee80211_sub_if_data *sdata,
1656			      const u8 *bssid, const u8 *addr, u32 supp_rates);
1657int ieee80211_ibss_join(struct ieee80211_sub_if_data *sdata,
1658			struct cfg80211_ibss_params *params);
1659int ieee80211_ibss_leave(struct ieee80211_sub_if_data *sdata);
1660void ieee80211_ibss_work(struct ieee80211_sub_if_data *sdata);
1661void ieee80211_ibss_rx_queued_mgmt(struct ieee80211_sub_if_data *sdata,
1662				   struct sk_buff *skb);
1663int ieee80211_ibss_csa_beacon(struct ieee80211_sub_if_data *sdata,
1664			      struct cfg80211_csa_settings *csa_settings);
1665int ieee80211_ibss_finish_csa(struct ieee80211_sub_if_data *sdata);
1666void ieee80211_ibss_stop(struct ieee80211_sub_if_data *sdata);
1667
1668/* OCB code */
1669void ieee80211_ocb_work(struct ieee80211_sub_if_data *sdata);
1670void ieee80211_ocb_rx_no_sta(struct ieee80211_sub_if_data *sdata,
1671			     const u8 *bssid, const u8 *addr, u32 supp_rates);
1672void ieee80211_ocb_setup_sdata(struct ieee80211_sub_if_data *sdata);
1673int ieee80211_ocb_join(struct ieee80211_sub_if_data *sdata,
1674		       struct ocb_setup *setup);
1675int ieee80211_ocb_leave(struct ieee80211_sub_if_data *sdata);
1676
1677/* mesh code */
1678void ieee80211_mesh_work(struct ieee80211_sub_if_data *sdata);
1679void ieee80211_mesh_rx_queued_mgmt(struct ieee80211_sub_if_data *sdata,
1680				   struct sk_buff *skb);
1681int ieee80211_mesh_csa_beacon(struct ieee80211_sub_if_data *sdata,
1682			      struct cfg80211_csa_settings *csa_settings);
1683int ieee80211_mesh_finish_csa(struct ieee80211_sub_if_data *sdata);
1684
1685/* scan/BSS handling */
1686void ieee80211_scan_work(struct work_struct *work);
1687int ieee80211_request_ibss_scan(struct ieee80211_sub_if_data *sdata,
1688				const u8 *ssid, u8 ssid_len,
1689				struct ieee80211_channel **channels,
1690				unsigned int n_channels,
1691				enum nl80211_bss_scan_width scan_width);
1692int ieee80211_request_scan(struct ieee80211_sub_if_data *sdata,
1693			   struct cfg80211_scan_request *req);
1694void ieee80211_scan_cancel(struct ieee80211_local *local);
1695void ieee80211_run_deferred_scan(struct ieee80211_local *local);
1696void ieee80211_scan_rx(struct ieee80211_local *local, struct sk_buff *skb);
1697
1698void ieee80211_mlme_notify_scan_completed(struct ieee80211_local *local);
1699struct ieee80211_bss *
1700ieee80211_bss_info_update(struct ieee80211_local *local,
1701			  struct ieee80211_rx_status *rx_status,
1702			  struct ieee80211_mgmt *mgmt,
1703			  size_t len,
1704			  struct ieee80211_channel *channel);
1705void ieee80211_rx_bss_put(struct ieee80211_local *local,
1706			  struct ieee80211_bss *bss);
1707
1708/* scheduled scan handling */
1709int
1710__ieee80211_request_sched_scan_start(struct ieee80211_sub_if_data *sdata,
1711				     struct cfg80211_sched_scan_request *req);
1712int ieee80211_request_sched_scan_start(struct ieee80211_sub_if_data *sdata,
1713				       struct cfg80211_sched_scan_request *req);
1714int ieee80211_request_sched_scan_stop(struct ieee80211_local *local);
1715void ieee80211_sched_scan_end(struct ieee80211_local *local);
1716void ieee80211_sched_scan_stopped_work(struct work_struct *work);
1717
1718/* off-channel/mgmt-tx */
1719void ieee80211_offchannel_stop_vifs(struct ieee80211_local *local);
1720void ieee80211_offchannel_return(struct ieee80211_local *local);
1721void ieee80211_roc_setup(struct ieee80211_local *local);
1722void ieee80211_start_next_roc(struct ieee80211_local *local);
1723void ieee80211_roc_purge(struct ieee80211_local *local,
1724			 struct ieee80211_sub_if_data *sdata);
1725int ieee80211_remain_on_channel(struct wiphy *wiphy, struct wireless_dev *wdev,
1726				struct ieee80211_channel *chan,
1727				unsigned int duration, u64 *cookie);
1728int ieee80211_cancel_remain_on_channel(struct wiphy *wiphy,
1729				       struct wireless_dev *wdev, u64 cookie);
1730int ieee80211_mgmt_tx(struct wiphy *wiphy, struct wireless_dev *wdev,
1731		      struct cfg80211_mgmt_tx_params *params, u64 *cookie);
1732int ieee80211_mgmt_tx_cancel_wait(struct wiphy *wiphy,
1733				  struct wireless_dev *wdev, u64 cookie);
1734
1735/* channel switch handling */
1736void ieee80211_csa_finalize_work(struct work_struct *work);
1737int ieee80211_channel_switch(struct wiphy *wiphy, struct net_device *dev,
1738			     struct cfg80211_csa_settings *params);
1739
1740/* interface handling */
1741#define MAC80211_SUPPORTED_FEATURES_TX	(NETIF_F_IP_CSUM | NETIF_F_IPV6_CSUM | \
1742					 NETIF_F_HW_CSUM | NETIF_F_SG | \
1743					 NETIF_F_HIGHDMA | NETIF_F_GSO_SOFTWARE)
1744#define MAC80211_SUPPORTED_FEATURES_RX	(NETIF_F_RXCSUM)
1745#define MAC80211_SUPPORTED_FEATURES	(MAC80211_SUPPORTED_FEATURES_TX | \
1746					 MAC80211_SUPPORTED_FEATURES_RX)
1747
1748int ieee80211_iface_init(void);
1749void ieee80211_iface_exit(void);
1750int ieee80211_if_add(struct ieee80211_local *local, const char *name,
1751		     unsigned char name_assign_type,
1752		     struct wireless_dev **new_wdev, enum nl80211_iftype type,
1753		     struct vif_params *params);
1754int ieee80211_if_change_type(struct ieee80211_sub_if_data *sdata,
1755			     enum nl80211_iftype type);
1756void ieee80211_if_remove(struct ieee80211_sub_if_data *sdata);
1757void ieee80211_remove_interfaces(struct ieee80211_local *local);
1758u32 ieee80211_idle_off(struct ieee80211_local *local);
1759void ieee80211_recalc_idle(struct ieee80211_local *local);
1760void ieee80211_adjust_monitor_flags(struct ieee80211_sub_if_data *sdata,
1761				    const int offset);
1762int ieee80211_do_open(struct wireless_dev *wdev, bool coming_up);
1763void ieee80211_sdata_stop(struct ieee80211_sub_if_data *sdata);
1764int ieee80211_add_virtual_monitor(struct ieee80211_local *local);
1765void ieee80211_del_virtual_monitor(struct ieee80211_local *local);
1766
1767bool __ieee80211_recalc_txpower(struct ieee80211_sub_if_data *sdata);
1768void ieee80211_recalc_txpower(struct ieee80211_sub_if_data *sdata,
1769			      bool update_bss);
 
1770
1771static inline bool ieee80211_sdata_running(struct ieee80211_sub_if_data *sdata)
1772{
1773	return test_bit(SDATA_STATE_RUNNING, &sdata->state);
1774}
1775
1776/* tx handling */
1777void ieee80211_clear_tx_pending(struct ieee80211_local *local);
1778void ieee80211_tx_pending(unsigned long data);
1779netdev_tx_t ieee80211_monitor_start_xmit(struct sk_buff *skb,
1780					 struct net_device *dev);
1781netdev_tx_t ieee80211_subif_start_xmit(struct sk_buff *skb,
1782				       struct net_device *dev);
1783netdev_tx_t ieee80211_subif_start_xmit_8023(struct sk_buff *skb,
1784					    struct net_device *dev);
1785void __ieee80211_subif_start_xmit(struct sk_buff *skb,
1786				  struct net_device *dev,
1787				  u32 info_flags,
1788				  u32 ctrl_flags,
1789				  u64 *cookie);
1790void ieee80211_purge_tx_queue(struct ieee80211_hw *hw,
1791			      struct sk_buff_head *skbs);
1792struct sk_buff *
1793ieee80211_build_data_template(struct ieee80211_sub_if_data *sdata,
1794			      struct sk_buff *skb, u32 info_flags);
1795void ieee80211_tx_monitor(struct ieee80211_local *local, struct sk_buff *skb,
1796			  struct ieee80211_supported_band *sband,
1797			  int retry_count, int shift, bool send_to_cooked,
1798			  struct ieee80211_tx_status *status);
1799
1800void ieee80211_check_fast_xmit(struct sta_info *sta);
1801void ieee80211_check_fast_xmit_all(struct ieee80211_local *local);
1802void ieee80211_check_fast_xmit_iface(struct ieee80211_sub_if_data *sdata);
1803void ieee80211_clear_fast_xmit(struct sta_info *sta);
1804int ieee80211_tx_control_port(struct wiphy *wiphy, struct net_device *dev,
1805			      const u8 *buf, size_t len,
1806			      const u8 *dest, __be16 proto, bool unencrypted,
1807			      u64 *cookie);
1808int ieee80211_probe_mesh_link(struct wiphy *wiphy, struct net_device *dev,
1809			      const u8 *buf, size_t len);
 
 
 
 
 
 
 
 
1810
1811/* HT */
1812void ieee80211_apply_htcap_overrides(struct ieee80211_sub_if_data *sdata,
1813				     struct ieee80211_sta_ht_cap *ht_cap);
1814bool ieee80211_ht_cap_ie_to_sta_ht_cap(struct ieee80211_sub_if_data *sdata,
1815				       struct ieee80211_supported_band *sband,
1816				       const struct ieee80211_ht_cap *ht_cap_ie,
1817				       struct sta_info *sta);
1818void ieee80211_send_delba(struct ieee80211_sub_if_data *sdata,
1819			  const u8 *da, u16 tid,
1820			  u16 initiator, u16 reason_code);
1821int ieee80211_send_smps_action(struct ieee80211_sub_if_data *sdata,
1822			       enum ieee80211_smps_mode smps, const u8 *da,
1823			       const u8 *bssid);
1824void ieee80211_request_smps_ap_work(struct work_struct *work);
1825void ieee80211_request_smps_mgd_work(struct work_struct *work);
1826bool ieee80211_smps_is_restrictive(enum ieee80211_smps_mode smps_mode_old,
1827				   enum ieee80211_smps_mode smps_mode_new);
1828
1829void ___ieee80211_stop_rx_ba_session(struct sta_info *sta, u16 tid,
1830				     u16 initiator, u16 reason, bool stop);
1831void __ieee80211_stop_rx_ba_session(struct sta_info *sta, u16 tid,
1832				    u16 initiator, u16 reason, bool stop);
1833void ___ieee80211_start_rx_ba_session(struct sta_info *sta,
1834				      u8 dialog_token, u16 timeout,
1835				      u16 start_seq_num, u16 ba_policy, u16 tid,
1836				      u16 buf_size, bool tx, bool auto_seq,
1837				      const struct ieee80211_addba_ext_ie *addbaext);
1838void ieee80211_sta_tear_down_BA_sessions(struct sta_info *sta,
1839					 enum ieee80211_agg_stop_reason reason);
1840void ieee80211_process_delba(struct ieee80211_sub_if_data *sdata,
1841			     struct sta_info *sta,
1842			     struct ieee80211_mgmt *mgmt, size_t len);
1843void ieee80211_process_addba_resp(struct ieee80211_local *local,
1844				  struct sta_info *sta,
1845				  struct ieee80211_mgmt *mgmt,
1846				  size_t len);
1847void ieee80211_process_addba_request(struct ieee80211_local *local,
1848				     struct sta_info *sta,
1849				     struct ieee80211_mgmt *mgmt,
1850				     size_t len);
1851
1852int __ieee80211_stop_tx_ba_session(struct sta_info *sta, u16 tid,
1853				   enum ieee80211_agg_stop_reason reason);
1854int ___ieee80211_stop_tx_ba_session(struct sta_info *sta, u16 tid,
1855				    enum ieee80211_agg_stop_reason reason);
1856void ieee80211_start_tx_ba_cb(struct sta_info *sta, int tid,
1857			      struct tid_ampdu_tx *tid_tx);
1858void ieee80211_stop_tx_ba_cb(struct sta_info *sta, int tid,
1859			     struct tid_ampdu_tx *tid_tx);
1860void ieee80211_ba_session_work(struct work_struct *work);
1861void ieee80211_tx_ba_session_handle_start(struct sta_info *sta, int tid);
1862void ieee80211_release_reorder_timeout(struct sta_info *sta, int tid);
1863
1864u8 ieee80211_mcs_to_chains(const struct ieee80211_mcs_info *mcs);
1865enum nl80211_smps_mode
1866ieee80211_smps_mode_to_smps_mode(enum ieee80211_smps_mode smps);
1867
1868/* VHT */
1869void
1870ieee80211_vht_cap_ie_to_sta_vht_cap(struct ieee80211_sub_if_data *sdata,
1871				    struct ieee80211_supported_band *sband,
1872				    const struct ieee80211_vht_cap *vht_cap_ie,
1873				    struct sta_info *sta);
1874enum ieee80211_sta_rx_bandwidth ieee80211_sta_cap_rx_bw(struct sta_info *sta);
1875enum ieee80211_sta_rx_bandwidth ieee80211_sta_cur_vht_bw(struct sta_info *sta);
1876void ieee80211_sta_set_rx_nss(struct sta_info *sta);
1877enum ieee80211_sta_rx_bandwidth
1878ieee80211_chan_width_to_rx_bw(enum nl80211_chan_width width);
1879enum nl80211_chan_width ieee80211_sta_cap_chan_bw(struct sta_info *sta);
1880void ieee80211_sta_set_rx_nss(struct sta_info *sta);
1881void ieee80211_process_mu_groups(struct ieee80211_sub_if_data *sdata,
1882				 struct ieee80211_mgmt *mgmt);
1883u32 __ieee80211_vht_handle_opmode(struct ieee80211_sub_if_data *sdata,
1884                                  struct sta_info *sta, u8 opmode,
1885				  enum nl80211_band band);
1886void ieee80211_vht_handle_opmode(struct ieee80211_sub_if_data *sdata,
1887				 struct sta_info *sta, u8 opmode,
1888				 enum nl80211_band band);
1889void ieee80211_apply_vhtcap_overrides(struct ieee80211_sub_if_data *sdata,
1890				      struct ieee80211_sta_vht_cap *vht_cap);
1891void ieee80211_get_vht_mask_from_cap(__le16 vht_cap,
1892				     u16 vht_mask[NL80211_VHT_NSS_MAX]);
1893enum nl80211_chan_width
1894ieee80211_sta_rx_bw_to_chan_width(struct sta_info *sta);
1895
1896/* HE */
1897void
1898ieee80211_he_cap_ie_to_sta_he_cap(struct ieee80211_sub_if_data *sdata,
1899				  struct ieee80211_supported_band *sband,
1900				  const u8 *he_cap_ie, u8 he_cap_len,
1901				  const struct ieee80211_he_6ghz_capa *he_6ghz_capa,
1902				  struct sta_info *sta);
1903void
1904ieee80211_he_spr_ie_to_bss_conf(struct ieee80211_vif *vif,
1905				const struct ieee80211_he_spr *he_spr_ie_elem);
1906
1907void
1908ieee80211_he_op_ie_to_bss_conf(struct ieee80211_vif *vif,
1909			const struct ieee80211_he_operation *he_op_ie_elem);
1910
 
 
 
1911/* Spectrum management */
1912void ieee80211_process_measurement_req(struct ieee80211_sub_if_data *sdata,
1913				       struct ieee80211_mgmt *mgmt,
1914				       size_t len);
1915/**
1916 * ieee80211_parse_ch_switch_ie - parses channel switch IEs
1917 * @sdata: the sdata of the interface which has received the frame
1918 * @elems: parsed 802.11 elements received with the frame
1919 * @current_band: indicates the current band
1920 * @vht_cap_info: VHT capabilities of the transmitter
1921 * @sta_flags: contains information about own capabilities and restrictions
1922 *	to decide which channel switch announcements can be accepted. Only the
1923 *	following subset of &enum ieee80211_sta_flags are evaluated:
1924 *	%IEEE80211_STA_DISABLE_HT, %IEEE80211_STA_DISABLE_VHT,
1925 *	%IEEE80211_STA_DISABLE_40MHZ, %IEEE80211_STA_DISABLE_80P80MHZ,
1926 *	%IEEE80211_STA_DISABLE_160MHZ.
1927 * @bssid: the currently connected bssid (for reporting)
1928 * @csa_ie: parsed 802.11 csa elements on count, mode, chandef and mesh ttl.
1929	All of them will be filled with if success only.
1930 * Return: 0 on success, <0 on error and >0 if there is nothing to parse.
1931 */
1932int ieee80211_parse_ch_switch_ie(struct ieee80211_sub_if_data *sdata,
1933				 struct ieee802_11_elems *elems,
1934				 enum nl80211_band current_band,
1935				 u32 vht_cap_info,
1936				 u32 sta_flags, u8 *bssid,
1937				 struct ieee80211_csa_ie *csa_ie);
1938
1939/* Suspend/resume and hw reconfiguration */
1940int ieee80211_reconfig(struct ieee80211_local *local);
1941void ieee80211_stop_device(struct ieee80211_local *local);
1942
1943int __ieee80211_suspend(struct ieee80211_hw *hw,
1944			struct cfg80211_wowlan *wowlan);
1945
1946static inline int __ieee80211_resume(struct ieee80211_hw *hw)
1947{
1948	struct ieee80211_local *local = hw_to_local(hw);
1949
1950	WARN(test_bit(SCAN_HW_SCANNING, &local->scanning) &&
1951	     !test_bit(SCAN_COMPLETED, &local->scanning),
1952		"%s: resume with hardware scan still in progress\n",
1953		wiphy_name(hw->wiphy));
1954
1955	return ieee80211_reconfig(hw_to_local(hw));
1956}
1957
1958/* utility functions/constants */
1959extern const void *const mac80211_wiphy_privid; /* for wiphy privid */
1960int ieee80211_frame_duration(enum nl80211_band band, size_t len,
1961			     int rate, int erp, int short_preamble,
1962			     int shift);
1963void ieee80211_regulatory_limit_wmm_params(struct ieee80211_sub_if_data *sdata,
1964					   struct ieee80211_tx_queue_params *qparam,
1965					   int ac);
1966void ieee80211_set_wmm_default(struct ieee80211_sub_if_data *sdata,
1967			       bool bss_notify, bool enable_qos);
1968void ieee80211_xmit(struct ieee80211_sub_if_data *sdata,
1969		    struct sta_info *sta, struct sk_buff *skb);
1970
1971void __ieee80211_tx_skb_tid_band(struct ieee80211_sub_if_data *sdata,
1972				 struct sk_buff *skb, int tid,
1973				 enum nl80211_band band);
1974
1975/* sta_out needs to be checked for ERR_PTR() before using */
1976int ieee80211_lookup_ra_sta(struct ieee80211_sub_if_data *sdata,
1977			    struct sk_buff *skb,
1978			    struct sta_info **sta_out);
1979
1980static inline void
1981ieee80211_tx_skb_tid_band(struct ieee80211_sub_if_data *sdata,
1982			  struct sk_buff *skb, int tid,
1983			  enum nl80211_band band)
1984{
1985	rcu_read_lock();
1986	__ieee80211_tx_skb_tid_band(sdata, skb, tid, band);
1987	rcu_read_unlock();
1988}
1989
1990static inline void ieee80211_tx_skb_tid(struct ieee80211_sub_if_data *sdata,
1991					struct sk_buff *skb, int tid)
1992{
1993	struct ieee80211_chanctx_conf *chanctx_conf;
1994
1995	rcu_read_lock();
1996	chanctx_conf = rcu_dereference(sdata->vif.chanctx_conf);
1997	if (WARN_ON(!chanctx_conf)) {
1998		rcu_read_unlock();
1999		kfree_skb(skb);
2000		return;
2001	}
2002
2003	__ieee80211_tx_skb_tid_band(sdata, skb, tid,
2004				    chanctx_conf->def.chan->band);
2005	rcu_read_unlock();
2006}
2007
2008static inline void ieee80211_tx_skb(struct ieee80211_sub_if_data *sdata,
2009				    struct sk_buff *skb)
2010{
2011	/* Send all internal mgmt frames on VO. Accordingly set TID to 7. */
2012	ieee80211_tx_skb_tid(sdata, skb, 7);
2013}
2014
2015u32 ieee802_11_parse_elems_crc(const u8 *start, size_t len, bool action,
2016			       struct ieee802_11_elems *elems,
2017			       u64 filter, u32 crc, u8 *transmitter_bssid,
2018			       u8 *bss_bssid);
2019static inline void ieee802_11_parse_elems(const u8 *start, size_t len,
2020					  bool action,
2021					  struct ieee802_11_elems *elems,
2022					  u8 *transmitter_bssid,
2023					  u8 *bss_bssid)
2024{
2025	ieee802_11_parse_elems_crc(start, len, action, elems, 0, 0,
2026				   transmitter_bssid, bss_bssid);
2027}
2028
2029
2030extern const int ieee802_1d_to_ac[8];
2031
2032static inline int ieee80211_ac_from_tid(int tid)
2033{
2034	return ieee802_1d_to_ac[tid & 7];
2035}
2036
2037void ieee80211_dynamic_ps_enable_work(struct work_struct *work);
2038void ieee80211_dynamic_ps_disable_work(struct work_struct *work);
2039void ieee80211_dynamic_ps_timer(struct timer_list *t);
2040void ieee80211_send_nullfunc(struct ieee80211_local *local,
2041			     struct ieee80211_sub_if_data *sdata,
2042			     bool powersave);
2043void ieee80211_sta_rx_notify(struct ieee80211_sub_if_data *sdata,
2044			     struct ieee80211_hdr *hdr);
2045void ieee80211_sta_tx_notify(struct ieee80211_sub_if_data *sdata,
2046			     struct ieee80211_hdr *hdr, bool ack, u16 tx_time);
2047
2048void ieee80211_wake_queues_by_reason(struct ieee80211_hw *hw,
2049				     unsigned long queues,
2050				     enum queue_stop_reason reason,
2051				     bool refcounted);
2052void ieee80211_stop_vif_queues(struct ieee80211_local *local,
2053			       struct ieee80211_sub_if_data *sdata,
2054			       enum queue_stop_reason reason);
2055void ieee80211_wake_vif_queues(struct ieee80211_local *local,
2056			       struct ieee80211_sub_if_data *sdata,
2057			       enum queue_stop_reason reason);
2058void ieee80211_stop_queues_by_reason(struct ieee80211_hw *hw,
2059				     unsigned long queues,
2060				     enum queue_stop_reason reason,
2061				     bool refcounted);
2062void ieee80211_wake_queue_by_reason(struct ieee80211_hw *hw, int queue,
2063				    enum queue_stop_reason reason,
2064				    bool refcounted);
2065void ieee80211_stop_queue_by_reason(struct ieee80211_hw *hw, int queue,
2066				    enum queue_stop_reason reason,
2067				    bool refcounted);
2068void ieee80211_propagate_queue_wake(struct ieee80211_local *local, int queue);
2069void ieee80211_add_pending_skb(struct ieee80211_local *local,
2070			       struct sk_buff *skb);
2071void ieee80211_add_pending_skbs(struct ieee80211_local *local,
2072				struct sk_buff_head *skbs);
2073void ieee80211_flush_queues(struct ieee80211_local *local,
2074			    struct ieee80211_sub_if_data *sdata, bool drop);
2075void __ieee80211_flush_queues(struct ieee80211_local *local,
2076			      struct ieee80211_sub_if_data *sdata,
2077			      unsigned int queues, bool drop);
2078
2079static inline bool ieee80211_can_run_worker(struct ieee80211_local *local)
2080{
2081	/*
2082	 * It's unsafe to try to do any work during reconfigure flow.
2083	 * When the flow ends the work will be requeued.
2084	 */
2085	if (local->in_reconfig)
2086		return false;
2087
2088	/*
2089	 * If quiescing is set, we are racing with __ieee80211_suspend.
2090	 * __ieee80211_suspend flushes the workers after setting quiescing,
2091	 * and we check quiescing / suspended before enqueing new workers.
2092	 * We should abort the worker to avoid the races below.
2093	 */
2094	if (local->quiescing)
2095		return false;
2096
2097	/*
2098	 * We might already be suspended if the following scenario occurs:
2099	 * __ieee80211_suspend		Control path
2100	 *
2101	 *				if (local->quiescing)
2102	 *					return;
2103	 * local->quiescing = true;
2104	 * flush_workqueue();
2105	 *				queue_work(...);
2106	 * local->suspended = true;
2107	 * local->quiescing = false;
2108	 *				worker starts running...
2109	 */
2110	if (local->suspended)
2111		return false;
2112
2113	return true;
2114}
2115
2116int ieee80211_txq_setup_flows(struct ieee80211_local *local);
2117void ieee80211_txq_set_params(struct ieee80211_local *local);
2118void ieee80211_txq_teardown_flows(struct ieee80211_local *local);
2119void ieee80211_txq_init(struct ieee80211_sub_if_data *sdata,
2120			struct sta_info *sta,
2121			struct txq_info *txq, int tid);
2122void ieee80211_txq_purge(struct ieee80211_local *local,
2123			 struct txq_info *txqi);
2124void ieee80211_txq_remove_vlan(struct ieee80211_local *local,
2125			       struct ieee80211_sub_if_data *sdata);
2126void ieee80211_fill_txq_stats(struct cfg80211_txq_stats *txqstats,
2127			      struct txq_info *txqi);
2128void ieee80211_wake_txqs(unsigned long data);
2129void ieee80211_send_auth(struct ieee80211_sub_if_data *sdata,
2130			 u16 transaction, u16 auth_alg, u16 status,
2131			 const u8 *extra, size_t extra_len, const u8 *bssid,
2132			 const u8 *da, const u8 *key, u8 key_len, u8 key_idx,
2133			 u32 tx_flags);
2134void ieee80211_send_deauth_disassoc(struct ieee80211_sub_if_data *sdata,
2135				    const u8 *da, const u8 *bssid,
2136				    u16 stype, u16 reason,
2137				    bool send_frame, u8 *frame_buf);
2138
2139enum {
2140	IEEE80211_PROBE_FLAG_DIRECTED		= BIT(0),
2141	IEEE80211_PROBE_FLAG_MIN_CONTENT	= BIT(1),
2142	IEEE80211_PROBE_FLAG_RANDOM_SN		= BIT(2),
2143};
2144
2145int ieee80211_build_preq_ies(struct ieee80211_sub_if_data *sdata, u8 *buffer,
2146			     size_t buffer_len,
2147			     struct ieee80211_scan_ies *ie_desc,
2148			     const u8 *ie, size_t ie_len,
2149			     u8 bands_used, u32 *rate_masks,
2150			     struct cfg80211_chan_def *chandef,
2151			     u32 flags);
2152struct sk_buff *ieee80211_build_probe_req(struct ieee80211_sub_if_data *sdata,
2153					  const u8 *src, const u8 *dst,
2154					  u32 ratemask,
2155					  struct ieee80211_channel *chan,
2156					  const u8 *ssid, size_t ssid_len,
2157					  const u8 *ie, size_t ie_len,
2158					  u32 flags);
2159u32 ieee80211_sta_get_rates(struct ieee80211_sub_if_data *sdata,
2160			    struct ieee802_11_elems *elems,
2161			    enum nl80211_band band, u32 *basic_rates);
2162int __ieee80211_request_smps_mgd(struct ieee80211_sub_if_data *sdata,
2163				 enum ieee80211_smps_mode smps_mode);
2164void ieee80211_recalc_smps(struct ieee80211_sub_if_data *sdata);
2165void ieee80211_recalc_min_chandef(struct ieee80211_sub_if_data *sdata);
2166
2167size_t ieee80211_ie_split_vendor(const u8 *ies, size_t ielen, size_t offset);
2168u8 *ieee80211_ie_build_ht_cap(u8 *pos, struct ieee80211_sta_ht_cap *ht_cap,
2169			      u16 cap);
2170u8 *ieee80211_ie_build_ht_oper(u8 *pos, struct ieee80211_sta_ht_cap *ht_cap,
2171			       const struct cfg80211_chan_def *chandef,
2172			       u16 prot_mode, bool rifs_mode);
2173void ieee80211_ie_build_wide_bw_cs(u8 *pos,
2174				   const struct cfg80211_chan_def *chandef);
2175u8 *ieee80211_ie_build_vht_cap(u8 *pos, struct ieee80211_sta_vht_cap *vht_cap,
2176			       u32 cap);
2177u8 *ieee80211_ie_build_vht_oper(u8 *pos, struct ieee80211_sta_vht_cap *vht_cap,
2178				const struct cfg80211_chan_def *chandef);
2179u8 ieee80211_ie_len_he_cap(struct ieee80211_sub_if_data *sdata, u8 iftype);
2180u8 *ieee80211_ie_build_he_cap(u8 *pos,
2181			      const struct ieee80211_sta_he_cap *he_cap,
2182			      u8 *end);
2183void ieee80211_ie_build_he_6ghz_cap(struct ieee80211_sub_if_data *sdata,
2184				    struct sk_buff *skb);
2185u8 *ieee80211_ie_build_he_oper(u8 *pos, struct cfg80211_chan_def *chandef);
2186int ieee80211_parse_bitrates(struct cfg80211_chan_def *chandef,
2187			     const struct ieee80211_supported_band *sband,
2188			     const u8 *srates, int srates_len, u32 *rates);
2189int ieee80211_add_srates_ie(struct ieee80211_sub_if_data *sdata,
2190			    struct sk_buff *skb, bool need_basic,
2191			    enum nl80211_band band);
2192int ieee80211_add_ext_srates_ie(struct ieee80211_sub_if_data *sdata,
2193				struct sk_buff *skb, bool need_basic,
2194				enum nl80211_band band);
2195u8 *ieee80211_add_wmm_info_ie(u8 *buf, u8 qosinfo);
 
 
 
 
 
2196
2197/* channel management */
2198bool ieee80211_chandef_ht_oper(const struct ieee80211_ht_operation *ht_oper,
2199			       struct cfg80211_chan_def *chandef);
2200bool ieee80211_chandef_vht_oper(struct ieee80211_hw *hw, u32 vht_cap_info,
2201				const struct ieee80211_vht_operation *oper,
2202				const struct ieee80211_ht_operation *htop,
2203				struct cfg80211_chan_def *chandef);
2204bool ieee80211_chandef_he_6ghz_oper(struct ieee80211_sub_if_data *sdata,
2205				    const struct ieee80211_he_operation *he_oper,
2206				    struct cfg80211_chan_def *chandef);
 
 
2207u32 ieee80211_chandef_downgrade(struct cfg80211_chan_def *c);
2208
2209int __must_check
2210ieee80211_vif_use_channel(struct ieee80211_sub_if_data *sdata,
2211			  const struct cfg80211_chan_def *chandef,
2212			  enum ieee80211_chanctx_mode mode);
2213int __must_check
2214ieee80211_vif_reserve_chanctx(struct ieee80211_sub_if_data *sdata,
2215			      const struct cfg80211_chan_def *chandef,
2216			      enum ieee80211_chanctx_mode mode,
2217			      bool radar_required);
2218int __must_check
2219ieee80211_vif_use_reserved_context(struct ieee80211_sub_if_data *sdata);
2220int ieee80211_vif_unreserve_chanctx(struct ieee80211_sub_if_data *sdata);
2221
2222int __must_check
2223ieee80211_vif_change_bandwidth(struct ieee80211_sub_if_data *sdata,
2224			       const struct cfg80211_chan_def *chandef,
2225			       u32 *changed);
2226void ieee80211_vif_release_channel(struct ieee80211_sub_if_data *sdata);
2227void ieee80211_vif_vlan_copy_chanctx(struct ieee80211_sub_if_data *sdata);
2228void ieee80211_vif_copy_chanctx_to_vlans(struct ieee80211_sub_if_data *sdata,
2229					 bool clear);
2230int ieee80211_chanctx_refcount(struct ieee80211_local *local,
2231			       struct ieee80211_chanctx *ctx);
2232
2233void ieee80211_recalc_smps_chanctx(struct ieee80211_local *local,
2234				   struct ieee80211_chanctx *chanctx);
2235void ieee80211_recalc_chanctx_min_def(struct ieee80211_local *local,
2236				      struct ieee80211_chanctx *ctx);
2237bool ieee80211_is_radar_required(struct ieee80211_local *local);
2238
2239void ieee80211_dfs_cac_timer(unsigned long data);
2240void ieee80211_dfs_cac_timer_work(struct work_struct *work);
2241void ieee80211_dfs_cac_cancel(struct ieee80211_local *local);
2242void ieee80211_dfs_radar_detected_work(struct work_struct *work);
2243int ieee80211_send_action_csa(struct ieee80211_sub_if_data *sdata,
2244			      struct cfg80211_csa_settings *csa_settings);
2245
2246bool ieee80211_cs_valid(const struct ieee80211_cipher_scheme *cs);
2247bool ieee80211_cs_list_valid(const struct ieee80211_cipher_scheme *cs, int n);
2248const struct ieee80211_cipher_scheme *
2249ieee80211_cs_get(struct ieee80211_local *local, u32 cipher,
2250		 enum nl80211_iftype iftype);
2251int ieee80211_cs_headroom(struct ieee80211_local *local,
2252			  struct cfg80211_crypto_settings *crypto,
2253			  enum nl80211_iftype iftype);
2254void ieee80211_recalc_dtim(struct ieee80211_local *local,
2255			   struct ieee80211_sub_if_data *sdata);
2256int ieee80211_check_combinations(struct ieee80211_sub_if_data *sdata,
2257				 const struct cfg80211_chan_def *chandef,
2258				 enum ieee80211_chanctx_mode chanmode,
2259				 u8 radar_detect);
2260int ieee80211_max_num_channels(struct ieee80211_local *local);
2261enum nl80211_chan_width ieee80211_get_sta_bw(struct ieee80211_sta *sta);
2262void ieee80211_recalc_chanctx_chantype(struct ieee80211_local *local,
2263				       struct ieee80211_chanctx *ctx);
2264
2265/* TDLS */
2266int ieee80211_tdls_mgmt(struct wiphy *wiphy, struct net_device *dev,
2267			const u8 *peer, u8 action_code, u8 dialog_token,
2268			u16 status_code, u32 peer_capability,
2269			bool initiator, const u8 *extra_ies,
2270			size_t extra_ies_len);
2271int ieee80211_tdls_oper(struct wiphy *wiphy, struct net_device *dev,
2272			const u8 *peer, enum nl80211_tdls_operation oper);
2273void ieee80211_tdls_peer_del_work(struct work_struct *wk);
2274int ieee80211_tdls_channel_switch(struct wiphy *wiphy, struct net_device *dev,
2275				  const u8 *addr, u8 oper_class,
2276				  struct cfg80211_chan_def *chandef);
2277void ieee80211_tdls_cancel_channel_switch(struct wiphy *wiphy,
2278					  struct net_device *dev,
2279					  const u8 *addr);
2280void ieee80211_teardown_tdls_peers(struct ieee80211_sub_if_data *sdata);
2281void ieee80211_tdls_chsw_work(struct work_struct *wk);
2282void ieee80211_tdls_handle_disconnect(struct ieee80211_sub_if_data *sdata,
2283				      const u8 *peer, u16 reason);
 
 
 
 
 
2284const char *ieee80211_get_reason_code_string(u16 reason_code);
 
 
 
2285
2286extern const struct ethtool_ops ieee80211_ethtool_ops;
2287
2288u32 ieee80211_calc_expected_tx_airtime(struct ieee80211_hw *hw,
2289				       struct ieee80211_vif *vif,
2290				       struct ieee80211_sta *pubsta,
2291				       int len, bool ampdu);
2292#ifdef CONFIG_MAC80211_NOINLINE
2293#define debug_noinline noinline
2294#else
2295#define debug_noinline
2296#endif
 
 
 
2297
2298#endif /* IEEE80211_I_H */