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