xref: /freebsd/sys/net80211/ieee80211_freebsd.h (revision e67e85659c0de33e617e5fbf1028c6e8b49eee53)
1 /*-
2  * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
3  *
4  * Copyright (c) 2003-2008 Sam Leffler, Errno Consulting
5  * All rights reserved.
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 ``AS IS'' AND ANY EXPRESS OR
17  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
18  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
19  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
20  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
21  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
22  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
23  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
25  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26  *
27  * $FreeBSD$
28  */
29 #ifndef _NET80211_IEEE80211_FREEBSD_H_
30 #define _NET80211_IEEE80211_FREEBSD_H_
31 
32 #ifdef _KERNEL
33 #include <sys/param.h>
34 #include <sys/systm.h>
35 #include <sys/counter.h>
36 #include <sys/lock.h>
37 #include <sys/mutex.h>
38 #include <sys/rwlock.h>
39 #include <sys/sysctl.h>
40 #include <sys/taskqueue.h>
41 #include <sys/time.h>
42 
43 #include <net/debugnet.h>
44 
45 /*
46  * priv(9) NET80211 checks.
47  */
48 struct ieee80211vap;
49 int ieee80211_priv_check_vap_getkey(u_long, struct ieee80211vap *,
50     struct ifnet *);
51 int ieee80211_priv_check_vap_manage(u_long, struct ieee80211vap *,
52     struct ifnet *);
53 int ieee80211_priv_check_vap_setmac(u_long, struct ieee80211vap *,
54     struct ifnet *);
55 int ieee80211_priv_check_create_vap(u_long, struct ieee80211vap *,
56     struct ifnet *);
57 
58 /*
59  * Common state locking definitions.
60  */
61 typedef struct {
62 	char		name[16];		/* e.g. "ath0_com_lock" */
63 	struct mtx	mtx;
64 } ieee80211_com_lock_t;
65 #define	IEEE80211_LOCK_INIT(_ic, _name) do {				\
66 	ieee80211_com_lock_t *cl = &(_ic)->ic_comlock;			\
67 	snprintf(cl->name, sizeof(cl->name), "%s_com_lock", _name);	\
68 	mtx_init(&cl->mtx, cl->name, NULL, MTX_DEF | MTX_RECURSE);	\
69 } while (0)
70 #define	IEEE80211_LOCK_OBJ(_ic)	(&(_ic)->ic_comlock.mtx)
71 #define	IEEE80211_LOCK_DESTROY(_ic) mtx_destroy(IEEE80211_LOCK_OBJ(_ic))
72 #define	IEEE80211_LOCK(_ic)	   mtx_lock(IEEE80211_LOCK_OBJ(_ic))
73 #define	IEEE80211_UNLOCK(_ic)	   mtx_unlock(IEEE80211_LOCK_OBJ(_ic))
74 #define	IEEE80211_LOCK_ASSERT(_ic) \
75 	mtx_assert(IEEE80211_LOCK_OBJ(_ic), MA_OWNED)
76 #define	IEEE80211_UNLOCK_ASSERT(_ic) \
77 	mtx_assert(IEEE80211_LOCK_OBJ(_ic), MA_NOTOWNED)
78 
79 /*
80  * Transmit lock.
81  *
82  * This is a (mostly) temporary lock designed to serialise all of the
83  * transmission operations throughout the stack.
84  */
85 typedef struct {
86 	char		name[16];		/* e.g. "ath0_tx_lock" */
87 	struct mtx	mtx;
88 } ieee80211_tx_lock_t;
89 #define	IEEE80211_TX_LOCK_INIT(_ic, _name) do {				\
90 	ieee80211_tx_lock_t *cl = &(_ic)->ic_txlock;			\
91 	snprintf(cl->name, sizeof(cl->name), "%s_tx_lock", _name);	\
92 	mtx_init(&cl->mtx, cl->name, NULL, MTX_DEF);	\
93 } while (0)
94 #define	IEEE80211_TX_LOCK_OBJ(_ic)	(&(_ic)->ic_txlock.mtx)
95 #define	IEEE80211_TX_LOCK_DESTROY(_ic) mtx_destroy(IEEE80211_TX_LOCK_OBJ(_ic))
96 #define	IEEE80211_TX_LOCK(_ic)	   mtx_lock(IEEE80211_TX_LOCK_OBJ(_ic))
97 #define	IEEE80211_TX_UNLOCK(_ic)	   mtx_unlock(IEEE80211_TX_LOCK_OBJ(_ic))
98 #define	IEEE80211_TX_LOCK_ASSERT(_ic) \
99 	mtx_assert(IEEE80211_TX_LOCK_OBJ(_ic), MA_OWNED)
100 #define	IEEE80211_TX_UNLOCK_ASSERT(_ic) \
101 	mtx_assert(IEEE80211_TX_LOCK_OBJ(_ic), MA_NOTOWNED)
102 
103 /*
104  * Stageq / ni_tx_superg lock
105  */
106 typedef struct {
107 	char		name[16];		/* e.g. "ath0_ff_lock" */
108 	struct mtx	mtx;
109 } ieee80211_ff_lock_t;
110 #define IEEE80211_FF_LOCK_INIT(_ic, _name) do {				\
111 	ieee80211_ff_lock_t *fl = &(_ic)->ic_fflock;			\
112 	snprintf(fl->name, sizeof(fl->name), "%s_ff_lock", _name);	\
113 	mtx_init(&fl->mtx, fl->name, NULL, MTX_DEF);			\
114 } while (0)
115 #define IEEE80211_FF_LOCK_OBJ(_ic)	(&(_ic)->ic_fflock.mtx)
116 #define IEEE80211_FF_LOCK_DESTROY(_ic)	mtx_destroy(IEEE80211_FF_LOCK_OBJ(_ic))
117 #define IEEE80211_FF_LOCK(_ic)		mtx_lock(IEEE80211_FF_LOCK_OBJ(_ic))
118 #define IEEE80211_FF_UNLOCK(_ic)	mtx_unlock(IEEE80211_FF_LOCK_OBJ(_ic))
119 #define IEEE80211_FF_LOCK_ASSERT(_ic) \
120 	mtx_assert(IEEE80211_FF_LOCK_OBJ(_ic), MA_OWNED)
121 
122 /*
123  * Node locking definitions.
124  */
125 typedef struct {
126 	char		name[16];		/* e.g. "ath0_node_lock" */
127 	struct mtx	mtx;
128 } ieee80211_node_lock_t;
129 #define	IEEE80211_NODE_LOCK_INIT(_nt, _name) do {			\
130 	ieee80211_node_lock_t *nl = &(_nt)->nt_nodelock;		\
131 	snprintf(nl->name, sizeof(nl->name), "%s_node_lock", _name);	\
132 	mtx_init(&nl->mtx, nl->name, NULL, MTX_DEF | MTX_RECURSE);	\
133 } while (0)
134 #define	IEEE80211_NODE_LOCK_OBJ(_nt)	(&(_nt)->nt_nodelock.mtx)
135 #define	IEEE80211_NODE_LOCK_DESTROY(_nt) \
136 	mtx_destroy(IEEE80211_NODE_LOCK_OBJ(_nt))
137 #define	IEEE80211_NODE_LOCK(_nt) \
138 	mtx_lock(IEEE80211_NODE_LOCK_OBJ(_nt))
139 #define	IEEE80211_NODE_IS_LOCKED(_nt) \
140 	mtx_owned(IEEE80211_NODE_LOCK_OBJ(_nt))
141 #define	IEEE80211_NODE_UNLOCK(_nt) \
142 	mtx_unlock(IEEE80211_NODE_LOCK_OBJ(_nt))
143 #define	IEEE80211_NODE_LOCK_ASSERT(_nt)	\
144 	mtx_assert(IEEE80211_NODE_LOCK_OBJ(_nt), MA_OWNED)
145 
146 /*
147  * Power-save queue definitions.
148  */
149 typedef struct mtx ieee80211_psq_lock_t;
150 #define	IEEE80211_PSQ_INIT(_psq, _name) \
151 	mtx_init(&(_psq)->psq_lock, _name, "802.11 ps q", MTX_DEF)
152 #define	IEEE80211_PSQ_DESTROY(_psq)	mtx_destroy(&(_psq)->psq_lock)
153 #define	IEEE80211_PSQ_LOCK(_psq)	mtx_lock(&(_psq)->psq_lock)
154 #define	IEEE80211_PSQ_UNLOCK(_psq)	mtx_unlock(&(_psq)->psq_lock)
155 
156 #ifndef IF_PREPEND_LIST
157 #define _IF_PREPEND_LIST(ifq, mhead, mtail, mcount) do {	\
158 	(mtail)->m_nextpkt = (ifq)->ifq_head;			\
159 	if ((ifq)->ifq_tail == NULL)				\
160 		(ifq)->ifq_tail = (mtail);			\
161 	(ifq)->ifq_head = (mhead);				\
162 	(ifq)->ifq_len += (mcount);				\
163 } while (0)
164 #define IF_PREPEND_LIST(ifq, mhead, mtail, mcount) do {		\
165 	IF_LOCK(ifq);						\
166 	_IF_PREPEND_LIST(ifq, mhead, mtail, mcount);		\
167 	IF_UNLOCK(ifq);						\
168 } while (0)
169 #endif /* IF_PREPEND_LIST */
170 
171 /*
172  * Age queue definitions.
173  */
174 typedef struct mtx ieee80211_ageq_lock_t;
175 #define	IEEE80211_AGEQ_INIT(_aq, _name) \
176 	mtx_init(&(_aq)->aq_lock, _name, "802.11 age q", MTX_DEF)
177 #define	IEEE80211_AGEQ_DESTROY(_aq)	mtx_destroy(&(_aq)->aq_lock)
178 #define	IEEE80211_AGEQ_LOCK(_aq)	mtx_lock(&(_aq)->aq_lock)
179 #define	IEEE80211_AGEQ_UNLOCK(_aq)	mtx_unlock(&(_aq)->aq_lock)
180 
181 /*
182  * 802.1x MAC ACL database locking definitions.
183  */
184 typedef struct mtx acl_lock_t;
185 #define	ACL_LOCK_INIT(_as, _name) \
186 	mtx_init(&(_as)->as_lock, _name, "802.11 ACL", MTX_DEF)
187 #define	ACL_LOCK_DESTROY(_as)		mtx_destroy(&(_as)->as_lock)
188 #define	ACL_LOCK(_as)			mtx_lock(&(_as)->as_lock)
189 #define	ACL_UNLOCK(_as)			mtx_unlock(&(_as)->as_lock)
190 #define	ACL_LOCK_ASSERT(_as) \
191 	mtx_assert((&(_as)->as_lock), MA_OWNED)
192 
193 /*
194  * Scan table definitions.
195  */
196 typedef struct mtx ieee80211_scan_table_lock_t;
197 #define	IEEE80211_SCAN_TABLE_LOCK_INIT(_st, _name) \
198 	mtx_init(&(_st)->st_lock, _name, "802.11 scan table", MTX_DEF)
199 #define	IEEE80211_SCAN_TABLE_LOCK_DESTROY(_st)	mtx_destroy(&(_st)->st_lock)
200 #define	IEEE80211_SCAN_TABLE_LOCK(_st)		mtx_lock(&(_st)->st_lock)
201 #define	IEEE80211_SCAN_TABLE_UNLOCK(_st)	mtx_unlock(&(_st)->st_lock)
202 
203 typedef struct mtx ieee80211_scan_iter_lock_t;
204 #define	IEEE80211_SCAN_ITER_LOCK_INIT(_st, _name) \
205 	mtx_init(&(_st)->st_scanlock, _name, "802.11 scangen", MTX_DEF)
206 #define	IEEE80211_SCAN_ITER_LOCK_DESTROY(_st)	mtx_destroy(&(_st)->st_scanlock)
207 #define	IEEE80211_SCAN_ITER_LOCK(_st)		mtx_lock(&(_st)->st_scanlock)
208 #define	IEEE80211_SCAN_ITER_UNLOCK(_st)	mtx_unlock(&(_st)->st_scanlock)
209 
210 /*
211  * Mesh node/routing definitions.
212  */
213 typedef struct mtx ieee80211_rte_lock_t;
214 #define	MESH_RT_ENTRY_LOCK_INIT(_rt, _name) \
215 	mtx_init(&(rt)->rt_lock, _name, "802.11s route entry", MTX_DEF)
216 #define	MESH_RT_ENTRY_LOCK_DESTROY(_rt) \
217 	mtx_destroy(&(_rt)->rt_lock)
218 #define	MESH_RT_ENTRY_LOCK(rt)	mtx_lock(&(rt)->rt_lock)
219 #define	MESH_RT_ENTRY_LOCK_ASSERT(rt) mtx_assert(&(rt)->rt_lock, MA_OWNED)
220 #define	MESH_RT_ENTRY_UNLOCK(rt)	mtx_unlock(&(rt)->rt_lock)
221 
222 typedef struct mtx ieee80211_rt_lock_t;
223 #define	MESH_RT_LOCK(ms)	mtx_lock(&(ms)->ms_rt_lock)
224 #define	MESH_RT_LOCK_ASSERT(ms)	mtx_assert(&(ms)->ms_rt_lock, MA_OWNED)
225 #define	MESH_RT_UNLOCK(ms)	mtx_unlock(&(ms)->ms_rt_lock)
226 #define	MESH_RT_LOCK_INIT(ms, name) \
227 	mtx_init(&(ms)->ms_rt_lock, name, "802.11s routing table", MTX_DEF)
228 #define	MESH_RT_LOCK_DESTROY(ms) \
229 	mtx_destroy(&(ms)->ms_rt_lock)
230 
231 /*
232  * Node reference counting definitions.
233  *
234  * ieee80211_node_initref	initialize the reference count to 1
235  * ieee80211_node_incref	add a reference
236  * ieee80211_node_decref	remove a reference
237  * ieee80211_node_dectestref	remove a reference and return 1 if this
238  *				is the last reference, otherwise 0
239  * ieee80211_node_refcnt	reference count for printing (only)
240  */
241 #include <machine/atomic.h>
242 
243 struct ieee80211vap;
244 int	ieee80211_com_vincref(struct ieee80211vap *);
245 void	ieee80211_com_vdecref(struct ieee80211vap *);
246 void	ieee80211_com_vdetach(struct ieee80211vap *);
247 
248 #define ieee80211_node_initref(_ni) \
249 	do { ((_ni)->ni_refcnt = 1); } while (0)
250 #define ieee80211_node_incref(_ni) \
251 	atomic_add_int(&(_ni)->ni_refcnt, 1)
252 #define	ieee80211_node_decref(_ni) \
253 	atomic_subtract_int(&(_ni)->ni_refcnt, 1)
254 struct ieee80211_node;
255 int	ieee80211_node_dectestref(struct ieee80211_node *ni);
256 #define	ieee80211_node_refcnt(_ni)	(_ni)->ni_refcnt
257 
258 struct ifqueue;
259 void	ieee80211_drain_ifq(struct ifqueue *);
260 void	ieee80211_flush_ifq(struct ifqueue *, struct ieee80211vap *);
261 
262 void	ieee80211_vap_destroy(struct ieee80211vap *);
263 const char *	ieee80211_get_vap_ifname(struct ieee80211vap *);
264 
265 #define	IFNET_IS_UP_RUNNING(_ifp) \
266 	(((_ifp)->if_flags & IFF_UP) && \
267 	 ((_ifp)->if_drv_flags & IFF_DRV_RUNNING))
268 
269 #define	msecs_to_ticks(ms)	MSEC_2_TICKS(ms)
270 #define	ticks_to_msecs(t)	TICKS_2_MSEC(t)
271 #define	ticks_to_secs(t)	((t) / hz)
272 
273 #define ieee80211_time_after(a,b) 	((int)(b) - (int)(a) < 0)
274 #define ieee80211_time_before(a,b)	ieee80211_time_after(b,a)
275 #define ieee80211_time_after_eq(a,b)	((int)(a) - (int)(b) >= 0)
276 #define ieee80211_time_before_eq(a,b)	ieee80211_time_after_eq(b,a)
277 
278 struct mbuf *ieee80211_getmgtframe(uint8_t **frm, int headroom, int pktlen);
279 
280 /* tx path usage */
281 #define	M_ENCAP		M_PROTO1		/* 802.11 encap done */
282 #define	M_EAPOL		M_PROTO3		/* PAE/EAPOL frame */
283 #define	M_PWR_SAV	M_PROTO4		/* bypass PS handling */
284 #define	M_MORE_DATA	M_PROTO5		/* more data frames to follow */
285 #define	M_FF		M_PROTO6		/* fast frame / A-MSDU */
286 #define	M_TXCB		M_PROTO7		/* do tx complete callback */
287 #define	M_AMPDU_MPDU	M_PROTO8		/* ok for A-MPDU aggregation */
288 #define	M_FRAG		M_PROTO9		/* frame fragmentation */
289 #define	M_FIRSTFRAG	M_PROTO10		/* first frame fragment */
290 #define	M_LASTFRAG	M_PROTO11		/* last frame fragment */
291 
292 #define	M_80211_TX \
293 	(M_ENCAP|M_EAPOL|M_PWR_SAV|M_MORE_DATA|M_FF|M_TXCB| \
294 	 M_AMPDU_MPDU|M_FRAG|M_FIRSTFRAG|M_LASTFRAG)
295 
296 /* rx path usage */
297 #define	M_AMPDU		M_PROTO1		/* A-MPDU subframe */
298 #define	M_WEP		M_PROTO2		/* WEP done by hardware */
299 #if 0
300 #define	M_AMPDU_MPDU	M_PROTO8		/* A-MPDU re-order done */
301 #endif
302 #define	M_80211_RX	(M_AMPDU|M_WEP|M_AMPDU_MPDU)
303 
304 #define	IEEE80211_MBUF_TX_FLAG_BITS \
305 	M_FLAG_BITS \
306 	"\15M_ENCAP\17M_EAPOL\20M_PWR_SAV\21M_MORE_DATA\22M_FF\23M_TXCB" \
307 	"\24M_AMPDU_MPDU\25M_FRAG\26M_FIRSTFRAG\27M_LASTFRAG"
308 
309 #define	IEEE80211_MBUF_RX_FLAG_BITS \
310 	M_FLAG_BITS \
311 	"\15M_AMPDU\16M_WEP\24M_AMPDU_MPDU"
312 
313 /*
314  * Store WME access control bits in the vlan tag.
315  * This is safe since it's done after the packet is classified
316  * (where we use any previous tag) and because it's passed
317  * directly in to the driver and there's no chance someone
318  * else will clobber them on us.
319  */
320 #define	M_WME_SETAC(m, ac) \
321 	((m)->m_pkthdr.ether_vtag = (ac))
322 #define	M_WME_GETAC(m)	((m)->m_pkthdr.ether_vtag)
323 
324 /*
325  * Mbufs on the power save queue are tagged with an age and
326  * timed out.  We reuse the hardware checksum field in the
327  * mbuf packet header to store this data.
328  */
329 #define	M_AGE_SET(m,v)		(m->m_pkthdr.csum_data = v)
330 #define	M_AGE_GET(m)		(m->m_pkthdr.csum_data)
331 #define	M_AGE_SUB(m,adj)	(m->m_pkthdr.csum_data -= adj)
332 
333 /*
334  * Store the sequence number.
335  */
336 #define	M_SEQNO_SET(m, seqno) \
337 	((m)->m_pkthdr.tso_segsz = (seqno))
338 #define	M_SEQNO_GET(m)	((m)->m_pkthdr.tso_segsz)
339 
340 #define	MTAG_ABI_NET80211	1132948340	/* net80211 ABI */
341 
342 struct ieee80211_cb {
343 	void	(*func)(struct ieee80211_node *, void *, int status);
344 	void	*arg;
345 };
346 #define	NET80211_TAG_CALLBACK	0	/* xmit complete callback */
347 int	ieee80211_add_callback(struct mbuf *m,
348 		void (*func)(struct ieee80211_node *, void *, int), void *arg);
349 void	ieee80211_process_callback(struct ieee80211_node *, struct mbuf *, int);
350 
351 #define	NET80211_TAG_XMIT_PARAMS	1
352 /* See below; this is after the bpf_params definition */
353 
354 #define	NET80211_TAG_RECV_PARAMS	2
355 
356 #define	NET80211_TAG_TOA_PARAMS		3
357 
358 struct ieee80211com;
359 int	ieee80211_parent_xmitpkt(struct ieee80211com *, struct mbuf *);
360 int	ieee80211_vap_xmitpkt(struct ieee80211vap *, struct mbuf *);
361 
362 void	net80211_get_random_bytes(void *, size_t);
363 
364 void	ieee80211_sysctl_attach(struct ieee80211com *);
365 void	ieee80211_sysctl_detach(struct ieee80211com *);
366 void	ieee80211_sysctl_vattach(struct ieee80211vap *);
367 void	ieee80211_sysctl_vdetach(struct ieee80211vap *);
368 
369 SYSCTL_DECL(_net_wlan);
370 int	ieee80211_sysctl_msecs_ticks(SYSCTL_HANDLER_ARGS);
371 
372 void	ieee80211_load_module(const char *);
373 
374 /*
375  * A "policy module" is an adjunct module to net80211 that provides
376  * functionality that typically includes policy decisions.  This
377  * modularity enables extensibility and vendor-supplied functionality.
378  */
379 #define	_IEEE80211_POLICY_MODULE(policy, name, version)			\
380 typedef void (*policy##_setup)(int);					\
381 SET_DECLARE(policy##_set, policy##_setup);				\
382 static int								\
383 wlan_##name##_modevent(module_t mod, int type, void *unused)		\
384 {									\
385 	policy##_setup * const *iter, f;				\
386 	switch (type) {							\
387 	case MOD_LOAD:							\
388 		SET_FOREACH(iter, policy##_set) {			\
389 			f = (void*) *iter;				\
390 			f(type);					\
391 		}							\
392 		return 0;						\
393 	case MOD_UNLOAD:						\
394 	case MOD_QUIESCE:						\
395 		if (nrefs) {						\
396 			printf("wlan_" #name ": still in use "		\
397 				"(%u dynamic refs)\n", nrefs);		\
398 			return EBUSY;					\
399 		}							\
400 		if (type == MOD_UNLOAD) {				\
401 			SET_FOREACH(iter, policy##_set) {		\
402 				f = (void*) *iter;			\
403 				f(type);				\
404 			}						\
405 		}							\
406 		return 0;						\
407 	}								\
408 	return EINVAL;							\
409 }									\
410 static moduledata_t name##_mod = {					\
411 	"wlan_" #name,							\
412 	wlan_##name##_modevent,						\
413 	0								\
414 };									\
415 DECLARE_MODULE(wlan_##name, name##_mod, SI_SUB_DRIVERS, SI_ORDER_FIRST);\
416 MODULE_VERSION(wlan_##name, version);					\
417 MODULE_DEPEND(wlan_##name, wlan, 1, 1, 1)
418 
419 /*
420  * Crypto modules implement cipher support.
421  */
422 #define	IEEE80211_CRYPTO_MODULE(name, version)				\
423 _IEEE80211_POLICY_MODULE(crypto, name, version);			\
424 static void								\
425 name##_modevent(int type)						\
426 {									\
427 	if (type == MOD_LOAD)						\
428 		ieee80211_crypto_register(&name);			\
429 	else								\
430 		ieee80211_crypto_unregister(&name);			\
431 }									\
432 TEXT_SET(crypto##_set, name##_modevent)
433 
434 /*
435  * Scanner modules provide scanning policy.
436  */
437 #define	IEEE80211_SCANNER_MODULE(name, version)				\
438 	_IEEE80211_POLICY_MODULE(scanner, name, version)
439 
440 #define	IEEE80211_SCANNER_ALG(name, alg, v)				\
441 static void								\
442 name##_modevent(int type)						\
443 {									\
444 	if (type == MOD_LOAD)						\
445 		ieee80211_scanner_register(alg, &v);			\
446 	else								\
447 		ieee80211_scanner_unregister(alg, &v);			\
448 }									\
449 TEXT_SET(scanner_set, name##_modevent);					\
450 
451 /*
452  * ACL modules implement acl policy.
453  */
454 #define	IEEE80211_ACL_MODULE(name, alg, version)			\
455 _IEEE80211_POLICY_MODULE(acl, name, version);				\
456 static void								\
457 alg##_modevent(int type)						\
458 {									\
459 	if (type == MOD_LOAD)						\
460 		ieee80211_aclator_register(&alg);			\
461 	else								\
462 		ieee80211_aclator_unregister(&alg);			\
463 }									\
464 TEXT_SET(acl_set, alg##_modevent);					\
465 
466 /*
467  * Authenticator modules handle 802.1x/WPA authentication.
468  */
469 #define	IEEE80211_AUTH_MODULE(name, version)				\
470 	_IEEE80211_POLICY_MODULE(auth, name, version)
471 
472 #define	IEEE80211_AUTH_ALG(name, alg, v)				\
473 static void								\
474 name##_modevent(int type)						\
475 {									\
476 	if (type == MOD_LOAD)						\
477 		ieee80211_authenticator_register(alg, &v);		\
478 	else								\
479 		ieee80211_authenticator_unregister(alg);		\
480 }									\
481 TEXT_SET(auth_set, name##_modevent)
482 
483 /*
484  * Rate control modules provide tx rate control support.
485  */
486 #define	IEEE80211_RATECTL_MODULE(alg, version)				\
487 	_IEEE80211_POLICY_MODULE(ratectl, alg, version);		\
488 
489 #define	IEEE80211_RATECTL_ALG(name, alg, v)				\
490 static void								\
491 alg##_modevent(int type)						\
492 {									\
493 	if (type == MOD_LOAD)						\
494 		ieee80211_ratectl_register(alg, &v);			\
495 	else								\
496 		ieee80211_ratectl_unregister(alg);			\
497 }									\
498 TEXT_SET(ratectl##_set, alg##_modevent)
499 
500 struct ieee80211req;
501 typedef int ieee80211_ioctl_getfunc(struct ieee80211vap *,
502     struct ieee80211req *);
503 SET_DECLARE(ieee80211_ioctl_getset, ieee80211_ioctl_getfunc);
504 #define	IEEE80211_IOCTL_GET(_name, _get) TEXT_SET(ieee80211_ioctl_getset, _get)
505 
506 typedef int ieee80211_ioctl_setfunc(struct ieee80211vap *,
507     struct ieee80211req *);
508 SET_DECLARE(ieee80211_ioctl_setset, ieee80211_ioctl_setfunc);
509 #define	IEEE80211_IOCTL_SET(_name, _set) TEXT_SET(ieee80211_ioctl_setset, _set)
510 
511 #ifdef DEBUGNET
512 typedef void debugnet80211_init_t(struct ieee80211com *, int *nrxr, int *ncl,
513     int *clsize);
514 typedef void debugnet80211_event_t(struct ieee80211com *, enum debugnet_ev);
515 typedef int debugnet80211_poll_t(struct ieee80211com *, int);
516 
517 struct debugnet80211_methods {
518 	debugnet80211_init_t		*dn8_init;
519 	debugnet80211_event_t		*dn8_event;
520 	debugnet80211_poll_t		*dn8_poll;
521 };
522 
523 #define	DEBUGNET80211_DEFINE(driver)					\
524 	static debugnet80211_init_t driver##_debugnet80211_init;		\
525 	static debugnet80211_event_t driver##_debugnet80211_event;	\
526 	static debugnet80211_poll_t driver##_debugnet80211_poll;		\
527 									\
528 	static struct debugnet80211_methods driver##_debugnet80211_methods = { \
529 		.dn8_init = driver##_debugnet80211_init,			\
530 		.dn8_event = driver##_debugnet80211_event,		\
531 		.dn8_poll = driver##_debugnet80211_poll,			\
532 	}
533 #define DEBUGNET80211_SET(ic, driver)					\
534 	(ic)->ic_debugnet_meth = &driver##_debugnet80211_methods
535 #else
536 #define DEBUGNET80211_DEFINE(driver)
537 #define DEBUGNET80211_SET(ic, driver)
538 #endif /* DEBUGNET */
539 
540 #endif /* _KERNEL */
541 
542 /* XXX this stuff belongs elsewhere */
543 /*
544  * Message formats for messages from the net80211 layer to user
545  * applications via the routing socket.  These messages are appended
546  * to an if_announcemsghdr structure.
547  */
548 struct ieee80211_join_event {
549 	uint8_t		iev_addr[6];
550 };
551 
552 struct ieee80211_leave_event {
553 	uint8_t		iev_addr[6];
554 };
555 
556 struct ieee80211_replay_event {
557 	uint8_t		iev_src[6];	/* src MAC */
558 	uint8_t		iev_dst[6];	/* dst MAC */
559 	uint8_t		iev_cipher;	/* cipher type */
560 	uint8_t		iev_keyix;	/* key id/index */
561 	uint64_t	iev_keyrsc;	/* RSC from key */
562 	uint64_t	iev_rsc;	/* RSC from frame */
563 };
564 
565 struct ieee80211_michael_event {
566 	uint8_t		iev_src[6];	/* src MAC */
567 	uint8_t		iev_dst[6];	/* dst MAC */
568 	uint8_t		iev_cipher;	/* cipher type */
569 	uint8_t		iev_keyix;	/* key id/index */
570 };
571 
572 struct ieee80211_wds_event {
573 	uint8_t		iev_addr[6];
574 };
575 
576 struct ieee80211_csa_event {
577 	uint32_t	iev_flags;	/* channel flags */
578 	uint16_t	iev_freq;	/* setting in Mhz */
579 	uint8_t		iev_ieee;	/* IEEE channel number */
580 	uint8_t		iev_mode;	/* CSA mode */
581 	uint8_t		iev_count;	/* CSA count */
582 };
583 
584 struct ieee80211_cac_event {
585 	uint32_t	iev_flags;	/* channel flags */
586 	uint16_t	iev_freq;	/* setting in Mhz */
587 	uint8_t		iev_ieee;	/* IEEE channel number */
588 	/* XXX timestamp? */
589 	uint8_t		iev_type;	/* IEEE80211_NOTIFY_CAC_* */
590 };
591 
592 struct ieee80211_radar_event {
593 	uint32_t	iev_flags;	/* channel flags */
594 	uint16_t	iev_freq;	/* setting in Mhz */
595 	uint8_t		iev_ieee;	/* IEEE channel number */
596 	/* XXX timestamp? */
597 };
598 
599 struct ieee80211_auth_event {
600 	uint8_t		iev_addr[6];
601 };
602 
603 struct ieee80211_deauth_event {
604 	uint8_t		iev_addr[6];
605 };
606 
607 struct ieee80211_country_event {
608 	uint8_t		iev_addr[6];
609 	uint8_t		iev_cc[2];	/* ISO country code */
610 };
611 
612 struct ieee80211_radio_event {
613 	uint8_t		iev_state;	/* 1 on, 0 off */
614 };
615 
616 #define	RTM_IEEE80211_ASSOC	100	/* station associate (bss mode) */
617 #define	RTM_IEEE80211_REASSOC	101	/* station re-associate (bss mode) */
618 #define	RTM_IEEE80211_DISASSOC	102	/* station disassociate (bss mode) */
619 #define	RTM_IEEE80211_JOIN	103	/* station join (ap mode) */
620 #define	RTM_IEEE80211_LEAVE	104	/* station leave (ap mode) */
621 #define	RTM_IEEE80211_SCAN	105	/* scan complete, results available */
622 #define	RTM_IEEE80211_REPLAY	106	/* sequence counter replay detected */
623 #define	RTM_IEEE80211_MICHAEL	107	/* Michael MIC failure detected */
624 #define	RTM_IEEE80211_REJOIN	108	/* station re-associate (ap mode) */
625 #define	RTM_IEEE80211_WDS	109	/* WDS discovery (ap mode) */
626 #define	RTM_IEEE80211_CSA	110	/* Channel Switch Announcement event */
627 #define	RTM_IEEE80211_RADAR	111	/* radar event */
628 #define	RTM_IEEE80211_CAC	112	/* Channel Availability Check event */
629 #define	RTM_IEEE80211_DEAUTH	113	/* station deauthenticate */
630 #define	RTM_IEEE80211_AUTH	114	/* station authenticate (ap mode) */
631 #define	RTM_IEEE80211_COUNTRY	115	/* discovered country code (sta mode) */
632 #define	RTM_IEEE80211_RADIO	116	/* RF kill switch state change */
633 
634 /*
635  * Structure prepended to raw packets sent through the bpf
636  * interface when set to DLT_IEEE802_11_RADIO.  This allows
637  * user applications to specify pretty much everything in
638  * an Atheros tx descriptor.  XXX need to generalize.
639  *
640  * XXX cannot be more than 14 bytes as it is copied to a sockaddr's
641  * XXX sa_data area.
642  */
643 struct ieee80211_bpf_params {
644 	uint8_t		ibp_vers;	/* version */
645 #define	IEEE80211_BPF_VERSION	0
646 	uint8_t		ibp_len;	/* header length in bytes */
647 	uint8_t		ibp_flags;
648 #define	IEEE80211_BPF_SHORTPRE	0x01	/* tx with short preamble */
649 #define	IEEE80211_BPF_NOACK	0x02	/* tx with no ack */
650 #define	IEEE80211_BPF_CRYPTO	0x04	/* tx with h/w encryption */
651 #define	IEEE80211_BPF_FCS	0x10	/* frame incldues FCS */
652 #define	IEEE80211_BPF_DATAPAD	0x20	/* frame includes data padding */
653 #define	IEEE80211_BPF_RTS	0x40	/* tx with RTS/CTS */
654 #define	IEEE80211_BPF_CTS	0x80	/* tx with CTS only */
655 	uint8_t		ibp_pri;	/* WME/WMM AC+tx antenna */
656 	uint8_t		ibp_try0;	/* series 1 try count */
657 	uint8_t		ibp_rate0;	/* series 1 IEEE tx rate */
658 	uint8_t		ibp_power;	/* tx power (device units) */
659 	uint8_t		ibp_ctsrate;	/* IEEE tx rate for CTS */
660 	uint8_t		ibp_try1;	/* series 2 try count */
661 	uint8_t		ibp_rate1;	/* series 2 IEEE tx rate */
662 	uint8_t		ibp_try2;	/* series 3 try count */
663 	uint8_t		ibp_rate2;	/* series 3 IEEE tx rate */
664 	uint8_t		ibp_try3;	/* series 4 try count */
665 	uint8_t		ibp_rate3;	/* series 4 IEEE tx rate */
666 };
667 
668 #ifdef _KERNEL
669 struct ieee80211_tx_params {
670 	struct ieee80211_bpf_params params;
671 };
672 int	ieee80211_add_xmit_params(struct mbuf *m,
673 	    const struct ieee80211_bpf_params *);
674 int	ieee80211_get_xmit_params(struct mbuf *m,
675 	    struct ieee80211_bpf_params *);
676 
677 struct ieee80211_rx_params;
678 struct ieee80211_rx_stats;
679 
680 int	ieee80211_add_rx_params(struct mbuf *m,
681 	    const struct ieee80211_rx_stats *rxs);
682 int	ieee80211_get_rx_params(struct mbuf *m,
683 	    struct ieee80211_rx_stats *rxs);
684 const struct ieee80211_rx_stats * ieee80211_get_rx_params_ptr(struct mbuf *m);
685 
686 struct ieee80211_toa_params {
687 	int request_id;
688 };
689 int	ieee80211_add_toa_params(struct mbuf *m,
690 	    const struct ieee80211_toa_params *p);
691 int	ieee80211_get_toa_params(struct mbuf *m,
692 	    struct ieee80211_toa_params *p);
693 
694 #define	IEEE80211_F_SURVEY_TIME		0x00000001
695 #define	IEEE80211_F_SURVEY_TIME_BUSY	0x00000002
696 #define	IEEE80211_F_SURVEY_NOISE_DBM	0x00000004
697 #define	IEEE80211_F_SURVEY_TSC		0x00000008
698 struct ieee80211_channel_survey {
699 	uint32_t s_flags;
700 	uint32_t s_time;
701 	uint32_t s_time_busy;
702 	int32_t s_noise;
703 	uint64_t s_tsc;
704 };
705 
706 #endif /* _KERNEL */
707 
708 /*
709  * Malloc API.  Other BSD operating systems have slightly
710  * different malloc/free namings (eg DragonflyBSD.)
711  */
712 #define	IEEE80211_MALLOC	malloc
713 #define	IEEE80211_FREE		free
714 
715 /* XXX TODO: get rid of WAITOK, fix all the users of it? */
716 #define	IEEE80211_M_NOWAIT	M_NOWAIT
717 #define	IEEE80211_M_WAITOK	M_WAITOK
718 #define	IEEE80211_M_ZERO	M_ZERO
719 
720 /* XXX TODO: the type fields */
721 
722 #endif /* _NET80211_IEEE80211_FREEBSD_H_ */
723