Lines Matching +full:buffered +full:- +full:negative
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 - 2023 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
121 * buffered packets in the driver specific data structures by calling
122 * ieee80211_sta_set_buffered(). For frames buffered in the ieee80211_txq
126 * buffered frames and afterwards also frames from the ieee80211_txq (obtained
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
227 * struct ieee80211_chanctx_conf - channel context that vifs may be tuned to
229 * This is the driver-visible part. The ieee80211_chanctx
255 * enum ieee80211_chanctx_switch_mode - channel context switch mode
263 * implement this as an on-the-fly chandef switch of the existing
274 * struct ieee80211_vif_chanctx_switch - vif chanctx switch information
294 * enum ieee80211_bss_change - BSS change notification flags
331 * @BSS_CHANGED_MU_GROUPS: VHT MU-MIMO group id or user position changed
391 * enum ieee80211_event_type - event to be notified to the low level driver
407 * enum ieee80211_rssi_event_data - relevant when event type is %RSSI_EVENT
417 * struct ieee80211_rssi_event - data attached to an %RSSI_EVENT
425 * enum ieee80211_mlme_event_data - relevant when event type is %MLME_EVENT
439 * enum ieee80211_mlme_event_status - relevant when event type is %MLME_EVENT
451 * struct ieee80211_mlme_event - data attached to an %MLME_EVENT
463 * struct ieee80211_ba_event - data attached for BlockAck related events
475 * struct ieee80211_event - event to be sent to the driver
492 * struct ieee80211_mu_group_data - STA's VHT MU-MIMO group data
494 * This structure describes the group id data of VHT MU-MIMO
496 * @membership: 64 bits array - a bit is set if station is member of the group
505 * struct ieee80211_ftm_responder_params - FTM responder parameters
520 * struct ieee80211_fils_discovery - FILS discovery parameters from
521 * IEEE Std 802.11ai-2016, Annex C.3 MIB detail.
523 * @min_interval: Minimum packet interval in TUs (0 - 10000)
524 * @max_interval: Maximum packet interval in TUs (0 - 10000)
532 * struct ieee80211_bss_conf - holds the BSS's changing parameters
539 * @link_id: link ID, or 0 for non-MLO
542 * @ack_enabled: indicates support to receive a multi-TID that solicits either
558 * with the %BSS_CHANGED_BEACON_INFO flag, will be non-zero then.
581 * @mcast_rate: per-band multicast rate index + 1 (0: disabled)
584 * @chandef: Channel definition for this BSS -- the hardware might be
586 * @mu_group: VHT MU-MIMO group membership data
600 * @qos: This is a QoS-enabled BSS.
601 * @hidden_ssid: The SSID of the current vif is hidden. Only valid in AP-mode.
647 * write-protected by sdata_lock and local->mtx so holding either is fine
650 * @mu_mimo_owner: indicates interface owns MU-MIMO capability
652 * when it is not assigned. This pointer is RCU-protected due to the TX
657 * write-protected by sdata_lock and local->mtx so holding either is fine
671 * @he_su_beamformer: in AP-mode, does this BSS support operation as an HE SU
673 * @he_su_beamformee: in AP-mode, does this BSS support operation as an HE SU
675 * @he_mu_beamformer: in AP-mode, does this BSS support operation as an HE MU
678 * (non-AP STA) of an HE TB PPDU on an RU that spans the entire PPDU
680 * @eht_su_beamformer: in AP-mode, does this BSS enable operation as an EHT SU
682 * @eht_su_beamformee: in AP-mode, does this BSS enable operation as an EHT SU
684 * @eht_mu_beamformer: in AP-mode, does this BSS enable operation as an EHT MU
782 * enum mac80211_tx_info_flags - flags to describe transmission information/status
791 * assign sequence numbers to QoS-data frames but cannot do so correctly
792 * for non-QoS-data and management frames because beacons need them from
796 * 802.11-2007 7.1.3.4.1 paragraph 3. This flag will always be set for
803 * @IEEE80211_TX_CTL_AMPDU: this frame should be sent as part of an A-MPDU
824 * off-channel operation.
832 * frame (PS-Poll or uAPSD) or a non-bufferable MMPDU and must
848 * @IEEE80211_TX_CTL_STBC: Enables Space-Time Block Coding (STBC) for this
851 * the off-channel channel when a remain-on-channel offload is done
852 * in hardware -- normal packets still flow and are expected to be
864 * PS-Poll responses.
874 * This flag must not be set for frames that don't request no-ack
919 * enum mac80211_tx_control_flags - flags to describe transmit control
924 * frame (PS-Poll or uAPSD).
926 * @IEEE80211_TX_CTRL_AMSDU: This frame is an A-MSDU frame
949 * These flags are used in tx_info->control.flags.
972 * enum mac80211_tx_status_flags - flags to describe transmit status
976 * These flags are used in tx_info->status.flags.
996 * enum mac80211_rate_control_flags - per-rate flags set by the
1003 * @IEEE80211_TX_RC_USE_CTS_PROTECT: CTS-to-self protection is required.
1050 * struct ieee80211_tx_rate - rate selection/status
1056 * A value of -1 for @idx indicates an invalid rate and, if used
1068 * { 3, 2 }, { 2, 2 }, { 1, 4 }, { -1, 0 }, { -1, 0 }
1076 * { 3, 2 }, { 2, 2 }, { 1, 1 }, { -1, 0 } ...
1093 WARN_ON((nss - 1) & ~0x7); in ieee80211_rate_set_vht()
1094 rate->idx = ((nss - 1) << 4) | mcs; in ieee80211_rate_set_vht()
1100 return rate->idx & 0xF; in ieee80211_rate_get_vht_mcs()
1106 return (rate->idx >> 4) + 1; in ieee80211_rate_get_vht_nss()
1110 * struct ieee80211_tx_info - skb transmit information
1112 * This structure is placed in skb->cb for three uses:
1113 * (1) mac80211 TX control - mac80211 tells the driver what to do
1115 * (3) TX status information - driver tells mac80211 what happened
1222 * in increments of 4us and clamp the maximum to 2**12-1 in ieee80211_info_set_tx_time_est()
1224 info->tx_time_est = min_t(u16, tx_time_est, 4095) >> 2; in ieee80211_info_set_tx_time_est()
1225 return info->tx_time_est << 2; in ieee80211_info_set_tx_time_est()
1231 return info->tx_time_est << 2; in ieee80211_info_get_tx_time_est()
1235 * struct ieee80211_rate_status - mrr stage for status path
1242 * @tx_power_idx An idx into the ieee80211_hw->tx_power_levels list of the
1253 * struct ieee80211_tx_status - extended tx status info for rate control
1277 * struct ieee80211_scan_ies - descriptors for different blocks of IEs
1298 return (struct ieee80211_tx_info *)skb->cb; in IEEE80211_SKB_CB()
1303 return (struct ieee80211_rx_status *)skb->cb; in IEEE80211_SKB_RXCB()
1307 * ieee80211_tx_info_clear_status - clear TX status
1332 info->status.rates[i].count = 0; in ieee80211_tx_info_clear_status()
1333 memset_after(&info->status, 0, rates); in ieee80211_tx_info_clear_status()
1338 * enum mac80211_rx_flags - receive flags
1354 * de-duplication by itself.
1369 * Valid only for data frames (mainly A-MPDU)
1370 * @RX_FLAG_AMPDU_DETAILS: A-MPDU details are known, in particular the reference
1372 * each A-MPDU
1374 * subframes of a single A-MPDU
1375 * @RX_FLAG_AMPDU_IS_LAST: this subframe is the last subframe of the A-MPDU
1390 * @RX_FLAG_AMSDU_MORE: Some drivers may prefer to report separate A-MSDU
1392 * All, but the last MSDU from an A-MSDU should have this flag set. E.g.
1393 * if an A-MSDU has 3 frames, the first 2 must have the flag set, while
1395 * deal with retransmission/duplication recovery properly since A-MSDU
1397 * either regular MSDU or singly A-MSDUs. Subframes must not be
1400 * skb->data (before the 802.11 header).
1410 * @RX_FLAG_AMPDU_EOF_BIT: Value of the EOF bit in the A-MPDU delimiter for this
1416 * - DATA3_DATA_MCS
1417 * - DATA3_DATA_DCM
1418 * - DATA3_CODING
1419 * - DATA5_GI
1420 * - DATA5_DATA_BW_RU_ALLOC
1421 * - DATA6_NSTS
1422 * - DATA3_STBC
1427 * @RX_FLAG_RADIOTAP_LSIG: L-SIG radiotap data is present
1429 * the "0-length PSDU" field included there. The value for it is
1470 * enum mac80211_rx_encoding_flags - MCS & bandwidth flags
1474 * @RX_ENC_FLAG_HT_GF: This frame was received in a HT-greenfield transmission,
1479 * @RX_ENC_FLAG_STBC_MASK: STBC 2 bit bitmask. 1 - Nss=1, 2 - Nss=2, 3 - Nss=3
1502 * struct ieee80211_rx_status - receive status
1504 * The low-level driver should provide this information (the subset
1508 * @mactime: value in microseconds of the 64-bit Time Synchronization Function
1520 * for data (other) frames - for those it only affects radiotap reporting.
1527 * @chain_signal: per-chain signal strength, in dBm (unlike @signal, doesn't
1544 * @ampdu_reference: A-MPDU reference number, must be a different value for
1545 * each A-MPDU but the same for each subframe within one A-MPDU
1546 * @ampdu_delimiter_crc: A-MPDU delimiter CRC
1547 * @zero_length_psdu_type: radiotap type of the 0-length PSDU
1592 return MHZ_TO_KHZ(rx_status->freq) + in ieee80211_rx_status_to_khz()
1593 (rx_status->freq_offset ? 500 : 0); in ieee80211_rx_status_to_khz()
1597 * enum ieee80211_conf_flags - configuration flags
1601 * @IEEE80211_CONF_MONITOR: there's a monitor interface present -- use this
1605 * This is the power save mode defined by IEEE 802.11-2007 section 11.2,
1628 * enum ieee80211_conf_changed - denotes which configuration changed
1653 * enum ieee80211_smps_mode - spatial multiplexing power save mode
1672 * struct ieee80211_conf - configuration of the device
1720 * struct ieee80211_channel_switch - holds the channel switch data
1725 * @timestamp: value in microseconds of the 64-bit Time Synchronization
1749 * enum ieee80211_vif_flags - virtual interface flags
1754 * monitoring on this virtual interface -- i.e. it can monitor
1757 * @IEEE80211_VIF_SUPPORTS_UAPSD: The device can do U-APSD for this
1777 * enum ieee80211_offload_flags - virtual interface offload flags
1782 * @IEEE80211_OFFLOAD_ENCAP_4ADDR: support 4-address mode encapsulation offload
1795 * struct ieee80211_vif_cfg - interface configuration
1799 * @ps: power-save mode (STA only). This flag is NOT affected by
1802 * @eml_cap: EML capabilities as described in P802.11be_D2.2 Figure 9-1002k.
1804 * P802.11be_D2.2 Figure 9-1002j.
1818 * @ap_addr: AP MLD address, or BSSID for non-MLO connections
1840 * struct ieee80211_vif - per-interface data
1849 * @link_conf: in case of MLD, the per-link BSS configuration,
1851 * @valid_links: bitmap of valid links, or 0 for non-MLO.
1852 * @active_links: The bitmap of active links, or 0 for non-MLO.
1855 * @dormant_links: bitmap of valid but disabled links, or 0 for non-MLO.
1859 * interface, i.e. a GO or p2p-sta respectively
1861 * vif. mac80211 initializes this to hw->netdev_features, and the driver
1874 * @cab_queue: content-after-beacon (DTIM beacon really) queue, AP mode only
1885 * @offload_flags: 802.3 -> 802.11 enapsulation offload flags, see
1921 * ieee80211_vif_usable_links - Return the usable links for the vif
1927 return vif->valid_links & ~vif->dormant_links; in ieee80211_vif_usable_links()
1931 * ieee80211_vif_is_mld - Returns true iff the vif is an MLD one
1938 return vif->valid_links != 0; in ieee80211_vif_is_mld()
1942 for (link_id = 0; link_id < ARRAY_SIZE((vif)->link_conf); link_id++) \
1943 if ((!(vif)->active_links || \
1944 (vif)->active_links & BIT(link_id)) && \
1945 (link = rcu_dereference((vif)->link_conf[link_id])))
1950 return vif->type == NL80211_IFTYPE_MESH_POINT; in ieee80211_vif_is_mesh()
1956 * wdev_to_ieee80211_vif - return a vif struct from a wdev
1969 * ieee80211_vif_to_wdev - return a wdev struct from a vif
1979 * lockdep_vif_mutex_held - for lockdep checks on link poiners
1984 return lockdep_is_held(&ieee80211_vif_to_wdev(vif)->mtx); in lockdep_vif_mutex_held()
1988 rcu_dereference_protected((vif)->link_conf[link_id], \
1992 rcu_dereference_check((vif)->link_conf[link_id], \
1996 * enum ieee80211_key_flags - key flags
2055 * struct ieee80211_key_conf - key information
2067 * @keyidx: the key index (0-3)
2069 * @key: key material. For ALG_TKIP the key is encoded as a 256-bit (32 byte)
2071 * - Temporal Encryption Key (128 bits)
2072 * - Temporal Authenticator Tx MIC Key (64 bits)
2073 * - Temporal Authenticator Rx MIC Key (64 bits)
2076 * @link_id: the link ID for MLO, or -1 for non-MLO or pairwise keys
2097 * struct ieee80211_key_seq - key sequence counter
2108 * @hw: data for HW-only (e.g. cipher scheme) keys
2136 * enum set_key_cmd - key command
2149 * enum ieee80211_sta_state - station state
2168 * enum ieee80211_sta_rx_bandwidth - station RX bandwidth
2188 * struct ieee80211_sta_rates - station rate selection table
2192 * Overriding entries per-packet is possible by using cb tx control.
2206 * struct ieee80211_sta_txpwr - station txpower configuration
2224 * struct ieee80211_sta_aggregates - info that is aggregated from active links
2226 * Used for any per-link data that needs to be aggregated and updated in the
2229 * @max_amsdu_len: indicates the maximal length of an A-MSDU in bytes.
2234 * A-MSDU maximal size is min(max_amsdu_len, 4065) bytes.
2235 * * If the skb is not part of a BA agreement, the A-MSDU maximal
2239 * driver. This is defined by the spec (IEEE 802.11-2012 section
2241 * @max_rc_amsdu_len: Maximum A-MSDU size in bytes recommended by rate control.
2242 * @max_tid_amsdu_len: Maximum A-MSDU size in bytes for this TID
2252 * struct ieee80211_link_sta - station Link specific info
2257 * @addr: MAC address of the Link STA. For non-MLO STA this is same as the addr
2268 * @agg: per-link data for multi-link aggregation
2299 * struct ieee80211_sta - station table entry
2302 * communicating with. Since stations are RCU-managed in
2330 * A-MSDU. Taken from the Extended Capabilities element. 0 means
2336 * @txq: per-TID data TX queues; note that the last entry (%IEEE80211_NUM_TIDS)
2337 * is used for non-data frames
2349 * @valid_links: bitmap of valid links, or 0 for non-MLO
2389 rcu_dereference_protected((sta)->link[link_id], \
2393 rcu_dereference_check((sta)->link[link_id], \
2397 for (link_id = 0; link_id < ARRAY_SIZE((sta)->link); link_id++) \
2398 if ((!(vif)->active_links || \
2399 (vif)->active_links & BIT(link_id)) && \
2403 * enum sta_notify_cmd - sta notify command
2416 * struct ieee80211_tx_control - TX control data
2426 * struct ieee80211_txq - Software intermediate tx queue
2429 * @sta: station table entry, %NULL for per-vif queue
2430 * @tid: the TID for this queue (unused for per-vif queue),
2431 * %IEEE80211_NUM_TIDS for non-data (if enabled)
2433 * @drv_priv: driver private area, sized by hw->txq_data_size
2449 * enum ieee80211_hw_flags - hardware flags
2497 * Hardware supports 11n A-MPDU aggregation.
2518 * periodic keep-alives to the AP and probing the AP on beacon loss.
2525 * per-station GTKs as used by IBSS RSN or during fast transition. If
2526 * the device doesn't support per-station GTKs, but can be asked not
2538 * @IEEE80211_HW_TX_AMPDU_SETUP_IN_HW: The device handles TX A-MPDU session
2547 * be created. It is expected user-space will create vifs as
2551 * crypto algorithms can be done in software - so don't automatically
2556 * @IEEE80211_HW_SUPPORT_FAST_XMIT: The driver/hardware supports fast-xmit,
2560 * @IEEE80211_HW_QUEUE_CONTROL: The driver wants to control per-interface
2579 * @IEEE80211_HW_CHANCTX_STA_CSA: Support 802.11h based channel-switch (CSA)
2593 * @IEEE80211_HW_SUPPORTS_AMSDU_IN_AMPDU: The driver supports receiving A-MSDUs
2594 * within A-MPDU.
2610 * which implies using per-CPU station statistics.
2613 * A-MSDU frames. Requires software tx queueing and fast-xmit support.
2615 * limit the maximum A-MSDU size based on the current tx rate by setting
2619 * skbs, needed for zero-copy software A-MSDU.
2636 * beacon was heard. This is required in multi-channel scenarios, where the
2642 * support QoS NDP for AP probing - that's most likely a driver bug.
2650 * but if the rate control is built-in then it must be set by the driver.
2653 * @IEEE80211_HW_STA_MMPDU_TXQ: use the extra non-TID per-station TXQ for all
2657 * @IEEE80211_HW_TX_STATUS_NO_AMPDU_LEN: Driver does not report accurate A-MPDU
2667 * A-MPDU sessions active while rekeying with Extended Key ID.
2750 * struct ieee80211_hw - hardware information and state
2804 * sub-frames) to be used for A-MPDU block ack receiver
2817 * @max_tx_fragments: maximum number of tx buffers per (A)-MSDU, sum
2818 * of 1 + skb_shinfo(skb)->nr_frags for each skb in the frag_list.
2835 * @units_pos member is set to a non-negative value then the timestamp
2841 * @radiotap_timestamp.accuracy: If non-negative, fills the accuracy in the
2849 * for each access category if it is uAPSD trigger-enabled and delivery-
2852 * that corresponding AC is both trigger- and delivery-enabled. '0' means
2855 * @uapsd_max_sp_len: maximum number of total buffered frames the WMM AP may
2919 return test_bit(flg, hw->flags); in _ieee80211_hw_check()
2926 return __set_bit(flg, hw->flags); in _ieee80211_hw_set()
2931 * struct ieee80211_scan_request - hw scan request
2944 * struct ieee80211_tdls_ch_sw_params - TDLS channel switch parameters
2946 * @sta: peer this TDLS channel-switch request/response came from
2947 * @chandef: channel referenced in a TDLS channel-switch request
2949 * @status: channel-switch response status
2951 * @switch_time: switch-timing parameter received in the frame
2952 * @switch_timeout: switch-timing parameter received in the frame
2953 * @tmpl_skb: TDLS switch-channel response template
2954 * @ch_sw_tm_ie: offset of the channel-switch timing IE inside @tmpl_skb
2969 * wiphy_to_ieee80211_hw - return a mac80211 driver hw struct from a wiphy
2975 * structure can then access it via hw->priv. Note that mac802111 drivers should
2984 * SET_IEEE80211_DEV - set device for 802.11 hardware
2991 set_wiphy_dev(hw->wiphy, dev); in SET_IEEE80211_DEV()
2995 * SET_IEEE80211_PERM_ADDR - set the permanent MAC address for 802.11 hardware
3002 memcpy(hw->wiphy->perm_addr, addr, ETH_ALEN); in SET_IEEE80211_PERM_ADDR()
3009 if (WARN_ON_ONCE(c->control.rates[0].idx < 0)) in ieee80211_get_tx_rate()
3011 return &hw->wiphy->bands[c->band]->bitrates[c->control.rates[0].idx]; in ieee80211_get_tx_rate()
3018 if (c->control.rts_cts_rate_idx < 0) in ieee80211_get_rts_cts_rate()
3020 return &hw->wiphy->bands[c->band]->bitrates[c->control.rts_cts_rate_idx]; in ieee80211_get_rts_cts_rate()
3027 if (c->control.rates[idx + 1].idx < 0) in ieee80211_get_alt_retry_rate()
3029 return &hw->wiphy->bands[c->band]->bitrates[c->control.rates[idx + 1].idx]; in ieee80211_get_alt_retry_rate()
3033 * ieee80211_free_txskb - free TX skb
3061 * the key is now in use, -%EOPNOTSUPP or -%ENOSPC if it couldn't be
3097 * when they are able to replace in-use PTK keys according to the following
3102 at the time of the key deletion (including re-transmits),
3125 * IEEE 802.11-2007 section 11.2 is enabled. This is not to be confused
3131 * buffered multicast/broadcast frames after the beacon. Also it must be
3143 * hardware stays awake for a user-specified period of time after sending a
3144 * frame so that reply frames need not be buffered and therefore delayed to
3160 * Driver informs U-APSD client support by enabling
3164 * utilize U-APSD, dynamic powersave is disabled for voip AC and all frames
3167 * Note: U-APSD client mode is not yet supported with
3198 * - a list of information element IDs
3199 * - a list of OUIs for the vendor information element
3213 * the various vendor-assigned IEs with unknown contents (128, 129, 133-136,
3237 * and rationale, please refer to 802.11 (as amended by 802.11n-2009)
3301 * client powersaving, both "legacy" PS (PS-Poll/null data) and uAPSD.
3305 * will not poll with PS-Poll and trigger with uAPSD at the same time.
3316 * handle PS-Poll/uAPSD.
3322 * data buffered on hardware queues. If the device has support for this
3330 * it can PS-Poll, or it can possibly start a uAPSD service period.
3331 * Waking up is implemented by simply transmitting all buffered (and
3333 * the station sends a PS-Poll or a uAPSD trigger frame, mac80211
3338 * response to a PS-Poll) also has %IEEE80211_TX_STATUS_EOSP set to
3344 * Additionally, non-bufferable MMPDUs can also be transmitted by
3352 * transmitted to a certain station is out-of-band communication to
3354 * call ieee80211_sta_block_awake() if frames are buffered when it
3362 * TIDs that have frames buffered. Note that when a station wakes up
3370 * there is more data on other TIDs -- the TIDs to release frames
3375 * shorten service periods (or abort PS-Poll responses), it must
3377 * are buffered in the driver -- those must remain buffered to avoid
3388 * Note that if the driver ever buffers frames other than QoS-data
3389 * frames, it must take care to never send a non-QoS-data frame as
3390 * the last frame in a service period, adding a QoS-nulldata frame
3391 * after a non-QoS-data frame if needed.
3398 * assignment of per-interface AC software queues to hardware queues. This
3400 * 1) off-channel transmissions might get stuck behind other frames
3402 * 3) after-DTIM frames could get stuck behind other frames
3426 * after-DTIM queue for AP: 8
3427 * off-channel queue: 9
3438 * and the second virtual interface with 4-7.
3450 * enum ieee80211_filter_flags - hardware filter flags
3455 * but this has negative impact on power consumption.
3497 * enum ieee80211_ampdu_mlme_action - A-MPDU actions
3542 * struct ieee80211_ampdu_params - AMPDU action parameters
3553 * @amsdu: indicates the peer's ability to receive A-MSDU within A-MPDU.
3569 * enum ieee80211_frame_release_type - frame release reason
3570 * @IEEE80211_FRAME_RELEASE_PSPOLL: frame released for PS-Poll
3572 * frame received on trigger-enabled AC
3580 * enum ieee80211_rate_control_changed - flags to indicate what changed
3584 * information -- for HT20/40 the IEEE80211_HT_CAP_SUP_WIDTH_20_40
3601 * enum ieee80211_roc_type - remain on channel type
3619 * enum ieee80211_reconfig_type - reconfig type
3635 * struct ieee80211_prep_tx_info - prepare TX information
3636 * @duration: if non-zero, hint about the required duration,
3650 * struct ieee80211_ops - callbacks from mac80211 to the driver
3658 * The low-level driver should send the frame out based on
3666 * Returns negative error codes, these may be seen in userspace,
3669 * to avoid acknowledging frames before a non-monitor device
3709 * negative error code (which will be seen in userspace.)
3729 * This function should never fail but returns a negative error code
3753 * non-MLO connections.
3778 * Returns a negative error code if the key can't be added.
3794 * offloading. The index can be 0-3, or -1 for unsetting it.
3803 * at all but just send them after the SSID -- mac80211 includes the
3807 * any error unless this callback returned a negative error code.
3815 * @cancel_hw_scan: Ask the low-level tp cancel the active hw scan.
3820 * scan_work after the low-level driver was already suspended.
3842 * @get_stats: Return low-level statistics.
3873 * For non-MLO the callback will be called once for the default bss_conf
3885 * For non-MLO the callback will be called once for the deflink with the
3902 * isn't safe to use the pointer, not even RCU protected - no RCU grace
3927 * let the driver pre-fill the statistics. The driver can fill most of
3929 * all of them make sense - see the source for which ones are possible.
3935 * Returns a negative error code on failure.
3963 * Returns non-zero if this device sent the last beacon.
3966 * @get_survey: Return per-channel survey information
3969 * need to set wiphy->rfkill_poll to %true before registration,
3974 * in IEEE 802.11-2007 section 17.3.8.6 and modify ACK timeout
3975 * accordingly; coverage class equals to -1 to enable ACK timeout
4002 * reject TX/RX mask combinations they cannot support by returning -EINVAL
4007 * @remain_on_channel: Starts an off-channel period on the given channel, must
4010 * offload. Frames to transmit on the off-channel channel are transmitted
4012 * duration (which will always be non-zero) expires, the driver must call
4017 * @cancel_remain_on_channel: Requests that an ongoing off-channel period is
4034 * @release_buffered_frames: Release buffered frames according to the given
4037 * to release some frames, either for PS-poll or uAPSD.
4040 * the frames being released then it must still set the more-data bit in
4042 * more-data bit must always be set.
4044 * from, for PS-poll it will always have only a single bit set.
4045 * In the case this is used for a PS-poll initiated release, the
4048 * on the TX status (and must report TX status) so that the PS-poll
4050 * responses for a retried PS-poll frame.
4073 * @get_et_sset_count: Ethtool API to get string-set count.
4078 * and perhaps other supported types of ethtool data-sets.
4081 * before associated. In multi-channel scenarios, a virtual interface is
4103 * a TDLS discovery-request, we expect a reply to arrive on the AP's
4105 * setup-response is a direct packet not buffered by the AP.
4107 * discovery-request. The recommended period of protection is at least
4161 * gets a CSA or a userspace initiated channel-switch), allowing
4184 * @tdls_channel_switch: Start channel-switching with a TDLS peer. The driver
4185 * is responsible for continually initiating channel-switching operations
4187 * driver receives a channel-switch request template and the location of
4188 * the switch-timing IE within the template as part of the invocation.
4190 * optionally copy the skb for further re-use.
4191 * @tdls_cancel_channel_switch: Stop channel-switching with a TDLS peer. Both
4193 * @tdls_recv_channel_switch: a TDLS channel-switch related frame (request or
4196 * an ongoing channel-switch operation. In addition, a channel-switch
4198 * switch-timing IE within the template. The skb can only be used within
4222 * aggregating two specific frames in the same A-MSDU. The relation
4224 * skb is always a real frame, head may or may not be an A-MSDU.
4236 * 4-address mode
4260 * new links bitmaps may be 0 if going from/to a non-MLO situation.
4267 * i.e. passed to @sta_add/@sta_state with sta->valid_links not zero.
4415 * Perform a certain A-MPDU action.
4425 * - ``TX: 1.....7``
4426 * - ``RX: 2....7`` (lost frame #1)
4427 * - ``TX: 8..1...``
4429 * which is invalid since #1 was now re-transmitted well past the
4432 * - ``TX: 1 or``
4433 * - ``TX: 18 or``
4434 * - ``TX: 81``
4438 * Returns a negative error code on failure. The driver may return
4652 * ieee80211_alloc_hw_nm - Allocate a new hardware device
4672 * ieee80211_alloc_hw - Allocate a new hardware device
4693 * ieee80211_register_hw - Register hardware device
4706 * struct ieee80211_tpt_blink - throughput blink description
4717 * enum ieee80211_tpt_led_trigger_flags - throughput trigger flags
4741 * ieee80211_get_tx_led_name - get name of TX LED
4762 * ieee80211_get_rx_led_name - get name of RX LED
4783 * ieee80211_get_assoc_led_name - get name of association LED
4804 * ieee80211_get_radio_led_name - get name of radio LED
4825 * ieee80211_create_tpt_led_trigger - create throughput LED trigger
4828 * @blink_table: the blink table -- needs to be ordered by throughput
4850 * ieee80211_unregister_hw - Unregister a hardware device
4860 * ieee80211_free_hw - free hardware descriptor
4871 * ieee80211_restart_hw - restart hardware completely
4877 * calling the ->start() operation. The driver will need to reset all
4885 * ieee80211_rx_list - receive frame and store processed skbs in a list
4910 * ieee80211_rx_napi - receive frame from NAPI context
4935 * ieee80211_rx - receive frame
4960 * ieee80211_rx_irqsafe - receive frame
4975 * ieee80211_rx_ni - receive frame (in process context)
4996 * ieee80211_sta_ps_transition - PS transition for connected sta
5010 * Return: 0 on success. -EINVAL when the requested PS mode is already set.
5015 * ieee80211_sta_ps_transition_ni - PS transition for connected sta
5040 * ieee80211_sta_pspoll - PS-Poll frame received
5044 * use this function to inform mac80211 that a PS-Poll frame from a
5053 * ieee80211_sta_uapsd_trigger - (potential) U-APSD trigger frame received
5077 * ieee80211_sta_set_buffered - inform mac80211 about driver-buffered frames
5079 * @tid: the TID that has buffered frames
5080 * @buffered: indicates whether or not frames are buffered for this TID
5084 * to be told that there are buffered frames via the TIM bit.
5087 * buffered in the driver for a given TID; mac80211 can then use this data
5091 * If all frames are released to the station (due to PS-poll or uAPSD)
5093 * frames buffered. However, when the station wakes up mac80211 assumes
5094 * that all buffered frames will be transmitted and clears this data,
5095 * drivers need to make sure they inform mac80211 about all buffered
5105 u8 tid, bool buffered);
5108 * ieee80211_get_tx_rates - get the selected transmit rates for a packet
5110 * Call this function in a driver with per-packet rate selection support
5127 * ieee80211_sta_set_expected_throughput - set the expected tpt for a station
5143 * ieee80211_tx_rate_update - transmit rate update callback
5145 * Drivers should call this functions with a non-NULL pub sta
5158 * ieee80211_tx_status - transmit status callback
5177 * ieee80211_tx_status_ext - extended transmit status callback
5194 * ieee80211_tx_status_noskb - transmit status callback without skb
5222 * ieee80211_tx_status_ni - transmit status callback (in process context)
5242 * ieee80211_tx_status_irqsafe - IRQ-safe transmit status callback
5257 * ieee80211_report_low_ack - report non-responding station
5259 * When operating in AP-mode, call this function to report a non-responding
5262 * @sta: the non-responding connected sta
5270 * struct ieee80211_mutable_offsets - mutable beacon offsets
5287 * ieee80211_beacon_get_template - beacon template generation function
5314 * ieee80211_beacon_get_template_ema_index - EMA beacon template generation
5319 * @link_id: the link id to which the beacon belongs (or 0 for a non-MLD AP).
5335 * struct ieee80211_ema_beacons - List of EMA beacons
5352 * ieee80211_beacon_get_template_ema_list - EMA beacon template generation
5355 * @link_id: the link id to which the beacon belongs (or 0 for a non-MLD AP)
5373 * ieee80211_beacon_free_ema_list - free an EMA beacon template list
5382 * ieee80211_beacon_get_tim - beacon generation function
5386 * Set to 0 if invalid (in non-AP modes).
5389 * Set to 0 if invalid (in non-AP modes).
5398 * frame from mac80211 -- it is responsible for calling this function exactly
5411 * ieee80211_beacon_get - beacon generation function
5429 * ieee80211_beacon_update_cntdwn - request mac80211 to decrement the beacon countdown
5443 * ieee80211_beacon_set_cntdwn - request mac80211 to set beacon countdown
5456 * ieee80211_csa_finish - notify mac80211 about channel switch
5466 * ieee80211_beacon_cntdwn_is_complete - find out if countdown reached 1
5474 * ieee80211_color_change_finish - notify mac80211 about color change
5484 * ieee80211_proberesp_get - retrieve a Probe Response template
5499 * ieee80211_pspoll_get - retrieve a PS Poll template
5516 * ieee80211_nullfunc_get - retrieve a nullfunc template
5542 * ieee80211_probereq_get - retrieve a Probe Request template
5560 * ieee80211_rts_get - RTS frame generation function
5569 * hardware/firmware), the low-level driver uses this function to receive
5570 * the next RTS frame from the 802.11 code. The low-level is responsible
5579 * ieee80211_rts_duration - Get the duration field for an RTS frame
5586 * the duration field, the low-level driver uses this function to receive
5587 * the duration field value in little-endian byteorder.
5596 * ieee80211_ctstoself_get - CTS-to-self frame generation function
5599 * @frame: pointer to the frame that is going to be protected by the CTS-to-self.
5602 * @cts: The buffer where to store the CTS-to-self frame.
5604 * If the CTS-to-self frames are generated by the host system (i.e., not in
5605 * hardware/firmware), the low-level driver uses this function to receive
5606 * the next CTS-to-self frame from the 802.11 code. The low-level is responsible
5607 * for calling this function before and CTS-to-self frame is needed.
5616 * ieee80211_ctstoself_duration - Get the duration field for a CTS-to-self frame
5619 * @frame_len: the length of the frame that is going to be protected by the CTS-to-self.
5622 * If the CTS-to-self is generated in firmware, but the host system must provide
5623 * the duration field, the low-level driver uses this function to receive
5624 * the duration field value in little-endian byteorder.
5634 * ieee80211_generic_frame_duration - Calculate the duration field for a frame
5653 * ieee80211_get_buffered_bc - accessing buffered broadcast and multicast frames
5657 * Function for accessing buffered broadcast and multicast frames. If
5660 * memory. The low-level driver uses this function to fetch next buffered
5663 * Return: A pointer to the next buffered skb or NULL if no more buffered
5666 * Note: buffered frames are returned only after DTIM beacon frame was
5667 * generated with ieee80211_beacon_get() and the low-level driver must thus
5669 * NULL if the previous generated beacon was not DTIM, so the low-level driver
5677 * ieee80211_get_tkip_p1k_iv - get a TKIP phase 1 key for IV32
5689 * ieee80211_get_tkip_p1k - get a TKIP phase 1 key
5702 struct ieee80211_hdr *hdr = (struct ieee80211_hdr *)skb->data; in ieee80211_get_tkip_p1k()
5703 const u8 *data = (u8 *)hdr + ieee80211_hdrlen(hdr->frame_control); in ieee80211_get_tkip_p1k()
5710 * ieee80211_get_tkip_rx_p1k - get a TKIP phase 1 key for RX
5724 * ieee80211_get_tkip_p2k - get a TKIP phase 2 key
5738 * ieee80211_tkip_add_iv - write TKIP IV and Ext. IV to pos
5753 * ieee80211_get_key_rx_seq - get key RX sequence counter
5756 * @tid: The TID, or -1 for the management frame value (CCMP/GCMP only);
5757 * the value on TID 0 is also used for non-QoS frames. For
5772 * ieee80211_set_key_rx_seq - set key RX sequence counter
5775 * @tid: The TID, or -1 for the management frame value (CCMP/GCMP only);
5776 * the value on TID 0 is also used for non-QoS frames. For
5792 * ieee80211_remove_key - remove the given key
5805 * ieee80211_gtk_rekey_add - add a GTK key from rekeying during WoWLAN
5815 * mac80211-owned memory. In case of errors, the function returns an
5838 * ieee80211_gtk_rekey_notify - notify userspace supplicant of rekeying
5848 * ieee80211_key_mic_failure - increment MIC failure counter for the key
5858 * ieee80211_key_replay - increment replay counter for the key
5868 * ieee80211_wake_queue - wake specific queue
5877 * ieee80211_stop_queue - stop specific queue
5886 * ieee80211_queue_stopped - test status of the queue
5898 * ieee80211_stop_queues - stop all queues
5906 * ieee80211_wake_queues - wake all queues
5914 * ieee80211_scan_completed - completed hardware scan
5928 * ieee80211_sched_scan_results - got results from scheduled scan
5938 * ieee80211_sched_scan_stopped - inform that the scheduled scan has stopped
5950 * enum ieee80211_interface_iteration_flags - interface iteration flags
5955 * haven't been re-added to the driver yet.
5957 * interfaces, even if they haven't been re-added to the driver yet.
5971 * ieee80211_iterate_interfaces - iterate interfaces
5989 * ieee80211_iterate_active_interfaces - iterate active interfaces
6015 * ieee80211_iterate_active_interfaces_atomic - iterate active interfaces
6036 * ieee80211_iterate_active_interfaces_mtx - iterate active interfaces
6055 * ieee80211_iterate_stations_atomic - iterate stations
6071 * ieee80211_queue_work - add work onto the mac80211 workqueue
6082 * ieee80211_queue_delayed_work - add work onto the mac80211 workqueue
6096 * ieee80211_refresh_tx_agg_session_timer - Refresh a tx agg session timer.
6110 * ieee80211_start_tx_ba_session - Start a tx Block Ack session.
6125 * ieee80211_start_tx_ba_cb_irqsafe - low level driver ready to aggregate.
6138 * ieee80211_stop_tx_ba_session - Stop a Block Ack session.
6142 * Return: negative error if the TID is invalid, or no aggregation active
6151 * ieee80211_stop_tx_ba_cb_irqsafe - low level driver ready to stop aggregate.
6164 * ieee80211_find_sta - find a station
6178 * ieee80211_find_sta_by_ifaddr - find a station on hardware
6182 * @localaddr: local address (vif->sdata->vif.addr). Use NULL for 'any'.
6204 * ieee80211_find_sta_by_link_addrs - find STA by link addresses
6220 * ieee80211_sta_block_awake - block station from waking up
6231 * This function allows implementing this mode in a race-free
6241 * cause mac80211 to be able to send ps-poll responses, and if
6252 * ieee80211_sta_eosp - notify mac80211 about end of SP
6258 * This applies for PS-Poll as well as uAPSD.
6261 * not mix calls to irqsafe/non-irqsafe versions, this function
6263 * all non-irqsafe, don't mix!
6273 * ieee80211_send_eosp_nullfunc - ask mac80211 to send NDP with EOSP
6283 * let mac80211 know that there are no buffered frames any
6286 * will be sent despite the station being in power-save.
6295 * ieee80211_sta_recalc_aggregates - recalculate aggregate data after a change
6298 * Call this function after changing a per-link aggregate data as referenced in
6308 * ieee80211_sta_register_airtime - register airtime usage for a sta/tid
6336 * ieee80211_txq_airtime_check - check if a txq can send frame to device
6348 * ieee80211_iter_keys - iterate keys programmed into the device
6375 * ieee80211_iter_keys_rcu - iterate keys programmed into the device
6399 * ieee80211_iter_chan_contexts_atomic - iterate channel contexts
6414 * found while iterating, whether they've been re-added already
6425 * ieee80211_ap_probereq_get - retrieve a Probe Request template
6442 * ieee80211_beacon_loss - inform hardware does not receive beacons
6453 * ieee80211_connection_loss - inform hardware has lost connection to the AP
6469 * ieee80211_disconnect - request disconnection
6480 * ieee80211_resume_disconnect - disconnect from AP after resume
6503 * ieee80211_hw_restart_disconnect - disconnect from AP after
6513 * ieee80211_cqm_rssi_notify - inform a configured connection quality monitoring
6531 * ieee80211_cqm_beacon_loss_notify - inform CQM of beacon loss
6539 * ieee80211_radar_detected - inform that a radar was detected
6546 * ieee80211_chswitch_done - Complete channel switch process
6550 * Complete the channel switch post-process: set the new operational channel
6556 * ieee80211_channel_switch_disconnect - disconnect due to channel switch error
6568 * ieee80211_request_smps - request SM PS transition
6581 * ieee80211_ready_on_channel - notification of remain-on-channel start
6587 * ieee80211_remain_on_channel_expired - remain_on_channel duration expired
6593 * ieee80211_stop_rx_ba_session - callback to stop existing BA sessions
6600 * therefore prevent the peer device to use a-mpdu aggregation.
6610 * ieee80211_mark_rx_ba_filtered_frames - move RX BA window and mark filtered
6629 * ieee80211_send_bar - send a BlockAckReq frame
6642 * ieee80211_manage_rx_ba_offl - helper to queue an RX BA work
6651 * ieee80211_start_rx_ba_session_offl - start a Rx BA session
6673 * ieee80211_stop_rx_ba_session_offl - stop a Rx BA session
6695 * ieee80211_rx_ba_timer_expired - stop a Rx BA session due to timeout
6712 * struct ieee80211_tx_rate_control - rate control information for/from RC algo
6724 * @short_preamble: whether mac80211 will request short-preamble transmission
6726 * @rate_idx_mask: user-requested (legacy) rate mask
6727 * @rate_idx_mcs_mask: user-requested MCS rate mask (NULL if not in use)
6743 * enum rate_control_capabilities - rate control capabilities
6756 * mac80211 should start A-MPDU sessions on tx
6799 return (sta == NULL || sta->deflink.supp_rates[band] & BIT(index)); in rate_supported()
6808 for (i = 0; i < sband->n_bitrates; i++) in rate_lowest_index()
6809 if (rate_supported(sta, sband->band, i)) in rate_lowest_index()
6825 for (i = 0; i < sband->n_bitrates; i++) in rate_usable_index_exists()
6826 if (rate_supported(sta, sband->band, i)) in rate_usable_index_exists()
6832 * rate_control_set_rates - pass the sta rate selection to mac80211/driver
6853 return conf->chandef.width == NL80211_CHAN_WIDTH_20; in conf_is_ht20()
6859 return conf->chandef.width == NL80211_CHAN_WIDTH_40 && in conf_is_ht40_minus()
6860 conf->chandef.center_freq1 < conf->chandef.chan->center_freq; in conf_is_ht40_minus()
6866 return conf->chandef.width == NL80211_CHAN_WIDTH_40 && in conf_is_ht40_plus()
6867 conf->chandef.center_freq1 > conf->chandef.chan->center_freq; in conf_is_ht40_plus()
6873 return conf->chandef.width == NL80211_CHAN_WIDTH_40; in conf_is_ht40()
6879 return (conf->chandef.width != NL80211_CHAN_WIDTH_5) && in conf_is_ht()
6880 (conf->chandef.width != NL80211_CHAN_WIDTH_10) && in conf_is_ht()
6881 (conf->chandef.width != NL80211_CHAN_WIDTH_20_NOHT); in conf_is_ht()
6903 return ieee80211_iftype_p2p(vif->type, vif->p2p); in ieee80211_vif_type_p2p()
6907 * ieee80211_get_he_iftype_cap_vif - return HE capabilities for sband/vif
6921 * ieee80211_get_he_6ghz_capa_vif - return HE 6 GHz capabilities
6935 * ieee80211_get_eht_iftype_cap_vif - return ETH capabilities for sband/vif
6949 * ieee80211_update_mu_groups - set the VHT MU-MIMO groud data
6953 * @membership: 64 bits array - a bit is set if station is member of the group
6971 * ieee80211_ave_rssi - report the average RSSI for the specified interface
6983 * ieee80211_report_wowlan_wakeup - report WoWLAN wakeup
6995 * ieee80211_tx_prepare_skb - prepare an 802.11 skb for transmission
7009 * ieee80211_parse_tx_radiotap - Sanity-check and parse the radiotap header
7023 * struct ieee80211_noa_data - holds temporary data for tracking P2P NoA state
7050 * ieee80211_parse_p2p_noa - initialize NoA tracking data from P2P IE
7062 * ieee80211_update_p2p_noa - get next pending P2P GO absent state change
7070 * ieee80211_tdls_oper_request - request userspace to perform a TDLS operation
7084 * ieee80211_reserve_tid - request to reserve a specific TID
7105 * ieee80211_unreserve_tid - request to unreserve a specific TID
7121 * ieee80211_tx_dequeue - dequeue a packet from a software tx queue
7131 * skb->cb, e.g. the key pointer, are protected by RCU and thus the
7144 * ieee80211_tx_dequeue_ni - dequeue a packet from a software tx queue
7167 * ieee80211_handle_wake_tx_queue - mac80211 handler for wake_tx_queue callback
7179 * ieee80211_next_txq - get next tx queue to pull packets from
7191 * ieee80211_txq_schedule_start - start new scheduling round for TXQs
7210 * ieee80211_schedule_txq - schedule a TXQ for transmission
7216 * even if mac80211 does not have any packets buffered.
7218 * The driver may call this function if it has buffered packets for
7228 * ieee80211_return_txq - return a TXQ previously acquired by ieee80211_next_txq()
7232 * @force: schedule txq even if mac80211 does not have any buffered packets.
7234 * The driver may set force=true if it has buffered packets for this TXQ
7245 * ieee80211_txq_may_transmit - check whether TXQ is allowed to transmit
7259 * aligned against driver's own round-robin scheduler list. i.e it rotates
7272 * ieee80211_txq_get_depth - get pending frame/byte count of given txq
7275 * txq state can change half-way of this function and the caller may end up
7276 * with "new" frame_cnt and "old" byte_cnt or vice-versa.
7287 * ieee80211_nan_func_terminated - notify about NAN function termination.
7303 * ieee80211_nan_func_match - notify about NAN function match event.
7318 * ieee80211_calc_rx_airtime - calculate estimated transmission airtime for RX.
7333 * ieee80211_calc_tx_airtime - calculate estimated transmission airtime for TX.
7346 * ieee80211_set_hw_80211_encap - enable hardware encapsulation offloading.
7358 * ieee80211_get_fils_discovery_tmpl - Get FILS discovery template.
7370 * ieee80211_get_unsol_bcast_probe_resp_tmpl - Get unsolicited broadcast
7384 * ieee80211_obss_color_collision_notify - notify userland about a BSS color
7397 * ieee80211_is_tx_data - check if frame is a data frame
7407 struct ieee80211_hdr *hdr = (void *) skb->data; in ieee80211_is_tx_data()
7409 return info->flags & IEEE80211_TX_CTL_HW_80211_ENCAP || in ieee80211_is_tx_data()
7410 ieee80211_is_data(hdr->frame_control); in ieee80211_is_tx_data()
7414 * ieee80211_set_active_links - set active links in client mode
7425 * - change_vif_links(0x11)
7426 * - unassign_vif_chanctx(link_id=0)
7427 * - change_sta_links(0x11) for each affected STA (the AP)
7429 * - remove group keys on the old link (link_id 0)
7430 * - add new group keys (GTK/IGTK/BIGTK) on the new link (link_id 4)
7431 * - change_sta_links(0x10) for each affected STA (the AP)
7432 * - assign_vif_chanctx(link_id=4)
7433 * - change_vif_links(0x10)
7442 * ieee80211_set_active_links_async - asynchronously set active links