xref: /freebsd/sys/compat/linuxkpi/common/include/linux/ieee80211.h (revision 2ab7cbdc346e2a174a7bee4ce44c4f78b1ca093b)
1 /*-
2  * Copyright (c) 2020-2025 The FreeBSD Foundation
3  *
4  * This software was developed by Björn Zeeb under sponsorship from
5  * the FreeBSD Foundation.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  * 1. Redistributions of source code must retain the above copyright
11  *    notice, this list of conditions and the following disclaimer.
12  * 2. Redistributions in binary form must reproduce the above copyright
13  *    notice, this list of conditions and the following disclaimer in the
14  *    documentation and/or other materials provided with the distribution.
15  *
16  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26  * SUCH DAMAGE.
27  */
28 
29 #ifndef	_LINUXKPI_LINUX_IEEE80211_H
30 #define	_LINUXKPI_LINUX_IEEE80211_H
31 
32 #include <sys/types.h>
33 #include <net80211/ieee80211.h>
34 
35 #include <asm/unaligned.h>
36 #include <linux/kernel.h>
37 #include <linux/bitops.h>
38 #include <linux/if_ether.h>
39 
40 /* linux_80211.c */
41 extern int linuxkpi_debug_80211;
42 #ifndef	D80211_TODO
43 #define	D80211_TODO		0x1
44 #endif
45 #define	TODO(fmt, ...)		if (linuxkpi_debug_80211 & D80211_TODO)	\
46     printf("%s:%d: XXX LKPI80211 TODO " fmt "\n", __func__, __LINE__, ##__VA_ARGS__)
47 
48 
49 /* 9.4.2.55 Management MIC element (CMAC-256, GMAC-128, and GMAC-256). */
50 struct ieee80211_mmie_16 {
51 	uint8_t		element_id;
52 	uint8_t		length;
53 	uint16_t	key_id;
54 	uint8_t		ipn[6];
55 	uint8_t		mic[16];
56 };
57 
58 #define	IEEE80211_CCMP_HDR_LEN			8	/* 802.11i .. net80211 comment */
59 #define	IEEE80211_CCMP_PN_LEN			6
60 #define	IEEE80211_CCMP_MIC_LEN			8	/* || 16 */
61 #define	IEEE80211_CCMP_256_HDR_LEN		8
62 #define	IEEE80211_CCMP_256_MIC_LEN		16
63 #define	IEEE80211_GCMP_HDR_LEN			8
64 #define	IEEE80211_GCMP_MIC_LEN			16
65 #define	IEEE80211_GCMP_PN_LEN			6
66 #define	IEEE80211_GMAC_PN_LEN			6
67 #define	IEEE80211_CMAC_PN_LEN			6
68 
69 #define	IEEE80211_MAX_PN_LEN			16
70 
71 #define	IEEE80211_INVAL_HW_QUEUE		((uint8_t)-1)
72 
73 #define	IEEE80211_MAX_AMPDU_BUF_HT		IEEE80211_AGGR_BAWMAX
74 #define	IEEE80211_MAX_AMPDU_BUF_HE		256
75 #define	IEEE80211_MAX_AMPDU_BUF_EHT		1024
76 
77 #define	IEEE80211_MAX_FRAME_LEN			2352
78 #define	IEEE80211_MAX_DATA_LEN			(2300 + IEEE80211_CRC_LEN)
79 
80 #define	IEEE80211_MAX_MPDU_LEN_HT_BA		4095	/* 9.3.2.1 Format of Data frames; non-VHT non-DMG STA */
81 #define	IEEE80211_MAX_MPDU_LEN_HT_3839		3839
82 #define	IEEE80211_MAX_MPDU_LEN_HT_7935		7935
83 #define	IEEE80211_MAX_MPDU_LEN_VHT_3895		3895
84 #define	IEEE80211_MAX_MPDU_LEN_VHT_7991		7991
85 #define	IEEE80211_MAX_MPDU_LEN_VHT_11454	11454
86 
87 #define	IEEE80211_MAX_RTS_THRESHOLD		2346	/* net80211::IEEE80211_RTS_MAX */
88 
89 #define	IEEE80211_MIN_ACTION_SIZE		23	/* ? */
90 
91 /* Wi-Fi Peer-to-Peer (P2P) Technical Specification */
92 #define	IEEE80211_P2P_OPPPS_CTWINDOW_MASK	0x7f
93 #define	IEEE80211_P2P_OPPPS_ENABLE_BIT		BIT(7)
94 
95 /* 802.11-2016, 9.2.4.5.1, Table 9-6 QoS Control Field */
96 #define	IEEE80211_QOS_CTL_TAG1D_MASK		0x0007
97 #define	IEEE80211_QOS_CTL_TID_MASK		IEEE80211_QOS_TID
98 #define	IEEE80211_QOS_CTL_EOSP			0x0010
99 #define	IEEE80211_QOS_CTL_A_MSDU_PRESENT	0x0080
100 #define	IEEE80211_QOS_CTL_ACK_POLICY_MASK	0x0060
101 #define	IEEE80211_QOS_CTL_ACK_POLICY_NOACK	0x0020
102 #define	IEEE80211_QOS_CTL_MESH_CONTROL_PRESENT	0x0100
103 
104 enum ieee80211_rate_flags {
105 	IEEE80211_RATE_SHORT_PREAMBLE		= BIT(0),
106 };
107 
108 enum ieee80211_rate_control_changed_flags {
109 	IEEE80211_RC_BW_CHANGED			= BIT(0),
110 	IEEE80211_RC_NSS_CHANGED		= BIT(1),
111 	IEEE80211_RC_SUPP_RATES_CHANGED		= BIT(2),
112 	IEEE80211_RC_SMPS_CHANGED		= BIT(3),
113 };
114 
115 #define	IEEE80211_SCTL_FRAG			IEEE80211_SEQ_FRAG_MASK
116 #define	IEEE80211_SCTL_SEQ			IEEE80211_SEQ_SEQ_MASK
117 
118 #define	IEEE80211_TKIP_ICV_LEN			4
119 #define	IEEE80211_TKIP_IV_LEN			8	/* WEP + KID + EXT */
120 
121 /* 802.11-2016, 9.4.2.158.3 Supported VHT-MCS and NSS Set field. */
122 #define	IEEE80211_VHT_EXT_NSS_BW_CAPABLE	(1 << 13)	/* part of tx_highest */
123 
124 #define	IEEE80211_VHT_MAX_AMPDU_1024K		7	/* 9.4.2.56.3 A-MPDU Parameters field, Table 9-163 */
125 
126 #define	IEEE80211_WEP_IV_LEN			3	/* net80211: IEEE80211_WEP_IVLEN */
127 #define	IEEE80211_WEP_ICV_LEN			4
128 
129 #define	WLAN_AUTH_OPEN				__LINE__ /* TODO FIXME brcmfmac */
130 #define	WLAN_CAPABILITY_IBSS			__LINE__ /* TODO FIXME no longer used? */
131 #define	WLAN_CAPABILITY_SHORT_PREAMBLE		__LINE__ /* TODO FIXME brcmfmac */
132 #define	WLAN_CAPABILITY_SHORT_SLOT_TIME		__LINE__ /* TODO FIXME brcmfmac */
133 
134 enum wlan_ht_cap_sm_ps {
135 	WLAN_HT_CAP_SM_PS_STATIC		= 0,
136 	WLAN_HT_CAP_SM_PS_DYNAMIC,
137 	WLAN_HT_CAP_SM_PS_INVALID,
138 	WLAN_HT_CAP_SM_PS_DISABLED,
139 };
140 
141 #define	WLAN_MAX_KEY_LEN			32
142 #define	WLAN_PMKID_LEN				16
143 #define	WLAN_PMK_LEN_SUITE_B_192		48
144 
145 enum ieee80211_key_len {
146 	WLAN_KEY_LEN_WEP40			= 5,
147 	WLAN_KEY_LEN_WEP104			= 13,
148 	WLAN_KEY_LEN_TKIP			= 32,
149 	WLAN_KEY_LEN_CCMP			= 16,
150 	WLAN_KEY_LEN_CCMP_256			= 32,
151 	WLAN_KEY_LEN_GCMP			= 16,
152 	WLAN_KEY_LEN_AES_CMAC			= 16,
153 	WLAN_KEY_LEN_GCMP_256			= 32,
154 	WLAN_KEY_LEN_BIP_CMAC_256		= 32,
155 	WLAN_KEY_LEN_BIP_GMAC_128		= 16,
156 	WLAN_KEY_LEN_BIP_GMAC_256		= 32,
157 };
158 
159 /* 802.11-2020, 9.4.2.55.3, Table 9-185 Subfields of the A-MPDU Parameters field */
160 enum ieee80211_min_mpdu_start_spacing {
161 	IEEE80211_HT_MPDU_DENSITY_NONE		= 0,
162 #if 0
163 	IEEE80211_HT_MPDU_DENSITY_XXX		= 1,	/* 1/4 us */
164 #endif
165 	IEEE80211_HT_MPDU_DENSITY_0_5		= 2,	/* 1/2 us */
166 	IEEE80211_HT_MPDU_DENSITY_1		= 3,	/* 1 us */
167 	IEEE80211_HT_MPDU_DENSITY_2		= 4,	/* 2 us */
168 	IEEE80211_HT_MPDU_DENSITY_4		= 5,	/* 4us */
169 	IEEE80211_HT_MPDU_DENSITY_8		= 6,	/* 8us */
170 	IEEE80211_HT_MPDU_DENSITY_16		= 7, 	/* 16us */
171 };
172 
173 /* 9.4.2.57, Table 9-168, HT Operation element fields and subfields */
174 #define	IEEE80211_HT_STBC_PARAM_DUAL_CTS_PROT	0x0080	/* B24.. */
175 
176 #define	IEEE80211_FCTL_FTYPE			IEEE80211_FC0_TYPE_MASK
177 #define	IEEE80211_FCTL_STYPE			IEEE80211_FC0_SUBTYPE_MASK
178 #define	IEEE80211_FCTL_ORDER			(IEEE80211_FC1_ORDER << 8)
179 #define	IEEE80211_FCTL_PROTECTED		(IEEE80211_FC1_PROTECTED << 8)
180 #define	IEEE80211_FCTL_FROMDS			(IEEE80211_FC1_DIR_FROMDS << 8)
181 #define	IEEE80211_FCTL_TODS			(IEEE80211_FC1_DIR_TODS << 8)
182 #define	IEEE80211_FCTL_MOREFRAGS		(IEEE80211_FC1_MORE_FRAG << 8)
183 #define	IEEE80211_FCTL_PM			(IEEE80211_FC1_PWR_MGT << 8)
184 
185 #define	IEEE80211_FTYPE_MGMT			IEEE80211_FC0_TYPE_MGT
186 #define	IEEE80211_FTYPE_CTL			IEEE80211_FC0_TYPE_CTL
187 #define	IEEE80211_FTYPE_DATA			IEEE80211_FC0_TYPE_DATA
188 
189 #define	IEEE80211_STYPE_ASSOC_REQ		IEEE80211_FC0_SUBTYPE_ASSOC_REQ
190 #define	IEEE80211_STYPE_REASSOC_REQ		IEEE80211_FC0_SUBTYPE_REASSOC_REQ
191 #define	IEEE80211_STYPE_PROBE_REQ		IEEE80211_FC0_SUBTYPE_PROBE_REQ
192 #define	IEEE80211_STYPE_DISASSOC		IEEE80211_FC0_SUBTYPE_DISASSOC
193 #define	IEEE80211_STYPE_AUTH			IEEE80211_FC0_SUBTYPE_AUTH
194 #define	IEEE80211_STYPE_DEAUTH			IEEE80211_FC0_SUBTYPE_DEAUTH
195 #define	IEEE80211_STYPE_CTS			IEEE80211_FC0_SUBTYPE_CTS
196 #define	IEEE80211_STYPE_RTS			IEEE80211_FC0_SUBTYPE_RTS
197 #define	IEEE80211_STYPE_ACTION			IEEE80211_FC0_SUBTYPE_ACTION
198 #define	IEEE80211_STYPE_DATA			IEEE80211_FC0_SUBTYPE_DATA
199 #define	IEEE80211_STYPE_QOS_DATA		IEEE80211_FC0_SUBTYPE_QOS_DATA
200 #define	IEEE80211_STYPE_QOS_NULLFUNC		IEEE80211_FC0_SUBTYPE_QOS_NULL
201 #define	IEEE80211_STYPE_QOS_CFACK		0xd0	/* XXX-BZ reserved? */
202 
203 #define	IEEE80211_NUM_ACS			4	/* net8021::WME_NUM_AC */
204 
205 #define	IEEE80211_MAX_SSID_LEN			32	/* 9.4.2.2 SSID element, net80211: IEEE80211_NWID_LEN */
206 
207 
208 /* Figure 9-27, BAR Control field */
209 #define	IEEE80211_BAR_CTRL_TID_INFO_MASK	0xf000
210 #define	IEEE80211_BAR_CTRL_TID_INFO_SHIFT	12
211 
212 #define	IEEE80211_PPE_THRES_INFO_PPET_SIZE		1 /* TODO FIXME ax? */
213 #define	IEEE80211_PPE_THRES_NSS_MASK			2 /* TODO FIXME ax? */
214 #define	IEEE80211_PPE_THRES_RU_INDEX_BITMASK_POS	3 /* TODO FIXME ax? */
215 #define	IEEE80211_PPE_THRES_RU_INDEX_BITMASK_MASK	8 /* TODO FIXME ax? */
216 #define	IEEE80211_HE_PPE_THRES_INFO_HEADER_SIZE		16	/* TODO FIXME ax? */
217 
218 /* 802.11-2012, Table 8-130-HT Operation element fields and subfields, HT Protection */
219 #define	IEEE80211_HT_OP_MODE_PROTECTION			IEEE80211_HTINFO_OPMODE		/* Mask. */
220 #define	IEEE80211_HT_OP_MODE_PROTECTION_NONE		IEEE80211_HTINFO_OPMODE_PURE	/* No protection */
221 #define	IEEE80211_HT_OP_MODE_PROTECTION_NONMEMBER	IEEE80211_HTINFO_OPMODE_PROTOPT	/* Nonmember protection */
222 #define	IEEE80211_HT_OP_MODE_PROTECTION_20MHZ		IEEE80211_HTINFO_OPMODE_HT20PR	/* 20 MHz protection */
223 #define	IEEE80211_HT_OP_MODE_PROTECTION_NONHT_MIXED	IEEE80211_HTINFO_OPMODE_MIXED	/* Non-HT mixed */
224 
225 
226 /* 9.6.13.1, Table 9-342 TDLS Action field values. */
227 enum ieee80211_tdls_action_code {
228 	WLAN_TDLS_SETUP_REQUEST			= 0,
229 	WLAN_TDLS_SETUP_RESPONSE		= 1,
230 	WLAN_TDLS_SETUP_CONFIRM			= 2,
231 	WLAN_TDLS_TEARDOWN			= 3,
232 	WLAN_TDLS_PEER_TRAFFIC_INDICATION	= 4,
233 	WLAN_TDLS_CHANNEL_SWITCH_REQUEST	= 5,
234 	WLAN_TDLS_CHANNEL_SWITCH_RESPONSE	= 6,
235 	WLAN_TDLS_PEER_PSM_REQUEST		= 7,
236 	WLAN_TDLS_PEER_PSM_RESPONSE		= 8,
237 	WLAN_TDLS_PEER_TRAFFIC_RESPONSE		= 9,
238 	WLAN_TDLS_DISCOVERY_REQUEST		= 10,
239 	/* 11-255 reserved */
240 };
241 
242 /* 802.11-2020 9.4.2.26, Table 9-153. Extended Capabilities field. */
243 /* This is split up into octets CAPA1 = octet 1, ... */
244 #define	WLAN_EXT_CAPA1_EXT_CHANNEL_SWITCHING			BIT(2  % 8)
245 #define	WLAN_EXT_CAPA3_MULTI_BSSID_SUPPORT			BIT(22 % 8)
246 #define	WLAN_EXT_CAPA3_TIMING_MEASUREMENT_SUPPORT		BIT(23 % 8)
247 #define	WLAN_EXT_CAPA8_OPMODE_NOTIF				BIT(62 % 8)
248 #define	WLAN_EXT_CAPA8_MAX_MSDU_IN_AMSDU_LSB			BIT(63 % 8)
249 #define	WLAN_EXT_CAPA9_MAX_MSDU_IN_AMSDU_MSB			BIT(64 % 8)
250 #define	WLAN_EXT_CAPA10_TWT_REQUESTER_SUPPORT			BIT(77 % 8)
251 #define	WLAN_EXT_CAPA10_TWT_RESPONDER_SUPPORT			BIT(78 % 8)
252 #define	WLAN_EXT_CAPA10_OBSS_NARROW_BW_RU_TOLERANCE_SUPPORT	BIT(79 % 8)
253 
254 #define	WLAN_EXT_CAPA11_EMA_SUPPORT				0x00	/* XXX TODO FIXME */
255 
256 
257 /* iwlwifi/mvm/utils:: for (ac = IEEE80211_AC_VO; ac <= IEEE80211_AC_VI; ac++) */
258 /* Would be so much easier if we'd define constants to the same. */
259 enum ieee80211_ac_numbers {
260 	IEEE80211_AC_VO = 0,			/* net80211::WME_AC_VO */
261 	IEEE80211_AC_VI = 1,			/* net80211::WME_AC_VI */
262 	IEEE80211_AC_BE = 2,			/* net80211::WME_AC_BE */
263 	IEEE80211_AC_BK = 3,			/* net80211::WME_AC_BK */
264 };
265 
266 #define	IEEE80211_MAX_QUEUES			16	/* Assume IEEE80211_NUM_TIDS for the moment. */
267 
268 #define	IEEE80211_WMM_IE_STA_QOSINFO_AC_VO	1
269 #define	IEEE80211_WMM_IE_STA_QOSINFO_AC_VI	2
270 #define	IEEE80211_WMM_IE_STA_QOSINFO_AC_BK	4
271 #define	IEEE80211_WMM_IE_STA_QOSINFO_AC_BE	8
272 #define	IEEE80211_WMM_IE_STA_QOSINFO_SP_ALL	0xf
273 
274 
275 /* Define the LinuxKPI names directly to the net80211 ones. */
276 #define	IEEE80211_HT_CAP_LDPC_CODING		IEEE80211_HTCAP_LDPC
277 #define	IEEE80211_HT_CAP_SUP_WIDTH_20_40	IEEE80211_HTCAP_CHWIDTH40
278 #define	IEEE80211_HT_CAP_SM_PS			IEEE80211_HTCAP_SMPS
279 #define	IEEE80211_HT_CAP_SM_PS_SHIFT		2
280 #define	IEEE80211_HT_CAP_GRN_FLD		IEEE80211_HTCAP_GREENFIELD
281 #define	IEEE80211_HT_CAP_SGI_20			IEEE80211_HTCAP_SHORTGI20
282 #define	IEEE80211_HT_CAP_SGI_40			IEEE80211_HTCAP_SHORTGI40
283 #define	IEEE80211_HT_CAP_TX_STBC		IEEE80211_HTCAP_TXSTBC
284 #define	IEEE80211_HT_CAP_RX_STBC		IEEE80211_HTCAP_RXSTBC
285 #define	IEEE80211_HT_CAP_RX_STBC_SHIFT		IEEE80211_HTCAP_RXSTBC_S
286 #define	IEEE80211_HT_CAP_MAX_AMSDU		IEEE80211_HTCAP_MAXAMSDU
287 #define	IEEE80211_HT_CAP_DSSSCCK40		IEEE80211_HTCAP_DSSSCCK40
288 #define	IEEE80211_HT_CAP_LSIG_TXOP_PROT		IEEE80211_HTCAP_LSIGTXOPPROT
289 
290 #define	IEEE80211_HT_MCS_TX_DEFINED		0x0001
291 #define	IEEE80211_HT_MCS_TX_RX_DIFF		0x0002
292 #define	IEEE80211_HT_MCS_TX_MAX_STREAMS_SHIFT	2
293 #define	IEEE80211_HT_MCS_TX_MAX_STREAMS_MASK	0x0c
294 #define	IEEE80211_HT_MCS_RX_HIGHEST_MASK	0x3ff
295 #define	IEEE80211_HT_MCS_MASK_LEN		10
296 
297 #define	IEEE80211_MLD_MAX_NUM_LINKS		15
298 #define	IEEE80211_MLD_CAP_OP_MAX_SIMUL_LINKS	0xf
299 #define	IEEE80211_MLD_CAP_OP_TID_TO_LINK_MAP_NEG_SUPP		0x0060
300 #define	IEEE80211_MLD_CAP_OP_TID_TO_LINK_MAP_NEG_SUPP_SAME	1
301 
302 struct ieee80211_mcs_info {
303 	uint8_t		rx_mask[IEEE80211_HT_MCS_MASK_LEN];
304 	uint16_t	rx_highest;
305 	uint8_t		tx_params;
306 	uint8_t		__reserved[3];
307 } __packed;
308 
309 /* 802.11-2020, 9.4.2.55.1 HT Capabilities element structure */
310 struct ieee80211_ht_cap {
311 	uint16_t				cap_info;
312 	uint8_t					ampdu_params_info;
313 	struct ieee80211_mcs_info		mcs;
314 	uint16_t				extended_ht_cap_info;
315 	uint32_t				tx_BF_cap_info;
316 	uint8_t					antenna_selection_info;
317 } __packed;
318 
319 #define	IEEE80211_HT_MAX_AMPDU_FACTOR		13
320 #define	IEEE80211_HE_HT_MAX_AMPDU_FACTOR	16
321 #define	IEEE80211_HE_VHT_MAX_AMPDU_FACTOR	20
322 #define	IEEE80211_HE_6GHZ_MAX_AMPDU_FACTOR	13
323 
324 enum ieee80211_ht_max_ampdu_len {
325 	IEEE80211_HT_MAX_AMPDU_64K
326 };
327 
328 enum ieee80211_ampdu_mlme_action {
329 	IEEE80211_AMPDU_RX_START,
330 	IEEE80211_AMPDU_RX_STOP,
331 	IEEE80211_AMPDU_TX_OPERATIONAL,
332 	IEEE80211_AMPDU_TX_START,
333 	IEEE80211_AMPDU_TX_STOP_CONT,
334 	IEEE80211_AMPDU_TX_STOP_FLUSH,
335 	IEEE80211_AMPDU_TX_STOP_FLUSH_CONT
336 };
337 
338 #define	IEEE80211_AMPDU_TX_START_IMMEDIATE	1
339 #define	IEEE80211_AMPDU_TX_START_DELAY_ADDBA	2
340 
341 enum ieee80211_chanctx_switch_mode {
342 	CHANCTX_SWMODE_REASSIGN_VIF,
343 	CHANCTX_SWMODE_SWAP_CONTEXTS,
344 };
345 
346 enum ieee80211_chanctx_change_flags {
347 	IEEE80211_CHANCTX_CHANGE_MIN_WIDTH	= BIT(0),
348 	IEEE80211_CHANCTX_CHANGE_RADAR		= BIT(1),
349 	IEEE80211_CHANCTX_CHANGE_RX_CHAINS	= BIT(2),
350 	IEEE80211_CHANCTX_CHANGE_WIDTH		= BIT(3),
351 	IEEE80211_CHANCTX_CHANGE_CHANNEL	= BIT(4),
352 	IEEE80211_CHANCTX_CHANGE_PUNCTURING	= BIT(5),
353 	IEEE80211_CHANCTX_CHANGE_MIN_DEF	= BIT(6),
354 };
355 
356 enum ieee80211_frame_release_type {
357 	IEEE80211_FRAME_RELEASE_PSPOLL		= 1,
358 	IEEE80211_FRAME_RELEASE_UAPSD		= 2,
359 };
360 
361 enum ieee80211_p2p_attr_ids {
362 	IEEE80211_P2P_ATTR_DEVICE_ID,
363 	IEEE80211_P2P_ATTR_DEVICE_INFO,
364 	IEEE80211_P2P_ATTR_GROUP_ID,
365 	IEEE80211_P2P_ATTR_LISTEN_CHANNEL,
366 	IEEE80211_P2P_ATTR_ABSENCE_NOTICE,
367 };
368 
369 enum ieee80211_reconfig_type {
370 	IEEE80211_RECONFIG_TYPE_RESTART,
371 	IEEE80211_RECONFIG_TYPE_SUSPEND,
372 };
373 
374 enum ieee80211_roc_type {
375 	IEEE80211_ROC_TYPE_MGMT_TX,
376 	IEEE80211_ROC_TYPE_NORMAL,
377 };
378 
379 enum ieee80211_smps_mode {
380 	IEEE80211_SMPS_OFF,
381 	IEEE80211_SMPS_STATIC,
382 	IEEE80211_SMPS_DYNAMIC,
383 	IEEE80211_SMPS_AUTOMATIC,
384 	IEEE80211_SMPS_NUM_MODES,
385 };
386 
387 /* net80211::IEEE80211_S_* different but represents the state machine. */
388 /* Note: order here is important! */
389 enum ieee80211_sta_state {
390 	IEEE80211_STA_NOTEXIST		= 0,
391 	IEEE80211_STA_NONE		= 1,
392 	IEEE80211_STA_AUTH		= 2,
393 	IEEE80211_STA_ASSOC		= 3,
394 	IEEE80211_STA_AUTHORIZED	= 4,	/* 802.1x */
395 };
396 
397 enum ieee80211_tx_info_flags {
398 	/* XXX TODO .. right shift numbers - not sure where that came from? */
399 	IEEE80211_TX_CTL_AMPDU			= BIT(0),
400 	IEEE80211_TX_CTL_ASSIGN_SEQ		= BIT(1),
401 	IEEE80211_TX_CTL_NO_ACK			= BIT(2),
402 	IEEE80211_TX_CTL_SEND_AFTER_DTIM	= BIT(3),
403 	IEEE80211_TX_CTL_TX_OFFCHAN		= BIT(4),
404 	IEEE80211_TX_CTL_REQ_TX_STATUS		= BIT(5),
405 	IEEE80211_TX_STATUS_EOSP		= BIT(6),
406 	IEEE80211_TX_STAT_ACK			= BIT(7),
407 	IEEE80211_TX_STAT_AMPDU			= BIT(8),
408 	IEEE80211_TX_STAT_AMPDU_NO_BACK		= BIT(9),
409 	IEEE80211_TX_STAT_TX_FILTERED		= BIT(10),
410 	IEEE80211_TX_STAT_NOACK_TRANSMITTED	= BIT(11),
411 	IEEE80211_TX_CTL_FIRST_FRAGMENT		= BIT(12),
412 	IEEE80211_TX_INTFL_DONT_ENCRYPT		= BIT(13),
413 	IEEE80211_TX_CTL_NO_CCK_RATE		= BIT(14),
414 	IEEE80211_TX_CTL_INJECTED		= BIT(15),
415 	IEEE80211_TX_CTL_HW_80211_ENCAP		= BIT(16),
416 	IEEE80211_TX_CTL_USE_MINRATE		= BIT(17),
417 	IEEE80211_TX_CTL_RATE_CTRL_PROBE	= BIT(18),
418 	IEEE80211_TX_CTL_LDPC			= BIT(19),
419 	IEEE80211_TX_CTL_STBC			= BIT(20),
420 } __packed;
421 
422 enum ieee80211_tx_status_flags {
423 	IEEE80211_TX_STATUS_ACK_SIGNAL_VALID	= BIT(0),
424 };
425 
426 enum ieee80211_tx_control_flags {
427 	/* XXX TODO .. right shift numbers */
428 	IEEE80211_TX_CTRL_PORT_CTRL_PROTO	= BIT(0),
429 	IEEE80211_TX_CTRL_PS_RESPONSE		= BIT(1),
430 	IEEE80211_TX_CTRL_RATE_INJECT		= BIT(2),
431 	IEEE80211_TX_CTRL_DONT_USE_RATE_MASK	= BIT(3),
432 	IEEE80211_TX_CTRL_MLO_LINK		= 0xF0000000,	/* This is IEEE80211_LINK_UNSPECIFIED on the high bits. */
433 };
434 
435 enum ieee80211_tx_rate_flags {
436 	/* XXX TODO .. right shift numbers */
437 	IEEE80211_TX_RC_40_MHZ_WIDTH		= BIT(0),
438 	IEEE80211_TX_RC_80_MHZ_WIDTH		= BIT(1),
439 	IEEE80211_TX_RC_160_MHZ_WIDTH		= BIT(2),
440 	IEEE80211_TX_RC_GREEN_FIELD		= BIT(3),
441 	IEEE80211_TX_RC_MCS			= BIT(4),
442 	IEEE80211_TX_RC_SHORT_GI		= BIT(5),
443 	IEEE80211_TX_RC_VHT_MCS			= BIT(6),
444 	IEEE80211_TX_RC_USE_SHORT_PREAMBLE	= BIT(7),
445 };
446 
447 #define	IEEE80211_RNR_TBTT_PARAMS_PSD_RESERVED	-128
448 
449 #define	IEEE80211_HT_CTL_LEN	4
450 
451 struct ieee80211_hdr {		/* net80211::ieee80211_frame_addr4 */
452         __le16		frame_control;
453         __le16		duration_id;
454 	uint8_t		addr1[ETH_ALEN];
455 	uint8_t		addr2[ETH_ALEN];
456 	uint8_t		addr3[ETH_ALEN];
457 	__le16		seq_ctrl;
458 	uint8_t		addr4[ETH_ALEN];
459 };
460 
461 struct ieee80211_hdr_3addr {	/* net80211::ieee80211_frame */
462         __le16		frame_control;
463         __le16		duration_id;
464 	uint8_t		addr1[ETH_ALEN];
465 	uint8_t		addr2[ETH_ALEN];
466 	uint8_t		addr3[ETH_ALEN];
467 	__le16		seq_ctrl;
468 };
469 
470 struct ieee80211_qos_hdr {	/* net80211:ieee80211_qosframe */
471         __le16		frame_control;
472         __le16		duration_id;
473 	uint8_t		addr1[ETH_ALEN];
474 	uint8_t		addr2[ETH_ALEN];
475 	uint8_t		addr3[ETH_ALEN];
476 	__le16		seq_ctrl;
477 	__le16		qos_ctrl;
478 };
479 
480 struct ieee80211_vendor_ie {
481 };
482 
483 /* 802.11-2020, Table 9-359-Block Ack Action field values */
484 enum ieee80211_back {
485 	WLAN_ACTION_ADDBA_REQ		= 0,
486 };
487 
488 enum ieee80211_sa_query {
489 	WLAN_ACTION_SA_QUERY_RESPONSE	= 1,
490 };
491 
492 /* 802.11-2020, Table 9-51-Category values */
493 enum ieee80211_category {
494 	WLAN_CATEGORY_BACK		= 3,
495 	WLAN_CATEGORY_SA_QUERY		= 8,	/* net80211::IEEE80211_ACTION_CAT_SA_QUERY */
496 };
497 
498 /* 80211-2020 9.3.3.2 Format of Management frames */
499 struct ieee80211_mgmt {
500 	__le16		frame_control;
501         __le16		duration_id;
502 	uint8_t		da[ETH_ALEN];
503 	uint8_t		sa[ETH_ALEN];
504 	uint8_t		bssid[ETH_ALEN];
505 	__le16		seq_ctrl;
506 	union {
507 		/* 9.3.3.3 Beacon frame format */
508 		struct {
509 			uint64_t	timestamp;
510 			uint16_t	beacon_int;
511 			uint16_t	capab_info;
512 			uint8_t		variable[0];
513 		} beacon;
514 		/* 9.3.3.5 Association Request frame format */
515 		struct  {
516 			uint16_t	capab_info;
517 			uint16_t	listen_interval;
518 			uint8_t		variable[0];
519 		} assoc_req;
520 		/* 9.3.3.10 Probe Request frame format */
521 		struct {
522 			uint8_t		variable[0];
523 		} probe_req;
524 		/* 9.3.3.11 Probe Response frame format */
525 		struct {
526 			uint64_t	timestamp;
527 			uint16_t	beacon_int;
528 			uint16_t	capab_info;
529 			uint8_t		variable[0];
530 		} probe_resp;
531 		/* 9.3.3.14 Action frame format */
532 		struct {
533 			/* 9.4.1.11 Action field */
534 			uint8_t		category;
535 			/* 9.6.8 Public Action details */
536 			union {
537 				/* 9.6.2.5 TPC Report frame format */
538 				struct {
539 					uint8_t spec_mgmt;
540 					uint8_t dialog_token;
541 					/* uint32_t tpc_rep_elem:: */
542 					uint8_t tpc_elem_id;
543 					uint8_t tpc_elem_length;
544 					uint8_t tpc_elem_tx_power;
545 					uint8_t tpc_elem_link_margin;
546 				} tpc_report;
547 				/* 9.6.8.33 Fine Timing Measurement frame format */
548 				struct {
549 					uint8_t	dialog_token;
550 					uint8_t	follow_up;
551 					uint8_t	tod[6];
552 					uint8_t	toa[6];
553 					uint16_t tod_error;
554 					uint16_t toa_error;
555 					uint8_t variable[0];
556 				} ftm;
557 				/* 802.11-2016, 9.6.5.2 ADDBA Request frame format */
558 				struct {
559 					uint8_t action_code;
560 					uint8_t dialog_token;
561 					uint16_t capab;
562 					uint16_t timeout;
563 					uint16_t start_seq_num;
564 					/* Optional follows... */
565 					uint8_t variable[0];
566 				} addba_req;
567 				/* XXX */
568 				struct {
569 					uint8_t dialog_token;
570 				} wnm_timing_msr;
571 			} u;
572 		} action;
573 		DECLARE_FLEX_ARRAY(uint8_t, body);
574 	} u;
575 };
576 
577 struct ieee80211_cts {		/* net80211::ieee80211_frame_cts */
578         __le16		frame_control;
579         __le16		duration;
580 	uint8_t		ra[ETH_ALEN];
581 } __packed;
582 
583 struct ieee80211_rts {		/* net80211::ieee80211_frame_rts */
584         __le16		frame_control;
585         __le16		duration;
586 	uint8_t		ra[ETH_ALEN];
587 	uint8_t		ta[ETH_ALEN];
588 } __packed;
589 
590 #define	MHZ_TO_KHZ(_f)		((_f) * 1000)
591 #define	DBI_TO_MBI(_g)		((_g) * 100)
592 #define	MBI_TO_DBI(_x)		((_x) / 100)
593 #define	DBM_TO_MBM(_g)		((_g) * 100)
594 #define	MBM_TO_DBM(_x)		((_x) / 100)
595 
596 #define	IEEE80211_SEQ_TO_SN(_seqn)	(((_seqn) & IEEE80211_SEQ_SEQ_MASK) >> \
597 					    IEEE80211_SEQ_SEQ_SHIFT)
598 #define	IEEE80211_SN_TO_SEQ(_sn)	(((_sn) << IEEE80211_SEQ_SEQ_SHIFT) & \
599 					    IEEE80211_SEQ_SEQ_MASK)
600 
601 /* Time unit (TU) to .. See net80211: IEEE80211_DUR_TU */
602 #define	TU_TO_JIFFIES(_tu)	(usecs_to_jiffies(_tu) * 1024)
603 #define	TU_TO_EXP_TIME(_tu)	(jiffies + TU_TO_JIFFIES(_tu))
604 
605 /* 9.4.2.21.1, Table 9-82. */
606 #define	IEEE80211_SPCT_MSR_RPRT_TYPE_LCI	8
607 #define	IEEE80211_SPCT_MSR_RPRT_TYPE_CIVIC	11
608 
609 /* 9.4.2.1, Table 9-77. Element IDs. */
610 enum ieee80211_eid {
611 	WLAN_EID_SSID				= 0,
612 	WLAN_EID_SUPP_RATES			= 1,
613 	WLAN_EID_DS_PARAMS			= 3,
614 	WLAN_EID_TIM				= 5,
615 	WLAN_EID_COUNTRY			= 7,	/* IEEE80211_ELEMID_COUNTRY */
616 	WLAN_EID_REQUEST			= 10,
617 	WLAN_EID_QBSS_LOAD			= 11,	/* IEEE80211_ELEMID_BSSLOAD */
618 	WLAN_EID_CHANNEL_SWITCH			= 37,
619 	WLAN_EID_MEASURE_REPORT			= 39,
620 	WLAN_EID_HT_CAPABILITY			= 45,	/* IEEE80211_ELEMID_HTCAP */
621 	WLAN_EID_RSN				= 48,	/* IEEE80211_ELEMID_RSN */
622 	WLAN_EID_EXT_SUPP_RATES			= 50,
623 	WLAN_EID_EXT_NON_INHERITANCE		= 56,
624 	WLAN_EID_EXT_CHANSWITCH_ANN		= 60,
625 	WLAN_EID_MULTIPLE_BSSID			= 71,	/* IEEE80211_ELEMID_MULTIBSSID */
626 	WLAN_EID_MULTI_BSSID_IDX		= 85,
627 	WLAN_EID_EXT_CAPABILITY			= 127,
628 	WLAN_EID_VHT_CAPABILITY			= 191,	/* IEEE80211_ELEMID_VHT_CAP */
629 	WLAN_EID_S1G_TWT			= 216,
630 	WLAN_EID_VENDOR_SPECIFIC		= 221,	/* IEEE80211_ELEMID_VENDOR */
631 };
632 
633 enum ieee80211_eid_ext {
634 	WLAN_EID_EXT_HE_CAPABILITY		= 35,
635 };
636 
637 #define	for_each_element(_elem, _data, _len) \
638 	for (_elem = (const struct element *)(_data); \
639 	    (((const uint8_t *)(_data) + (_len) - (const uint8_t *)_elem) >= sizeof(*_elem)) && \
640 		(((const uint8_t *)(_data) + (_len) - (const uint8_t *)_elem) >= (sizeof(*_elem) + _elem->datalen)); \
641 	    _elem = (const struct element *)(_elem->data + _elem->datalen))
642 
643 #define	for_each_element_id(_elem, _eid, _data, _len) \
644 	for_each_element(_elem, _data, _len) \
645 		if (_elem->id == (_eid))
646 
647 /* 9.4.1.7, Table 9-45. Reason codes. */
648 enum ieee80211_reason_code {
649 	/* reserved				= 0, */
650 	WLAN_REASON_UNSPECIFIED			= 1,
651 	WLAN_REASON_DEAUTH_LEAVING		= 3,	/* LEAVING_NETWORK_DEAUTH */
652 	WLAN_REASON_TDLS_TEARDOWN_UNREACHABLE	= 25,
653 	WLAN_REASON_TDLS_TEARDOWN_UNSPECIFIED	= 26,
654 };
655 
656 /* 9.4.1.9, Table 9-46. Status codes. */
657 enum ieee80211_status_code {
658 	WLAN_STATUS_SUCCESS			= 0,
659 	WLAN_STATUS_AUTH_TIMEOUT		= 16,	/* REJECTED_SEQUENCE_TIMEOUT */
660 };
661 
662 /* 9.3.1.22 Trigger frame format; 80211ax-2021 */
663 struct ieee80211_trigger {
664         __le16		frame_control;
665         __le16		duration_id;
666 	uint8_t		ra[ETH_ALEN];
667 	uint8_t		ta[ETH_ALEN];
668 	__le64		common_info;		/* 8+ really */
669 	uint8_t		variable[];
670 };
671 
672 /* Table 9-29c-Trigger Type subfield encoding */
673 enum {
674 	IEEE80211_TRIGGER_TYPE_BASIC		= 0x0,
675 	IEEE80211_TRIGGER_TYPE_MU_BAR		= 0x2,
676 #if 0
677 	/* Not seen yet. */
678 	BFRP					= 0x1,
679 	MU-RTS					= 0x3,
680 	BSRP					= 0x4,
681 	GCR MU-BAR				= 0x5,
682 	BQRP					= 0x6,
683 	NFRP					= 0x7,
684 	/* 0x8..0xf reserved */
685 #endif
686 	IEEE80211_TRIGGER_TYPE_MASK		= 0xf
687 };
688 
689 #define	IEEE80211_TRIGGER_ULBW_MASK		0xc0000
690 #define	IEEE80211_TRIGGER_ULBW_20MHZ		0x0
691 #define	IEEE80211_TRIGGER_ULBW_40MHZ		0x1
692 #define	IEEE80211_TRIGGER_ULBW_80MHZ		0x2
693 #define	IEEE80211_TRIGGER_ULBW_160_80P80MHZ	0x3
694 
695 /* 802.11-2020, Figure 9-687-Control field format; 802.11ax-2021 */
696 #define	IEEE80211_TWT_CONTROL_NEG_TYPE_BROADCAST	BIT(3)
697 #define	IEEE80211_TWT_CONTROL_RX_DISABLED		BIT(4)
698 #define	IEEE80211_TWT_CONTROL_WAKE_DUR_UNIT		BIT(5)
699 
700 /* 802.11-2020, Figure 9-688-Request Type field format; 802.11ax-2021 */
701 #define	IEEE80211_TWT_REQTYPE_SETUP_CMD		(BIT(1) | BIT(2) | BIT(3))
702 #define	IEEE80211_TWT_REQTYPE_TRIGGER		BIT(4)
703 #define	IEEE80211_TWT_REQTYPE_IMPLICIT		BIT(5)
704 #define	IEEE80211_TWT_REQTYPE_FLOWTYPE		BIT(6)
705 #define	IEEE80211_TWT_REQTYPE_FLOWID		(BIT(7) | BIT(8) | BIT(9))
706 #define	IEEE80211_TWT_REQTYPE_WAKE_INT_EXP	(BIT(10) | BIT(11) | BIT(12) | BIT(13) | BIT(14))
707 #define	IEEE80211_TWT_REQTYPE_PROTECTION	BIT(15)
708 
709 struct ieee80211_twt_params {
710 	int	mantissa, min_twt_dur, twt;
711 	uint16_t				req_type;
712 };
713 
714 struct ieee80211_twt_setup {
715 	int	control;
716 	struct ieee80211_twt_params		*params;
717 };
718 
719 /* 802.11-2020, Table 9-297-TWT Setup Command field values */
720 enum ieee80211_twt_setup_cmd {
721 	TWT_SETUP_CMD_REQUEST			= 0,
722 	TWT_SETUP_CMD_SUGGEST			= 1,
723 	/* DEMAND				= 2, */
724 	/* GROUPING				= 3, */
725 	TWT_SETUP_CMD_ACCEPT			= 4,
726 	/* ALTERNATE				= 5 */
727 	TWT_SETUP_CMD_DICTATE			= 6,
728 	TWT_SETUP_CMD_REJECT			= 7,
729 };
730 
731 struct ieee80211_bssid_index {
732 	int	bssid_index;
733 };
734 
735 enum ieee80211_ap_reg_power {
736 	IEEE80211_REG_UNSET_AP,
737 	IEEE80211_REG_LPI_AP,
738 	IEEE80211_REG_SP_AP,
739 	IEEE80211_REG_VLP_AP,
740 };
741 
742 /*
743  * 802.11ax-2021, Table 9-277-Meaning of Maximum Transmit Power Count subfield
744  * if Maximum Transmit Power Interpretation subfield is 1 or 3
745  */
746 #define	IEEE80211_MAX_NUM_PWR_LEVEL		8
747 
748 /*
749  * 802.11ax-2021, Table 9-275a-Maximum Transmit Power Interpretation subfield
750  * encoding (4) * Table E-12-Regulatory Info subfield encoding in the
751  * United States (2)
752  */
753 #define	IEEE80211_TPE_MAX_IE_NUM		8
754 
755 /* 802.11ax-2021, 9.4.2.161 Transmit Power Envelope element */
756 struct ieee80211_tx_pwr_env {
757 	uint8_t		tx_power_info;
758 	uint8_t		tx_power[IEEE80211_MAX_NUM_PWR_LEVEL];
759 };
760 
761 /* 802.11ax-2021, Figure 9-617-Transmit Power Information field format */
762 /* These are field masks (3bit/3bit/2bit). */
763 #define	IEEE80211_TX_PWR_ENV_INFO_COUNT		0x07
764 #define	IEEE80211_TX_PWR_ENV_INFO_INTERPRET	0x38
765 #define	IEEE80211_TX_PWR_ENV_INFO_CATEGORY	0xc0
766 
767 /*
768  * 802.11ax-2021, Table 9-275a-Maximum Transmit Power Interpretation subfield
769  * encoding
770  */
771 enum ieee80211_tx_pwr_interpretation_subfield_enc {
772 	IEEE80211_TPE_LOCAL_EIRP,
773 	IEEE80211_TPE_LOCAL_EIRP_PSD,
774 	IEEE80211_TPE_REG_CLIENT_EIRP,
775 	IEEE80211_TPE_REG_CLIENT_EIRP_PSD,
776 };
777 
778 enum ieee80211_tx_pwr_category_6ghz {
779 	IEEE80211_TPE_CAT_6GHZ_DEFAULT,
780 };
781 
782 /* 802.11-2020, 9.4.2.27 BSS Load element */
783 struct ieee80211_bss_load_elem {
784 	uint16_t				sta_count;
785 	uint8_t					channel_util;
786 	uint16_t				avail_adm_capa;
787 };
788 
789 struct ieee80211_p2p_noa_desc {
790 	uint32_t				count;		/* uint8_t ? */
791 	uint32_t				duration;
792 	uint32_t				interval;
793 	uint32_t				start_time;
794 };
795 
796 struct ieee80211_p2p_noa_attr {
797 	uint8_t					index;
798 	uint8_t					oppps_ctwindow;
799 	struct ieee80211_p2p_noa_desc		desc[4];
800 };
801 
802 
803 /* net80211: IEEE80211_IS_CTL() */
804 static __inline bool
ieee80211_is_ctl(__le16 fc)805 ieee80211_is_ctl(__le16 fc)
806 {
807 	__le16 v;
808 
809 	fc &= htole16(IEEE80211_FC0_TYPE_MASK);
810 	v = htole16(IEEE80211_FC0_TYPE_CTL);
811 
812 	return (fc == v);
813 }
814 
815 /* net80211: IEEE80211_IS_DATA() */
816 static __inline bool
ieee80211_is_data(__le16 fc)817 ieee80211_is_data(__le16 fc)
818 {
819 	__le16 v;
820 
821 	fc &= htole16(IEEE80211_FC0_TYPE_MASK);
822 	v = htole16(IEEE80211_FC0_TYPE_DATA);
823 
824 	return (fc == v);
825 }
826 
827 /* net80211: IEEE80211_IS_QOSDATA() */
828 static __inline bool
ieee80211_is_data_qos(__le16 fc)829 ieee80211_is_data_qos(__le16 fc)
830 {
831 	__le16 v;
832 
833 	fc &= htole16(IEEE80211_FC0_SUBTYPE_QOS_DATA | IEEE80211_FC0_TYPE_MASK);
834 	v = htole16(IEEE80211_FC0_SUBTYPE_QOS_DATA | IEEE80211_FC0_TYPE_DATA);
835 
836 	return (fc == v);
837 }
838 
839 /* net80211: IEEE80211_IS_MGMT() */
840 static __inline bool
ieee80211_is_mgmt(__le16 fc)841 ieee80211_is_mgmt(__le16 fc)
842 {
843 	__le16 v;
844 
845 	fc &= htole16(IEEE80211_FC0_TYPE_MASK);
846 	v = htole16(IEEE80211_FC0_TYPE_MGT);
847 
848 	return (fc == v);
849 }
850 
851 
852 /* Derived from net80211::ieee80211_anyhdrsize. */
853 static __inline unsigned int
ieee80211_hdrlen(__le16 fc)854 ieee80211_hdrlen(__le16 fc)
855 {
856 	unsigned int size;
857 
858 	if (ieee80211_is_ctl(fc)) {
859 		switch (fc & htole16(IEEE80211_FC0_SUBTYPE_MASK)) {
860 		case htole16(IEEE80211_FC0_SUBTYPE_CTS):
861 		case htole16(IEEE80211_FC0_SUBTYPE_ACK):
862 			return sizeof(struct ieee80211_frame_ack);
863 		case htole16(IEEE80211_FC0_SUBTYPE_BAR):
864 			return sizeof(struct ieee80211_frame_bar);
865 		}
866 		return (sizeof(struct ieee80211_frame_min));
867 	}
868 
869 	size = sizeof(struct ieee80211_frame);
870 	if (ieee80211_is_data(fc)) {
871 		if ((fc & htole16(IEEE80211_FC1_DIR_MASK << 8)) ==
872 		    htole16(IEEE80211_FC1_DIR_DSTODS << 8))
873 			size += IEEE80211_ADDR_LEN;
874 		if ((fc & htole16(IEEE80211_FC0_SUBTYPE_QOS_DATA |
875 		    IEEE80211_FC0_TYPE_MASK)) ==
876 		    htole16(IEEE80211_FC0_SUBTYPE_QOS_DATA |
877 		    IEEE80211_FC0_TYPE_DATA))
878 			size += sizeof(uint16_t);
879 	}
880 
881 	if (ieee80211_is_mgmt(fc)) {
882 #ifdef __notyet__
883 		printf("XXX-BZ %s: TODO? fc %#04x size %u\n",
884 		    __func__, fc, size);
885 #endif
886 		;
887 	}
888 
889 	return (size);
890 }
891 
892 static inline bool
ieee80211_is_trigger(__le16 fc)893 ieee80211_is_trigger(__le16 fc)
894 {
895 	__le16 v;
896 
897 	fc &= htole16(IEEE80211_FC0_SUBTYPE_MASK | IEEE80211_FC0_TYPE_MASK);
898 	v = htole16(IEEE80211_FC0_SUBTYPE_TRIGGER | IEEE80211_FC0_TYPE_CTL);
899 
900 	return (fc == v);
901 }
902 
903 static __inline bool
ieee80211_is_action(__le16 fc)904 ieee80211_is_action(__le16 fc)
905 {
906 	__le16 v;
907 
908 	fc &= htole16(IEEE80211_FC0_SUBTYPE_MASK | IEEE80211_FC0_TYPE_MASK);
909 	v = htole16(IEEE80211_FC0_SUBTYPE_ACTION | IEEE80211_FC0_TYPE_MGT);
910 
911 	return (fc == v);
912 }
913 
914 static __inline bool
ieee80211_is_probe_resp(__le16 fc)915 ieee80211_is_probe_resp(__le16 fc)
916 {
917 	__le16 v;
918 
919 	fc &= htole16(IEEE80211_FC0_SUBTYPE_MASK | IEEE80211_FC0_TYPE_MASK);
920 	v = htole16(IEEE80211_FC0_SUBTYPE_PROBE_RESP | IEEE80211_FC0_TYPE_MGT);
921 
922 	return (fc == v);
923 }
924 
925 static __inline bool
ieee80211_is_auth(__le16 fc)926 ieee80211_is_auth(__le16 fc)
927 {
928 	__le16 v;
929 
930 	fc &= htole16(IEEE80211_FC0_SUBTYPE_MASK | IEEE80211_FC0_TYPE_MASK);
931 	v = htole16(IEEE80211_FC0_SUBTYPE_AUTH | IEEE80211_FC0_TYPE_MGT);
932 
933 	return (fc == v);
934 }
935 
936 static __inline bool
ieee80211_is_assoc_req(__le16 fc)937 ieee80211_is_assoc_req(__le16 fc)
938 {
939 	__le16 v;
940 
941 	fc &= htole16(IEEE80211_FC0_SUBTYPE_MASK | IEEE80211_FC0_TYPE_MASK);
942 	v = htole16(IEEE80211_FC0_SUBTYPE_ASSOC_REQ | IEEE80211_FC0_TYPE_MGT);
943 
944 	return (fc == v);
945 }
946 
947 static __inline bool
ieee80211_is_assoc_resp(__le16 fc)948 ieee80211_is_assoc_resp(__le16 fc)
949 {
950 	__le16 v;
951 
952 	fc &= htole16(IEEE80211_FC0_SUBTYPE_MASK | IEEE80211_FC0_TYPE_MASK);
953 	v = htole16(IEEE80211_FC0_SUBTYPE_ASSOC_RESP | IEEE80211_FC0_TYPE_MGT);
954 
955 	return (fc == v);
956 }
957 
958 static __inline bool
ieee80211_is_reassoc_req(__le16 fc)959 ieee80211_is_reassoc_req(__le16 fc)
960 {
961 	__le16 v;
962 
963 	fc &= htole16(IEEE80211_FC0_SUBTYPE_MASK | IEEE80211_FC0_TYPE_MASK);
964 	v = htole16(IEEE80211_FC0_SUBTYPE_REASSOC_REQ | IEEE80211_FC0_TYPE_MGT);
965 
966 	return (fc == v);
967 }
968 
969 static __inline bool
ieee80211_is_reassoc_resp(__le16 fc)970 ieee80211_is_reassoc_resp(__le16 fc)
971 {
972 	__le16 v;
973 
974 	fc &= htole16(IEEE80211_FC0_SUBTYPE_MASK | IEEE80211_FC0_TYPE_MASK);
975 	v = htole16(IEEE80211_FC0_SUBTYPE_REASSOC_RESP | IEEE80211_FC0_TYPE_MGT);
976 
977 	return (fc == v);
978 }
979 
980 static __inline bool
ieee80211_is_disassoc(__le16 fc)981 ieee80211_is_disassoc(__le16 fc)
982 {
983 	__le16 v;
984 
985 	fc &= htole16(IEEE80211_FC0_SUBTYPE_MASK | IEEE80211_FC0_TYPE_MASK);
986 	v = htole16(IEEE80211_FC0_SUBTYPE_DISASSOC | IEEE80211_FC0_TYPE_MGT);
987 
988 	return (fc == v);
989 }
990 
991 static __inline bool
ieee80211_is_data_present(__le16 fc)992 ieee80211_is_data_present(__le16 fc)
993 {
994 	__le16 v;
995 
996 	/* If it is a data frame and NODATA is not present. */
997 	fc &= htole16(IEEE80211_FC0_TYPE_MASK | IEEE80211_FC0_SUBTYPE_NODATA);
998 	v = htole16(IEEE80211_FC0_TYPE_DATA);
999 
1000 	return (fc == v);
1001 }
1002 
1003 static __inline bool
ieee80211_is_deauth(__le16 fc)1004 ieee80211_is_deauth(__le16 fc)
1005 {
1006 	__le16 v;
1007 
1008 	fc &= htole16(IEEE80211_FC0_SUBTYPE_MASK | IEEE80211_FC0_TYPE_MASK);
1009 	v = htole16(IEEE80211_FC0_SUBTYPE_DEAUTH | IEEE80211_FC0_TYPE_MGT);
1010 
1011 	return (fc == v);
1012 }
1013 
1014 static __inline bool
ieee80211_is_beacon(__le16 fc)1015 ieee80211_is_beacon(__le16 fc)
1016 {
1017 	__le16 v;
1018 
1019 	/*
1020 	 * For as much as I get it this comes in LE and unlike FreeBSD
1021 	 * where we get the entire frame header and u8[], here we get the
1022 	 * 9.2.4.1 Frame Control field only. Mask and compare.
1023 	 */
1024 	fc &= htole16(IEEE80211_FC0_SUBTYPE_MASK | IEEE80211_FC0_TYPE_MASK);
1025 	v = htole16(IEEE80211_FC0_SUBTYPE_BEACON | IEEE80211_FC0_TYPE_MGT);
1026 
1027 	return (fc == v);
1028 }
1029 
1030 
1031 static __inline bool
ieee80211_is_probe_req(__le16 fc)1032 ieee80211_is_probe_req(__le16 fc)
1033 {
1034 	__le16 v;
1035 
1036 	fc &= htole16(IEEE80211_FC0_SUBTYPE_MASK | IEEE80211_FC0_TYPE_MASK);
1037 	v = htole16(IEEE80211_FC0_SUBTYPE_PROBE_REQ | IEEE80211_FC0_TYPE_MGT);
1038 
1039 	return (fc == v);
1040 }
1041 
1042 static __inline bool
ieee80211_has_protected(__le16 fc)1043 ieee80211_has_protected(__le16 fc)
1044 {
1045 
1046 	return (fc & htole16(IEEE80211_FC1_PROTECTED << 8));
1047 }
1048 
1049 static __inline bool
ieee80211_is_back_req(__le16 fc)1050 ieee80211_is_back_req(__le16 fc)
1051 {
1052 	__le16 v;
1053 
1054 	fc &= htole16(IEEE80211_FC0_SUBTYPE_MASK | IEEE80211_FC0_TYPE_MASK);
1055 	v = htole16(IEEE80211_FC0_SUBTYPE_BAR | IEEE80211_FC0_TYPE_CTL);
1056 
1057 	return (fc == v);
1058 }
1059 
1060 static __inline bool
ieee80211_is_bufferable_mmpdu(struct sk_buff * skb)1061 ieee80211_is_bufferable_mmpdu(struct sk_buff *skb)
1062 {
1063 	struct ieee80211_mgmt *mgmt;
1064 	__le16 fc;
1065 
1066 	mgmt = (struct ieee80211_mgmt *)skb->data;
1067 	fc = mgmt->frame_control;
1068 
1069 	/* 11.2.2 Bufferable MMPDUs, 80211-2020. */
1070 	/* XXX we do not care about IBSS yet. */
1071 
1072 	if (!ieee80211_is_mgmt(fc))
1073 		return (false);
1074 	if (ieee80211_is_action(fc))		/* XXX FTM? */
1075 		return (true);			/* XXX false? */
1076 	if (ieee80211_is_disassoc(fc))
1077 		return (true);
1078 	if (ieee80211_is_deauth(fc))
1079 		return (true);
1080 
1081 	TODO();
1082 
1083 	return (false);
1084 }
1085 
1086 static __inline bool
ieee80211_is_nullfunc(__le16 fc)1087 ieee80211_is_nullfunc(__le16 fc)
1088 {
1089 	__le16 v;
1090 
1091 	fc &= htole16(IEEE80211_FC0_SUBTYPE_MASK | IEEE80211_FC0_TYPE_MASK);
1092 	v = htole16(IEEE80211_FC0_SUBTYPE_NODATA | IEEE80211_FC0_TYPE_DATA);
1093 
1094 	return (fc == v);
1095 }
1096 
1097 static __inline bool
ieee80211_is_qos_nullfunc(__le16 fc)1098 ieee80211_is_qos_nullfunc(__le16 fc)
1099 {
1100 	__le16 v;
1101 
1102 	fc &= htole16(IEEE80211_FC0_SUBTYPE_MASK | IEEE80211_FC0_TYPE_MASK);
1103 	v = htole16(IEEE80211_FC0_SUBTYPE_QOS_NULL | IEEE80211_FC0_TYPE_DATA);
1104 
1105 	return (fc == v);
1106 }
1107 
1108 static __inline bool
ieee80211_is_any_nullfunc(__le16 fc)1109 ieee80211_is_any_nullfunc(__le16 fc)
1110 {
1111 
1112 	return (ieee80211_is_nullfunc(fc) || ieee80211_is_qos_nullfunc(fc));
1113 }
1114 
1115 static inline bool
ieee80211_is_pspoll(__le16 fc)1116 ieee80211_is_pspoll(__le16 fc)
1117 {
1118 	__le16 v;
1119 
1120 	fc &= htole16(IEEE80211_FC0_SUBTYPE_MASK | IEEE80211_FC0_TYPE_MASK);
1121 	v = htole16(IEEE80211_FC0_SUBTYPE_PS_POLL | IEEE80211_FC0_TYPE_CTL);
1122 
1123 	return (fc == v);
1124 }
1125 
1126 static __inline bool
ieee80211_has_a4(__le16 fc)1127 ieee80211_has_a4(__le16 fc)
1128 {
1129 	__le16 v;
1130 
1131 	fc &= htole16((IEEE80211_FC1_DIR_TODS | IEEE80211_FC1_DIR_FROMDS) << 8);
1132 	v = htole16((IEEE80211_FC1_DIR_TODS | IEEE80211_FC1_DIR_FROMDS) << 8);
1133 
1134 	return (fc == v);
1135 }
1136 
1137 static __inline bool
ieee80211_has_order(__le16 fc)1138 ieee80211_has_order(__le16 fc)
1139 {
1140 
1141 	return (fc & htole16(IEEE80211_FC1_ORDER << 8));
1142 }
1143 
1144 static __inline bool
ieee80211_has_retry(__le16 fc)1145 ieee80211_has_retry(__le16 fc)
1146 {
1147 
1148 	return (fc & htole16(IEEE80211_FC1_RETRY << 8));
1149 }
1150 
1151 
1152 static __inline bool
ieee80211_has_fromds(__le16 fc)1153 ieee80211_has_fromds(__le16 fc)
1154 {
1155 
1156 	return (fc & htole16(IEEE80211_FC1_DIR_FROMDS << 8));
1157 }
1158 
1159 static __inline bool
ieee80211_has_tods(__le16 fc)1160 ieee80211_has_tods(__le16 fc)
1161 {
1162 
1163 	return (fc & htole16(IEEE80211_FC1_DIR_TODS << 8));
1164 }
1165 
1166 static __inline uint8_t *
ieee80211_get_SA(struct ieee80211_hdr * hdr)1167 ieee80211_get_SA(struct ieee80211_hdr *hdr)
1168 {
1169 
1170 	if (ieee80211_has_a4(hdr->frame_control))
1171 		return (hdr->addr4);
1172 	if (ieee80211_has_fromds(hdr->frame_control))
1173 		return (hdr->addr3);
1174 	return (hdr->addr2);
1175 }
1176 
1177 static __inline uint8_t *
ieee80211_get_DA(struct ieee80211_hdr * hdr)1178 ieee80211_get_DA(struct ieee80211_hdr *hdr)
1179 {
1180 
1181 	if (ieee80211_has_tods(hdr->frame_control))
1182 		return (hdr->addr3);
1183 	return (hdr->addr1);
1184 }
1185 
1186 static __inline bool
ieee80211_is_frag(struct ieee80211_hdr * hdr)1187 ieee80211_is_frag(struct ieee80211_hdr *hdr)
1188 {
1189 	TODO();
1190 	return (false);
1191 }
1192 
1193 static __inline bool
ieee80211_is_first_frag(__le16 fc)1194 ieee80211_is_first_frag(__le16 fc)
1195 {
1196 	TODO();
1197 	return (false);
1198 }
1199 
1200 static __inline bool
ieee80211_is_robust_mgmt_frame(struct sk_buff * skb)1201 ieee80211_is_robust_mgmt_frame(struct sk_buff *skb)
1202 {
1203 	TODO();
1204 	return (false);
1205 }
1206 
1207 static __inline bool
ieee80211_is_ftm(struct sk_buff * skb)1208 ieee80211_is_ftm(struct sk_buff *skb)
1209 {
1210 	TODO();
1211 	return (false);
1212 }
1213 
1214 static __inline bool
ieee80211_is_timing_measurement(struct sk_buff * skb)1215 ieee80211_is_timing_measurement(struct sk_buff *skb)
1216 {
1217 	TODO();
1218 	return (false);
1219 }
1220 
1221 static __inline bool
ieee80211_has_pm(__le16 fc)1222 ieee80211_has_pm(__le16 fc)
1223 {
1224 	TODO();
1225 	return (false);
1226 }
1227 
1228 static __inline bool
ieee80211_has_morefrags(__le16 fc)1229 ieee80211_has_morefrags(__le16 fc)
1230 {
1231 
1232 	fc &= htole16(IEEE80211_FC1_MORE_FRAG << 8);
1233 	return (fc != 0);
1234 }
1235 
1236 static __inline u8 *
ieee80211_get_qos_ctl(struct ieee80211_hdr * hdr)1237 ieee80211_get_qos_ctl(struct ieee80211_hdr *hdr)
1238 {
1239         if (ieee80211_has_a4(hdr->frame_control))
1240                 return (u8 *)hdr + 30;
1241         else
1242                 return (u8 *)hdr + 24;
1243 }
1244 
1245 #endif	/* _LINUXKPI_LINUX_IEEE80211_H */
1246