ieee80211_ioctl.h revision 234894
1/*-
2 * Copyright (c) 2001 Atsushi Onoe
3 * Copyright (c) 2002-2009 Sam Leffler, Errno Consulting
4 * All rights reserved.
5 *
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions
8 * are met:
9 * 1. Redistributions of source code must retain the above copyright
10 *    notice, this list of conditions and the following disclaimer.
11 * 2. Redistributions in binary form must reproduce the above copyright
12 *    notice, this list of conditions and the following disclaimer in the
13 *    documentation and/or other materials provided with the distribution.
14 *
15 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
16 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
17 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
18 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
19 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
20 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
21 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
22 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
24 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25 *
26 * $FreeBSD: head/sys/net80211/ieee80211_ioctl.h 234894 2012-05-01 16:16:20Z monthadar $
27 */
28#ifndef _NET80211_IEEE80211_IOCTL_H_
29#define _NET80211_IEEE80211_IOCTL_H_
30
31/*
32 * IEEE 802.11 ioctls.
33 */
34#include <net80211/_ieee80211.h>
35#include <net80211/ieee80211.h>
36#include <net80211/ieee80211_crypto.h>
37
38/*
39 * Per/node (station) statistics.
40 */
41struct ieee80211_nodestats {
42	uint32_t	ns_rx_data;		/* rx data frames */
43	uint32_t	ns_rx_mgmt;		/* rx management frames */
44	uint32_t	ns_rx_ctrl;		/* rx control frames */
45	uint32_t	ns_rx_ucast;		/* rx unicast frames */
46	uint32_t	ns_rx_mcast;		/* rx multi/broadcast frames */
47	uint64_t	ns_rx_bytes;		/* rx data count (bytes) */
48	uint64_t	ns_rx_beacons;		/* rx beacon frames */
49	uint32_t	ns_rx_proberesp;	/* rx probe response frames */
50
51	uint32_t	ns_rx_dup;		/* rx discard 'cuz dup */
52	uint32_t	ns_rx_noprivacy;	/* rx w/ wep but privacy off */
53	uint32_t	ns_rx_wepfail;		/* rx wep processing failed */
54	uint32_t	ns_rx_demicfail;	/* rx demic failed */
55	uint32_t	ns_rx_decap;		/* rx decapsulation failed */
56	uint32_t	ns_rx_defrag;		/* rx defragmentation failed */
57	uint32_t	ns_rx_disassoc;		/* rx disassociation */
58	uint32_t	ns_rx_deauth;		/* rx deauthentication */
59	uint32_t	ns_rx_action;		/* rx action */
60	uint32_t	ns_rx_decryptcrc;	/* rx decrypt failed on crc */
61	uint32_t	ns_rx_unauth;		/* rx on unauthorized port */
62	uint32_t	ns_rx_unencrypted;	/* rx unecrypted w/ privacy */
63	uint32_t	ns_rx_drop;		/* rx discard other reason */
64
65	uint32_t	ns_tx_data;		/* tx data frames */
66	uint32_t	ns_tx_mgmt;		/* tx management frames */
67	uint32_t	ns_tx_ctrl;		/* tx control frames */
68	uint32_t	ns_tx_ucast;		/* tx unicast frames */
69	uint32_t	ns_tx_mcast;		/* tx multi/broadcast frames */
70	uint64_t	ns_tx_bytes;		/* tx data count (bytes) */
71	uint32_t	ns_tx_probereq;		/* tx probe request frames */
72
73	uint32_t	ns_tx_novlantag;	/* tx discard 'cuz no tag */
74	uint32_t	ns_tx_vlanmismatch;	/* tx discard 'cuz bad tag */
75
76	uint32_t	ns_ps_discard;		/* ps discard 'cuz of age */
77
78	/* MIB-related state */
79	uint32_t	ns_tx_assoc;		/* [re]associations */
80	uint32_t	ns_tx_assoc_fail;	/* [re]association failures */
81	uint32_t	ns_tx_auth;		/* [re]authentications */
82	uint32_t	ns_tx_auth_fail;	/* [re]authentication failures*/
83	uint32_t	ns_tx_deauth;		/* deauthentications */
84	uint32_t	ns_tx_deauth_code;	/* last deauth reason */
85	uint32_t	ns_tx_disassoc;		/* disassociations */
86	uint32_t	ns_tx_disassoc_code;	/* last disassociation reason */
87	uint32_t	ns_spare[8];
88};
89
90/*
91 * Summary statistics.
92 */
93struct ieee80211_stats {
94	uint32_t	is_rx_badversion;	/* rx frame with bad version */
95	uint32_t	is_rx_tooshort;		/* rx frame too short */
96	uint32_t	is_rx_wrongbss;		/* rx from wrong bssid */
97	uint32_t	is_rx_dup;		/* rx discard 'cuz dup */
98	uint32_t	is_rx_wrongdir;		/* rx w/ wrong direction */
99	uint32_t	is_rx_mcastecho;	/* rx discard 'cuz mcast echo */
100	uint32_t	is_rx_notassoc;		/* rx discard 'cuz sta !assoc */
101	uint32_t	is_rx_noprivacy;	/* rx w/ wep but privacy off */
102	uint32_t	is_rx_unencrypted;	/* rx w/o wep and privacy on */
103	uint32_t	is_rx_wepfail;		/* rx wep processing failed */
104	uint32_t	is_rx_decap;		/* rx decapsulation failed */
105	uint32_t	is_rx_mgtdiscard;	/* rx discard mgt frames */
106	uint32_t	is_rx_ctl;		/* rx ctrl frames */
107	uint32_t	is_rx_beacon;		/* rx beacon frames */
108	uint32_t	is_rx_rstoobig;		/* rx rate set truncated */
109	uint32_t	is_rx_elem_missing;	/* rx required element missing*/
110	uint32_t	is_rx_elem_toobig;	/* rx element too big */
111	uint32_t	is_rx_elem_toosmall;	/* rx element too small */
112	uint32_t	is_rx_elem_unknown;	/* rx element unknown */
113	uint32_t	is_rx_badchan;		/* rx frame w/ invalid chan */
114	uint32_t	is_rx_chanmismatch;	/* rx frame chan mismatch */
115	uint32_t	is_rx_nodealloc;	/* rx frame dropped */
116	uint32_t	is_rx_ssidmismatch;	/* rx frame ssid mismatch  */
117	uint32_t	is_rx_auth_unsupported;	/* rx w/ unsupported auth alg */
118	uint32_t	is_rx_auth_fail;	/* rx sta auth failure */
119	uint32_t	is_rx_auth_countermeasures;/* rx auth discard 'cuz CM */
120	uint32_t	is_rx_assoc_bss;	/* rx assoc from wrong bssid */
121	uint32_t	is_rx_assoc_notauth;	/* rx assoc w/o auth */
122	uint32_t	is_rx_assoc_capmismatch;/* rx assoc w/ cap mismatch */
123	uint32_t	is_rx_assoc_norate;	/* rx assoc w/ no rate match */
124	uint32_t	is_rx_assoc_badwpaie;	/* rx assoc w/ bad WPA IE */
125	uint32_t	is_rx_deauth;		/* rx deauthentication */
126	uint32_t	is_rx_disassoc;		/* rx disassociation */
127	uint32_t	is_rx_badsubtype;	/* rx frame w/ unknown subtype*/
128	uint32_t	is_rx_nobuf;		/* rx failed for lack of buf */
129	uint32_t	is_rx_decryptcrc;	/* rx decrypt failed on crc */
130	uint32_t	is_rx_ahdemo_mgt;	/* rx discard ahdemo mgt frame*/
131	uint32_t	is_rx_bad_auth;		/* rx bad auth request */
132	uint32_t	is_rx_unauth;		/* rx on unauthorized port */
133	uint32_t	is_rx_badkeyid;		/* rx w/ incorrect keyid */
134	uint32_t	is_rx_ccmpreplay;	/* rx seq# violation (CCMP) */
135	uint32_t	is_rx_ccmpformat;	/* rx format bad (CCMP) */
136	uint32_t	is_rx_ccmpmic;		/* rx MIC check failed (CCMP) */
137	uint32_t	is_rx_tkipreplay;	/* rx seq# violation (TKIP) */
138	uint32_t	is_rx_tkipformat;	/* rx format bad (TKIP) */
139	uint32_t	is_rx_tkipmic;		/* rx MIC check failed (TKIP) */
140	uint32_t	is_rx_tkipicv;		/* rx ICV check failed (TKIP) */
141	uint32_t	is_rx_badcipher;	/* rx failed 'cuz key type */
142	uint32_t	is_rx_nocipherctx;	/* rx failed 'cuz key !setup */
143	uint32_t	is_rx_acl;		/* rx discard 'cuz acl policy */
144	uint32_t	is_tx_nobuf;		/* tx failed for lack of buf */
145	uint32_t	is_tx_nonode;		/* tx failed for no node */
146	uint32_t	is_tx_unknownmgt;	/* tx of unknown mgt frame */
147	uint32_t	is_tx_badcipher;	/* tx failed 'cuz key type */
148	uint32_t	is_tx_nodefkey;		/* tx failed 'cuz no defkey */
149	uint32_t	is_tx_noheadroom;	/* tx failed 'cuz no space */
150	uint32_t	is_tx_fragframes;	/* tx frames fragmented */
151	uint32_t	is_tx_frags;		/* tx fragments created */
152	uint32_t	is_scan_active;		/* active scans started */
153	uint32_t	is_scan_passive;	/* passive scans started */
154	uint32_t	is_node_timeout;	/* nodes timed out inactivity */
155	uint32_t	is_crypto_nomem;	/* no memory for crypto ctx */
156	uint32_t	is_crypto_tkip;		/* tkip crypto done in s/w */
157	uint32_t	is_crypto_tkipenmic;	/* tkip en-MIC done in s/w */
158	uint32_t	is_crypto_tkipdemic;	/* tkip de-MIC done in s/w */
159	uint32_t	is_crypto_tkipcm;	/* tkip counter measures */
160	uint32_t	is_crypto_ccmp;		/* ccmp crypto done in s/w */
161	uint32_t	is_crypto_wep;		/* wep crypto done in s/w */
162	uint32_t	is_crypto_setkey_cipher;/* cipher rejected key */
163	uint32_t	is_crypto_setkey_nokey;	/* no key index for setkey */
164	uint32_t	is_crypto_delkey;	/* driver key delete failed */
165	uint32_t	is_crypto_badcipher;	/* unknown cipher */
166	uint32_t	is_crypto_nocipher;	/* cipher not available */
167	uint32_t	is_crypto_attachfail;	/* cipher attach failed */
168	uint32_t	is_crypto_swfallback;	/* cipher fallback to s/w */
169	uint32_t	is_crypto_keyfail;	/* driver key alloc failed */
170	uint32_t	is_crypto_enmicfail;	/* en-MIC failed */
171	uint32_t	is_ibss_capmismatch;	/* merge failed-cap mismatch */
172	uint32_t	is_ibss_norate;		/* merge failed-rate mismatch */
173	uint32_t	is_ps_unassoc;		/* ps-poll for unassoc. sta */
174	uint32_t	is_ps_badaid;		/* ps-poll w/ incorrect aid */
175	uint32_t	is_ps_qempty;		/* ps-poll w/ nothing to send */
176	uint32_t	is_ff_badhdr;		/* fast frame rx'd w/ bad hdr */
177	uint32_t	is_ff_tooshort;		/* fast frame rx decap error */
178	uint32_t	is_ff_split;		/* fast frame rx split error */
179	uint32_t	is_ff_decap;		/* fast frames decap'd */
180	uint32_t	is_ff_encap;		/* fast frames encap'd for tx */
181	uint32_t	is_rx_badbintval;	/* rx frame w/ bogus bintval */
182	uint32_t	is_rx_demicfail;	/* rx demic failed */
183	uint32_t	is_rx_defrag;		/* rx defragmentation failed */
184	uint32_t	is_rx_mgmt;		/* rx management frames */
185	uint32_t	is_rx_action;		/* rx action mgt frames */
186	uint32_t	is_amsdu_tooshort;	/* A-MSDU rx decap error */
187	uint32_t	is_amsdu_split;		/* A-MSDU rx split error */
188	uint32_t	is_amsdu_decap;		/* A-MSDU decap'd */
189	uint32_t	is_amsdu_encap;		/* A-MSDU encap'd for tx */
190	uint32_t	is_ampdu_bar_bad;	/* A-MPDU BAR out of window */
191	uint32_t	is_ampdu_bar_oow;	/* A-MPDU BAR before ADDBA */
192	uint32_t	is_ampdu_bar_move;	/* A-MPDU BAR moved window */
193	uint32_t	is_ampdu_bar_rx;	/* A-MPDU BAR frames handled */
194	uint32_t	is_ampdu_rx_flush;	/* A-MPDU frames flushed */
195	uint32_t	is_ampdu_rx_oor;	/* A-MPDU frames out-of-order */
196	uint32_t	is_ampdu_rx_copy;	/* A-MPDU frames copied down */
197	uint32_t	is_ampdu_rx_drop;	/* A-MPDU frames dropped */
198	uint32_t	is_tx_badstate;		/* tx discard state != RUN */
199	uint32_t	is_tx_notassoc;		/* tx failed, sta not assoc */
200	uint32_t	is_tx_classify;		/* tx classification failed */
201	uint32_t	is_dwds_mcast;		/* discard mcast over dwds */
202	uint32_t	is_dwds_qdrop;		/* dwds pending frame q full */
203	uint32_t	is_ht_assoc_nohtcap;	/* non-HT sta rejected */
204	uint32_t	is_ht_assoc_downgrade;	/* HT sta forced to legacy */
205	uint32_t	is_ht_assoc_norate;	/* HT assoc w/ rate mismatch */
206	uint32_t	is_ampdu_rx_age;	/* A-MPDU sent up 'cuz of age */
207	uint32_t	is_ampdu_rx_move;	/* A-MPDU MSDU moved window */
208	uint32_t	is_addba_reject;	/* ADDBA reject 'cuz disabled */
209	uint32_t	is_addba_norequest;	/* ADDBA response w/o ADDBA */
210	uint32_t	is_addba_badtoken;	/* ADDBA response w/ wrong
211						   dialogtoken */
212	uint32_t	is_addba_badpolicy;	/* ADDBA resp w/ wrong policy */
213	uint32_t	is_ampdu_stop;		/* A-MPDU stream stopped */
214	uint32_t	is_ampdu_stop_failed;	/* A-MPDU stream not running */
215	uint32_t	is_ampdu_rx_reorder;	/* A-MPDU held for rx reorder */
216	uint32_t	is_scan_bg;		/* background scans started */
217	uint8_t		is_rx_deauth_code;	/* last rx'd deauth reason */
218	uint8_t		is_rx_disassoc_code;	/* last rx'd disassoc reason */
219	uint8_t		is_rx_authfail_code;	/* last rx'd auth fail reason */
220	uint32_t	is_beacon_miss;		/* beacon miss notification */
221	uint32_t	is_rx_badstate;		/* rx discard state != RUN */
222	uint32_t	is_ff_flush;		/* ff's flush'd from stageq */
223	uint32_t	is_tx_ctl;		/* tx ctrl frames */
224	uint32_t	is_ampdu_rexmt;		/* A-MPDU frames rexmt ok */
225	uint32_t	is_ampdu_rexmt_fail;	/* A-MPDU frames rexmt fail */
226
227	uint32_t	is_mesh_wrongmesh;	/* dropped 'cuz not mesh sta*/
228	uint32_t	is_mesh_nolink;		/* dropped 'cuz link not estab*/
229	uint32_t	is_mesh_fwd_ttl;	/* mesh not fwd'd 'cuz ttl 0 */
230	uint32_t	is_mesh_fwd_nobuf;	/* mesh not fwd'd 'cuz no mbuf*/
231	uint32_t	is_mesh_fwd_tooshort;	/* mesh not fwd'd 'cuz no hdr */
232	uint32_t	is_mesh_fwd_disabled;	/* mesh not fwd'd 'cuz disabled */
233	uint32_t	is_mesh_fwd_nopath;	/* mesh not fwd'd 'cuz path unknown */
234
235	uint32_t	is_hwmp_wrongseq;	/* wrong hwmp seq no. */
236	uint32_t	is_hwmp_rootreqs;	/* root PREQs sent */
237	uint32_t	is_hwmp_rootrann;	/* root RANNs sent */
238
239	uint32_t	is_mesh_badae;		/* dropped 'cuz invalid AE */
240	uint32_t	is_mesh_rtaddfailed;	/* route add failed */
241	uint32_t	is_mesh_notproxy;	/* dropped 'cuz not proxying */
242	uint32_t	is_rx_badalign;		/* dropped 'cuz misaligned */
243	uint32_t	is_hwmp_proxy;		/* PREP for proxy route */
244	uint32_t	is_beacon_bad;		/* Number of bad beacons */
245	uint32_t	is_ampdu_bar_tx;	/* A-MPDU BAR frames TXed */
246	uint32_t	is_ampdu_bar_tx_retry;	/* A-MPDU BAR frames TX rtry */
247	uint32_t	is_ampdu_bar_tx_fail;	/* A-MPDU BAR frames TX fail */
248
249	uint32_t	is_spare[7];
250};
251
252/*
253 * Max size of optional information elements.  We artificially
254 * constrain this; it's limited only by the max frame size (and
255 * the max parameter size of the wireless extensions).
256 */
257#define	IEEE80211_MAX_OPT_IE	256
258
259/*
260 * WPA/RSN get/set key request.  Specify the key/cipher
261 * type and whether the key is to be used for sending and/or
262 * receiving.  The key index should be set only when working
263 * with global keys (use IEEE80211_KEYIX_NONE for ``no index'').
264 * Otherwise a unicast/pairwise key is specified by the bssid
265 * (on a station) or mac address (on an ap).  They key length
266 * must include any MIC key data; otherwise it should be no
267 * more than IEEE80211_KEYBUF_SIZE.
268 */
269struct ieee80211req_key {
270	uint8_t		ik_type;	/* key/cipher type */
271	uint8_t		ik_pad;
272	uint16_t	ik_keyix;	/* key index */
273	uint8_t		ik_keylen;	/* key length in bytes */
274	uint8_t		ik_flags;
275/* NB: IEEE80211_KEY_XMIT and IEEE80211_KEY_RECV defined elsewhere */
276#define	IEEE80211_KEY_DEFAULT	0x80	/* default xmit key */
277	uint8_t		ik_macaddr[IEEE80211_ADDR_LEN];
278	uint64_t	ik_keyrsc;	/* key receive sequence counter */
279	uint64_t	ik_keytsc;	/* key transmit sequence counter */
280	uint8_t		ik_keydata[IEEE80211_KEYBUF_SIZE+IEEE80211_MICBUF_SIZE];
281};
282
283/*
284 * Delete a key either by index or address.  Set the index
285 * to IEEE80211_KEYIX_NONE when deleting a unicast key.
286 */
287struct ieee80211req_del_key {
288	uint8_t		idk_keyix;	/* key index */
289	uint8_t		idk_macaddr[IEEE80211_ADDR_LEN];
290};
291
292/*
293 * MLME state manipulation request.  IEEE80211_MLME_ASSOC
294 * only makes sense when operating as a station.  The other
295 * requests can be used when operating as a station or an
296 * ap (to effect a station).
297 */
298struct ieee80211req_mlme {
299	uint8_t		im_op;		/* operation to perform */
300#define	IEEE80211_MLME_ASSOC		1	/* associate station */
301#define	IEEE80211_MLME_DISASSOC		2	/* disassociate station */
302#define	IEEE80211_MLME_DEAUTH		3	/* deauthenticate station */
303#define	IEEE80211_MLME_AUTHORIZE	4	/* authorize station */
304#define	IEEE80211_MLME_UNAUTHORIZE	5	/* unauthorize station */
305#define	IEEE80211_MLME_AUTH		6	/* authenticate station */
306	uint8_t		im_ssid_len;	/* length of optional ssid */
307	uint16_t	im_reason;	/* 802.11 reason code */
308	uint8_t		im_macaddr[IEEE80211_ADDR_LEN];
309	uint8_t		im_ssid[IEEE80211_NWID_LEN];
310};
311
312/*
313 * MAC ACL operations.
314 */
315enum {
316	IEEE80211_MACCMD_POLICY_OPEN	= 0,	/* set policy: no ACL's */
317	IEEE80211_MACCMD_POLICY_ALLOW	= 1,	/* set policy: allow traffic */
318	IEEE80211_MACCMD_POLICY_DENY	= 2,	/* set policy: deny traffic */
319	IEEE80211_MACCMD_FLUSH		= 3,	/* flush ACL database */
320	IEEE80211_MACCMD_DETACH		= 4,	/* detach ACL policy */
321	IEEE80211_MACCMD_POLICY		= 5,	/* get ACL policy */
322	IEEE80211_MACCMD_LIST		= 6,	/* get ACL database */
323	IEEE80211_MACCMD_POLICY_RADIUS	= 7,	/* set policy: RADIUS managed */
324};
325
326struct ieee80211req_maclist {
327	uint8_t		ml_macaddr[IEEE80211_ADDR_LEN];
328} __packed;
329
330/*
331 * Mesh Routing Table Operations.
332 */
333enum {
334	IEEE80211_MESH_RTCMD_LIST   = 0, /* list HWMP routing table */
335	IEEE80211_MESH_RTCMD_FLUSH  = 1, /* flush HWMP routing table */
336	IEEE80211_MESH_RTCMD_ADD    = 2, /* add entry to the table */
337	IEEE80211_MESH_RTCMD_DELETE = 3, /* delete an entry from the table */
338};
339
340struct ieee80211req_mesh_route {
341	uint8_t		imr_flags;
342#define	IEEE80211_MESHRT_FLAGS_DISCOVER	0x01
343#define	IEEE80211_MESHRT_FLAGS_VALID	0x02
344#define	IEEE80211_MESHRT_FLAGS_PROXY	0x04
345	uint8_t		imr_dest[IEEE80211_ADDR_LEN];
346	uint8_t		imr_nexthop[IEEE80211_ADDR_LEN];
347	uint16_t	imr_nhops;
348	uint8_t		imr_pad;
349	uint32_t	imr_metric;
350	uint32_t	imr_lifetime;
351	uint32_t	imr_lastmseq;
352};
353
354/*
355 * HWMP root modes
356 */
357enum {
358	IEEE80211_HWMP_ROOTMODE_DISABLED	= 0, 	/* disabled */
359	IEEE80211_HWMP_ROOTMODE_NORMAL		= 1,	/* normal PREPs */
360	IEEE80211_HWMP_ROOTMODE_PROACTIVE	= 2,	/* proactive PREPS */
361	IEEE80211_HWMP_ROOTMODE_RANN		= 3,	/* use RANN elemid */
362};
363
364
365/*
366 * Set the active channel list by IEEE channel #: each channel
367 * to be marked active is set in a bit vector.  Note this list is
368 * intersected with the available channel list in calculating
369 * the set of channels actually used in scanning.
370 */
371struct ieee80211req_chanlist {
372	uint8_t		ic_channels[32];	/* NB: can be variable length */
373};
374
375/*
376 * Get the active channel list info.
377 */
378struct ieee80211req_chaninfo {
379	u_int	ic_nchans;
380	struct ieee80211_channel ic_chans[1];	/* NB: variable length */
381};
382#define	IEEE80211_CHANINFO_SIZE(_nchan) \
383	(sizeof(struct ieee80211req_chaninfo) + \
384	 (((_nchan)-1) * sizeof(struct ieee80211_channel)))
385#define	IEEE80211_CHANINFO_SPACE(_ci) \
386	IEEE80211_CHANINFO_SIZE((_ci)->ic_nchans)
387
388/*
389 * Retrieve the WPA/RSN information element for an associated station.
390 */
391struct ieee80211req_wpaie {	/* old version w/ only one ie */
392	uint8_t		wpa_macaddr[IEEE80211_ADDR_LEN];
393	uint8_t		wpa_ie[IEEE80211_MAX_OPT_IE];
394};
395struct ieee80211req_wpaie2 {
396	uint8_t		wpa_macaddr[IEEE80211_ADDR_LEN];
397	uint8_t		wpa_ie[IEEE80211_MAX_OPT_IE];
398	uint8_t		rsn_ie[IEEE80211_MAX_OPT_IE];
399};
400
401/*
402 * Retrieve per-node statistics.
403 */
404struct ieee80211req_sta_stats {
405	union {
406		/* NB: explicitly force 64-bit alignment */
407		uint8_t		macaddr[IEEE80211_ADDR_LEN];
408		uint64_t	pad;
409	} is_u;
410	struct ieee80211_nodestats is_stats;
411};
412
413/*
414 * Station information block; the mac address is used
415 * to retrieve other data like stats, unicast key, etc.
416 */
417struct ieee80211req_sta_info {
418	uint16_t	isi_len;		/* total length (mult of 4) */
419	uint16_t	isi_ie_off;		/* offset to IE data */
420	uint16_t	isi_ie_len;		/* IE length */
421	uint16_t	isi_freq;		/* MHz */
422	uint32_t	isi_flags;		/* channel flags */
423	uint32_t	isi_state;		/* state flags */
424	uint8_t		isi_authmode;		/* authentication algorithm */
425	int8_t		isi_rssi;		/* receive signal strength */
426	int8_t		isi_noise;		/* noise floor */
427	uint8_t		isi_capinfo;		/* capabilities */
428	uint8_t		isi_erp;		/* ERP element */
429	uint8_t		isi_macaddr[IEEE80211_ADDR_LEN];
430	uint8_t		isi_nrates;
431						/* negotiated rates */
432	uint8_t		isi_rates[IEEE80211_RATE_MAXSIZE];
433	uint8_t		isi_txrate;		/* legacy/IEEE rate or MCS */
434	uint16_t	isi_associd;		/* assoc response */
435	uint16_t	isi_txpower;		/* current tx power */
436	uint16_t	isi_vlan;		/* vlan tag */
437	/* NB: [IEEE80211_NONQOS_TID] holds seq#'s for non-QoS stations */
438	uint16_t	isi_txseqs[IEEE80211_TID_SIZE];/* tx seq #/TID */
439	uint16_t	isi_rxseqs[IEEE80211_TID_SIZE];/* rx seq#/TID */
440	uint16_t	isi_inact;		/* inactivity timer */
441	uint16_t	isi_txmbps;		/* current tx rate in .5 Mb/s */
442	uint16_t	isi_pad;
443	uint32_t	isi_jointime;		/* time of assoc/join */
444	struct ieee80211_mimo_info isi_mimo;	/* MIMO info for 11n sta's */
445	/* 11s info */
446	uint16_t	isi_peerid;
447	uint16_t	isi_localid;
448	uint8_t		isi_peerstate;
449	/* XXX frag state? */
450	/* variable length IE data */
451};
452
453/*
454 * Retrieve per-station information; to retrieve all
455 * specify a mac address of ff:ff:ff:ff:ff:ff.
456 */
457struct ieee80211req_sta_req {
458	union {
459		/* NB: explicitly force 64-bit alignment */
460		uint8_t		macaddr[IEEE80211_ADDR_LEN];
461		uint64_t	pad;
462	} is_u;
463	struct ieee80211req_sta_info info[1];	/* variable length */
464};
465
466/*
467 * Get/set per-station tx power cap.
468 */
469struct ieee80211req_sta_txpow {
470	uint8_t		it_macaddr[IEEE80211_ADDR_LEN];
471	uint8_t		it_txpow;
472};
473
474/*
475 * WME parameters manipulated with IEEE80211_IOC_WME_CWMIN
476 * through IEEE80211_IOC_WME_ACKPOLICY are set and return
477 * using i_val and i_len.  i_val holds the value itself.
478 * i_len specifies the AC and, as appropriate, then high bit
479 * specifies whether the operation is to be applied to the
480 * BSS or ourself.
481 */
482#define	IEEE80211_WMEPARAM_SELF	0x0000		/* parameter applies to self */
483#define	IEEE80211_WMEPARAM_BSS	0x8000		/* parameter applies to BSS */
484#define	IEEE80211_WMEPARAM_VAL	0x7fff		/* parameter value */
485
486/*
487 * Application Information Elements can be appended to a variety
488 * of frames with the IEE80211_IOC_APPIE request.  This request
489 * piggybacks on a normal ieee80211req; the frame type is passed
490 * in i_val as the 802.11 FC0 bytes and the length of the IE data
491 * is passed in i_len.  The data is referenced in i_data.  If i_len
492 * is zero then any previously configured IE data is removed.  At
493 * most IEEE80211_MAX_APPIE data be appened.  Note that multiple
494 * IE's can be supplied; the data is treated opaquely.
495 */
496#define	IEEE80211_MAX_APPIE	1024		/* max app IE data */
497/*
498 * Hack: the WPA authenticator uses this mechanism to specify WPA
499 * ie's that are used instead of the ones normally constructed using
500 * the cipher state setup with separate ioctls.  This avoids issues
501 * like the authenticator ordering ie data differently than the
502 * net80211 layer and needing to keep separate state for WPA and RSN.
503 */
504#define	IEEE80211_APPIE_WPA \
505	(IEEE80211_FC0_TYPE_MGT | IEEE80211_FC0_SUBTYPE_BEACON | \
506	 IEEE80211_FC0_SUBTYPE_PROBE_RESP)
507
508/*
509 * Station mode roaming parameters.  These are maintained
510 * per band/mode and control the roaming algorithm.
511 */
512struct ieee80211_roamparams_req {
513	struct ieee80211_roamparam params[IEEE80211_MODE_MAX];
514};
515
516/*
517 * Transmit parameters.  These can be used to set fixed transmit
518 * rate for each operating mode when operating as client or on a
519 * per-client basis according to the capabilities of the client
520 * (e.g. an 11b client associated to an 11g ap) when operating as
521 * an ap.
522 *
523 * MCS are distinguished from legacy rates by or'ing in 0x80.
524 */
525struct ieee80211_txparams_req {
526	struct ieee80211_txparam params[IEEE80211_MODE_MAX];
527};
528
529/*
530 * Set regulatory domain state with IEEE80211_IOC_REGDOMAIN.
531 * Note this is both the regulatory description and the channel
532 * list.  The get request for IEEE80211_IOC_REGDOMAIN returns
533 * only the regdomain info; the channel list is obtained
534 * separately with IEEE80211_IOC_CHANINFO.
535 */
536struct ieee80211_regdomain_req {
537	struct ieee80211_regdomain	rd;
538	struct ieee80211req_chaninfo	chaninfo;
539};
540#define	IEEE80211_REGDOMAIN_SIZE(_nchan) \
541	(sizeof(struct ieee80211_regdomain_req) + \
542	 (((_nchan)-1) * sizeof(struct ieee80211_channel)))
543#define	IEEE80211_REGDOMAIN_SPACE(_req) \
544	IEEE80211_REGDOMAIN_SIZE((_req)->chaninfo.ic_nchans)
545
546/*
547 * Get driver capabilities.  Driver, hardware crypto, and
548 * HT/802.11n capabilities, and a table that describes what
549 * the radio can do.
550 */
551struct ieee80211_devcaps_req {
552	uint32_t	dc_drivercaps;		/* general driver caps */
553	uint32_t	dc_cryptocaps;		/* hardware crypto support */
554	uint32_t	dc_htcaps;		/* HT/802.11n support */
555	struct ieee80211req_chaninfo dc_chaninfo;
556};
557#define	IEEE80211_DEVCAPS_SIZE(_nchan) \
558	(sizeof(struct ieee80211_devcaps_req) + \
559	 (((_nchan)-1) * sizeof(struct ieee80211_channel)))
560#define	IEEE80211_DEVCAPS_SPACE(_dc) \
561	IEEE80211_DEVCAPS_SIZE((_dc)->dc_chaninfo.ic_nchans)
562
563struct ieee80211_chanswitch_req {
564	struct ieee80211_channel csa_chan;	/* new channel */
565	int		csa_mode;		/* CSA mode */
566	int		csa_count;		/* beacon count to switch */
567};
568
569/*
570 * Get/set per-station vlan tag.
571 */
572struct ieee80211req_sta_vlan {
573	uint8_t		sv_macaddr[IEEE80211_ADDR_LEN];
574	uint16_t	sv_vlan;
575};
576
577#ifdef __FreeBSD__
578/*
579 * FreeBSD-style ioctls.
580 */
581/* the first member must be matched with struct ifreq */
582struct ieee80211req {
583	char		i_name[IFNAMSIZ];	/* if_name, e.g. "wi0" */
584	uint16_t	i_type;			/* req type */
585	int16_t		i_val;			/* Index or simple value */
586	uint16_t	i_len;			/* Index or simple value */
587	void		*i_data;		/* Extra data */
588};
589#define	SIOCS80211		 _IOW('i', 234, struct ieee80211req)
590#define	SIOCG80211		_IOWR('i', 235, struct ieee80211req)
591#define	SIOCG80211STATS		_IOWR('i', 236, struct ifreq)
592
593#define IEEE80211_IOC_SSID		1
594#define IEEE80211_IOC_NUMSSIDS		2
595#define IEEE80211_IOC_WEP		3
596#define 	IEEE80211_WEP_NOSUP	-1
597#define 	IEEE80211_WEP_OFF	0
598#define 	IEEE80211_WEP_ON	1
599#define 	IEEE80211_WEP_MIXED	2
600#define IEEE80211_IOC_WEPKEY		4
601#define IEEE80211_IOC_NUMWEPKEYS	5
602#define IEEE80211_IOC_WEPTXKEY		6
603#define IEEE80211_IOC_AUTHMODE		7
604#define IEEE80211_IOC_STATIONNAME	8
605#define IEEE80211_IOC_CHANNEL		9
606#define IEEE80211_IOC_POWERSAVE		10
607#define 	IEEE80211_POWERSAVE_NOSUP	-1
608#define 	IEEE80211_POWERSAVE_OFF		0
609#define 	IEEE80211_POWERSAVE_CAM		1
610#define 	IEEE80211_POWERSAVE_PSP		2
611#define 	IEEE80211_POWERSAVE_PSP_CAM	3
612#define 	IEEE80211_POWERSAVE_ON		IEEE80211_POWERSAVE_CAM
613#define IEEE80211_IOC_POWERSAVESLEEP	11
614#define	IEEE80211_IOC_RTSTHRESHOLD	12
615#define IEEE80211_IOC_PROTMODE		13
616#define 	IEEE80211_PROTMODE_OFF		0
617#define 	IEEE80211_PROTMODE_CTS		1
618#define 	IEEE80211_PROTMODE_RTSCTS	2
619#define	IEEE80211_IOC_TXPOWER		14	/* global tx power limit */
620#define	IEEE80211_IOC_BSSID		15
621#define	IEEE80211_IOC_ROAMING		16	/* roaming mode */
622#define	IEEE80211_IOC_PRIVACY		17	/* privacy invoked */
623#define	IEEE80211_IOC_DROPUNENCRYPTED	18	/* discard unencrypted frames */
624#define	IEEE80211_IOC_WPAKEY		19
625#define	IEEE80211_IOC_DELKEY		20
626#define	IEEE80211_IOC_MLME		21
627/* 22 was IEEE80211_IOC_OPTIE, replaced by IEEE80211_IOC_APPIE */
628/* 23 was IEEE80211_IOC_SCAN_REQ */
629/* 24 was IEEE80211_IOC_SCAN_RESULTS */
630#define	IEEE80211_IOC_COUNTERMEASURES	25	/* WPA/TKIP countermeasures */
631#define	IEEE80211_IOC_WPA		26	/* WPA mode (0,1,2) */
632#define	IEEE80211_IOC_CHANLIST		27	/* channel list */
633#define	IEEE80211_IOC_WME		28	/* WME mode (on, off) */
634#define	IEEE80211_IOC_HIDESSID		29	/* hide SSID mode (on, off) */
635#define	IEEE80211_IOC_APBRIDGE		30	/* AP inter-sta bridging */
636/* 31-35,37-38 were for WPA authenticator settings */
637/* 36 was IEEE80211_IOC_DRIVER_CAPS */
638#define	IEEE80211_IOC_WPAIE		39	/* WPA information element */
639#define	IEEE80211_IOC_STA_STATS		40	/* per-station statistics */
640#define	IEEE80211_IOC_MACCMD		41	/* MAC ACL operation */
641#define	IEEE80211_IOC_CHANINFO		42	/* channel info list */
642#define	IEEE80211_IOC_TXPOWMAX		43	/* max tx power for channel */
643#define	IEEE80211_IOC_STA_TXPOW		44	/* per-station tx power limit */
644/* 45 was IEEE80211_IOC_STA_INFO */
645#define	IEEE80211_IOC_WME_CWMIN		46	/* WME: ECWmin */
646#define	IEEE80211_IOC_WME_CWMAX		47	/* WME: ECWmax */
647#define	IEEE80211_IOC_WME_AIFS		48	/* WME: AIFSN */
648#define	IEEE80211_IOC_WME_TXOPLIMIT	49	/* WME: txops limit */
649#define	IEEE80211_IOC_WME_ACM		50	/* WME: ACM (bss only) */
650#define	IEEE80211_IOC_WME_ACKPOLICY	51	/* WME: ACK policy (!bss only)*/
651#define	IEEE80211_IOC_DTIM_PERIOD	52	/* DTIM period (beacons) */
652#define	IEEE80211_IOC_BEACON_INTERVAL	53	/* beacon interval (ms) */
653#define	IEEE80211_IOC_ADDMAC		54	/* add sta to MAC ACL table */
654#define	IEEE80211_IOC_DELMAC		55	/* del sta from MAC ACL table */
655#define	IEEE80211_IOC_PUREG		56	/* pure 11g (no 11b stations) */
656#define	IEEE80211_IOC_FF		57	/* ATH fast frames (on, off) */
657#define	IEEE80211_IOC_TURBOP		58	/* ATH turbo' (on, off) */
658#define	IEEE80211_IOC_BGSCAN		59	/* bg scanning (on, off) */
659#define	IEEE80211_IOC_BGSCAN_IDLE	60	/* bg scan idle threshold */
660#define	IEEE80211_IOC_BGSCAN_INTERVAL	61	/* bg scan interval */
661#define	IEEE80211_IOC_SCANVALID		65	/* scan cache valid threshold */
662/* 66-72 were IEEE80211_IOC_ROAM_* and IEEE80211_IOC_MCAST_RATE */
663#define	IEEE80211_IOC_FRAGTHRESHOLD	73	/* tx fragmentation threshold */
664#define	IEEE80211_IOC_BURST		75	/* packet bursting */
665#define	IEEE80211_IOC_SCAN_RESULTS	76	/* get scan results */
666#define	IEEE80211_IOC_BMISSTHRESHOLD	77	/* beacon miss threshold */
667#define	IEEE80211_IOC_STA_INFO		78	/* station/neighbor info */
668#define	IEEE80211_IOC_WPAIE2		79	/* WPA+RSN info elements */
669#define	IEEE80211_IOC_CURCHAN		80	/* current channel */
670#define	IEEE80211_IOC_SHORTGI		81	/* 802.11n half GI */
671#define	IEEE80211_IOC_AMPDU		82	/* 802.11n A-MPDU (on, off) */
672#define	IEEE80211_IOC_AMPDU_LIMIT	83	/* A-MPDU length limit */
673#define	IEEE80211_IOC_AMPDU_DENSITY	84	/* A-MPDU density */
674#define	IEEE80211_IOC_AMSDU		85	/* 802.11n A-MSDU (on, off) */
675#define	IEEE80211_IOC_AMSDU_LIMIT	86	/* A-MSDU length limit */
676#define	IEEE80211_IOC_PUREN		87	/* pure 11n (no legacy sta's) */
677#define	IEEE80211_IOC_DOTH		88	/* 802.11h (on, off) */
678/* 89-91 were regulatory items */
679#define	IEEE80211_IOC_HTCOMPAT		92	/* support pre-D1.10 HT ie's */
680#define	IEEE80211_IOC_DWDS		93	/* DWDS/4-address handling */
681#define	IEEE80211_IOC_INACTIVITY	94	/* sta inactivity handling */
682#define	IEEE80211_IOC_APPIE		95	/* application IE's */
683#define	IEEE80211_IOC_WPS		96	/* WPS operation */
684#define	IEEE80211_IOC_TSN		97	/* TSN operation */
685#define	IEEE80211_IOC_DEVCAPS		98	/* driver+device capabilities */
686#define	IEEE80211_IOC_CHANSWITCH	99	/* start 11h channel switch */
687#define	IEEE80211_IOC_DFS		100	/* DFS (on, off) */
688#define	IEEE80211_IOC_DOTD		101	/* 802.11d (on, off) */
689#define IEEE80211_IOC_HTPROTMODE	102	/* HT protection (off, rts) */
690#define	IEEE80211_IOC_SCAN_REQ		103	/* scan w/ specified params */
691#define	IEEE80211_IOC_SCAN_CANCEL	104	/* cancel ongoing scan */
692#define	IEEE80211_IOC_HTCONF		105	/* HT config (off, HT20, HT40)*/
693#define	IEEE80211_IOC_REGDOMAIN		106	/* regulatory domain info */
694#define	IEEE80211_IOC_ROAM		107	/* roaming params en masse */
695#define	IEEE80211_IOC_TXPARAMS		108	/* tx parameters */
696#define	IEEE80211_IOC_STA_VLAN		109	/* per-station vlan tag */
697#define	IEEE80211_IOC_SMPS		110	/* MIMO power save */
698#define	IEEE80211_IOC_RIFS		111	/* RIFS config (on, off) */
699#define	IEEE80211_IOC_GREENFIELD	112	/* Greenfield (on, off) */
700#define	IEEE80211_IOC_STBC		113	/* STBC Tx/RX (on, off) */
701
702#define	IEEE80211_IOC_MESH_ID		170	/* mesh identifier */
703#define	IEEE80211_IOC_MESH_AP		171	/* accepting peerings */
704#define	IEEE80211_IOC_MESH_FWRD		172	/* forward frames */
705#define	IEEE80211_IOC_MESH_PROTO	173	/* mesh protocols */
706#define	IEEE80211_IOC_MESH_TTL		174	/* mesh TTL */
707#define	IEEE80211_IOC_MESH_RTCMD	175	/* mesh routing table commands*/
708#define	IEEE80211_IOC_MESH_PR_METRIC	176	/* mesh metric protocol */
709#define	IEEE80211_IOC_MESH_PR_PATH	177	/* mesh path protocol */
710#define	IEEE80211_IOC_MESH_PR_SIG	178	/* mesh sig protocol */
711#define	IEEE80211_IOC_MESH_PR_CC	179	/* mesh congestion protocol */
712#define	IEEE80211_IOC_MESH_PR_AUTH	180	/* mesh auth protocol */
713#define	IEEE80211_IOC_MESH_GATE		181	/* mesh gate XXX: 173? */
714
715#define	IEEE80211_IOC_HWMP_ROOTMODE	190	/* HWMP root mode */
716#define	IEEE80211_IOC_HWMP_MAXHOPS	191	/* number of hops before drop */
717#define	IEEE80211_IOC_HWMP_TTL		192	/* HWMP TTL */
718
719#define	IEEE80211_IOC_TDMA_SLOT		201	/* TDMA: assigned slot */
720#define	IEEE80211_IOC_TDMA_SLOTCNT	202	/* TDMA: slots in bss */
721#define	IEEE80211_IOC_TDMA_SLOTLEN	203	/* TDMA: slot length (usecs) */
722#define	IEEE80211_IOC_TDMA_BINTERVAL	204	/* TDMA: beacon intvl (slots) */
723
724#define	IEEE80211_IOC_QUIET		205	/* Quiet Enable/Disable */
725#define	IEEE80211_IOC_QUIET_PERIOD	206	/* Quiet Period */
726#define	IEEE80211_IOC_QUIET_OFFSET	207	/* Quiet Offset */
727#define	IEEE80211_IOC_QUIET_DUR		208	/* Quiet Duration */
728#define	IEEE80211_IOC_QUIET_COUNT	209	/* Quiet Count */
729/*
730 * Parameters for controlling a scan requested with
731 * IEEE80211_IOC_SCAN_REQ.
732 *
733 * Active scans cause ProbeRequest frames to be issued for each
734 * specified ssid and, by default, a broadcast ProbeRequest frame.
735 * The set of ssid's is specified in the request.
736 *
737 * By default the scan will cause a BSS to be joined (in station/adhoc
738 * mode) or a channel to be selected for operation (hostap mode).
739 * To disable that specify IEEE80211_IOC_SCAN_NOPICK and if the
740 *
741 * If the station is currently associated to an AP then a scan request
742 * will cause the station to leave the current channel and potentially
743 * miss frames from the AP.  Alternatively the station may notify the
744 * AP that it is going into power save mode before it leaves the channel.
745 * This ensures frames for the station are buffered by the AP.  This is
746 * termed a ``bg scan'' and is requested with the IEEE80211_IOC_SCAN_BGSCAN
747 * flag.  Background scans may take longer than foreground scans and may
748 * be preempted by traffic.  If a station is not associated to an AP
749 * then a request for a background scan is automatically done in the
750 * foreground.
751 *
752 * The results of the scan request are cached by the system.  This
753 * information is aged out and/or invalidated based on events like not
754 * being able to associated to an AP.  To flush the current cache
755 * contents before doing a scan the IEEE80211_IOC_SCAN_FLUSH flag may
756 * be specified.
757 *
758 * By default the scan will be done until a suitable AP is located
759 * or a channel is found for use.  A scan can also be constrained
760 * to be done once (IEEE80211_IOC_SCAN_ONCE) or to last for no more
761 * than a specified duration.
762 */
763struct ieee80211_scan_req {
764	int		sr_flags;
765#define	IEEE80211_IOC_SCAN_NOPICK	0x00001	/* scan only, no selection */
766#define	IEEE80211_IOC_SCAN_ACTIVE	0x00002	/* active scan (probe req) */
767#define	IEEE80211_IOC_SCAN_PICK1ST	0x00004	/* ``hey sailor'' mode */
768#define	IEEE80211_IOC_SCAN_BGSCAN	0x00008	/* bg scan, exit ps at end */
769#define	IEEE80211_IOC_SCAN_ONCE		0x00010	/* do one complete pass */
770#define	IEEE80211_IOC_SCAN_NOBCAST	0x00020	/* don't send bcast probe req */
771#define	IEEE80211_IOC_SCAN_NOJOIN	0x00040	/* no auto-sequencing */
772#define	IEEE80211_IOC_SCAN_FLUSH	0x10000	/* flush scan cache first */
773#define	IEEE80211_IOC_SCAN_CHECK	0x20000	/* check scan cache first */
774	u_int		sr_duration;		/* duration (ms) */
775#define	IEEE80211_IOC_SCAN_DURATION_MIN	1
776#define	IEEE80211_IOC_SCAN_DURATION_MAX	0x7fffffff
777#define	IEEE80211_IOC_SCAN_FOREVER	IEEE80211_IOC_SCAN_DURATION_MAX
778	u_int		sr_mindwell;		/* min channel dwelltime (ms) */
779	u_int		sr_maxdwell;		/* max channel dwelltime (ms) */
780	int		sr_nssid;
781#define	IEEE80211_IOC_SCAN_MAX_SSID	3
782	struct {
783		int	 len;				/* length in bytes */
784		uint8_t ssid[IEEE80211_NWID_LEN];	/* ssid contents */
785	} sr_ssid[IEEE80211_IOC_SCAN_MAX_SSID];
786};
787
788/*
789 * Scan result data returned for IEEE80211_IOC_SCAN_RESULTS.
790 * Each result is a fixed size structure followed by a variable
791 * length SSID and one or more variable length information elements.
792 * The size of each variable length item is found in the fixed
793 * size structure and the entire length of the record is specified
794 * in isr_len.  Result records are rounded to a multiple of 4 bytes.
795 */
796struct ieee80211req_scan_result {
797	uint16_t	isr_len;		/* total length (mult of 4) */
798	uint16_t	isr_ie_off;		/* offset to SSID+IE data */
799	uint16_t	isr_ie_len;		/* IE length */
800	uint16_t	isr_freq;		/* MHz */
801	uint16_t	isr_flags;		/* channel flags */
802	int8_t		isr_noise;
803	int8_t		isr_rssi;
804	uint16_t	isr_intval;		/* beacon interval */
805	uint8_t		isr_capinfo;		/* capabilities */
806	uint8_t		isr_erp;		/* ERP element */
807	uint8_t		isr_bssid[IEEE80211_ADDR_LEN];
808	uint8_t		isr_nrates;
809	uint8_t		isr_rates[IEEE80211_RATE_MAXSIZE];
810	uint8_t		isr_ssid_len;		/* SSID length */
811	uint8_t		isr_meshid_len;		/* MESH ID length */
812	/* variable length SSID, followed by variable length MESH ID,
813	  followed by IE data */
814};
815
816/*
817 * Virtual AP cloning parameters.  The parent device must
818 * be a vap-capable device.  All parameters specified with
819 * the clone request are fixed for the lifetime of the vap.
820 *
821 * There are two flavors of WDS vaps: legacy and dynamic.
822 * Legacy WDS operation implements a static binding between
823 * two stations encapsulating traffic in 4-address frames.
824 * Dynamic WDS vaps are created when a station associates to
825 * an AP and sends a 4-address frame.  If the AP vap is
826 * configured to support WDS then this will generate an
827 * event to user programs listening on the routing socket
828 * and a Dynamic WDS vap will be created to handle traffic
829 * to/from that station.  In both cases the bssid of the
830 * peer must be specified when creating the vap.
831 *
832 * By default a vap will inherit the mac address/bssid of
833 * the underlying device.  To request a unique address the
834 * IEEE80211_CLONE_BSSID flag should be supplied.  This is
835 * meaningless for WDS vaps as they share the bssid of an
836 * AP vap that must otherwise exist.  Note that some devices
837 * may not be able to support multiple addresses.
838 *
839 * Station mode vap's normally depend on the device to notice
840 * when the AP stops sending beacon frames.  If IEEE80211_CLONE_NOBEACONS
841 * is specified the net80211 layer will do this in s/w.  This
842 * is mostly useful when setting up a WDS repeater/extender where
843 * an AP vap is combined with a sta vap and the device isn't able
844 * to track beacon frames in hardware.
845 */
846struct ieee80211_clone_params {
847	char	icp_parent[IFNAMSIZ];		/* parent device */
848	uint16_t icp_opmode;			/* operating mode */
849	uint16_t icp_flags;			/* see below */
850	uint8_t	icp_bssid[IEEE80211_ADDR_LEN];	/* for WDS links */
851	uint8_t	icp_macaddr[IEEE80211_ADDR_LEN];/* local address */
852};
853#define	IEEE80211_CLONE_BSSID		0x0001	/* allocate unique mac/bssid */
854#define	IEEE80211_CLONE_NOBEACONS	0x0002	/* don't setup beacon timers */
855#define	IEEE80211_CLONE_WDSLEGACY	0x0004	/* legacy WDS processing */
856#define	IEEE80211_CLONE_MACADDR		0x0008	/* use specified mac addr */
857#define	IEEE80211_CLONE_TDMA		0x0010	/* operate in TDMA mode */
858#endif /* __FreeBSD__ */
859
860#endif /* _NET80211_IEEE80211_IOCTL_H_ */
861