| 1 | /*- |
| 2 | * SPDX-License-Identifier: BSD-2-Clause |
| 3 | * |
| 4 | * Copyright (c) 2001 Atsushi Onoe |
| 5 | * Copyright (c) 2002-2009 Sam Leffler, Errno Consulting |
| 6 | * All rights reserved. |
| 7 | * |
| 8 | * Redistribution and use in source and binary forms, with or without |
| 9 | * modification, are permitted provided that the following conditions |
| 10 | * are met: |
| 11 | * 1. Redistributions of source code must retain the above copyright |
| 12 | * notice, this list of conditions and the following disclaimer. |
| 13 | * 2. Redistributions in binary form must reproduce the above copyright |
| 14 | * notice, this list of conditions and the following disclaimer in the |
| 15 | * documentation and/or other materials provided with the distribution. |
| 16 | * |
| 17 | * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR |
| 18 | * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES |
| 19 | * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. |
| 20 | * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, |
| 21 | * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT |
| 22 | * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
| 23 | * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
| 24 | * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
| 25 | * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF |
| 26 | * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| 27 | */ |
| 28 | #ifndef _NET80211_IEEE80211_PROTO_H_ |
| 29 | #define _NET80211_IEEE80211_PROTO_H_ |
| 30 | |
| 31 | /* |
| 32 | * 802.11 protocol implementation definitions. |
| 33 | */ |
| 34 | |
| 35 | enum ieee80211_state { |
| 36 | 	IEEE80211_S_INIT	= 0,	/* default state */ |
| 37 | 	IEEE80211_S_SCAN	= 1,	/* scanning */ |
| 38 | 	IEEE80211_S_AUTH	= 2,	/* try to authenticate */ |
| 39 | 	IEEE80211_S_ASSOC	= 3,	/* try to assoc */ |
| 40 | 	IEEE80211_S_CAC		= 4,	/* doing channel availability check */ |
| 41 | 	IEEE80211_S_RUN		= 5,	/* operational (e.g. associated) */ |
| 42 | 	IEEE80211_S_CSA		= 6,	/* channel switch announce pending */ |
| 43 | 	IEEE80211_S_SLEEP	= 7,	/* power save */ |
| 44 | }; |
| 45 | #define	IEEE80211_S_MAX		(IEEE80211_S_SLEEP+1) |
| 46 | |
| 47 | #define	IEEE80211_SEND_MGMT(_ni,_type,_arg) \ |
| 48 | 	((*(_ni)->ni_ic->ic_send_mgmt)(_ni, _type, _arg)) |
| 49 | |
| 50 | extern	const char *mgt_subtype_name[]; |
| 51 | extern	const char *ctl_subtype_name[]; |
| 52 | extern	const char *ieee80211_phymode_name[IEEE80211_MODE_MAX]; |
| 53 | extern	const int ieee80211_opcap[IEEE80211_OPMODE_MAX]; |
| 54 | |
| 55 | static __inline const char * |
| 56 | ieee80211_mgt_subtype_name(uint8_t subtype) |
| 57 | { |
| 58 | 	return mgt_subtype_name[(subtype & IEEE80211_FC0_SUBTYPE_MASK) >> |
| 59 | 		 IEEE80211_FC0_SUBTYPE_SHIFT]; |
| 60 | } |
| 61 | |
| 62 | static __inline const char * |
| 63 | ieee80211_ctl_subtype_name(uint8_t subtype) |
| 64 | { |
| 65 | 	return ctl_subtype_name[(subtype & IEEE80211_FC0_SUBTYPE_MASK) >> |
| 66 | 		 IEEE80211_FC0_SUBTYPE_SHIFT]; |
| 67 | } |
| 68 | |
| 69 | const char *ieee80211_reason_to_string(uint16_t); |
| 70 | |
| 71 | void	ieee80211_proto_attach(struct ieee80211com *); |
| 72 | void	ieee80211_proto_detach(struct ieee80211com *); |
| 73 | void	ieee80211_proto_vattach(struct ieee80211vap *); |
| 74 | void	ieee80211_proto_vdetach(struct ieee80211vap *); |
| 75 | |
| 76 | void	ieee80211_promisc(struct ieee80211vap *, bool); |
| 77 | void	ieee80211_allmulti(struct ieee80211vap *, bool); |
| 78 | void	ieee80211_syncflag(struct ieee80211vap *, int flag); |
| 79 | void	ieee80211_syncflag_ht(struct ieee80211vap *, int flag); |
| 80 | void	ieee80211_syncflag_vht(struct ieee80211vap *, int flag); |
| 81 | void	ieee80211_syncflag_ext(struct ieee80211vap *, int flag); |
| 82 | |
| 83 | #define	ieee80211_input(ni, m, rssi, nf) \ |
| 84 | 	((ni)->ni_vap->iv_input(ni, m, NULL, rssi, nf)) |
| 85 | int	ieee80211_input_all(struct ieee80211com *, struct mbuf *, int, int); |
| 86 | |
| 87 | int	ieee80211_input_mimo(struct ieee80211_node *, struct mbuf *); |
| 88 | int	ieee80211_input_mimo_all(struct ieee80211com *, struct mbuf *); |
| 89 | |
| 90 | struct ieee80211_bpf_params; |
| 91 | int	ieee80211_mgmt_output(struct ieee80211_node *, struct mbuf *, int, |
| 92 | 		struct ieee80211_bpf_params *); |
| 93 | int	ieee80211_raw_xmit(struct ieee80211_node *, struct mbuf *, |
| 94 | 		const struct ieee80211_bpf_params *); |
| 95 | int	ieee80211_output(struct ifnet *, struct mbuf *, |
| 96 | const struct sockaddr *, struct route *ro); |
| 97 | int	ieee80211_vap_pkt_send_dest(struct ieee80211vap *, struct mbuf *, |
| 98 | 		struct ieee80211_node *); |
| 99 | int	ieee80211_raw_output(struct ieee80211vap *, struct ieee80211_node *, |
| 100 | 		struct mbuf *, const struct ieee80211_bpf_params *); |
| 101 | void	ieee80211_send_setup(struct ieee80211_node *, struct mbuf *, int, int, |
| 102 | const uint8_t [IEEE80211_ADDR_LEN], const uint8_t [IEEE80211_ADDR_LEN], |
| 103 | const uint8_t [IEEE80211_ADDR_LEN]); |
| 104 | int	ieee80211_vap_transmit(struct ifnet *ifp, struct mbuf *m); |
| 105 | void	ieee80211_vap_qflush(struct ifnet *ifp); |
| 106 | int	ieee80211_send_nulldata(struct ieee80211_node *); |
| 107 | int	ieee80211_classify(struct ieee80211_node *, struct mbuf *m); |
| 108 | struct mbuf *ieee80211_mbuf_adjust(struct ieee80211vap *, int, |
| 109 | 		struct ieee80211_key *, struct mbuf *); |
| 110 | struct mbuf *ieee80211_encap(struct ieee80211vap *, struct ieee80211_node *, |
| 111 | 		struct mbuf *); |
| 112 | void	ieee80211_free_mbuf(struct mbuf *); |
| 113 | int	ieee80211_send_mgmt(struct ieee80211_node *, int, int); |
| 114 | struct ieee80211_appie; |
| 115 | int	ieee80211_probereq_ie(struct ieee80211vap *, struct ieee80211com *, |
| 116 | 		uint8_t **, uint32_t *, const uint8_t *, size_t, bool); |
| 117 | int	ieee80211_send_probereq(struct ieee80211_node *ni, |
| 118 | 		const uint8_t sa[IEEE80211_ADDR_LEN], |
| 119 | 		const uint8_t da[IEEE80211_ADDR_LEN], |
| 120 | 		const uint8_t bssid[IEEE80211_ADDR_LEN], |
| 121 | 		const uint8_t *ssid, size_t ssidlen); |
| 122 | struct mbuf *	ieee80211_ff_encap1(struct ieee80211vap *, struct mbuf *, |
| 123 | 		const struct ether_header *); |
| 124 | void	ieee80211_tx_complete(struct ieee80211_node *, |
| 125 | 		struct mbuf *, int); |
| 126 | void	ieee80211_output_seqno_assign(struct ieee80211_node *, |
| 127 | 		int, struct mbuf *); |
| 128 | void	ieee80211_output_beacon_seqno_assign(struct ieee80211_node *, |
| 129 | 		struct mbuf *); |
| 130 | |
| 131 | /* |
| 132 | * The formation of ProbeResponse frames requires guidance to |
| 133 | * deal with legacy clients. When the client is identified as |
| 134 | * "legacy 11b" ieee80211_send_proberesp is passed this token. |
| 135 | */ |
| 136 | #define	IEEE80211_SEND_LEGACY_11B	0x1	/* legacy 11b client */ |
| 137 | #define	IEEE80211_SEND_LEGACY_11	0x2	/* other legacy client */ |
| 138 | #define	IEEE80211_SEND_LEGACY		0x3	/* any legacy client */ |
| 139 | struct mbuf *ieee80211_alloc_proberesp(struct ieee80211_node *, int); |
| 140 | int	ieee80211_send_proberesp(struct ieee80211vap *, |
| 141 | 		const uint8_t da[IEEE80211_ADDR_LEN], int); |
| 142 | struct mbuf *ieee80211_alloc_rts(struct ieee80211com *ic, |
| 143 | 		const uint8_t [IEEE80211_ADDR_LEN], |
| 144 | 		const uint8_t [IEEE80211_ADDR_LEN], uint16_t); |
| 145 | struct mbuf *ieee80211_alloc_cts(struct ieee80211com *, |
| 146 | 		const uint8_t [IEEE80211_ADDR_LEN], uint16_t); |
| 147 | struct mbuf *ieee80211_alloc_prot(struct ieee80211_node *, |
| 148 | 		const struct mbuf *, uint8_t, int); |
| 149 | |
| 150 | uint8_t *ieee80211_add_rates(uint8_t *, const struct ieee80211_rateset *); |
| 151 | uint8_t *ieee80211_add_xrates(uint8_t *, const struct ieee80211_rateset *); |
| 152 | uint8_t *ieee80211_add_ssid(uint8_t *, const uint8_t *, u_int); |
| 153 | uint8_t *ieee80211_add_wpa(uint8_t *, const struct ieee80211vap *); |
| 154 | uint8_t *ieee80211_add_rsn(uint8_t *, const struct ieee80211vap *); |
| 155 | uint8_t *ieee80211_add_qos(uint8_t *, const struct ieee80211_node *); |
| 156 | uint16_t ieee80211_getcapinfo(struct ieee80211vap *, |
| 157 | 		struct ieee80211_channel *); |
| 158 | struct ieee80211_wme_state; |
| 159 | uint8_t * ieee80211_add_wme_info(uint8_t *frm, struct ieee80211_wme_state *wme, |
| 160 | 	 struct ieee80211_node *ni); |
| 161 | |
| 162 | void	ieee80211_vap_reset_erp(struct ieee80211vap *); |
| 163 | void	ieee80211_reset_erp(struct ieee80211com *); |
| 164 | void	ieee80211_vap_set_shortslottime(struct ieee80211vap *, int onoff); |
| 165 | int	ieee80211_iserp_rateset(const struct ieee80211_rateset *); |
| 166 | void	ieee80211_setbasicrates(struct ieee80211_rateset *, |
| 167 | 		enum ieee80211_phymode); |
| 168 | void	ieee80211_addbasicrates(struct ieee80211_rateset *, |
| 169 | 		enum ieee80211_phymode); |
| 170 | |
| 171 | /* |
| 172 | * Return the size of the 802.11 header for a management or data frame. |
| 173 | */ |
| 174 | static __inline int |
| 175 | ieee80211_hdrsize(const void *data) |
| 176 | { |
| 177 | 	const struct ieee80211_frame *wh = data; |
| 178 | 	int size = sizeof(struct ieee80211_frame); |
| 179 | |
| 180 | 	/* NB: we don't handle control frames */ |
| 181 | 	KASSERT((wh->i_fc[0]&IEEE80211_FC0_TYPE_MASK) != IEEE80211_FC0_TYPE_CTL, |
| 182 | 		("%s: control frame", __func__)); |
| 183 | 	if (IEEE80211_IS_DSTODS(wh)) |
| 184 | 		size += IEEE80211_ADDR_LEN; |
| 185 | 	if (IEEE80211_QOS_HAS_SEQ(wh)) |
| 186 | 		size += sizeof(uint16_t); |
| 187 | 	return size; |
| 188 | } |
| 189 | |
| 190 | /* |
| 191 | * Like ieee80211_hdrsize, but handles any type of frame. |
| 192 | */ |
| 193 | static __inline int |
| 194 | ieee80211_anyhdrsize(const void *data) |
| 195 | { |
| 196 | 	const struct ieee80211_frame *wh = data; |
| 197 | |
| 198 | 	if ((wh->i_fc[0]&IEEE80211_FC0_TYPE_MASK) == IEEE80211_FC0_TYPE_CTL) { |
| 199 | 		switch (wh->i_fc[0] & IEEE80211_FC0_SUBTYPE_MASK) { |
| 200 | 		case IEEE80211_FC0_SUBTYPE_CTS: |
| 201 | 		case IEEE80211_FC0_SUBTYPE_ACK: |
| 202 | 			return sizeof(struct ieee80211_frame_ack); |
| 203 | 		case IEEE80211_FC0_SUBTYPE_BAR: |
| 204 | 			return sizeof(struct ieee80211_frame_bar); |
| 205 | 		} |
| 206 | 		return sizeof(struct ieee80211_frame_min); |
| 207 | 	} else |
| 208 | 		return ieee80211_hdrsize(data); |
| 209 | } |
| 210 | |
| 211 | /* |
| 212 | * Template for an in-kernel authenticator. Authenticators |
| 213 | * register with the protocol code and are typically loaded |
| 214 | * as separate modules as needed. One special authenticator |
| 215 | * is xauth; it intercepts requests so that protocols like |
| 216 | * WPA can be handled in user space. |
| 217 | */ |
| 218 | struct ieee80211_authenticator { |
| 219 | 	const char *ia_name;		/* printable name */ |
| 220 | 	int	(*ia_attach)(struct ieee80211vap *); |
| 221 | 	void	(*ia_detach)(struct ieee80211vap *); |
| 222 | 	void	(*ia_node_join)(struct ieee80211_node *); |
| 223 | 	void	(*ia_node_leave)(struct ieee80211_node *); |
| 224 | }; |
| 225 | void	ieee80211_authenticator_register(int type, |
| 226 | 		const struct ieee80211_authenticator *); |
| 227 | void	ieee80211_authenticator_unregister(int type); |
| 228 | const struct ieee80211_authenticator *ieee80211_authenticator_get(int auth); |
| 229 | |
| 230 | struct ieee80211req; |
| 231 | /* |
| 232 | * Template for an MAC ACL policy module. Such modules |
| 233 | * register with the protocol code and are passed the sender's |
| 234 | * address of each received auth frame for validation. |
| 235 | */ |
| 236 | struct ieee80211_aclator { |
| 237 | 	const char *iac_name;		/* printable name */ |
| 238 | 	int	(*iac_attach)(struct ieee80211vap *); |
| 239 | 	void	(*iac_detach)(struct ieee80211vap *); |
| 240 | 	int	(*iac_check)(struct ieee80211vap *, |
| 241 | 			const struct ieee80211_frame *wh); |
| 242 | 	int	(*iac_add)(struct ieee80211vap *, |
| 243 | 			const uint8_t mac[IEEE80211_ADDR_LEN]); |
| 244 | 	int	(*iac_remove)(struct ieee80211vap *, |
| 245 | 			const uint8_t mac[IEEE80211_ADDR_LEN]); |
| 246 | 	int	(*iac_flush)(struct ieee80211vap *); |
| 247 | 	int	(*iac_setpolicy)(struct ieee80211vap *, int); |
| 248 | 	int	(*iac_getpolicy)(struct ieee80211vap *); |
| 249 | 	int	(*iac_setioctl)(struct ieee80211vap *, struct ieee80211req *); |
| 250 | 	int	(*iac_getioctl)(struct ieee80211vap *, struct ieee80211req *); |
| 251 | }; |
| 252 | void	ieee80211_aclator_register(const struct ieee80211_aclator *); |
| 253 | void	ieee80211_aclator_unregister(const struct ieee80211_aclator *); |
| 254 | const struct ieee80211_aclator *ieee80211_aclator_get(const char *name); |
| 255 | |
| 256 | /* flags for ieee80211_fix_rate() */ |
| 257 | #define	IEEE80211_F_DOSORT	0x00000001	/* sort rate list */ |
| 258 | #define	IEEE80211_F_DOFRATE	0x00000002	/* use fixed legacy rate */ |
| 259 | #define	IEEE80211_F_DONEGO	0x00000004	/* calc negotiated rate */ |
| 260 | #define	IEEE80211_F_DODEL	0x00000008	/* delete ignore rate */ |
| 261 | #define	IEEE80211_F_DOBRS	0x00000010	/* check basic rate set */ |
| 262 | #define	IEEE80211_F_JOIN	0x00000020	/* sta joining our bss */ |
| 263 | #define	IEEE80211_F_DOFMCS	0x00000040	/* use fixed HT rate */ |
| 264 | int	ieee80211_fix_rate(struct ieee80211_node *, |
| 265 | 		struct ieee80211_rateset *, int); |
| 266 | |
| 267 | /* |
| 268 | * WME/WMM support. |
| 269 | */ |
| 270 | struct wmeParams { |
| 271 | 	uint8_t		wmep_acm; |
| 272 | 	uint8_t		wmep_aifsn; |
| 273 | 	uint8_t		wmep_logcwmin;		/* log2(cwmin) */ |
| 274 | 	uint8_t		wmep_logcwmax;		/* log2(cwmax) */ |
| 275 | 	uint8_t		wmep_txopLimit; |
| 276 | 	uint8_t		wmep_noackPolicy;	/* 0 (ack), 1 (no ack) */ |
| 277 | }; |
| 278 | #define	IEEE80211_TXOP_TO_US(_txop)	((_txop)<<5) |
| 279 | #define	IEEE80211_US_TO_TXOP(_us)	((_us)>>5) |
| 280 | |
| 281 | struct chanAccParams { |
| 282 | 	uint8_t		cap_info;		/* version of the current set */ |
| 283 | 	struct wmeParams cap_wmeParams[WME_NUM_AC]; |
| 284 | }; |
| 285 | |
| 286 | struct ieee80211_wme_state { |
| 287 | 	u_int	wme_flags; |
| 288 | #define	WME_F_AGGRMODE	0x00000001	/* STATUS: WME aggressive mode */ |
| 289 | 	u_int	wme_hipri_traffic;	/* VI/VO frames in beacon interval */ |
| 290 | 	u_int	wme_hipri_switch_thresh;/* aggressive mode switch thresh */ |
| 291 | 	u_int	wme_hipri_switch_hysteresis;/* aggressive mode switch hysteresis */ |
| 292 | |
| 293 | 	struct wmeParams wme_params[WME_NUM_AC]; /* from assoc resp for each AC */ |
| 294 | 	struct chanAccParams wme_wmeChanParams;	/* WME params applied to self */ |
| 295 | 	struct chanAccParams wme_wmeBssChanParams;/* WME params bcast to stations */ |
| 296 | 	struct chanAccParams wme_chanParams;	/* params applied to self */ |
| 297 | 	struct chanAccParams wme_bssChanParams;	/* params bcast to stations */ |
| 298 | |
| 299 | 	int	(*wme_update)(struct ieee80211com *); |
| 300 | }; |
| 301 | |
| 302 | void	ieee80211_wme_initparams(struct ieee80211vap *); |
| 303 | void	ieee80211_wme_updateparams(struct ieee80211vap *); |
| 304 | void	ieee80211_wme_updateparams_locked(struct ieee80211vap *); |
| 305 | void	ieee80211_wme_vap_getparams(struct ieee80211vap *vap, |
| 306 | 	 struct chanAccParams *); |
| 307 | void	ieee80211_wme_ic_getparams(struct ieee80211com *ic, |
| 308 | 	 struct chanAccParams *); |
| 309 | int	ieee80211_wme_vap_ac_is_noack(struct ieee80211vap *vap, int ac); |
| 310 | void	ieee80211_vap_update_preamble(struct ieee80211vap *vap); |
| 311 | void	ieee80211_vap_update_erp_protmode(struct ieee80211vap *vap); |
| 312 | void	ieee80211_vap_update_ht_protmode(struct ieee80211vap *vap); |
| 313 | |
| 314 | /* |
| 315 | * Return pointer to the QoS field from a Qos frame. |
| 316 | */ |
| 317 | static __inline uint8_t * |
| 318 | ieee80211_getqos(void *data) |
| 319 | { |
| 320 | 	struct ieee80211_frame *wh = data; |
| 321 | |
| 322 | 	KASSERT(IEEE80211_QOS_HAS_SEQ(wh), ("QoS field is absent!")); |
| 323 | |
| 324 | 	if (IEEE80211_IS_DSTODS(wh)) |
| 325 | 		return (((struct ieee80211_qosframe_addr4 *)wh)->i_qos); |
| 326 | 	else |
| 327 | 		return (((struct ieee80211_qosframe *)wh)->i_qos); |
| 328 | } |
| 329 | |
| 330 | /* |
| 331 | * Return the WME TID from a QoS frame. If no TID |
| 332 | * is present return the index for the "non-QoS" entry. |
| 333 | */ |
| 334 | static __inline uint8_t |
| 335 | ieee80211_gettid(const struct ieee80211_frame *wh) |
| 336 | { |
| 337 | 	uint8_t tid; |
| 338 | |
| 339 | 	if (IEEE80211_QOS_HAS_SEQ(wh)) { |
| 340 | 		if (IEEE80211_IS_DSTODS(wh)) |
| 341 | 			tid = ((const struct ieee80211_qosframe_addr4 *)wh)-> |
| 342 | 				i_qos[0]; |
| 343 | 		else |
| 344 | 			tid = ((const struct ieee80211_qosframe *)wh)->i_qos[0]; |
| 345 | 		tid &= IEEE80211_QOS_TID; |
| 346 | 	} else |
| 347 | 		tid = IEEE80211_NONQOS_TID; |
| 348 | 	return tid; |
| 349 | } |
| 350 | |
| 351 | void	ieee80211_waitfor_parent(struct ieee80211com *); |
| 352 | void	ieee80211_start_locked(struct ieee80211vap *); |
| 353 | void	ieee80211_init(void *); |
| 354 | void	ieee80211_start_all(struct ieee80211com *); |
| 355 | void	ieee80211_stop_locked(struct ieee80211vap *); |
| 356 | void	ieee80211_stop(struct ieee80211vap *); |
| 357 | void	ieee80211_stop_all(struct ieee80211com *); |
| 358 | void	ieee80211_suspend_all(struct ieee80211com *); |
| 359 | void	ieee80211_resume_all(struct ieee80211com *); |
| 360 | void	ieee80211_restart_all(struct ieee80211com *); |
| 361 | void	ieee80211_dturbo_switch(struct ieee80211vap *, int newflags); |
| 362 | void	ieee80211_swbmiss(void *arg); |
| 363 | void	ieee80211_beacon_miss(struct ieee80211com *); |
| 364 | int	ieee80211_new_state(struct ieee80211vap *, enum ieee80211_state, int); |
| 365 | int	ieee80211_new_state_locked(struct ieee80211vap *, enum ieee80211_state, |
| 366 | 		int); |
| 367 | void	ieee80211_print_essid(const uint8_t *, int); |
| 368 | void	ieee80211_dump_pkt(struct ieee80211com *, |
| 369 | 		const uint8_t *, int, int, int); |
| 370 | |
| 371 | extern 	const char *ieee80211_opmode_name[]; |
| 372 | extern	const char *ieee80211_state_name[IEEE80211_S_MAX]; |
| 373 | extern	const char *ieee80211_wme_acnames[]; |
| 374 | |
| 375 | /* |
| 376 | * Beacon frames constructed by ieee80211_beacon_alloc |
| 377 | * have the following structure filled in so drivers |
| 378 | * can update the frame later w/ minimal overhead. |
| 379 | */ |
| 380 | struct ieee80211_beacon_offsets { |
| 381 | 	uint8_t		bo_flags[4];	/* update/state flags */ |
| 382 | 	uint16_t	*bo_caps;	/* capabilities */ |
| 383 | 	uint8_t		*bo_cfp;	/* start of CFParms element */ |
| 384 | 	uint8_t		*bo_tim;	/* start of atim/dtim */ |
| 385 | 	uint8_t		*bo_wme;	/* start of WME parameters */ |
| 386 | 	uint8_t		*bo_tdma;	/* start of TDMA parameters */ |
| 387 | 	uint8_t		*bo_tim_trailer;/* start of fixed-size trailer */ |
| 388 | 	uint16_t	bo_tim_len;	/* atim/dtim length in bytes */ |
| 389 | 	uint16_t	bo_tim_trailer_len;/* tim trailer length in bytes */ |
| 390 | 	uint8_t		*bo_erp;	/* start of ERP element */ |
| 391 | 	uint8_t		*bo_htinfo;	/* start of HT info element */ |
| 392 | 	uint8_t		*bo_ath;	/* start of ATH parameters */ |
| 393 | 	uint8_t		*bo_appie;	/* start of AppIE element */ |
| 394 | 	uint16_t	bo_appie_len;	/* AppIE length in bytes */ |
| 395 | 	uint16_t	bo_csa_trailer_len; |
| 396 | 	uint8_t		*bo_csa;	/* start of CSA element */ |
| 397 | 	uint8_t		*bo_quiet;	/* start of Quiet element */ |
| 398 | 	uint8_t		*bo_meshconf;	/* start of MESHCONF element */ |
| 399 | 	uint8_t		*bo_vhtinfo;	/* start of VHT info element (XXX VHTCAP?) */ |
| 400 | 	uint8_t		*bo_spare[2]; |
| 401 | }; |
| 402 | struct mbuf *ieee80211_beacon_alloc(struct ieee80211_node *); |
| 403 | |
| 404 | /* |
| 405 | * Beacon frame updates are signaled through calls to iv_update_beacon |
| 406 | * with one of the IEEE80211_BEACON_* tokens defined below. For devices |
| 407 | * that construct beacon frames on the host this can trigger a rebuild |
| 408 | * or defer the processing. For devices that offload beacon frame |
| 409 | * handling this callback can be used to signal a rebuild. The bo_flags |
| 410 | * array in the ieee80211_beacon_offsets structure is intended to record |
| 411 | * deferred processing requirements; ieee80211_beacon_update uses the |
| 412 | * state to optimize work. Since this structure is owned by the driver |
| 413 | * and not visible to the 802.11 layer drivers must supply an iv_update_beacon |
| 414 | * callback that marks the flag bits and schedules (as necessary) an update. |
| 415 | */ |
| 416 | enum { |
| 417 | 	IEEE80211_BEACON_CAPS	= 0,	/* capabilities */ |
| 418 | 	IEEE80211_BEACON_TIM	= 1,	/* DTIM/ATIM */ |
| 419 | 	IEEE80211_BEACON_WME	= 2, |
| 420 | 	IEEE80211_BEACON_ERP	= 3,	/* Extended Rate Phy */ |
| 421 | 	IEEE80211_BEACON_HTINFO	= 4,	/* HT Information */ |
| 422 | 	IEEE80211_BEACON_APPIE	= 5,	/* Application IE's */ |
| 423 | 	IEEE80211_BEACON_CFP	= 6,	/* CFParms */ |
| 424 | 	IEEE80211_BEACON_CSA	= 7,	/* Channel Switch Announcement */ |
| 425 | 	IEEE80211_BEACON_TDMA	= 9,	/* TDMA Info */ |
| 426 | 	IEEE80211_BEACON_ATH	= 10,	/* ATH parameters */ |
| 427 | 	IEEE80211_BEACON_MESHCONF = 11,	/* Mesh Configuration */ |
| 428 | 	IEEE80211_BEACON_QUIET	= 12,	/* Quiet time IE */ |
| 429 | 	IEEE80211_BEACON_VHTINFO	= 13,	/* VHT information */ |
| 430 | }; |
| 431 | int	ieee80211_beacon_update(struct ieee80211_node *, |
| 432 | 		struct mbuf *, int mcast); |
| 433 | |
| 434 | void	ieee80211_csa_startswitch(struct ieee80211com *, |
| 435 | 		struct ieee80211_channel *, int mode, int count); |
| 436 | void	ieee80211_csa_completeswitch(struct ieee80211com *); |
| 437 | void	ieee80211_csa_cancelswitch(struct ieee80211com *); |
| 438 | void	ieee80211_cac_completeswitch(struct ieee80211vap *); |
| 439 | |
| 440 | /* |
| 441 | * Notification methods called from the 802.11 state machine. |
| 442 | * Note that while these are defined here, their implementation |
| 443 | * is OS-specific. |
| 444 | */ |
| 445 | void	ieee80211_notify_node_join(struct ieee80211_node *, int newassoc); |
| 446 | void	ieee80211_notify_node_leave(struct ieee80211_node *); |
| 447 | void	ieee80211_notify_scan_done(struct ieee80211vap *); |
| 448 | void	ieee80211_notify_wds_discover(struct ieee80211_node *); |
| 449 | void	ieee80211_notify_csa(struct ieee80211com *, |
| 450 | 		const struct ieee80211_channel *, int mode, int count); |
| 451 | void	ieee80211_notify_radar(struct ieee80211com *, |
| 452 | 		const struct ieee80211_channel *); |
| 453 | enum ieee80211_notify_cac_event { |
| 454 | 	IEEE80211_NOTIFY_CAC_START = 0, /* CAC timer started */ |
| 455 | 	IEEE80211_NOTIFY_CAC_STOP = 1, /* CAC intentionally stopped */ |
| 456 | 	IEEE80211_NOTIFY_CAC_RADAR = 2, /* CAC stopped due to radar detectio */ |
| 457 | 	IEEE80211_NOTIFY_CAC_EXPIRE = 3, /* CAC expired w/o radar */ |
| 458 | }; |
| 459 | void	ieee80211_notify_cac(struct ieee80211com *, |
| 460 | 		const struct ieee80211_channel *, |
| 461 | 		enum ieee80211_notify_cac_event); |
| 462 | void	ieee80211_notify_node_deauth(struct ieee80211_node *); |
| 463 | void	ieee80211_notify_node_auth(struct ieee80211_node *); |
| 464 | void	ieee80211_notify_country(struct ieee80211vap *, |
| 465 | 		const uint8_t [IEEE80211_ADDR_LEN], const uint8_t cc[2]); |
| 466 | void	ieee80211_notify_radio(struct ieee80211com *, int); |
| 467 | void	ieee80211_notify_ifnet_change(struct ieee80211vap *, int); |
| 468 | #endif /* _NET80211_IEEE80211_PROTO_H_ */ |