Something went wrong. Try again.
(I'm so sorry!) Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux
Something went wrong. Try again.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389/* SPDX-License-Identifier: GPL-2.0-only *//* * IEEE 802.11 EHT definitions * * Copyright (c) 2001-2002, SSH Communications Security Corp and Jouni Malinen * <jkmaline@cc.hut.fi> * Copyright (c) 2002-2003, Jouni Malinen <jkmaline@cc.hut.fi> * Copyright (c) 2005, Devicescape Software, Inc. * Copyright (c) 2006, Michael Wu <flamingice@sourmilk.net> * Copyright (c) 2013 - 2014 Intel Mobile Communications GmbH * Copyright (c) 2016 - 2017 Intel Deutschland GmbH * Copyright (c) 2018 - 2026 Intel Corporation */
#ifndef LINUX_IEEE80211_EHT_H#define LINUX_IEEE80211_EHT_H
#include <linux/types.h>#include <linux/if_ether.h>/* need HE definitions for the inlines here */#include <linux/ieee80211-he.h>
#define IEEE80211_TTLM_MAX_CNT 2#define IEEE80211_TTLM_CONTROL_DIRECTION 0x03#define IEEE80211_TTLM_CONTROL_DEF_LINK_MAP 0x04#define IEEE80211_TTLM_CONTROL_SWITCH_TIME_PRESENT 0x08#define IEEE80211_TTLM_CONTROL_EXPECTED_DUR_PRESENT 0x10#define IEEE80211_TTLM_CONTROL_LINK_MAP_SIZE 0x20
#define IEEE80211_TTLM_DIRECTION_DOWN 0#define IEEE80211_TTLM_DIRECTION_UP 1#define IEEE80211_TTLM_DIRECTION_BOTH 2
/** * struct ieee80211_ttlm_elem - TID-To-Link Mapping element * * Defined in section 9.4.2.314 in P802.11be_D4 * * @control: the first part of control field * @optional: the second part of control field */struct ieee80211_ttlm_elem { u8 control; u8 optional[];} __packed;
#define IEEE80211_EHT_MCS_NSS_RX 0x0f#define IEEE80211_EHT_MCS_NSS_TX 0xf0
/** * struct ieee80211_eht_mcs_nss_supp_20mhz_only - EHT 20MHz only station max * supported NSS for per MCS. * * For each field below, bits 0 - 3 indicate the maximal number of spatial * streams for Rx, and bits 4 - 7 indicate the maximal number of spatial streams * for Tx. * * @rx_tx_mcs7_max_nss: indicates the maximum number of spatial streams * supported for reception and the maximum number of spatial streams * supported for transmission for MCS 0 - 7. * @rx_tx_mcs9_max_nss: indicates the maximum number of spatial streams * supported for reception and the maximum number of spatial streams * supported for transmission for MCS 8 - 9. * @rx_tx_mcs11_max_nss: indicates the maximum number of spatial streams * supported for reception and the maximum number of spatial streams * supported for transmission for MCS 10 - 11. * @rx_tx_mcs13_max_nss: indicates the maximum number of spatial streams * supported for reception and the maximum number of spatial streams * supported for transmission for MCS 12 - 13. * @rx_tx_max_nss: array of the previous fields for easier loop access */struct ieee80211_eht_mcs_nss_supp_20mhz_only { union { struct { u8 rx_tx_mcs7_max_nss; u8 rx_tx_mcs9_max_nss; u8 rx_tx_mcs11_max_nss; u8 rx_tx_mcs13_max_nss; }; u8 rx_tx_max_nss[4]; };};
/** * struct ieee80211_eht_mcs_nss_supp_bw - EHT max supported NSS per MCS (except * 20MHz only stations). * * For each field below, bits 0 - 3 indicate the maximal number of spatial * streams for Rx, and bits 4 - 7 indicate the maximal number of spatial streams * for Tx. * * @rx_tx_mcs9_max_nss: indicates the maximum number of spatial streams * supported for reception and the maximum number of spatial streams * supported for transmission for MCS 0 - 9. * @rx_tx_mcs11_max_nss: indicates the maximum number of spatial streams * supported for reception and the maximum number of spatial streams * supported for transmission for MCS 10 - 11. * @rx_tx_mcs13_max_nss: indicates the maximum number of spatial streams * supported for reception and the maximum number of spatial streams * supported for transmission for MCS 12 - 13. * @rx_tx_max_nss: array of the previous fields for easier loop access */struct ieee80211_eht_mcs_nss_supp_bw { union { struct { u8 rx_tx_mcs9_max_nss; u8 rx_tx_mcs11_max_nss; u8 rx_tx_mcs13_max_nss; }; u8 rx_tx_max_nss[3]; };};
/** * struct ieee80211_eht_cap_elem_fixed - EHT capabilities fixed data * * This structure is the "EHT Capabilities element" fixed fields as * described in P802.11be_D2.0 section 9.4.2.313. * * @mac_cap_info: MAC capabilities, see IEEE80211_EHT_MAC_CAP* * @phy_cap_info: PHY capabilities, see IEEE80211_EHT_PHY_CAP* */struct ieee80211_eht_cap_elem_fixed { u8 mac_cap_info[2]; u8 phy_cap_info[9];} __packed;
/** * struct ieee80211_eht_cap_elem - EHT capabilities element * @fixed: fixed parts, see &ieee80211_eht_cap_elem_fixed * @optional: optional parts */struct ieee80211_eht_cap_elem { struct ieee80211_eht_cap_elem_fixed fixed;
/* * Followed by: * Supported EHT-MCS And NSS Set field: 4, 3, 6 or 9 octets. * EHT PPE Thresholds field: variable length. */ u8 optional[];} __packed;
#define IEEE80211_EHT_OPER_INFO_PRESENT 0x01#define IEEE80211_EHT_OPER_DISABLED_SUBCHANNEL_BITMAP_PRESENT 0x02#define IEEE80211_EHT_OPER_EHT_DEF_PE_DURATION 0x04#define IEEE80211_EHT_OPER_GROUP_ADDRESSED_BU_IND_LIMIT 0x08#define IEEE80211_EHT_OPER_GROUP_ADDRESSED_BU_IND_EXP_MASK 0x30#define IEEE80211_EHT_OPER_MCS15_DISABLE 0x40
/** * struct ieee80211_eht_operation - eht operation element * * This structure is the "EHT Operation Element" fields as * described in P802.11be_D2.0 section 9.4.2.311 * * @params: EHT operation element parameters. See &IEEE80211_EHT_OPER_* * @basic_mcs_nss: indicates the EHT-MCSs for each number of spatial streams in * EHT PPDUs that are supported by all EHT STAs in the BSS in transmit and * receive. * @optional: optional parts */struct ieee80211_eht_operation { u8 params; struct ieee80211_eht_mcs_nss_supp_20mhz_only basic_mcs_nss; u8 optional[];} __packed;
/** * struct ieee80211_eht_operation_info - eht operation information * * @control: EHT operation information control. * @ccfs0: defines a channel center frequency for a 20, 40, 80, 160, or 320 MHz * EHT BSS. * @ccfs1: defines a channel center frequency for a 160 or 320 MHz EHT BSS. * @optional: optional parts */struct ieee80211_eht_operation_info { u8 control; u8 ccfs0; u8 ccfs1; u8 optional[];} __packed;
/* EHT MAC capabilities as defined in P802.11be_D2.0 section 9.4.2.313.2 */#define IEEE80211_EHT_MAC_CAP0_EPCS_PRIO_ACCESS 0x01#define IEEE80211_EHT_MAC_CAP0_OM_CONTROL 0x02#define IEEE80211_EHT_MAC_CAP0_TRIG_TXOP_SHARING_MODE1 0x04#define IEEE80211_EHT_MAC_CAP0_TRIG_TXOP_SHARING_MODE2 0x08#define IEEE80211_EHT_MAC_CAP0_RESTRICTED_TWT 0x10#define IEEE80211_EHT_MAC_CAP0_SCS_TRAFFIC_DESC 0x20#define IEEE80211_EHT_MAC_CAP0_MAX_MPDU_LEN_MASK 0xc0#define IEEE80211_EHT_MAC_CAP0_MAX_MPDU_LEN_3895 0#define IEEE80211_EHT_MAC_CAP0_MAX_MPDU_LEN_7991 1#define IEEE80211_EHT_MAC_CAP0_MAX_MPDU_LEN_11454 2
#define IEEE80211_EHT_MAC_CAP1_MAX_AMPDU_LEN_MASK 0x01#define IEEE80211_EHT_MAC_CAP1_EHT_TRS 0x02#define IEEE80211_EHT_MAC_CAP1_TXOP_RET 0x04#define IEEE80211_EHT_MAC_CAP1_TWO_BQRS 0x08#define IEEE80211_EHT_MAC_CAP1_EHT_LINK_ADAPT_MASK 0x30#define IEEE80211_EHT_MAC_CAP1_UNSOL_EPCS_PRIO_ACCESS 0x40
/* EHT PHY capabilities as defined in P802.11be_D2.0 section 9.4.2.313.3 */#define IEEE80211_EHT_PHY_CAP0_320MHZ_IN_6GHZ 0x02#define IEEE80211_EHT_PHY_CAP0_242_TONE_RU_GT20MHZ 0x04#define IEEE80211_EHT_PHY_CAP0_NDP_4_EHT_LFT_32_GI 0x08#define IEEE80211_EHT_PHY_CAP0_PARTIAL_BW_UL_MU_MIMO 0x10#define IEEE80211_EHT_PHY_CAP0_SU_BEAMFORMER 0x20#define IEEE80211_EHT_PHY_CAP0_SU_BEAMFORMEE 0x40
/* EHT beamformee number of spatial streams <= 80MHz is split */#define IEEE80211_EHT_PHY_CAP0_BEAMFORMEE_SS_80MHZ_MASK 0x80#define IEEE80211_EHT_PHY_CAP1_BEAMFORMEE_SS_80MHZ_MASK 0x03
#define IEEE80211_EHT_PHY_CAP1_BEAMFORMEE_SS_160MHZ_MASK 0x1c#define IEEE80211_EHT_PHY_CAP1_BEAMFORMEE_SS_320MHZ_MASK 0xe0
#define IEEE80211_EHT_PHY_CAP2_SOUNDING_DIM_80MHZ_MASK 0x07#define IEEE80211_EHT_PHY_CAP2_SOUNDING_DIM_160MHZ_MASK 0x38
/* EHT number of sounding dimensions for 320MHz is split */#define IEEE80211_EHT_PHY_CAP2_SOUNDING_DIM_320MHZ_MASK 0xc0#define IEEE80211_EHT_PHY_CAP3_SOUNDING_DIM_320MHZ_MASK 0x01#define IEEE80211_EHT_PHY_CAP3_NG_16_SU_FEEDBACK 0x02#define IEEE80211_EHT_PHY_CAP3_NG_16_MU_FEEDBACK 0x04#define IEEE80211_EHT_PHY_CAP3_CODEBOOK_4_2_SU_FDBK 0x08#define IEEE80211_EHT_PHY_CAP3_CODEBOOK_7_5_MU_FDBK 0x10#define IEEE80211_EHT_PHY_CAP3_TRIG_SU_BF_FDBK 0x20#define IEEE80211_EHT_PHY_CAP3_TRIG_MU_BF_PART_BW_FDBK 0x40#define IEEE80211_EHT_PHY_CAP3_TRIG_CQI_FDBK 0x80
#define IEEE80211_EHT_PHY_CAP4_PART_BW_DL_MU_MIMO 0x01#define IEEE80211_EHT_PHY_CAP4_PSR_SR_SUPP 0x02#define IEEE80211_EHT_PHY_CAP4_POWER_BOOST_FACT_SUPP 0x04#define IEEE80211_EHT_PHY_CAP4_EHT_MU_PPDU_4_EHT_LTF_08_GI 0x08#define IEEE80211_EHT_PHY_CAP4_MAX_NC_MASK 0xf0
#define IEEE80211_EHT_PHY_CAP5_NON_TRIG_CQI_FEEDBACK 0x01#define IEEE80211_EHT_PHY_CAP5_TX_LESS_242_TONE_RU_SUPP 0x02#define IEEE80211_EHT_PHY_CAP5_RX_LESS_242_TONE_RU_SUPP 0x04#define IEEE80211_EHT_PHY_CAP5_PPE_THRESHOLD_PRESENT 0x08#define IEEE80211_EHT_PHY_CAP5_COMMON_NOMINAL_PKT_PAD_MASK 0x30#define IEEE80211_EHT_PHY_CAP5_COMMON_NOMINAL_PKT_PAD_0US 0#define IEEE80211_EHT_PHY_CAP5_COMMON_NOMINAL_PKT_PAD_8US 1#define IEEE80211_EHT_PHY_CAP5_COMMON_NOMINAL_PKT_PAD_16US 2#define IEEE80211_EHT_PHY_CAP5_COMMON_NOMINAL_PKT_PAD_20US 3
/* Maximum number of supported EHT LTF is split */#define IEEE80211_EHT_PHY_CAP5_MAX_NUM_SUPP_EHT_LTF_MASK 0xc0#define IEEE80211_EHT_PHY_CAP5_SUPP_EXTRA_EHT_LTF 0x40#define IEEE80211_EHT_PHY_CAP6_MAX_NUM_SUPP_EHT_LTF_MASK 0x07
#define IEEE80211_EHT_PHY_CAP6_MCS15_SUPP_80MHZ 0x10#define IEEE80211_EHT_PHY_CAP6_MCS15_SUPP_160MHZ 0x20#define IEEE80211_EHT_PHY_CAP6_MCS15_SUPP_320MHZ 0x40#define IEEE80211_EHT_PHY_CAP6_MCS15_SUPP_MASK 0x78#define IEEE80211_EHT_PHY_CAP6_EHT_DUP_6GHZ_SUPP 0x80
#define IEEE80211_EHT_PHY_CAP7_20MHZ_STA_RX_NDP_WIDER_BW 0x01#define IEEE80211_EHT_PHY_CAP7_NON_OFDMA_UL_MU_MIMO_80MHZ 0x02#define IEEE80211_EHT_PHY_CAP7_NON_OFDMA_UL_MU_MIMO_160MHZ 0x04#define IEEE80211_EHT_PHY_CAP7_NON_OFDMA_UL_MU_MIMO_320MHZ 0x08#define IEEE80211_EHT_PHY_CAP7_MU_BEAMFORMER_80MHZ 0x10#define IEEE80211_EHT_PHY_CAP7_MU_BEAMFORMER_160MHZ 0x20#define IEEE80211_EHT_PHY_CAP7_MU_BEAMFORMER_320MHZ 0x40#define IEEE80211_EHT_PHY_CAP7_TB_SOUNDING_FDBK_RATE_LIMIT 0x80
#define IEEE80211_EHT_PHY_CAP8_RX_1024QAM_WIDER_BW_DL_OFDMA 0x01#define IEEE80211_EHT_PHY_CAP8_RX_4096QAM_WIDER_BW_DL_OFDMA 0x02
/* * EHT operation channel width as defined in P802.11be_D2.0 section 9.4.2.311 */#define IEEE80211_EHT_OPER_CHAN_WIDTH 0x7#define IEEE80211_EHT_OPER_CHAN_WIDTH_20MHZ 0#define IEEE80211_EHT_OPER_CHAN_WIDTH_40MHZ 1#define IEEE80211_EHT_OPER_CHAN_WIDTH_80MHZ 2#define IEEE80211_EHT_OPER_CHAN_WIDTH_160MHZ 3#define IEEE80211_EHT_OPER_CHAN_WIDTH_320MHZ 4
/* Calculate 802.11be EHT capabilities IE Tx/Rx EHT MCS NSS Support Field size */static inline u8ieee80211_eht_mcs_nss_size(const struct ieee80211_he_cap_elem *he_cap, const struct ieee80211_eht_cap_elem_fixed *eht_cap, bool from_ap){ u8 count = 0;
/* on 2.4 GHz, if it supports 40 MHz, the result is 3 */ if (he_cap->phy_cap_info[0] & IEEE80211_HE_PHY_CAP0_CHANNEL_WIDTH_SET_40MHZ_IN_2G) return 3;
/* on 2.4 GHz, these three bits are reserved, so should be 0 */ if (he_cap->phy_cap_info[0] & IEEE80211_HE_PHY_CAP0_CHANNEL_WIDTH_SET_40MHZ_80MHZ_IN_5G) count += 3;
if (he_cap->phy_cap_info[0] & IEEE80211_HE_PHY_CAP0_CHANNEL_WIDTH_SET_160MHZ_IN_5G) count += 3;
if (eht_cap->phy_cap_info[0] & IEEE80211_EHT_PHY_CAP0_320MHZ_IN_6GHZ) count += 3;
if (count) return count;
return from_ap ? 3 : 4;}
/* 802.11be EHT PPE Thresholds */#define IEEE80211_EHT_PPE_THRES_NSS_POS 0#define IEEE80211_EHT_PPE_THRES_NSS_MASK 0xf#define IEEE80211_EHT_PPE_THRES_RU_INDEX_BITMASK_MASK 0x1f0#define IEEE80211_EHT_PPE_THRES_INFO_PPET_SIZE 3#define IEEE80211_EHT_PPE_THRES_INFO_HEADER_SIZE 9
/* * Calculate 802.11be EHT capabilities IE EHT field size */static inline u8ieee80211_eht_ppe_size(u16 ppe_thres_hdr, const u8 *phy_cap_info){ u32 n;
if (!(phy_cap_info[5] & IEEE80211_EHT_PHY_CAP5_PPE_THRESHOLD_PRESENT)) return 0;
n = hweight16(ppe_thres_hdr & IEEE80211_EHT_PPE_THRES_RU_INDEX_BITMASK_MASK); n *= 1 + u16_get_bits(ppe_thres_hdr, IEEE80211_EHT_PPE_THRES_NSS_MASK);
/* * Each pair is 6 bits, and we need to add the 9 "header" bits to the * total size. */ n = n * IEEE80211_EHT_PPE_THRES_INFO_PPET_SIZE * 2 + IEEE80211_EHT_PPE_THRES_INFO_HEADER_SIZE; return DIV_ROUND_UP(n, 8);}
static inline boolieee80211_eht_capa_size_ok(const u8 *he_capa, const u8 *data, u8 len, bool from_ap){ const struct ieee80211_eht_cap_elem_fixed *elem = (const void *)data; u8 needed = sizeof(struct ieee80211_eht_cap_elem_fixed);
if (len < needed || !he_capa) return false;
needed += ieee80211_eht_mcs_nss_size((const void *)he_capa, (const void *)data, from_ap); if (len < needed) return false;
if (elem->phy_cap_info[5] & IEEE80211_EHT_PHY_CAP5_PPE_THRESHOLD_PRESENT) { u16 ppe_thres_hdr;
if (len < needed + sizeof(ppe_thres_hdr)) return false;
ppe_thres_hdr = get_unaligned_le16(data + needed); needed += ieee80211_eht_ppe_size(ppe_thres_hdr, elem->phy_cap_info); }
return len >= needed;}
static inline boolieee80211_eht_oper_size_ok(const u8 *data, u8 len){ const struct ieee80211_eht_operation *elem = (const void *)data; u8 needed = sizeof(*elem);
if (len < needed) return false;
if (elem->params & IEEE80211_EHT_OPER_INFO_PRESENT) { needed += 3;
if (elem->params & IEEE80211_EHT_OPER_DISABLED_SUBCHANNEL_BITMAP_PRESENT) needed += 2; }
return len >= needed;}
/* must validate ieee80211_eht_oper_size_ok() first */static inline const struct ieee80211_eht_operation_info *ieee80211_eht_oper_info(const struct ieee80211_eht_operation *eht_oper){ if (!(eht_oper->params & IEEE80211_EHT_OPER_INFO_PRESENT)) return NULL;
return (const void *)eht_oper->optional;}
/* must validate ieee80211_eht_oper_size_ok() first */static inline u16ieee80211_eht_oper_dis_subchan_bitmap(const struct ieee80211_eht_operation *eht_oper){ const struct ieee80211_eht_operation_info *info;
info = ieee80211_eht_oper_info(eht_oper); if (!info) return 0;
if (!(eht_oper->params & IEEE80211_EHT_OPER_DISABLED_SUBCHANNEL_BITMAP_PRESENT)) return 0;
return get_unaligned_le16(info->optional);}
#define IEEE80211_BW_IND_DIS_SUBCH_PRESENT BIT(1)
struct ieee80211_bandwidth_indication { u8 params; struct ieee80211_eht_operation_info info;} __packed;
static inline boolieee80211_bandwidth_indication_size_ok(const u8 *data, u8 len){ const struct ieee80211_bandwidth_indication *bwi = (const void *)data;
if (len < sizeof(*bwi)) return false;
if (bwi->params & IEEE80211_BW_IND_DIS_SUBCH_PRESENT && len < sizeof(*bwi) + 2) return false;
return true;}
/* Protected EHT action codes */enum ieee80211_protected_eht_actioncode { WLAN_PROTECTED_EHT_ACTION_TTLM_REQ = 0, WLAN_PROTECTED_EHT_ACTION_TTLM_RES = 1, WLAN_PROTECTED_EHT_ACTION_TTLM_TEARDOWN = 2, WLAN_PROTECTED_EHT_ACTION_EPCS_ENABLE_REQ = 3, WLAN_PROTECTED_EHT_ACTION_EPCS_ENABLE_RESP = 4, WLAN_PROTECTED_EHT_ACTION_EPCS_ENABLE_TEARDOWN = 5, WLAN_PROTECTED_EHT_ACTION_EML_OP_MODE_NOTIF = 6, WLAN_PROTECTED_EHT_ACTION_LINK_RECOMMEND = 7, WLAN_PROTECTED_EHT_ACTION_ML_OP_UPDATE_REQ = 8, WLAN_PROTECTED_EHT_ACTION_ML_OP_UPDATE_RESP = 9, WLAN_PROTECTED_EHT_ACTION_LINK_RECONFIG_NOTIF = 10, WLAN_PROTECTED_EHT_ACTION_LINK_RECONFIG_REQ = 11, WLAN_PROTECTED_EHT_ACTION_LINK_RECONFIG_RESP = 12,};
/* multi-link device */#define IEEE80211_MLD_MAX_NUM_LINKS 15
#define IEEE80211_ML_CONTROL_TYPE 0x0007#define IEEE80211_ML_CONTROL_TYPE_BASIC 0#define IEEE80211_ML_CONTROL_TYPE_PREQ 1#define IEEE80211_ML_CONTROL_TYPE_RECONF 2#define IEEE80211_ML_CONTROL_TYPE_TDLS 3#define IEEE80211_ML_CONTROL_TYPE_PRIO_ACCESS 4#define IEEE80211_ML_CONTROL_PRESENCE_MASK 0xfff0
struct ieee80211_multi_link_elem { __le16 control; u8 variable[];} __packed;
#define IEEE80211_MLC_BASIC_PRES_LINK_ID 0x0010#define IEEE80211_MLC_BASIC_PRES_BSS_PARAM_CH_CNT 0x0020#define IEEE80211_MLC_BASIC_PRES_MED_SYNC_DELAY 0x0040#define IEEE80211_MLC_BASIC_PRES_EML_CAPA 0x0080#define IEEE80211_MLC_BASIC_PRES_MLD_CAPA_OP 0x0100#define IEEE80211_MLC_BASIC_PRES_MLD_ID 0x0200#define IEEE80211_MLC_BASIC_PRES_EXT_MLD_CAPA_OP 0x0400#define IEEE80211_MLC_BASIC_PRES_ENH_CRIT_UPD 0x0800#define IEEE80211_MLC_BASIC_PRES_AGE_OF_BSS_LOAD 0x1000
#define IEEE80211_MED_SYNC_DELAY_DURATION 0x00ff#define IEEE80211_MED_SYNC_DELAY_SYNC_OFDM_ED_THRESH 0x0f00#define IEEE80211_MED_SYNC_DELAY_SYNC_MAX_NUM_TXOPS 0xf000
/* * Described in P802.11be_D3.0 * dot11MSDTimerDuration should default to 5484 (i.e. 171.375) * dot11MSDOFDMEDthreshold defaults to -72 (i.e. 0) * dot11MSDTXOPMAX defaults to 1 */#define IEEE80211_MED_SYNC_DELAY_DEFAULT 0x10ac
#define IEEE80211_EML_CAP_EMLSR_SUPP 0x0001#define IEEE80211_EML_CAP_EML_PADDING_DELAY 0x000e/* Described Tables 9-417i & 9-417k in 802.11be-2024, which have the same values */#define IEEE80211_EML_CAP_EML_PADDING_DELAY_0US 0#define IEEE80211_EML_CAP_EML_PADDING_DELAY_32US 1#define IEEE80211_EML_CAP_EML_PADDING_DELAY_64US 2#define IEEE80211_EML_CAP_EML_PADDING_DELAY_128US 3#define IEEE80211_EML_CAP_EML_PADDING_DELAY_256US 4#define IEEE80211_EML_CAP_EML_TRANSITION_DELAY 0x0070/* Described in Table 9-417j in 802.11be-2024 */#define IEEE80211_EML_CAP_EMLSR_TRANSITION_DELAY_0US 0#define IEEE80211_EML_CAP_EMLSR_TRANSITION_DELAY_16US 1#define IEEE80211_EML_CAP_EMLSR_TRANSITION_DELAY_32US 2#define IEEE80211_EML_CAP_EMLSR_TRANSITION_DELAY_64US 3#define IEEE80211_EML_CAP_EMLSR_TRANSITION_DELAY_128US 4#define IEEE80211_EML_CAP_EMLSR_TRANSITION_DELAY_256US 5/* Described in Table 9-417l in 802.11be-2024 */#define IEEE80211_EML_CAP_EMLMR_TRANSITION_DELAY_0US 0#define IEEE80211_EML_CAP_EMLMR_TRANSITION_DELAY_32US 1#define IEEE80211_EML_CAP_EMLMR_TRANSITION_DELAY_64US 2#define IEEE80211_EML_CAP_EMLMR_TRANSITION_DELAY_128US 3#define IEEE80211_EML_CAP_EMLMR_TRANSITION_DELAY_256US 4#define IEEE80211_EML_CAP_EMLMR_SUPPORT 0x0080#define IEEE80211_EML_CAP_TRANSITION_TIMEOUT 0x7800#define IEEE80211_EML_CAP_TRANSITION_TIMEOUT_0 0#define IEEE80211_EML_CAP_TRANSITION_TIMEOUT_128US 1#define IEEE80211_EML_CAP_TRANSITION_TIMEOUT_256US 2#define IEEE80211_EML_CAP_TRANSITION_TIMEOUT_512US 3#define IEEE80211_EML_CAP_TRANSITION_TIMEOUT_1TU 4#define IEEE80211_EML_CAP_TRANSITION_TIMEOUT_2TU 5#define IEEE80211_EML_CAP_TRANSITION_TIMEOUT_4TU 6#define IEEE80211_EML_CAP_TRANSITION_TIMEOUT_8TU 7#define IEEE80211_EML_CAP_TRANSITION_TIMEOUT_16TU 8#define IEEE80211_EML_CAP_TRANSITION_TIMEOUT_32TU 9#define IEEE80211_EML_CAP_TRANSITION_TIMEOUT_64TU 10
#define IEEE80211_MLD_CAP_OP_MAX_SIMUL_LINKS 0x000f#define IEEE80211_MLD_CAP_OP_SRS_SUPPORT 0x0010#define IEEE80211_MLD_CAP_OP_TID_TO_LINK_MAP_NEG_SUPP 0x0060#define IEEE80211_MLD_CAP_OP_TID_TO_LINK_MAP_NEG_NO_SUPP 0#define IEEE80211_MLD_CAP_OP_TID_TO_LINK_MAP_NEG_SUPP_SAME 1#define IEEE80211_MLD_CAP_OP_TID_TO_LINK_MAP_NEG_RESERVED 2#define IEEE80211_MLD_CAP_OP_TID_TO_LINK_MAP_NEG_SUPP_DIFF 3#define IEEE80211_MLD_CAP_OP_FREQ_SEP_TYPE_IND 0x0f80#define IEEE80211_MLD_CAP_OP_AAR_SUPPORT 0x1000#define IEEE80211_MLD_CAP_OP_LINK_RECONF_SUPPORT 0x2000#define IEEE80211_MLD_CAP_OP_ALIGNED_TWT_SUPPORT 0x4000
struct ieee80211_mle_basic_common_info { u8 len; u8 mld_mac_addr[ETH_ALEN]; u8 variable[];} __packed;
#define IEEE80211_MLC_PREQ_PRES_MLD_ID 0x0010#define IEEE80211_MLC_PREQ_PRES_MLD_MAC_ADDR 0x0020#define IEEE80211_MLC_PREQ_PRES_NEIGH_AP_MLD_MAC_ADDR 0x0040
struct ieee80211_mle_preq_common_info { u8 len; u8 variable[];} __packed;
#define IEEE80211_MLC_RECONF_PRES_MLD_MAC_ADDR 0x0010#define IEEE80211_MLC_RECONF_PRES_EML_CAPA 0x0020#define IEEE80211_MLC_RECONF_PRES_MLD_CAPA_OP 0x0040#define IEEE80211_MLC_RECONF_PRES_EXT_MLD_CAPA_OP 0x0080#define IEEE80211_MLC_RECONF_PRES_TARGET_AP_MLD_ADDR 0x0100
/* no fixed fields in RECONF */
struct ieee80211_mle_tdls_common_info { u8 len; u8 ap_mld_mac_addr[ETH_ALEN];} __packed;
#define IEEE80211_MLC_PRIO_ACCESS_PRES_AP_MLD_MAC_ADDR 0x0010
#define IEEE80211_EML_CTRL_EMLSR_MODE BIT(0)#define IEEE80211_EML_CTRL_EMLMR_MODE BIT(1)#define IEEE80211_EML_CTRL_EMLSR_PARAM_UPDATE BIT(2)#define IEEE80211_EML_CTRL_INDEV_COEX_ACT BIT(3)
#define IEEE80211_EML_EMLSR_PAD_DELAY 0x07#define IEEE80211_EML_EMLSR_TRANS_DELAY 0x38
#define IEEE80211_EML_EMLMR_RX_MCS_MAP 0xf0#define IEEE80211_EML_EMLMR_TX_MCS_MAP 0x0f
/* no fixed fields in PRIO_ACCESS */
/** * ieee80211_mle_common_size - check multi-link element common size * @data: multi-link element, must already be checked for size using * ieee80211_mle_size_ok() * Return: the size of the multi-link element's "common" subfield */static inline u8 ieee80211_mle_common_size(const u8 *data){ const struct ieee80211_multi_link_elem *mle = (const void *)data; u16 control = le16_to_cpu(mle->control);
switch (u16_get_bits(control, IEEE80211_ML_CONTROL_TYPE)) { case IEEE80211_ML_CONTROL_TYPE_BASIC: case IEEE80211_ML_CONTROL_TYPE_PREQ: case IEEE80211_ML_CONTROL_TYPE_TDLS: case IEEE80211_ML_CONTROL_TYPE_RECONF: case IEEE80211_ML_CONTROL_TYPE_PRIO_ACCESS: /* * The length is the first octet pointed by mle->variable so no * need to add anything */ break; default: WARN_ON(1); return 0; }
return sizeof(*mle) + mle->variable[0];}
/** * ieee80211_mle_get_link_id - returns the link ID * @data: the basic multi link element * Return: the link ID, or -1 if not present * * The element is assumed to be of the correct type (BASIC) and big enough, * this must be checked using ieee80211_mle_type_ok(). */static inline int ieee80211_mle_get_link_id(const u8 *data){ const struct ieee80211_multi_link_elem *mle = (const void *)data; u16 control = le16_to_cpu(mle->control); const u8 *common = mle->variable;
/* common points now at the beginning of ieee80211_mle_basic_common_info */ common += sizeof(struct ieee80211_mle_basic_common_info);
if (!(control & IEEE80211_MLC_BASIC_PRES_LINK_ID)) return -1;
return *common;}
/** * ieee80211_mle_get_bss_param_ch_cnt - returns the BSS parameter change count * @data: pointer to the basic multi link element * Return: the BSS Parameter Change Count field value, or -1 if not present * * The element is assumed to be of the correct type (BASIC) and big enough, * this must be checked using ieee80211_mle_type_ok(). */static inline intieee80211_mle_get_bss_param_ch_cnt(const u8 *data){ const struct ieee80211_multi_link_elem *mle = (const void *)data; u16 control = le16_to_cpu(mle->control); const u8 *common = mle->variable;
/* common points now at the beginning of ieee80211_mle_basic_common_info */ common += sizeof(struct ieee80211_mle_basic_common_info);
if (!(control & IEEE80211_MLC_BASIC_PRES_BSS_PARAM_CH_CNT)) return -1;
if (control & IEEE80211_MLC_BASIC_PRES_LINK_ID) common += 1;
return *common;}
/** * ieee80211_mle_get_eml_med_sync_delay - returns the medium sync delay * @data: pointer to the multi-link element * Return: the medium synchronization delay field value from the multi-link * element, or the default value (%IEEE80211_MED_SYNC_DELAY_DEFAULT) * if not present * * The element is assumed to be of the correct type (BASIC) and big enough, * this must be checked using ieee80211_mle_type_ok(). */static inline u16 ieee80211_mle_get_eml_med_sync_delay(const u8 *data){ const struct ieee80211_multi_link_elem *mle = (const void *)data; u16 control = le16_to_cpu(mle->control); const u8 *common = mle->variable;
/* common points now at the beginning of ieee80211_mle_basic_common_info */ common += sizeof(struct ieee80211_mle_basic_common_info);
if (!(control & IEEE80211_MLC_BASIC_PRES_MED_SYNC_DELAY)) return IEEE80211_MED_SYNC_DELAY_DEFAULT;
if (control & IEEE80211_MLC_BASIC_PRES_LINK_ID) common += 1; if (control & IEEE80211_MLC_BASIC_PRES_BSS_PARAM_CH_CNT) common += 1;
return get_unaligned_le16(common);}
/** * ieee80211_mle_get_eml_cap - returns the EML capability * @data: pointer to the multi-link element * Return: the EML capability field value from the multi-link element, * or 0 if not present * * The element is assumed to be of the correct type (BASIC) and big enough, * this must be checked using ieee80211_mle_type_ok(). */static inline u16 ieee80211_mle_get_eml_cap(const u8 *data){ const struct ieee80211_multi_link_elem *mle = (const void *)data; u16 control = le16_to_cpu(mle->control); const u8 *common = mle->variable;
/* common points now at the beginning of ieee80211_mle_basic_common_info */ common += sizeof(struct ieee80211_mle_basic_common_info);
if (!(control & IEEE80211_MLC_BASIC_PRES_EML_CAPA)) return 0;
if (control & IEEE80211_MLC_BASIC_PRES_LINK_ID) common += 1; if (control & IEEE80211_MLC_BASIC_PRES_BSS_PARAM_CH_CNT) common += 1; if (control & IEEE80211_MLC_BASIC_PRES_MED_SYNC_DELAY) common += 2;
return get_unaligned_le16(common);}
/** * ieee80211_mle_get_mld_capa_op - returns the MLD capabilities and operations. * @data: pointer to the multi-link element * Return: the MLD capabilities and operations field value from the multi-link * element, or 0 if not present * * The element is assumed to be of the correct type (BASIC) and big enough, * this must be checked using ieee80211_mle_type_ok(). */static inline u16 ieee80211_mle_get_mld_capa_op(const u8 *data){ const struct ieee80211_multi_link_elem *mle = (const void *)data; u16 control = le16_to_cpu(mle->control); const u8 *common = mle->variable;
/* * common points now at the beginning of * ieee80211_mle_basic_common_info */ common += sizeof(struct ieee80211_mle_basic_common_info);
if (!(control & IEEE80211_MLC_BASIC_PRES_MLD_CAPA_OP)) return 0;
if (control & IEEE80211_MLC_BASIC_PRES_LINK_ID) common += 1; if (control & IEEE80211_MLC_BASIC_PRES_BSS_PARAM_CH_CNT) common += 1; if (control & IEEE80211_MLC_BASIC_PRES_MED_SYNC_DELAY) common += 2; if (control & IEEE80211_MLC_BASIC_PRES_EML_CAPA) common += 2;
return get_unaligned_le16(common);}
/* Defined in Figure 9-1074t in P802.11be_D7.0 */#define IEEE80211_EHT_ML_EXT_MLD_CAPA_OP_PARAM_UPDATE 0x0001#define IEEE80211_EHT_ML_EXT_MLD_CAPA_OP_RECO_MAX_LINKS_MASK 0x001e#define IEEE80211_EHT_ML_EXT_MLD_CAPA_NSTR_UPDATE 0x0020#define IEEE80211_EHT_ML_EXT_MLD_CAPA_EMLSR_ENA_ON_ONE_LINK 0x0040#define IEEE80211_EHT_ML_EXT_MLD_CAPA_BTM_MLD_RECO_MULTI_AP 0x0080/* defined by UHR Draft P802.11bn_D1.5 Figure 9-1168 */#define IEEE80211_UHR_ML_EXT_MLD_CAPA_ML_PM 0x0100
/** * ieee80211_mle_get_ext_mld_capa_op - returns the extended MLD capabilities * and operations. * @data: pointer to the multi-link element * Return: the extended MLD capabilities and operations field value from * the multi-link element, or 0 if not present * * The element is assumed to be of the correct type (BASIC) and big enough, * this must be checked using ieee80211_mle_type_ok(). */static inline u16 ieee80211_mle_get_ext_mld_capa_op(const u8 *data){ const struct ieee80211_multi_link_elem *mle = (const void *)data; u16 control = le16_to_cpu(mle->control); const u8 *common = mle->variable;
/* * common points now at the beginning of * ieee80211_mle_basic_common_info */ common += sizeof(struct ieee80211_mle_basic_common_info);
if (!(control & IEEE80211_MLC_BASIC_PRES_EXT_MLD_CAPA_OP)) return 0;
if (control & IEEE80211_MLC_BASIC_PRES_LINK_ID) common += 1; if (control & IEEE80211_MLC_BASIC_PRES_BSS_PARAM_CH_CNT) common += 1; if (control & IEEE80211_MLC_BASIC_PRES_MED_SYNC_DELAY) common += 2; if (control & IEEE80211_MLC_BASIC_PRES_EML_CAPA) common += 2; if (control & IEEE80211_MLC_BASIC_PRES_MLD_CAPA_OP) common += 2; if (control & IEEE80211_MLC_BASIC_PRES_MLD_ID) common += 1;
return get_unaligned_le16(common);}
/** * ieee80211_mle_get_enh_crit_upd_info - returns the enhanced critical * updates information * @data: pointer to the multi-link element * Return: the enhanced critical updates information field, or %NULL * * The element is assumed to be of the correct type (BASIC) and big enough, * this must be checked using ieee80211_mle_type_ok(). */static inline const struct ieee80211_enh_crit_upd *ieee80211_mle_get_enh_crit_upd_info(const u8 *data){ const struct ieee80211_multi_link_elem *mle = (const void *)data; u16 control = le16_to_cpu(mle->control); const u8 *common = mle->variable;
/* * common points now at the beginning of * ieee80211_mle_basic_common_info */ common += sizeof(struct ieee80211_mle_basic_common_info);
if (!(control & IEEE80211_MLC_BASIC_PRES_ENH_CRIT_UPD)) return NULL;
if (control & IEEE80211_MLC_BASIC_PRES_LINK_ID) common += 1; if (control & IEEE80211_MLC_BASIC_PRES_BSS_PARAM_CH_CNT) common += 1; if (control & IEEE80211_MLC_BASIC_PRES_MED_SYNC_DELAY) common += 2; if (control & IEEE80211_MLC_BASIC_PRES_EML_CAPA) common += 2; if (control & IEEE80211_MLC_BASIC_PRES_MLD_CAPA_OP) common += 2; if (control & IEEE80211_MLC_BASIC_PRES_MLD_ID) common += 1; if (control & IEEE80211_MLC_BASIC_PRES_EXT_MLD_CAPA_OP) common += 2;
return (const void *)common;}
/** * ieee80211_mle_get_mld_id - returns the MLD ID * @data: pointer to the multi-link element * Return: The MLD ID in the given multi-link element, or 0 if not present * * The element is assumed to be of the correct type (BASIC) and big enough, * this must be checked using ieee80211_mle_type_ok(). */static inline u8 ieee80211_mle_get_mld_id(const u8 *data){ const struct ieee80211_multi_link_elem *mle = (const void *)data; u16 control = le16_to_cpu(mle->control); const u8 *common = mle->variable;
/* * common points now at the beginning of * ieee80211_mle_basic_common_info */ common += sizeof(struct ieee80211_mle_basic_common_info);
if (!(control & IEEE80211_MLC_BASIC_PRES_MLD_ID)) return 0;
if (control & IEEE80211_MLC_BASIC_PRES_LINK_ID) common += 1; if (control & IEEE80211_MLC_BASIC_PRES_BSS_PARAM_CH_CNT) common += 1; if (control & IEEE80211_MLC_BASIC_PRES_MED_SYNC_DELAY) common += 2; if (control & IEEE80211_MLC_BASIC_PRES_EML_CAPA) common += 2; if (control & IEEE80211_MLC_BASIC_PRES_MLD_CAPA_OP) common += 2;
return *common;}
/** * ieee80211_mle_size_ok - validate multi-link element size * @data: pointer to the element data * @len: length of the containing element * Return: whether or not the multi-link element size is OK */static inline bool ieee80211_mle_size_ok(const u8 *data, size_t len){ const struct ieee80211_multi_link_elem *mle = (const void *)data; u8 fixed = sizeof(*mle); u8 common = 0; u8 common_len; u16 control;
if (!data || len < fixed) return false;
control = le16_to_cpu(mle->control);
switch (u16_get_bits(control, IEEE80211_ML_CONTROL_TYPE)) { case IEEE80211_ML_CONTROL_TYPE_BASIC: common += sizeof(struct ieee80211_mle_basic_common_info); if (control & IEEE80211_MLC_BASIC_PRES_LINK_ID) common += 1; if (control & IEEE80211_MLC_BASIC_PRES_BSS_PARAM_CH_CNT) common += 1; if (control & IEEE80211_MLC_BASIC_PRES_MED_SYNC_DELAY) common += 2; if (control & IEEE80211_MLC_BASIC_PRES_EML_CAPA) common += 2; if (control & IEEE80211_MLC_BASIC_PRES_MLD_CAPA_OP) common += 2; if (control & IEEE80211_MLC_BASIC_PRES_MLD_ID) common += 1; if (control & IEEE80211_MLC_BASIC_PRES_EXT_MLD_CAPA_OP) common += 2; if (control & IEEE80211_MLC_BASIC_PRES_ENH_CRIT_UPD) common += 1; if (control & IEEE80211_MLC_BASIC_PRES_AGE_OF_BSS_LOAD) common += 1; break; case IEEE80211_ML_CONTROL_TYPE_PREQ: common += sizeof(struct ieee80211_mle_preq_common_info); if (control & IEEE80211_MLC_PREQ_PRES_MLD_ID) common += 1; if (control & IEEE80211_MLC_PREQ_PRES_MLD_MAC_ADDR) common += ETH_ALEN; if (control & IEEE80211_MLC_PREQ_PRES_NEIGH_AP_MLD_MAC_ADDR) common += ETH_ALEN; break; case IEEE80211_ML_CONTROL_TYPE_RECONF: common += 1; if (control & IEEE80211_MLC_RECONF_PRES_MLD_MAC_ADDR) common += ETH_ALEN; if (control & IEEE80211_MLC_RECONF_PRES_EML_CAPA) common += 2; if (control & IEEE80211_MLC_RECONF_PRES_MLD_CAPA_OP) common += 2; if (control & IEEE80211_MLC_RECONF_PRES_EXT_MLD_CAPA_OP) common += 2; if (control & IEEE80211_MLC_RECONF_PRES_TARGET_AP_MLD_ADDR) common += ETH_ALEN; break; case IEEE80211_ML_CONTROL_TYPE_TDLS: common += sizeof(struct ieee80211_mle_tdls_common_info); break; case IEEE80211_ML_CONTROL_TYPE_PRIO_ACCESS: common = ETH_ALEN + 1; break; default: /* we don't know this type */ return true; }
if (len < fixed + common) return false;
common_len = mle->variable[0];
return common_len >= common && common_len <= len - fixed;}
/** * ieee80211_mle_type_ok - validate multi-link element type and size * @data: pointer to the element data * @type: expected type of the element * @len: length of the containing element * Return: whether or not the multi-link element type matches and size is OK */static inline bool ieee80211_mle_type_ok(const u8 *data, u8 type, size_t len){ const struct ieee80211_multi_link_elem *mle = (const void *)data; u16 control;
if (!ieee80211_mle_size_ok(data, len)) return false;
control = le16_to_cpu(mle->control);
if (u16_get_bits(control, IEEE80211_ML_CONTROL_TYPE) == type) return true;
return false;}
enum ieee80211_mle_subelems { IEEE80211_MLE_SUBELEM_PER_STA_PROFILE = 0, IEEE80211_MLE_SUBELEM_FRAGMENT = 254,};
#define IEEE80211_MLE_STA_CONTROL_LINK_ID 0x000f#define IEEE80211_MLE_STA_CONTROL_COMPLETE_PROFILE 0x0010#define IEEE80211_MLE_STA_CONTROL_STA_MAC_ADDR_PRESENT 0x0020#define IEEE80211_MLE_STA_CONTROL_BEACON_INT_PRESENT 0x0040#define IEEE80211_MLE_STA_CONTROL_TSF_OFFS_PRESENT 0x0080#define IEEE80211_MLE_STA_CONTROL_DTIM_INFO_PRESENT 0x0100#define IEEE80211_MLE_STA_CONTROL_NSTR_LINK_PAIR_PRESENT 0x0200#define IEEE80211_MLE_STA_CONTROL_NSTR_BITMAP_SIZE 0x0400#define IEEE80211_MLE_STA_CONTROL_BSS_PARAM_CHANGE_CNT_PRESENT 0x0800#define IEEE80211_MLE_STA_CONTROL_ENH_CRIT_UPD_PRESENT 0x1000#define IEEE80211_MLE_STA_CONTROL_AP_CONDUCTED_TX_PWR_PRESENT 0x2000#define IEEE80211_MLE_STA_CONTROL_AGE_OF_BSS_LOAD_PRESENT 0x4000
struct ieee80211_mle_per_sta_profile { __le16 control; u8 sta_info_len; u8 variable[];} __packed;
/** * ieee80211_mle_basic_sta_prof_size_ok - validate basic multi-link element sta * profile size * @data: pointer to the sub element data * @len: length of the containing sub element * Return: %true if the STA profile is large enough, %false otherwise */static inline bool ieee80211_mle_basic_sta_prof_size_ok(const u8 *data, size_t len){ const struct ieee80211_mle_per_sta_profile *prof = (const void *)data; u16 control; u8 fixed = sizeof(*prof); u8 info_len = 1;
if (len < fixed) return false;
control = le16_to_cpu(prof->control);
if (control & IEEE80211_MLE_STA_CONTROL_STA_MAC_ADDR_PRESENT) info_len += 6; if (control & IEEE80211_MLE_STA_CONTROL_BEACON_INT_PRESENT) info_len += 2; if (control & IEEE80211_MLE_STA_CONTROL_TSF_OFFS_PRESENT) info_len += 8; if (control & IEEE80211_MLE_STA_CONTROL_DTIM_INFO_PRESENT) info_len += 2; if (control & IEEE80211_MLE_STA_CONTROL_COMPLETE_PROFILE && control & IEEE80211_MLE_STA_CONTROL_NSTR_LINK_PAIR_PRESENT) { if (control & IEEE80211_MLE_STA_CONTROL_NSTR_BITMAP_SIZE) info_len += 2; else info_len += 1; } if (control & IEEE80211_MLE_STA_CONTROL_BSS_PARAM_CHANGE_CNT_PRESENT) info_len += 1;
if (control & IEEE80211_MLE_STA_CONTROL_ENH_CRIT_UPD_PRESENT) info_len += 1;
if (control & IEEE80211_MLE_STA_CONTROL_AP_CONDUCTED_TX_PWR_PRESENT) info_len += 1;
if (control & IEEE80211_MLE_STA_CONTROL_AGE_OF_BSS_LOAD_PRESENT) info_len += 1;
return prof->sta_info_len >= info_len && fixed + prof->sta_info_len - 1 <= len;}
/** * ieee80211_mle_basic_sta_prof_bss_param_ch_cnt - get per-STA profile BSS * parameter change count * @prof: the per-STA profile, having been checked with * ieee80211_mle_basic_sta_prof_size_ok() for the correct length * * Return: The BSS parameter change count value if present, 0 otherwise. */static inline u8ieee80211_mle_basic_sta_prof_bss_param_ch_cnt(const struct ieee80211_mle_per_sta_profile *prof){ u16 control = le16_to_cpu(prof->control); const u8 *pos = prof->variable;
if (!(control & IEEE80211_MLE_STA_CONTROL_BSS_PARAM_CHANGE_CNT_PRESENT)) return 0;
if (control & IEEE80211_MLE_STA_CONTROL_STA_MAC_ADDR_PRESENT) pos += 6; if (control & IEEE80211_MLE_STA_CONTROL_BEACON_INT_PRESENT) pos += 2; if (control & IEEE80211_MLE_STA_CONTROL_TSF_OFFS_PRESENT) pos += 8; if (control & IEEE80211_MLE_STA_CONTROL_DTIM_INFO_PRESENT) pos += 2; if (control & IEEE80211_MLE_STA_CONTROL_COMPLETE_PROFILE && control & IEEE80211_MLE_STA_CONTROL_NSTR_LINK_PAIR_PRESENT) { if (control & IEEE80211_MLE_STA_CONTROL_NSTR_BITMAP_SIZE) pos += 2; else pos += 1; }
return *pos;}
/** * ieee80211_mle_basic_sta_prof_enh_crit_upd - get per-STA profile enhanced * critical updates field * @prof: the per-STA profile, having been checked with * ieee80211_mle_basic_sta_prof_size_ok() for the correct length * * Return: The enhanced critical updates field if present, %NULL otherwise. */static inline const struct ieee80211_enh_crit_upd *ieee80211_mle_basic_sta_prof_enh_crit_upd(const struct ieee80211_mle_per_sta_profile *prof){ u16 control = le16_to_cpu(prof->control); const u8 *pos = prof->variable;
if (!(control & IEEE80211_MLE_STA_CONTROL_ENH_CRIT_UPD_PRESENT)) return NULL;
if (control & IEEE80211_MLE_STA_CONTROL_STA_MAC_ADDR_PRESENT) pos += 6; if (control & IEEE80211_MLE_STA_CONTROL_BEACON_INT_PRESENT) pos += 2; if (control & IEEE80211_MLE_STA_CONTROL_TSF_OFFS_PRESENT) pos += 8; if (control & IEEE80211_MLE_STA_CONTROL_DTIM_INFO_PRESENT) pos += 2; if (control & IEEE80211_MLE_STA_CONTROL_COMPLETE_PROFILE && control & IEEE80211_MLE_STA_CONTROL_NSTR_LINK_PAIR_PRESENT) { if (control & IEEE80211_MLE_STA_CONTROL_NSTR_BITMAP_SIZE) pos += 2; else pos += 1; } if (control & IEEE80211_MLE_STA_CONTROL_BSS_PARAM_CHANGE_CNT_PRESENT) pos += 1;
return (const void *)pos;}
#define IEEE80211_MLE_STA_RECONF_CONTROL_LINK_ID 0x000f#define IEEE80211_MLE_STA_RECONF_CONTROL_COMPLETE_PROFILE 0x0010#define IEEE80211_MLE_STA_RECONF_CONTROL_STA_MAC_ADDR_PRESENT 0x0020#define IEEE80211_MLE_STA_RECONF_CONTROL_AP_REM_TIMER_PRESENT 0x0040#define IEEE80211_MLE_STA_RECONF_CONTROL_OPERATION_TYPE 0x0780#define IEEE80211_MLE_STA_RECONF_CONTROL_OPERATION_TYPE_AP_REM 0#define IEEE80211_MLE_STA_RECONF_CONTROL_OPERATION_TYPE_OP_PARAM_UPDATE 1#define IEEE80211_MLE_STA_RECONF_CONTROL_OPERATION_TYPE_ADD_LINK 2#define IEEE80211_MLE_STA_RECONF_CONTROL_OPERATION_TYPE_DEL_LINK 3#define IEEE80211_MLE_STA_RECONF_CONTROL_OPERATION_TYPE_NSTR_STATUS 4#define IEEE80211_MLE_STA_RECONF_CONTROL_OPERATION_TYPE_UHR_OMP_UPD 5#define IEEE80211_MLE_STA_RECONF_CONTROL_OPERATION_PARAMS_PRESENT 0x0800#define IEEE80211_MLE_STA_RECONF_CONTROL_OPERATION_NSTR_BMAP_SIZE 0x1000#define IEEE80211_MLE_STA_RECONF_CONTROL_OPERATION_NSTR_IND_BMAP_PRES 0x2000#define IEEE80211_MLE_STA_RECONF_CONTROL_OPERATION_DSO_INFO_PRESENT 0x4000
/** * ieee80211_mle_reconf_sta_prof_size_ok - validate reconfiguration multi-link * element sta profile size. * @data: pointer to the sub element data * @len: length of the containing sub element * Return: %true if the STA profile is large enough, %false otherwise */static inline bool ieee80211_mle_reconf_sta_prof_size_ok(const u8 *data, size_t len){ const struct ieee80211_mle_per_sta_profile *prof = (const void *)data; u16 control; u8 fixed = sizeof(*prof); u8 info_len = 1;
if (len < fixed) return false;
control = le16_to_cpu(prof->control);
if (control & IEEE80211_MLE_STA_RECONF_CONTROL_STA_MAC_ADDR_PRESENT) info_len += ETH_ALEN; if (control & IEEE80211_MLE_STA_RECONF_CONTROL_AP_REM_TIMER_PRESENT) info_len += 2; if (control & IEEE80211_MLE_STA_RECONF_CONTROL_OPERATION_PARAMS_PRESENT) info_len += 2;
return prof->sta_info_len >= info_len && fixed + prof->sta_info_len - 1 <= len;}
#define IEEE80211_MLE_STA_EPCS_CONTROL_LINK_ID 0x000f#define IEEE80211_EPCS_ENA_RESP_BODY_LEN 3
static inline bool ieee80211_tid_to_link_map_size_ok(const u8 *data, size_t len){ const struct ieee80211_ttlm_elem *t2l = (const void *)data; u8 control, fixed = sizeof(*t2l), elem_len = 0;
if (len < fixed) return false;
control = t2l->control;
if (control & IEEE80211_TTLM_CONTROL_SWITCH_TIME_PRESENT) elem_len += 2; if (control & IEEE80211_TTLM_CONTROL_EXPECTED_DUR_PRESENT) elem_len += 3;
if (!(control & IEEE80211_TTLM_CONTROL_DEF_LINK_MAP)) { u8 bm_size;
elem_len += 1; if (len < fixed + elem_len) return false;
if (control & IEEE80211_TTLM_CONTROL_LINK_MAP_SIZE) bm_size = 1; else bm_size = 2;
elem_len += hweight8(t2l->optional[0]) * bm_size; }
return len >= fixed + elem_len;}
/** * ieee80211_emlsr_pad_delay_in_us - Fetch the EMLSR Padding delay * in microseconds * @eml_cap: EML capabilities field value from common info field of * the Multi-link element * Return: the EMLSR Padding delay (in microseconds) encoded in the * EML Capabilities field */
static inline u32 ieee80211_emlsr_pad_delay_in_us(u16 eml_cap){ u32 emlsr_supp = u16_get_bits(eml_cap, IEEE80211_EML_CAP_EMLSR_SUPP);
if (!emlsr_supp) return 0;
/* IEEE Std 802.11be-2024 Table 9-417i—Encoding of the EMLSR * Padding Delay subfield. */ u32 pad_delay = u16_get_bits(eml_cap, IEEE80211_EML_CAP_EML_PADDING_DELAY);
if (!pad_delay || pad_delay > IEEE80211_EML_CAP_EML_PADDING_DELAY_256US) return 0;
return 32 * (1 << (pad_delay - 1));}
/** * ieee80211_emlsr_trans_delay_in_us - Fetch the EMLSR Transition * delay in microseconds * @eml_cap: EML capabilities field value from common info field of * the Multi-link element * Return: the EMLSR Transition delay (in microseconds) encoded in the * EML Capabilities field */
static inline u32 ieee80211_emlsr_trans_delay_in_us(u16 eml_cap){ u32 emlsr_supp = u16_get_bits(eml_cap, IEEE80211_EML_CAP_EMLSR_SUPP);
if (!emlsr_supp) return 0;
/* IEEE Std 802.11be-2024 Table 9-417j—Encoding of the EMLSR * Transition Delay subfield. */ u32 trans_delay = u16_get_bits(eml_cap, IEEE80211_EML_CAP_EML_TRANSITION_DELAY);
/* invalid values also just use 0 */ if (!trans_delay || trans_delay > IEEE80211_EML_CAP_EMLSR_TRANSITION_DELAY_256US) return 0;
return 16 * (1 << (trans_delay - 1));}
/** * ieee80211_emlmr_pad_delay_in_us - Fetch the EMLMR Padding delay * in microseconds * @eml_cap: EML capabilities field value from common info field of * the Multi-link element * Return: the EMLMR Padding delay (in microseconds) encoded in the * EML Capabilities field */
static inline u32 ieee80211_emlmr_pad_delay_in_us(u16 eml_cap){ u32 emlmr_supp = u16_get_bits(eml_cap, IEEE80211_EML_CAP_EMLMR_SUPPORT);
if (!emlmr_supp) return 0;
/* IEEE Std 802.11be-2024 Table 9-417k—Encoding of the EMLMR * Padding Delay subfield. */ u32 pad_delay = u16_get_bits(eml_cap, IEEE80211_EML_CAP_EML_PADDING_DELAY);
if (!pad_delay || pad_delay > IEEE80211_EML_CAP_EML_PADDING_DELAY_256US) return 0;
return 32 * (1 << (pad_delay - 1));}
/** * ieee80211_emlmr_trans_delay_in_us - Fetch the EMLMR Transition * delay in microseconds * @eml_cap: EML capabilities field value from common info field of * the Multi-link element * Return: the EMLMR Transition delay (in microseconds) encoded in the * EML Capabilities field */
static inline u32 ieee80211_emlmr_trans_delay_in_us(u16 eml_cap){ u32 emlmr_supp = u16_get_bits(eml_cap, IEEE80211_EML_CAP_EMLMR_SUPPORT);
if (!emlmr_supp) return 0;
/* IEEE Std 802.11be-2024 Table 9-417l—Encoding of the EMLMR * Transition Delay subfield. */ u32 trans_delay = u16_get_bits(eml_cap, IEEE80211_EML_CAP_EML_TRANSITION_DELAY);
/* invalid values also just use 0 */ if (!trans_delay || trans_delay > IEEE80211_EML_CAP_EMLMR_TRANSITION_DELAY_256US) return 0;
return 32 * (1 << (trans_delay - 1));}
/** * ieee80211_eml_trans_timeout_in_us - Fetch the EML Transition * timeout value in microseconds * @eml_cap: EML capabilities field value from common info field of * the Multi-link element * Return: the EML Transition timeout (in microseconds) encoded in * the EML Capabilities field */
static inline u32 ieee80211_eml_trans_timeout_in_us(u16 eml_cap){ /* IEEE Std 802.11be-2024 Table 9-417m—Encoding of the * Transition Timeout subfield. */ u8 timeout = u16_get_bits(eml_cap, IEEE80211_EML_CAP_TRANSITION_TIMEOUT);
/* invalid values also just use 0 */ if (!timeout || timeout > IEEE80211_EML_CAP_TRANSITION_TIMEOUT_64TU) return 0;
return 128 * (1 << (timeout - 1));}
#define for_each_mle_subelement(_elem, _data, _len) \ if (ieee80211_mle_size_ok(_data, _len)) \ for_each_element(_elem, \ _data + ieee80211_mle_common_size(_data),\ _len - ieee80211_mle_common_size(_data))
#endif /* LINUX_IEEE80211_EHT_H */