1 /* SPDX-License-Identifier: GPL-2.0-only */
3  * mac80211 <-> driver interface
5  * Copyright 2002-2005, Devicescape Software, Inc.
6  * Copyright 2006-2007	Jiri Benc <jbenc@suse.cz>
7  * Copyright 2007-2010	Johannes Berg <johannes@sipsolutions.net>
8  * Copyright 2013-2014  Intel Mobile Communications GmbH
9  * Copyright (C) 2015 - 2017 Intel Deutschland GmbH
10  * Copyright (C) 2018 - 2024 Intel Corporation
31  * only partial functionality in hard- or firmware. This document
32  * defines the interface between mac80211 and low-level hardware
40  * called in hardware interrupt context. The low-level driver must not call any
42  * call, the low-level driver should first ACK the interrupt and perform the
47  *	 use the non-IRQ-safe functions!
100  * Intermediate queues (struct ieee80211_txq) are kept per-sta per-tid, with
101  * another per-sta for non-data/non-mgmt and bufferable management frames, and
102  * a single per-vif queue for multicast data frames.
104  * The driver is expected to initialize its private per-queue data for stations
149  * enum ieee80211_max_queues - maximum number of queues
156 	IEEE80211_MAX_QUEUE_MAP =	BIT(IEEE80211_MAX_QUEUES) - 1,
162  * enum ieee80211_ac_numbers - AC numbers as used in mac80211
176  * struct ieee80211_tx_queue_params - transmit queue configuration
183  *	2^n-1 in the range 1..32767]
187  * @uapsd: is U-APSD mode enabled for the queue
210  * enum ieee80211_chanctx_change - change flag for channel context
233  * struct ieee80211_chan_req - A channel "request"
244  * struct ieee80211_chanctx_conf - channel context that vifs may be tuned to
246  * This is the driver-visible part. The ieee80211_chanctx
277  * enum ieee80211_chanctx_switch_mode - channel context switch mode
285  *      implement this as an on-the-fly chandef switch of the existing
296  * struct ieee80211_vif_chanctx_switch - vif chanctx switch information
304  * @link_conf: the link conf that's switching
316  * enum ieee80211_bss_change - BSS change notification flags
353  * @BSS_CHANGED_MU_GROUPS: VHT MU-MIMO group id or user position changed
366  * @BSS_CHANGED_MLD_TTLM: negotiated TID to link mapping was changed
417  * enum ieee80211_event_type - event to be notified to the low level driver
433  * enum ieee80211_rssi_event_data - relevant when event type is %RSSI_EVENT
443  * struct ieee80211_rssi_event - data attached to an %RSSI_EVENT
451  * enum ieee80211_mlme_event_data - relevant when event type is %MLME_EVENT
465  * enum ieee80211_mlme_event_status - relevant when event type is %MLME_EVENT
477  * struct ieee80211_mlme_event - data attached to an %MLME_EVENT
489  * struct ieee80211_ba_event - data attached for BlockAck related events
501  * struct ieee80211_event - event to be sent to the driver
518  * struct ieee80211_mu_group_data - STA's VHT MU-MIMO group data
520  * This structure describes the group id data of VHT MU-MIMO
522  * @membership: 64 bits array - a bit is set if station is member of the group
531  * struct ieee80211_ftm_responder_params - FTM responder parameters
546  * struct ieee80211_fils_discovery - FILS discovery parameters from
547  * IEEE Std 802.11ai-2016, Annex C.3 MIB detail.
549  * @min_interval: Minimum packet interval in TUs (0 - 10000)
550  * @max_interval: Maximum packet interval in TUs (0 - 10000)
572  * struct ieee80211_parsed_tpe - parsed transmit power envelope information
591  * struct ieee80211_bss_conf - holds the BSS's changing parameters
601  * @addr: (link) address used locally
602  * @link_id: link ID, or 0 for non-MLO
619  *	with the %BSS_CHANGED_BEACON_INFO flag, will be non-zero then.
642  * @mcast_rate: per-band multicast rate index + 1 (0: disabled)
645  * @chanreq: Channel request for this BSS -- the hardware might be
647  * @mu_group: VHT MU-MIMO group membership data
661  * @qos: This is a QoS-enabled BSS.
662  * @hidden_ssid: The SSID of the current vif is hidden. Only valid in AP-mode.
691  *	in order to discover all the nontransmitted BSSIDs in the set.
706  * @mu_mimo_owner: indicates interface owns MU-MIMO capability
708  *	when it is not assigned. This pointer is RCU-protected due to the TX
725  * @he_su_beamformer: in AP-mode, does this BSS support operation as an HE SU
727  * @he_su_beamformee: in AP-mode, does this BSS support operation as an HE SU
729  * @he_mu_beamformer: in AP-mode, does this BSS support operation as an HE MU
732  *	(non-AP STA) of an HE TB PPDU on an RU that spans the entire PPDU
734  * @eht_su_beamformer: in AP-mode, does this BSS enable operation as an EHT SU
736  * @eht_su_beamformee: in AP-mode, does this BSS enable operation as an EHT SU
738  * @eht_mu_beamformer: in AP-mode, does this BSS enable operation as an EHT MU
740  * @eht_80mhz_full_bw_ul_mumimo: in AP-mode, does this BSS support the
743  * @bss_param_ch_cnt: in BSS-mode, the BSS params change count. This
744  *	information is the latest known value. It can come from this link's
745  *	beacon or from a beacon sent by another link.
746  * @bss_param_ch_cnt_link_id: in BSS-mode, the link_id to which the beacon
747  *	that updated &bss_param_ch_cnt belongs. E.g. if link 1 doesn't hear
748  *	its beacons, and link 2 sent a beacon with an RNR element that updated
749  *	link 1's BSS params change count, then, link 1's
750  *	bss_param_ch_cnt_link_id will be 2. That means that link 1 knows that
751  *	link 2 was the link that updated its bss_param_ch_cnt value.
752  *	In case link 1 hears its beacon again, bss_param_ch_cnt_link_id will
754  *	the link to know that it heard the latest value from its own beacon
755  *	(as opposed to hearing its value from another link's beacon).
855  * enum mac80211_tx_info_flags - flags to describe transmission information/status
864  *	assign sequence numbers to QoS-data frames but cannot do so correctly
865  *	for non-QoS-data and management frames because beacons need them from
869  *	802.11-2007 7.1.3.4.1 paragraph 3. This flag will always be set for
876  * @IEEE80211_TX_CTL_AMPDU: this frame should be sent as part of an A-MPDU
897  *	off-channel operation.
905  *	frame (PS-Poll or uAPSD) or a non-bufferable MMPDU and must
921  * @IEEE80211_TX_CTL_STBC: Enables Space-Time Block Coding (STBC) for this
924  *	the off-channel channel when a remain-on-channel offload is done
925  *	in hardware -- normal packets still flow and are expected to be
937  *	PS-Poll responses.
947  *	This flag must not be set for frames that don't request no-ack
992  * enum mac80211_tx_control_flags - flags to describe transmit control
997  *	frame (PS-Poll or uAPSD).
999  * @IEEE80211_TX_CTRL_AMSDU: This frame is an A-MSDU frame
1016  *	frame should be transmitted on the specific link. This really is
1019  *	is on a specific link, address translation might still apply if
1022  * These flags are used in tx_info->control.flags.
1045  * enum mac80211_tx_status_flags - flags to describe transmit status
1049  * These flags are used in tx_info->status.flags.
1069  * enum mac80211_rate_control_flags - per-rate flags set by the
1076  * @IEEE80211_TX_RC_USE_CTS_PROTECT: CTS-to-self protection is required.
1123  * struct ieee80211_tx_rate - rate selection/status
1129  * A value of -1 for @idx indicates an invalid rate and, if used
1141  *    { 3, 2 }, { 2, 2 }, { 1, 4 }, { -1, 0 }, { -1, 0 }
1149  *   { 3, 2 }, { 2, 2 }, { 1, 1 }, { -1, 0 } ...
1164 	return rate->idx >= 0 && rate->count > 0;  in ieee80211_rate_valid()
1171 	WARN_ON((nss - 1) & ~0x7);  in ieee80211_rate_set_vht()
1172 	rate->idx = ((nss - 1) << 4) | mcs;  in ieee80211_rate_set_vht()
1178 	return rate->idx & 0xF;  in ieee80211_rate_get_vht_mcs()
1184 	return (rate->idx >> 4) + 1;  in ieee80211_rate_get_vht_nss()
1188  * struct ieee80211_tx_info - skb transmit information
1190  * This structure is placed in skb->cb for three uses:
1191  *  (1) mac80211 TX control - mac80211 tells the driver what to do
1193  *  (3) TX status information - driver tells mac80211 what happened
1198  *	link the frame will be transmitted on
1302 	 * in increments of 4us and clamp the maximum to 2**12-1  in ieee80211_info_set_tx_time_est()
1304 	info->tx_time_est = min_t(u16, tx_time_est, 4095) >> 2;  in ieee80211_info_set_tx_time_est()
1305 	return info->tx_time_est << 2;  in ieee80211_info_set_tx_time_est()
1311 	return info->tx_time_est << 2;  in ieee80211_info_get_tx_time_est()
1315  * struct ieee80211_rate_status - mrr stage for status path
1322  * @tx_power_idx An idx into the ieee80211_hw->tx_power_levels list of the
1333  * struct ieee80211_tx_status - extended tx status info for rate control
1357  * struct ieee80211_scan_ies - descriptors for different blocks of IEs
1378 	return (struct ieee80211_tx_info *)skb->cb;  in IEEE80211_SKB_CB()
1383 	return (struct ieee80211_rx_status *)skb->cb;  in IEEE80211_SKB_RXCB()
1387  * ieee80211_tx_info_clear_status - clear TX status
1412 		info->status.rates[i].count = 0;  in ieee80211_tx_info_clear_status()
1413 	memset_after(&info->status, 0, rates);  in ieee80211_tx_info_clear_status()
1418  * enum mac80211_rx_flags - receive flags
1434  *	de-duplication by itself.
1440  *	field) is valid if this field is non-zero, and the position
1457  *	Valid only for data frames (mainly A-MPDU)
1458  * @RX_FLAG_AMPDU_DETAILS: A-MPDU details are known, in particular the reference
1460  *	each A-MPDU
1462  *	subframes of a single A-MPDU
1463  * @RX_FLAG_AMPDU_IS_LAST: this subframe is the last subframe of the A-MPDU
1476  * @RX_FLAG_AMSDU_MORE: Some drivers may prefer to report separate A-MSDU
1478  *	All, but the last MSDU from an A-MSDU should have this flag set. E.g.
1479  *	if an A-MSDU has 3 frames, the first 2 must have the flag set, while
1481  *	deal with retransmission/duplication recovery properly since A-MSDU
1483  *	either regular MSDU or singly A-MSDUs. Subframes must not be
1486  *	skb->data (before the 802.11 header).
1496  * @RX_FLAG_AMPDU_EOF_BIT: Value of the EOF bit in the A-MPDU delimiter for this
1502  *	 - DATA3_DATA_MCS
1503  *	 - DATA3_DATA_DCM
1504  *	 - DATA3_CODING
1505  *	 - DATA5_GI
1506  *	 - DATA5_DATA_BW_RU_ALLOC
1507  *	 - DATA6_NSTS
1508  *	 - DATA3_STBC
1513  * @RX_FLAG_RADIOTAP_LSIG: L-SIG radiotap data is present
1515  *	the "0-length PSDU" field included there.  The value for it is
1558  * enum mac80211_rx_encoding_flags - MCS & bandwidth flags
1562  * @RX_ENC_FLAG_HT_GF: This frame was received in a HT-greenfield transmission,
1567  * @RX_ENC_FLAG_STBC_MASK: STBC 2 bit bitmask. 1 - Nss=1, 2 - Nss=2, 3 - Nss=3
1590  * struct ieee80211_rx_status - receive status
1592  * The low-level driver should provide this information (the subset
1596  * @mactime: value in microseconds of the 64-bit Time Synchronization Function
1608  *	for data (other) frames - for those it only affects radiotap reporting.
1615  * @chain_signal: per-chain signal strength, in dBm (unlike @signal, doesn't
1632  * @ampdu_reference: A-MPDU reference number, must be a different value for
1633  *	each A-MPDU but the same for each subframe within one A-MPDU
1634  * @zero_length_psdu_type: radiotap type of the 0-length PSDU
1635  * @link_valid: if the link which is identified by @link_id is valid. This flag
1637  * @link_id: id of the link used to receive the packet. This is used along with
1678 	return MHZ_TO_KHZ(rx_status->freq) +  in ieee80211_rx_status_to_khz()
1679 	       (rx_status->freq_offset ? 500 : 0);  in ieee80211_rx_status_to_khz()
1683  * enum ieee80211_conf_flags - configuration flags
1687  * @IEEE80211_CONF_MONITOR: there's a monitor interface present -- use this
1691  *	This is the power save mode defined by IEEE 802.11-2007 section 11.2,
1714  * enum ieee80211_conf_changed - denotes which configuration changed
1739  * enum ieee80211_smps_mode - spatial multiplexing power save mode
1758  * struct ieee80211_conf - configuration of the device
1806  * struct ieee80211_channel_switch - holds the channel switch data
1811  * @timestamp: value in microseconds of the 64-bit Time Synchronization
1824  * @link_id: the link ID of the link doing the channel switch, 0 for non-MLO
1837  * enum ieee80211_vif_flags - virtual interface flags
1842  *	monitoring on this virtual interface -- i.e. it can monitor
1844  *	provide notifications if configured trigger levels are reached.
1845  * @IEEE80211_VIF_SUPPORTS_UAPSD: The device can do U-APSD for this
1857  *	handle OFDMA (downlink and trigger for uplink) on a per-AP basis.
1870  * enum ieee80211_offload_flags - virtual interface offload flags
1875  * @IEEE80211_OFFLOAD_ENCAP_4ADDR: support 4-address mode encapsulation offload
1888  * struct ieee80211_vif_cfg - interface configuration
1892  * @ps: power-save mode (STA only). This flag is NOT affected by
1895  * @eml_cap: EML capabilities as described in P802.11be_D4.1 Figure 9-1001j.
1897  *	P802.11be_D4.1 Figure 9-1001i.
1899  *	Figure 9-1001k
1913  * @ap_addr: AP MLD address, or BSSID for non-MLO connections
1938  * struct ieee80211_neg_ttlm - negotiated TID to link map info
1953  * enum ieee80211_neg_ttlm_res - return value for negotiated TTLM handling
1965  * struct ieee80211_vif - per-interface data
1974  * @link_conf: in case of MLD, the per-link BSS configuration,
1975  *	indexed by link ID
1976  * @valid_links: bitmap of valid links, or 0 for non-MLO.
1977  * @active_links: The bitmap of active links, or 0 for non-MLO.
1982  *	0 for non-MLO.
1986  *	0 for non-MLO.
1987  * @neg_ttlm: negotiated TID to link mapping info.
1993  *	interface, i.e. a GO or p2p-sta respectively
1995  *	vif. mac80211 initializes this to hw->netdev_features, and the driver
2008  * @cab_queue: content-after-beacon (DTIM beacon really) queue, AP mode only
2019  * @offload_flags: 802.3 -> 802.11 enapsulation offload flags, see
2057  * ieee80211_vif_usable_links - Return the usable links for the vif
2059  * Return: the usable link bitmap
2063 	return vif->valid_links & ~vif->dormant_links;  in ieee80211_vif_usable_links()
2067  * ieee80211_vif_is_mld - Returns true iff the vif is an MLD one
2074 	return vif->valid_links != 0;  in ieee80211_vif_is_mld()
2078  * ieee80211_vif_link_active - check if a given link is active
2080  * @link_id: the link ID to check
2081  * Return: %true if the vif is an MLD and the link is active, or if
2082  *	the vif is not an MLD and the link ID is 0; %false otherwise.
2089 	return vif->active_links & BIT(link_id);  in ieee80211_vif_link_active()
2092 #define for_each_vif_active_link(vif, link, link_id)				\  argument
2093 	for (link_id = 0; link_id < ARRAY_SIZE((vif)->link_conf); link_id++)	\
2094 		if ((!(vif)->active_links ||					\
2095 		     (vif)->active_links & BIT(link_id)) &&			\
2096 		    (link = link_conf_dereference_check(vif, link_id)))
2101 	return vif->type == NL80211_IFTYPE_MESH_POINT;  in ieee80211_vif_is_mesh()
2107  * wdev_to_ieee80211_vif - return a vif struct from a wdev
2120  * ieee80211_vif_to_wdev - return a wdev struct from a vif
2133 	return lockdep_is_held(&ieee80211_vif_to_wdev(vif)->wiphy->mtx);  in lockdep_vif_wiphy_mutex_held()
2137 	rcu_dereference_protected((vif)->link_conf[link_id],	\
2141 	rcu_dereference_check((vif)->link_conf[link_id],	\
2145  * enum ieee80211_key_flags - key flags
2188  * @IEEE80211_KEY_FLAG_SPP_AMSDU: SPP A-MSDUs can be used with this key
2189  *	(set by mac80211 from the sta->spp_amsdu flag)
2207  * struct ieee80211_key_conf - key information
2219  * @keyidx: the key index (0-3)
2221  * @key: key material. For ALG_TKIP the key is encoded as a 256-bit (32 byte)
2223  * 	- Temporal Encryption Key (128 bits)
2224  * 	- Temporal Authenticator Tx MIC Key (64 bits)
2225  * 	- Temporal Authenticator Rx MIC Key (64 bits)
2228  * @link_id: the link ID for MLO, or -1 for non-MLO or pairwise keys
2249  * struct ieee80211_key_seq - key sequence counter
2251  * @tkip: TKIP data, containing IV32 and IV16 in host byte order
2253  *	reverse order than in packet)
2255  *	reverse order than in packet)
2257  *	reverse order than in packet)
2259  *	reverse order than in packet)
2260  * @hw: data for HW-only (e.g. cipher scheme) keys
2288  * enum set_key_cmd - key command
2301  * enum ieee80211_sta_state - station state
2320  * enum ieee80211_sta_rx_bandwidth - station RX bandwidth
2340  * struct ieee80211_sta_rates - station rate selection table
2344  *	Overriding entries per-packet is possible by using cb tx control.
2358  * struct ieee80211_sta_txpwr - station txpower configuration
2376  * struct ieee80211_sta_aggregates - info that is aggregated from active links
2378  * Used for any per-link data that needs to be aggregated and updated in the
2381  * @max_amsdu_len: indicates the maximal length of an A-MSDU in bytes.
2386  *	  A-MSDU maximal size is min(max_amsdu_len, 4065) bytes.
2387  *	* If the skb is not part of a BA agreement, the A-MSDU maximal
2391  * driver. This is defined by the spec (IEEE 802.11-2012 section
2393  * @max_rc_amsdu_len: Maximum A-MSDU size in bytes recommended by rate control.
2394  * @max_tid_amsdu_len: Maximum A-MSDU size in bytes for this TID
2404  * struct ieee80211_link_sta - station Link specific info
2405  * All link specific info for a STA link for a non MLD STA(single)
2409  * @addr: MAC address of the Link STA. For non-MLO STA this is same as the addr
2410  *	in ieee80211_sta. For MLO Link STA this addr can be same or different
2412  * @link_id: the link ID for this link STA (0 for deflink)
2420  * @agg: per-link data for multi-link aggregation
2451  * struct ieee80211_sta - station table entry
2454  * communicating with. Since stations are RCU-managed in
2460  * and holds pointers to various link STA's
2472  *	if wme is supported. The bits order is like in
2477  * @tdls_initiator: indicates the STA is an initiator of the TDLS link. Only
2482  *	A-MSDU. Taken from the Extended Capabilities element. 0 means
2488  * @txq: per-TID data TX queues; note that the last entry (%IEEE80211_NUM_TIDS)
2489  *	is used for non-data frames
2490  * @deflink: This holds the default link STA information, for non MLO STA all link
2492  *	link[0] which points to address of @deflink. For MLO Link STA
2493  *	the first added link STA will point to deflink.
2494  * @link: reference to Link Sta entries. For Non MLO STA, except 1st link,
2495  *	i.e link[0] all links would be assigned to NULL by default and
2496  *	would access link information via @deflink or link[0]. For MLO
2497  *	STA, first link STA being added will point its link pointer to
2499  *	would be assigned to link[link_id] where link_id is the id assigned
2501  * @valid_links: bitmap of valid links, or 0 for non-MLO
2502  * @spp_amsdu: indicates whether the STA uses SPP A-MSDU or not.
2527 	struct ieee80211_link_sta __rcu *link[IEEE80211_MLD_MAX_NUM_LINKS];  member
2543 	rcu_dereference_protected((sta)->link[link_id],		\
2547 	rcu_dereference_check((sta)->link[link_id],		\
2551 	for (link_id = 0; link_id < ARRAY_SIZE((sta)->link); link_id++)		\
2552 		if ((!(vif)->active_links ||					\
2553 		     (vif)->active_links & BIT(link_id)) &&			\
2557  * enum sta_notify_cmd - sta notify command
2570  * struct ieee80211_tx_control - TX control data
2580  * struct ieee80211_txq - Software intermediate tx queue
2583  * @sta: station table entry, %NULL for per-vif queue
2584  * @tid: the TID for this queue (unused for per-vif queue),
2585  *	%IEEE80211_NUM_TIDS for non-data (if enabled)
2587  * @drv_priv: driver private area, sized by hw->txq_data_size
2603  * enum ieee80211_hw_flags - hardware flags
2651  *	Hardware supports 11n A-MPDU aggregation.
2672  *	periodic keep-alives to the AP and probing the AP on beacon loss.
2679  *	per-station GTKs as used by IBSS RSN or during fast transition. If
2680  *	the device doesn't support per-station GTKs, but can be asked not
2687  *	this flag is set mac80211 will not trigger PS mode for connected
2692  * @IEEE80211_HW_TX_AMPDU_SETUP_IN_HW: The device handles TX A-MPDU session
2706  *	be created.  It is expected user-space will create vifs as
2710  *	crypto algorithms can be done in software - so don't automatically
2715  * @IEEE80211_HW_SUPPORT_FAST_XMIT: The driver/hardware supports fast-xmit,
2719  * @IEEE80211_HW_QUEUE_CONTROL: The driver wants to control per-interface
2720  *	queue mapping in order to use different queues (not just one per AC)
2738  * @IEEE80211_HW_CHANCTX_STA_CSA: Support 802.11h based channel-switch (CSA)
2750  *	than then BSS bandwidth for a TDLS link on the base channel.
2752  * @IEEE80211_HW_SUPPORTS_AMSDU_IN_AMPDU: The driver supports receiving A-MSDUs
2753  *	within A-MPDU.
2765  *	order and does not need to manage its own reorder buffer or BA session
2769  *	which implies using per-CPU station statistics.
2772  *	A-MSDU frames. Requires software tx queueing and fast-xmit support.
2774  *	limit the maximum A-MSDU size based on the current tx rate by setting
2778  *	skbs, needed for zero-copy software A-MSDU.
2793  *	support QoS NDP for AP probing - that's most likely a driver bug.
2801  *	but if the rate control is built-in then it must be set by the driver.
2804  * @IEEE80211_HW_STA_MMPDU_TXQ: use the extra non-TID per-station TXQ for all
2808  * @IEEE80211_HW_TX_STATUS_NO_AMPDU_LEN: Driver does not report accurate A-MPDU
2818  *	A-MPDU sessions active while rekeying with Extended Key ID.
2846  *	link is switching.
2914  * struct ieee80211_hw - hardware information and state
2968  *	sub-frames) to be used for A-MPDU block ack receiver
2981  * @max_tx_fragments: maximum number of tx buffers per (A)-MSDU, sum
2982  *	of 1 + skb_shinfo(skb)->nr_frags for each skb in the frag_list.
2997  *	@units_pos member is set to a non-negative value then the timestamp
3003  * @radiotap_timestamp.accuracy: If non-negative, fills the accuracy in the
3011  *	for each access category if it is uAPSD trigger-enabled and delivery-
3014  *	that corresponding AC is both trigger- and delivery-enabled. '0' means
3081 	return test_bit(flg, hw->flags);  in _ieee80211_hw_check()
3088 	return __set_bit(flg, hw->flags);  in _ieee80211_hw_set()
3093  * struct ieee80211_scan_request - hw scan request
3106  * struct ieee80211_tdls_ch_sw_params - TDLS channel switch parameters
3108  * @sta: peer this TDLS channel-switch request/response came from
3109  * @chandef: channel referenced in a TDLS channel-switch request
3111  * @status: channel-switch response status
3113  * @switch_time: switch-timing parameter received in the frame
3114  * @switch_timeout: switch-timing parameter received in the frame
3115  * @tmpl_skb: TDLS switch-channel response template
3116  * @ch_sw_tm_ie: offset of the channel-switch timing IE inside @tmpl_skb
3131  * wiphy_to_ieee80211_hw - return a mac80211 driver hw struct from a wiphy
3137  * structure can then access it via hw->priv. Note that mac802111 drivers should
3146  * SET_IEEE80211_DEV - set device for 802.11 hardware
3153 	set_wiphy_dev(hw->wiphy, dev);  in SET_IEEE80211_DEV()
3157  * SET_IEEE80211_PERM_ADDR - set the permanent MAC address for 802.11 hardware
3164 	memcpy(hw->wiphy->perm_addr, addr, ETH_ALEN);  in SET_IEEE80211_PERM_ADDR()
3171 	if (WARN_ON_ONCE(c->control.rates[0].idx < 0))  in ieee80211_get_tx_rate()
3173 	return &hw->wiphy->bands[c->band]->bitrates[c->control.rates[0].idx];  in ieee80211_get_tx_rate()
3180 	if (c->control.rts_cts_rate_idx < 0)  in ieee80211_get_rts_cts_rate()
3182 	return &hw->wiphy->bands[c->band]->bitrates[c->control.rts_cts_rate_idx];  in ieee80211_get_rts_cts_rate()
3189 	if (c->control.rates[idx + 1].idx < 0)  in ieee80211_get_alt_retry_rate()
3191 	return &hw->wiphy->bands[c->band]->bitrates[c->control.rates[idx + 1].idx];  in ieee80211_get_alt_retry_rate()
3195  * ieee80211_free_txskb - free TX skb
3205  * ieee80211_purge_tx_queue - purge TX skb queue
3236  * the key is now in use, -%EOPNOTSUPP or -%ENOSPC if it couldn't be
3264  * provided by update_tkip_key only. The trigger that makes mac80211 call this
3272  * when they are able to replace in-use PTK keys according to the following
3277       at the time of the key deletion (including re-transmits),
3300  * IEEE 802.11-2007 section 11.2 is enabled. This is not to be confused
3318  * hardware stays awake for a user-specified period of time after sending a
3335  * Driver informs U-APSD client support by enabling
3339  * utilize U-APSD, dynamic powersave is disabled for voip AC and all frames
3342  * Note: U-APSD client mode is not yet supported with
3373  *  - a list of information element IDs
3374  *  - a list of OUIs for the vendor information element
3388  * the various vendor-assigned IEs with unknown contents (128, 129, 133-136,
3412  * and rationale, please refer to 802.11 (as amended by 802.11n-2009)
3475  * In order to implement AP and P2P GO modes, mac80211 has support for
3476  * client powersaving, both "legacy" PS (PS-Poll/null data) and uAPSD.
3480  * will not poll with PS-Poll and trigger with uAPSD at the same time.
3491  * handle PS-Poll/uAPSD.
3505  * it can PS-Poll, or it can possibly start a uAPSD service period.
3508  * the station sends a PS-Poll or a uAPSD trigger frame, mac80211
3513  * response to a PS-Poll) also has %IEEE80211_TX_STATUS_EOSP set to
3519  * Additionally, non-bufferable MMPDUs can also be transmitted by
3527  * transmitted to a certain station is out-of-band communication to
3545  * there is more data on other TIDs -- the TIDs to release frames
3550  * shorten service periods (or abort PS-Poll responses), it must
3552  * are buffered in the driver -- those must remain buffered to avoid
3563  * Note that if the driver ever buffers frames other than QoS-data
3564  * frames, it must take care to never send a non-QoS-data frame as
3565  * the last frame in a service period, adding a QoS-nulldata frame
3566  * after a non-QoS-data frame if needed.
3573  * assignment of per-interface AC software queues to hardware queues. This
3575  * 1) off-channel transmissions might get stuck behind other frames
3577  * 3) after-DTIM frames could get stuck behind other frames
3601  * after-DTIM queue for AP:   8
3602  * off-channel queue:         9
3613  * and the second virtual interface with 4-7.
3625  * enum ieee80211_filter_flags - hardware filter flags
3672  * enum ieee80211_ampdu_mlme_action - A-MPDU actions
3717  * struct ieee80211_ampdu_params - AMPDU action parameters
3728  * @amsdu: indicates the peer's ability to receive A-MSDU within A-MPDU.
3744  * enum ieee80211_frame_release_type - frame release reason
3745  * @IEEE80211_FRAME_RELEASE_PSPOLL: frame released for PS-Poll
3747  *	frame received on trigger-enabled AC
3755  * enum ieee80211_rate_control_changed - flags to indicate what changed
3759  *	information -- for HT20/40 the IEEE80211_HT_CAP_SUP_WIDTH_20_40
3776  * enum ieee80211_roc_type - remain on channel type
3794  * enum ieee80211_reconfig_type - reconfig type
3810  * struct ieee80211_prep_tx_info - prepare TX information
3811  * @duration: if non-zero, hint about the required duration,
3819  * @link_id: the link id on which the frame will be TX'ed.
3830  * struct ieee80211_ops - callbacks from mac80211 to the driver
3838  *	The low-level driver should send the frame out based on
3849  *	to avoid acknowledging frames before a non-monitor device
3928  * @link_info_changed: Handler for configuration requests related to link
3930  *	individual link. e.g. legacy/HT/VHT/... rate information.
3932  *	parameter indicates the link ID. Note that the @link_id will be 0 for
3933  *	non-MLO connections.
3974  *	offloading. The index can be 0-3, or -1 for unsetting it.
3983  *	at all but just send them after the SSID -- mac80211 includes the
3995  * @cancel_hw_scan: Ask the low-level tp cancel the active hw scan.
4000  *	scan_work after the low-level driver was already suspended.
4022  * @get_stats: Return low-level statistics.
4055  *	when a link is added to a mac80211 vif. This callback should be within
4057  *	For non-MLO the callback will be called once for the default bss_conf
4066  *	when a link is added to a mac80211 station. This callback
4069  *	For non-MLO the callback will be called once for the deflink with the
4086  *	isn't safe to use the pointer, not even RCU protected - no RCU grace
4111  *	let the driver pre-fill the statistics. The driver can fill most of
4113  *	all of them make sense - see the source for which ones are possible.
4147  *	Returns non-zero if this device sent the last beacon.
4150  * @get_survey: Return per-channel survey information
4153  *	need to set wiphy->rfkill_poll to %true before registration,
4158  *	in IEEE 802.11-2007 section 17.3.8.6 and modify ACK timeout
4159  *	accordingly; coverage class equals to -1 to enable ACK timeout
4186  *	reject TX/RX mask combinations they cannot support by returning -EINVAL
4191  * @remain_on_channel: Starts an off-channel period on the given channel, must
4194  *	offload. Frames to transmit on the off-channel channel are transmitted
4196  *	duration (which will always be non-zero) expires, the driver must call
4201  * @cancel_remain_on_channel: Requests that an ongoing off-channel period is
4221  *	to release some frames, either for PS-poll or uAPSD.
4224  *	the frames being released then it must still set the more-data bit in
4226  *	more-data bit must always be set.
4228  *	from, for PS-poll it will always have only a single bit set.
4229  *	In the case this is used for a PS-poll initiated release, the
4232  *	on the TX status (and must report TX status) so that the PS-poll
4234  *	responses for a retried PS-poll frame.
4257  * @get_et_sset_count:  Ethtool API to get string-set count.
4264  *	and perhaps other supported types of ethtool data-sets.
4269  *	before associated. In multi-channel scenarios, a virtual interface is
4288  *	a TDLS discovery-request, we expect a reply to arrive on the AP's
4290  *	setup-response is a direct packet not buffered by the AP.
4292  *	discovery-request. The recommended period of protection is at least
4346  *	gets a CSA or a userspace initiated channel-switch), allowing
4369  * @tdls_channel_switch: Start channel-switching with a TDLS peer. The driver
4370  *	is responsible for continually initiating channel-switching operations
4372  *	driver receives a channel-switch request template and the location of
4373  *	the switch-timing IE within the template as part of the invocation.
4375  *	optionally copy the skb for further re-use.
4376  * @tdls_cancel_channel_switch: Stop channel-switching with a TDLS peer. Both
4378  * @tdls_recv_channel_switch: a TDLS channel-switch related frame (request or
4381  *	an ongoing channel-switch operation. In addition, a channel-switch
4383  *	switch-timing IE within the template. The skb can only be used within
4406  * @can_aggregate_in_amsdu: Called in order to determine if HW supports
4407  *	aggregating two specific frames in the same A-MSDU. The relation
4409  *	skb is always a real frame, head may or may not be an A-MSDU.
4421  *	4-address mode
4438  *	The caller is expected to set chandef pointer to NULL in order to
4440  * @net_fill_forward_path: Called from .ndo_fill_forward_path in order to
4445  *	removing the old link information is still valid (link_conf pointer),
4447  *	new links bitmaps may be 0 if going from/to a non-MLO situation.
4454  *	i.e. passed to @sta_add/@sta_state with sta->valid_links not zero.
4459  * @net_setup_tc: Called from .ndo_setup_tc in order to prepare hardware
4464  *	if the requested TID-To-Link mapping can be accepted or not.
4466  *	modify @ttlm parameter with the suggested TID-to-Link mapping.
4614 	 * Perform a certain A-MPDU action.
4624 	 * - ``TX: 1.....7``
4625 	 * - ``RX:  2....7`` (lost frame #1)
4626 	 * - ``TX:        8..1...``
4628 	 * which is invalid since #1 was now re-transmitted well past the
4631 	 * - ``TX:        1   or``
4632 	 * - ``TX:        18  or``
4633 	 * - ``TX:        81``
4862  * ieee80211_alloc_hw_nm - Allocate a new hardware device
4882  * ieee80211_alloc_hw - Allocate a new hardware device
4903  * ieee80211_register_hw - Register hardware device
4916  * struct ieee80211_tpt_blink - throughput blink description
4927  * enum ieee80211_tpt_led_trigger_flags - throughput trigger flags
4951  * ieee80211_get_tx_led_name - get name of TX LED
4953  * mac80211 creates a transmit LED trigger for each wireless hardware
4956  * of the trigger so you can automatically link the LED device.
4958  * @hw: the hardware to get the LED trigger name for
4960  * Return: The name of the LED trigger. %NULL if not configured for LEDs.
4972  * ieee80211_get_rx_led_name - get name of RX LED
4974  * mac80211 creates a receive LED trigger for each wireless hardware
4977  * of the trigger so you can automatically link the LED device.
4979  * @hw: the hardware to get the LED trigger name for
4981  * Return: The name of the LED trigger. %NULL if not configured for LEDs.
4993  * ieee80211_get_assoc_led_name - get name of association LED
4995  * mac80211 creates a association LED trigger for each wireless hardware
4998  * of the trigger so you can automatically link the LED device.
5000  * @hw: the hardware to get the LED trigger name for
5002  * Return: The name of the LED trigger. %NULL if not configured for LEDs.
5014  * ieee80211_get_radio_led_name - get name of radio LED
5016  * mac80211 creates a radio change LED trigger for each wireless hardware
5019  * of the trigger so you can automatically link the LED device.
5021  * @hw: the hardware to get the LED trigger name for
5023  * Return: The name of the LED trigger. %NULL if not configured for LEDs.
5035  * ieee80211_create_tpt_led_trigger - create throughput LED trigger
5036  * @hw: the hardware to create the trigger for
5037  * @flags: trigger flags, see &enum ieee80211_tpt_led_trigger_flags
5038  * @blink_table: the blink table -- needs to be ordered by throughput
5042  * configured) or the name of the new trigger.
5060  * ieee80211_unregister_hw - Unregister a hardware device
5070  * ieee80211_free_hw - free hardware descriptor
5081  * ieee80211_restart_hw - restart hardware completely
5087  * calling the ->start() operation. The driver will need to reset all
5095  * ieee80211_rx_list - receive frame and store processed skbs in a list
5120  * ieee80211_rx_napi - receive frame from NAPI context
5145  * ieee80211_rx - receive frame
5170  * ieee80211_rx_irqsafe - receive frame
5185  * ieee80211_rx_ni - receive frame (in process context)
5206  * ieee80211_sta_ps_transition - PS transition for connected sta
5220  * Return: 0 on success. -EINVAL when the requested PS mode is already set.
5225  * ieee80211_sta_ps_transition_ni - PS transition for connected sta
5250  * ieee80211_sta_pspoll - PS-Poll frame received
5254  * use this function to inform mac80211 that a PS-Poll frame from a
5263  * ieee80211_sta_uapsd_trigger - (potential) U-APSD trigger frame received
5265  * @tid: TID of the received (potential) trigger frame
5268  * use this function to inform mac80211 that a (potential) trigger frame
5275  * that is trigger enabled and assume that the caller did the proper
5287  * ieee80211_sta_set_buffered - inform mac80211 about driver-buffered frames
5301  * If all frames are released to the station (due to PS-poll or uAPSD)
5318  * ieee80211_get_tx_rates - get the selected transmit rates for a packet
5320  * Call this function in a driver with per-packet rate selection support
5337  * ieee80211_sta_set_expected_throughput - set the expected tpt for a station
5353  * ieee80211_tx_rate_update - transmit rate update callback
5355  * Drivers should call this functions with a non-NULL pub sta
5368  * ieee80211_tx_status_skb - transmit status callback
5387  * ieee80211_tx_status_ext - extended transmit status callback
5404  * ieee80211_tx_status_noskb - transmit status callback without skb
5432  * ieee80211_tx_status_ni - transmit status callback (in process context)
5452  * ieee80211_tx_status_irqsafe - IRQ-safe transmit status callback
5467  * ieee80211_report_low_ack - report non-responding station
5469  * When operating in AP-mode, call this function to report a non-responding
5472  * @sta: the non-responding connected sta
5480  * struct ieee80211_mutable_offsets - mutable beacon offsets
5497  * ieee80211_beacon_get_template - beacon template generation function
5502  * @link_id: the link id to which the beacon belongs (or 0 for an AP STA
5524  * ieee80211_beacon_get_template_ema_index - EMA beacon template generation
5529  * @link_id: the link id to which the beacon belongs (or 0 for a non-MLD AP).
5545  * struct ieee80211_ema_beacons - List of EMA beacons
5562  * ieee80211_beacon_get_template_ema_list - EMA beacon template generation
5565  * @link_id: the link id to which the beacon belongs (or 0 for a non-MLD AP)
5583  * ieee80211_beacon_free_ema_list - free an EMA beacon template list
5592  * ieee80211_beacon_get_tim - beacon generation function
5596  *	Set to 0 if invalid (in non-AP modes).
5599  *	Set to 0 if invalid (in non-AP modes).
5600  * @link_id: the link id to which the beacon belongs (or 0 for an AP STA
5608  * frame from mac80211 -- it is responsible for calling this function exactly
5621  * ieee80211_beacon_get - beacon generation function
5624  * @link_id: the link id to which the beacon belongs (or 0 for an AP STA
5639  * ieee80211_beacon_update_cntdwn - request mac80211 to decrement the beacon countdown
5641  * @link_id: valid link_id during MLO or 0 for non-MLO
5655  * ieee80211_beacon_set_cntdwn - request mac80211 to set beacon countdown
5668  * ieee80211_csa_finish - notify mac80211 about channel switch
5670  * @link_id: valid link_id during MLO or 0 for non-MLO
5679  * ieee80211_beacon_cntdwn_is_complete - find out if countdown reached 1
5681  * @link_id: valid link_id during MLO or 0 for non-MLO
5689  * ieee80211_color_change_finish - notify mac80211 about color change
5691  * @link_id: valid link_id during MLO or 0 for non-MLO
5700  * ieee80211_proberesp_get - retrieve a Probe Response template
5715  * ieee80211_pspoll_get - retrieve a PS Poll template
5732  * ieee80211_nullfunc_get - retrieve a nullfunc template
5735  * @link_id: If the vif is an MLD, get a frame with the link addresses
5736  *	for the given link ID. For a link_id < 0 you get a frame with
5758  * ieee80211_probereq_get - retrieve a Probe Request template
5776  * ieee80211_rts_get - RTS frame generation function
5785  * hardware/firmware), the low-level driver uses this function to receive
5786  * the next RTS frame from the 802.11 code. The low-level is responsible
5795  * ieee80211_rts_duration - Get the duration field for an RTS frame
5802  * the duration field, the low-level driver uses this function to receive
5803  * the duration field value in little-endian byteorder.
5812  * ieee80211_ctstoself_get - CTS-to-self frame generation function
5815  * @frame: pointer to the frame that is going to be protected by the CTS-to-self.
5818  * @cts: The buffer where to store the CTS-to-self frame.
5820  * If the CTS-to-self frames are generated by the host system (i.e., not in
5821  * hardware/firmware), the low-level driver uses this function to receive
5822  * the next CTS-to-self frame from the 802.11 code. The low-level is responsible
5823  * for calling this function before and CTS-to-self frame is needed.
5832  * ieee80211_ctstoself_duration - Get the duration field for a CTS-to-self frame
5835  * @frame_len: the length of the frame that is going to be protected by the CTS-to-self.
5838  * If the CTS-to-self is generated in firmware, but the host system must provide
5839  * the duration field, the low-level driver uses this function to receive
5840  * the duration field value in little-endian byteorder.
5850  * ieee80211_generic_frame_duration - Calculate the duration field for a frame
5869  * ieee80211_get_buffered_bc - accessing buffered broadcast and multicast frames
5876  * memory. The low-level driver uses this function to fetch next buffered
5883  * generated with ieee80211_beacon_get() and the low-level driver must thus
5885  * NULL if the previous generated beacon was not DTIM, so the low-level driver
5893  * ieee80211_get_tkip_p1k_iv - get a TKIP phase 1 key for IV32
5905  * ieee80211_get_tkip_p1k - get a TKIP phase 1 key
5918 	struct ieee80211_hdr *hdr = (struct ieee80211_hdr *)skb->data;  in ieee80211_get_tkip_p1k()
5919 	const u8 *data = (u8 *)hdr + ieee80211_hdrlen(hdr->frame_control);  in ieee80211_get_tkip_p1k()
5926  * ieee80211_get_tkip_rx_p1k - get a TKIP phase 1 key for RX
5940  * ieee80211_get_tkip_p2k - get a TKIP phase 2 key
5954  * ieee80211_tkip_add_iv - write TKIP IV and Ext. IV to pos
5969  * ieee80211_get_key_rx_seq - get key RX sequence counter
5972  * @tid: The TID, or -1 for the management frame value (CCMP/GCMP only);
5973  *	the value on TID 0 is also used for non-QoS frames. For
5988  * ieee80211_set_key_rx_seq - set key RX sequence counter
5991  * @tid: The TID, or -1 for the management frame value (CCMP/GCMP only);
5992  *	the value on TID 0 is also used for non-QoS frames. For
6008  * ieee80211_remove_key - remove the given key
6020  * ieee80211_gtk_rekey_add - add a GTK key from rekeying during WoWLAN
6023  * @link_id: the link id of the key or -1 for non-MLO
6031  * mac80211-owned memory. In case of errors, the function returns an
6055  * ieee80211_gtk_rekey_notify - notify userspace supplicant of rekeying
6065  * ieee80211_key_mic_failure - increment MIC failure counter for the key
6075  * ieee80211_key_replay - increment replay counter for the key
6085  * ieee80211_wake_queue - wake specific queue
6094  * ieee80211_stop_queue - stop specific queue
6103  * ieee80211_queue_stopped - test status of the queue
6115  * ieee80211_stop_queues - stop all queues
6123  * ieee80211_wake_queues - wake all queues
6131  * ieee80211_scan_completed - completed hardware scan
6145  * ieee80211_sched_scan_results - got results from scheduled scan
6155  * ieee80211_sched_scan_stopped - inform that the scheduled scan has stopped
6167  * enum ieee80211_interface_iteration_flags - interface iteration flags
6172  *	haven't been re-added to the driver yet.
6174  *	interfaces, even if they haven't been re-added to the driver yet.
6188  * ieee80211_iterate_interfaces - iterate interfaces
6206  * ieee80211_iterate_active_interfaces - iterate active interfaces
6232  * ieee80211_iterate_active_interfaces_atomic - iterate active interfaces
6253  * ieee80211_iterate_active_interfaces_mtx - iterate active interfaces
6272  * ieee80211_iterate_stations_atomic - iterate stations
6289  * ieee80211_iterate_stations_mtx - iterate stations
6306  * ieee80211_queue_work - add work onto the mac80211 workqueue
6317  * ieee80211_queue_delayed_work - add work onto the mac80211 workqueue
6331  * ieee80211_refresh_tx_agg_session_timer - Refresh a tx agg session timer.
6345  * ieee80211_start_tx_ba_session - Start a tx Block Ack session.
6360  * ieee80211_start_tx_ba_cb_irqsafe - low level driver ready to aggregate.
6373  * ieee80211_stop_tx_ba_session - Stop a Block Ack session.
6386  * ieee80211_stop_tx_ba_cb_irqsafe - low level driver ready to stop aggregate.
6399  * ieee80211_find_sta - find a station
6413  * ieee80211_find_sta_by_ifaddr - find a station on hardware
6417  * @localaddr: local address (vif->sdata->vif.addr). Use NULL for 'any'.
6439  * ieee80211_find_sta_by_link_addrs - find STA by link addresses
6441  * @addr: remote station's link address
6442  * @localaddr: local link address, use %NULL for any (but avoid that)
6443  * @link_id: pointer to obtain the link ID if the STA is found,
6444  *	may be %NULL if the link ID is not needed
6446  * Obtain the STA by link address, must use RCU protection.
6457  * ieee80211_sta_block_awake - block station from waking up
6468  * This function allows implementing this mode in a race-free
6478  * cause mac80211 to be able to send ps-poll responses, and if
6489  * ieee80211_sta_eosp - notify mac80211 about end of SP
6495  * This applies for PS-Poll as well as uAPSD.
6498  * not mix calls to irqsafe/non-irqsafe versions, this function
6500  * all non-irqsafe, don't mix!
6510  * ieee80211_send_eosp_nullfunc - ask mac80211 to send NDP with EOSP
6523  * will be sent despite the station being in power-save.
6532  * ieee80211_sta_recalc_aggregates - recalculate aggregate data after a change
6535  * Call this function after changing a per-link aggregate data as referenced in
6545  * ieee80211_sta_register_airtime - register airtime usage for a sta/tid
6573  * ieee80211_txq_airtime_check - check if a txq can send frame to device
6585  * ieee80211_iter_keys - iterate keys programmed into the device
6598  * The order in which the keys are iterated matches the order
6612  * ieee80211_iter_keys_rcu - iterate keys programmed into the device
6636  * ieee80211_iter_chan_contexts_atomic - iterate channel contexts
6651  * found while iterating, whether they've been re-added already
6662  * ieee80211_ap_probereq_get - retrieve a Probe Request template
6679  * ieee80211_beacon_loss - inform hardware does not receive beacons
6690  * ieee80211_connection_loss - inform hardware has lost connection to the AP
6706  * ieee80211_disconnect - request disconnection
6717  * ieee80211_resume_disconnect - disconnect from AP after resume
6740  * ieee80211_hw_restart_disconnect - disconnect from AP after
6750  * ieee80211_cqm_rssi_notify - inform a configured connection quality monitoring
6754  * @rssi_event: the RSSI trigger event type
6768  * ieee80211_cqm_beacon_loss_notify - inform CQM of beacon loss
6776  * ieee80211_radar_detected - inform that a radar was detected
6780  *	pass a valid pointer during MLO. For non-MLO %NULL can be passed
6786  * ieee80211_chswitch_done - Complete channel switch process
6792  * Complete the channel switch post-process: set the new operational channel
6799  * ieee80211_channel_switch_disconnect - disconnect due to channel switch error
6809  * ieee80211_request_smps - request SM PS transition
6811  * @link_id: link ID for MLO, or 0
6822  * ieee80211_ready_on_channel - notification of remain-on-channel start
6828  * ieee80211_remain_on_channel_expired - remain_on_channel duration expired
6834  * ieee80211_stop_rx_ba_session - callback to stop existing BA sessions
6836  * in order not to harm the system performance and user experience, the device
6841  * therefore prevent the peer device to use a-mpdu aggregation.
6851  * ieee80211_mark_rx_ba_filtered_frames - move RX BA window and mark filtered
6870  * ieee80211_send_bar - send a BlockAckReq frame
6883  * ieee80211_manage_rx_ba_offl - helper to queue an RX BA work
6892  * ieee80211_start_rx_ba_session_offl - start a Rx BA session
6914  * ieee80211_stop_rx_ba_session_offl - stop a Rx BA session
6936  * ieee80211_rx_ba_timer_expired - stop a Rx BA session due to timeout
6941  * Trigger the timeout flow, which sends a DelBa.
6953  * struct ieee80211_tx_rate_control - rate control information for/from RC algo
6965  * @short_preamble: whether mac80211 will request short-preamble transmission
6967  * @rate_idx_mask: user-requested (legacy) rate mask
6968  * @rate_idx_mcs_mask: user-requested MCS rate mask (NULL if not in use)
6984  * enum rate_control_capabilities - rate control capabilities
6997 	 * mac80211 should start A-MPDU sessions on tx
7040 	return (sta == NULL || sta->deflink.supp_rates[band] & BIT(index));  in rate_supported()
7049 	for (i = 0; i < sband->n_bitrates; i++)  in rate_lowest_index()
7050 		if (rate_supported(sta, sband->band, i))  in rate_lowest_index()
7066 	for (i = 0; i < sband->n_bitrates; i++)  in rate_usable_index_exists()
7067 		if (rate_supported(sta, sband->band, i))  in rate_usable_index_exists()
7073  * rate_control_set_rates - pass the sta rate selection to mac80211/driver
7096 	return conf->chandef.width == NL80211_CHAN_WIDTH_20;  in conf_is_ht20()
7102 	return conf->chandef.width == NL80211_CHAN_WIDTH_40 &&  in conf_is_ht40_minus()
7103 	       conf->chandef.center_freq1 < conf->chandef.chan->center_freq;  in conf_is_ht40_minus()
7109 	return conf->chandef.width == NL80211_CHAN_WIDTH_40 &&  in conf_is_ht40_plus()
7110 	       conf->chandef.center_freq1 > conf->chandef.chan->center_freq;  in conf_is_ht40_plus()
7116 	return conf->chandef.width == NL80211_CHAN_WIDTH_40;  in conf_is_ht40()
7122 	return (conf->chandef.width != NL80211_CHAN_WIDTH_5) &&  in conf_is_ht()
7123 		(conf->chandef.width != NL80211_CHAN_WIDTH_10) &&  in conf_is_ht()
7124 		(conf->chandef.width != NL80211_CHAN_WIDTH_20_NOHT);  in conf_is_ht()
7146 	return ieee80211_iftype_p2p(vif->type, vif->p2p);  in ieee80211_vif_type_p2p()
7150  * ieee80211_get_he_iftype_cap_vif - return HE capabilities for sband/vif
7164  * ieee80211_get_he_6ghz_capa_vif - return HE 6 GHz capabilities
7178  * ieee80211_get_eht_iftype_cap_vif - return ETH capabilities for sband/vif
7192  * ieee80211_update_mu_groups - set the VHT MU-MIMO groud data
7195  * @link_id: the link ID for MLO, otherwise 0
7196  * @membership: 64 bits array - a bit is set if station is member of the group
7200  * membership data is of the correct size and are in the same byte order as the
7214  * ieee80211_ave_rssi - report the average RSSI for the specified interface
7226  * ieee80211_report_wowlan_wakeup - report WoWLAN wakeup
7238  * ieee80211_tx_prepare_skb - prepare an 802.11 skb for transmission
7254  * ieee80211_parse_tx_radiotap - Sanity-check and parse the radiotap header
7270  * struct ieee80211_noa_data - holds temporary data for tracking P2P NoA state
7297  * ieee80211_parse_p2p_noa - initialize NoA tracking data from P2P IE
7309  * ieee80211_update_p2p_noa - get next pending P2P GO absent state change
7317  * ieee80211_tdls_oper_request - request userspace to perform a TDLS operation
7331  * ieee80211_reserve_tid - request to reserve a specific TID
7352  * ieee80211_unreserve_tid - request to unreserve a specific TID
7368  * ieee80211_tx_dequeue - dequeue a packet from a software tx queue
7378  * skb->cb, e.g. the key pointer, are protected by RCU and thus the
7391  * ieee80211_tx_dequeue_ni - dequeue a packet from a software tx queue
7416  * ieee80211_handle_wake_tx_queue - mac80211 handler for wake_tx_queue callback
7428  * ieee80211_next_txq - get next tx queue to pull packets from
7440  * ieee80211_txq_schedule_start - start new scheduling round for TXQs
7459  * ieee80211_schedule_txq - schedule a TXQ for transmission
7477  * ieee80211_return_txq - return a TXQ previously acquired by ieee80211_next_txq()
7494  * ieee80211_txq_may_transmit - check whether TXQ is allowed to transmit
7498  * fairness accounting without using the scheduling order enforced by
7508  * aligned against driver's own round-robin scheduler list. i.e it rotates
7523  * ieee80211_txq_get_depth - get pending frame/byte count of given txq
7526  * txq state can change half-way of this function and the caller may end up
7527  * with "new" frame_cnt and "old" byte_cnt or vice-versa.
7538  * ieee80211_nan_func_terminated - notify about NAN function termination.
7554  * ieee80211_nan_func_match - notify about NAN function match event.
7569  * ieee80211_calc_rx_airtime - calculate estimated transmission airtime for RX.
7586  * ieee80211_calc_tx_airtime - calculate estimated transmission airtime for TX.
7601  * ieee80211_get_fils_discovery_tmpl - Get FILS discovery template.
7613  * ieee80211_get_unsol_bcast_probe_resp_tmpl - Get unsolicited broadcast
7627  * ieee80211_obss_color_collision_notify - notify userland about a BSS color
7629  * @link_id: valid link_id during MLO or 0 for non-MLO
7640  * ieee80211_is_tx_data - check if frame is a data frame
7652 	struct ieee80211_hdr *hdr = (void *) skb->data;  in ieee80211_is_tx_data()
7654 	return info->flags & IEEE80211_TX_CTL_HW_80211_ENCAP ||  in ieee80211_is_tx_data()
7655 	       ieee80211_is_data(hdr->frame_control);  in ieee80211_is_tx_data()
7659  * ieee80211_set_active_links - set active links in client mode
7670  * If a link is switched off and another is switched on at the same
7674  *  - change_vif_links(0x11)
7675  *  - unassign_vif_chanctx(link_id=0)
7676  *  - assign_vif_chanctx(link_id=4)
7677  *  - change_sta_links(0x11) for each affected STA (the AP)
7679  *  - remove group keys on the old link (link_id 0)
7680  *  - add new group keys (GTK/IGTK/BIGTK) on the new link (link_id 4)
7681  *  - change_sta_links(0x10) for each affected STA (the AP)
7682  *  - change_vif_links(0x10)
7689  * ieee80211_set_active_links_async - asynchronously set active links
7694  * difference here is that the link change is triggered async and
7695  * can be called in any context, but the link switch will only be
7702  * ieee80211_send_teardown_neg_ttlm - tear down a negotiated TTLM request
7711  * ieee80211_chan_width_to_rx_bw - convert channel width to STA RX bandwidth
7737 /* for older drivers - let's not document these ... */