ieee80211_ioctl.h revision 194136
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 194136 2009-06-13 23:43:00Z sam $ 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 uint32_t is_spare[16]; 227}; 228 229/* 230 * Max size of optional information elements. We artificially 231 * constrain this; it's limited only by the max frame size (and 232 * the max parameter size of the wireless extensions). 233 */ 234#define IEEE80211_MAX_OPT_IE 256 235 236/* 237 * WPA/RSN get/set key request. Specify the key/cipher 238 * type and whether the key is to be used for sending and/or 239 * receiving. The key index should be set only when working 240 * with global keys (use IEEE80211_KEYIX_NONE for ``no index''). 241 * Otherwise a unicast/pairwise key is specified by the bssid 242 * (on a station) or mac address (on an ap). They key length 243 * must include any MIC key data; otherwise it should be no 244 * more than IEEE80211_KEYBUF_SIZE. 245 */ 246struct ieee80211req_key { 247 uint8_t ik_type; /* key/cipher type */ 248 uint8_t ik_pad; 249 uint16_t ik_keyix; /* key index */ 250 uint8_t ik_keylen; /* key length in bytes */ 251 uint8_t ik_flags; 252/* NB: IEEE80211_KEY_XMIT and IEEE80211_KEY_RECV defined elsewhere */ 253#define IEEE80211_KEY_DEFAULT 0x80 /* default xmit key */ 254 uint8_t ik_macaddr[IEEE80211_ADDR_LEN]; 255 uint64_t ik_keyrsc; /* key receive sequence counter */ 256 uint64_t ik_keytsc; /* key transmit sequence counter */ 257 uint8_t ik_keydata[IEEE80211_KEYBUF_SIZE+IEEE80211_MICBUF_SIZE]; 258}; 259 260/* 261 * Delete a key either by index or address. Set the index 262 * to IEEE80211_KEYIX_NONE when deleting a unicast key. 263 */ 264struct ieee80211req_del_key { 265 uint8_t idk_keyix; /* key index */ 266 uint8_t idk_macaddr[IEEE80211_ADDR_LEN]; 267}; 268 269/* 270 * MLME state manipulation request. IEEE80211_MLME_ASSOC 271 * only makes sense when operating as a station. The other 272 * requests can be used when operating as a station or an 273 * ap (to effect a station). 274 */ 275struct ieee80211req_mlme { 276 uint8_t im_op; /* operation to perform */ 277#define IEEE80211_MLME_ASSOC 1 /* associate station */ 278#define IEEE80211_MLME_DISASSOC 2 /* disassociate station */ 279#define IEEE80211_MLME_DEAUTH 3 /* deauthenticate station */ 280#define IEEE80211_MLME_AUTHORIZE 4 /* authorize station */ 281#define IEEE80211_MLME_UNAUTHORIZE 5 /* unauthorize station */ 282#define IEEE80211_MLME_AUTH 6 /* authenticate station */ 283 uint8_t im_ssid_len; /* length of optional ssid */ 284 uint16_t im_reason; /* 802.11 reason code */ 285 uint8_t im_macaddr[IEEE80211_ADDR_LEN]; 286 uint8_t im_ssid[IEEE80211_NWID_LEN]; 287}; 288 289/* 290 * MAC ACL operations. 291 */ 292enum { 293 IEEE80211_MACCMD_POLICY_OPEN = 0, /* set policy: no ACL's */ 294 IEEE80211_MACCMD_POLICY_ALLOW = 1, /* set policy: allow traffic */ 295 IEEE80211_MACCMD_POLICY_DENY = 2, /* set policy: deny traffic */ 296 IEEE80211_MACCMD_FLUSH = 3, /* flush ACL database */ 297 IEEE80211_MACCMD_DETACH = 4, /* detach ACL policy */ 298 IEEE80211_MACCMD_POLICY = 5, /* get ACL policy */ 299 IEEE80211_MACCMD_LIST = 6, /* get ACL database */ 300 IEEE80211_MACCMD_POLICY_RADIUS = 7, /* set policy: RADIUS managed */ 301}; 302 303struct ieee80211req_maclist { 304 uint8_t ml_macaddr[IEEE80211_ADDR_LEN]; 305}; 306 307/* 308 * Set the active channel list by IEEE channel #: each channel 309 * to be marked active is set in a bit vector. Note this list is 310 * intersected with the available channel list in calculating 311 * the set of channels actually used in scanning. 312 */ 313struct ieee80211req_chanlist { 314 uint8_t ic_channels[32]; /* NB: can be variable length */ 315}; 316 317/* 318 * Get the active channel list info. 319 */ 320struct ieee80211req_chaninfo { 321 u_int ic_nchans; 322 struct ieee80211_channel ic_chans[1]; /* NB: variable length */ 323}; 324#define IEEE80211_CHANINFO_SIZE(_nchan) \ 325 (sizeof(struct ieee80211req_chaninfo) + \ 326 (((_nchan)-1) * sizeof(struct ieee80211_channel))) 327#define IEEE80211_CHANINFO_SPACE(_ci) \ 328 IEEE80211_CHANINFO_SIZE((_ci)->ic_nchans) 329 330/* 331 * Retrieve the WPA/RSN information element for an associated station. 332 */ 333struct ieee80211req_wpaie { /* old version w/ only one ie */ 334 uint8_t wpa_macaddr[IEEE80211_ADDR_LEN]; 335 uint8_t wpa_ie[IEEE80211_MAX_OPT_IE]; 336}; 337struct ieee80211req_wpaie2 { 338 uint8_t wpa_macaddr[IEEE80211_ADDR_LEN]; 339 uint8_t wpa_ie[IEEE80211_MAX_OPT_IE]; 340 uint8_t rsn_ie[IEEE80211_MAX_OPT_IE]; 341}; 342 343/* 344 * Retrieve per-node statistics. 345 */ 346struct ieee80211req_sta_stats { 347 union { 348 /* NB: explicitly force 64-bit alignment */ 349 uint8_t macaddr[IEEE80211_ADDR_LEN]; 350 uint64_t pad; 351 } is_u; 352 struct ieee80211_nodestats is_stats; 353}; 354 355/* 356 * Station information block; the mac address is used 357 * to retrieve other data like stats, unicast key, etc. 358 */ 359struct ieee80211req_sta_info { 360 uint16_t isi_len; /* total length (mult of 4) */ 361 uint16_t isi_ie_off; /* offset to IE data */ 362 uint16_t isi_ie_len; /* IE length */ 363 uint16_t isi_freq; /* MHz */ 364 uint32_t isi_flags; /* channel flags */ 365 uint32_t isi_state; /* state flags */ 366 uint8_t isi_authmode; /* authentication algorithm */ 367 int8_t isi_rssi; /* receive signal strength */ 368 int8_t isi_noise; /* noise floor */ 369 uint8_t isi_capinfo; /* capabilities */ 370 uint8_t isi_erp; /* ERP element */ 371 uint8_t isi_macaddr[IEEE80211_ADDR_LEN]; 372 uint8_t isi_nrates; 373 /* negotiated rates */ 374 uint8_t isi_rates[IEEE80211_RATE_MAXSIZE]; 375 uint8_t isi_txrate; /* legacy/IEEE rate or MCS */ 376 uint16_t isi_associd; /* assoc response */ 377 uint16_t isi_txpower; /* current tx power */ 378 uint16_t isi_vlan; /* vlan tag */ 379 /* NB: [IEEE80211_NONQOS_TID] holds seq#'s for non-QoS stations */ 380 uint16_t isi_txseqs[IEEE80211_TID_SIZE];/* tx seq #/TID */ 381 uint16_t isi_rxseqs[IEEE80211_TID_SIZE];/* rx seq#/TID */ 382 uint16_t isi_inact; /* inactivity timer */ 383 uint16_t isi_txmbps; /* current tx rate in .5 Mb/s */ 384 uint16_t isi_pad; 385 uint32_t isi_jointime; /* time of assoc/join */ 386 struct ieee80211_mimo_info isi_mimo; /* MIMO info for 11n sta's */ 387 /* XXX frag state? */ 388 /* variable length IE data */ 389}; 390 391/* 392 * Retrieve per-station information; to retrieve all 393 * specify a mac address of ff:ff:ff:ff:ff:ff. 394 */ 395struct ieee80211req_sta_req { 396 union { 397 /* NB: explicitly force 64-bit alignment */ 398 uint8_t macaddr[IEEE80211_ADDR_LEN]; 399 uint64_t pad; 400 } is_u; 401 struct ieee80211req_sta_info info[1]; /* variable length */ 402}; 403 404/* 405 * Get/set per-station tx power cap. 406 */ 407struct ieee80211req_sta_txpow { 408 uint8_t it_macaddr[IEEE80211_ADDR_LEN]; 409 uint8_t it_txpow; 410}; 411 412/* 413 * WME parameters manipulated with IEEE80211_IOC_WME_CWMIN 414 * through IEEE80211_IOC_WME_ACKPOLICY are set and return 415 * using i_val and i_len. i_val holds the value itself. 416 * i_len specifies the AC and, as appropriate, then high bit 417 * specifies whether the operation is to be applied to the 418 * BSS or ourself. 419 */ 420#define IEEE80211_WMEPARAM_SELF 0x0000 /* parameter applies to self */ 421#define IEEE80211_WMEPARAM_BSS 0x8000 /* parameter applies to BSS */ 422#define IEEE80211_WMEPARAM_VAL 0x7fff /* parameter value */ 423 424/* 425 * Application Information Elements can be appended to a variety 426 * of frames with the IEE80211_IOC_APPIE request. This request 427 * piggybacks on a normal ieee80211req; the frame type is passed 428 * in i_val as the 802.11 FC0 bytes and the length of the IE data 429 * is passed in i_len. The data is referenced in i_data. If i_len 430 * is zero then any previously configured IE data is removed. At 431 * most IEEE80211_MAX_APPIE data be appened. Note that multiple 432 * IE's can be supplied; the data is treated opaquely. 433 */ 434#define IEEE80211_MAX_APPIE 1024 /* max app IE data */ 435/* 436 * Hack: the WPA authenticator uses this mechanism to specify WPA 437 * ie's that are used instead of the ones normally constructed using 438 * the cipher state setup with separate ioctls. This avoids issues 439 * like the authenticator ordering ie data differently than the 440 * net80211 layer and needing to keep separate state for WPA and RSN. 441 */ 442#define IEEE80211_APPIE_WPA \ 443 (IEEE80211_FC0_TYPE_MGT | IEEE80211_FC0_SUBTYPE_BEACON | \ 444 IEEE80211_FC0_SUBTYPE_PROBE_RESP) 445 446/* 447 * Station mode roaming parameters. These are maintained 448 * per band/mode and control the roaming algorithm. 449 */ 450struct ieee80211_roamparams_req { 451 struct ieee80211_roamparam params[IEEE80211_MODE_MAX]; 452}; 453 454/* 455 * Transmit parameters. These can be used to set fixed transmit 456 * rate for each operating mode when operating as client or on a 457 * per-client basis according to the capabilities of the client 458 * (e.g. an 11b client associated to an 11g ap) when operating as 459 * an ap. 460 * 461 * MCS are distinguished from legacy rates by or'ing in 0x80. 462 */ 463struct ieee80211_txparams_req { 464 struct ieee80211_txparam params[IEEE80211_MODE_MAX]; 465}; 466 467/* 468 * Set regulatory domain state with IEEE80211_IOC_REGDOMAIN. 469 * Note this is both the regulatory description and the channel 470 * list. The get request for IEEE80211_IOC_REGDOMAIN returns 471 * only the regdomain info; the channel list is obtained 472 * separately with IEEE80211_IOC_CHANINFO. 473 */ 474struct ieee80211_regdomain_req { 475 struct ieee80211_regdomain rd; 476 struct ieee80211req_chaninfo chaninfo; 477}; 478#define IEEE80211_REGDOMAIN_SIZE(_nchan) \ 479 (sizeof(struct ieee80211_regdomain_req) + \ 480 (((_nchan)-1) * sizeof(struct ieee80211_channel))) 481#define IEEE80211_REGDOMAIN_SPACE(_req) \ 482 IEEE80211_REGDOMAIN_SIZE((_req)->chaninfo.ic_nchans) 483 484/* 485 * Get driver capabilities. Driver, hardware crypto, and 486 * HT/802.11n capabilities, and a table that describes what 487 * the radio can do. 488 */ 489struct ieee80211_devcaps_req { 490 uint32_t dc_drivercaps; /* general driver caps */ 491 uint32_t dc_cryptocaps; /* hardware crypto support */ 492 uint32_t dc_htcaps; /* HT/802.11n support */ 493 struct ieee80211req_chaninfo dc_chaninfo; 494}; 495#define IEEE80211_DEVCAPS_SIZE(_nchan) \ 496 (sizeof(struct ieee80211_devcaps_req) + \ 497 (((_nchan)-1) * sizeof(struct ieee80211_channel))) 498#define IEEE80211_DEVCAPS_SPACE(_dc) \ 499 IEEE80211_DEVCAPS_SIZE((_dc)->dc_chaninfo.ic_nchans) 500 501struct ieee80211_chanswitch_req { 502 struct ieee80211_channel csa_chan; /* new channel */ 503 int csa_mode; /* CSA mode */ 504 int csa_count; /* beacon count to switch */ 505}; 506 507/* 508 * Get/set per-station vlan tag. 509 */ 510struct ieee80211req_sta_vlan { 511 uint8_t sv_macaddr[IEEE80211_ADDR_LEN]; 512 uint16_t sv_vlan; 513}; 514 515#ifdef __FreeBSD__ 516/* 517 * FreeBSD-style ioctls. 518 */ 519/* the first member must be matched with struct ifreq */ 520struct ieee80211req { 521 char i_name[IFNAMSIZ]; /* if_name, e.g. "wi0" */ 522 uint16_t i_type; /* req type */ 523 int16_t i_val; /* Index or simple value */ 524 int16_t i_len; /* Index or simple value */ 525 void *i_data; /* Extra data */ 526}; 527#define SIOCS80211 _IOW('i', 234, struct ieee80211req) 528#define SIOCG80211 _IOWR('i', 235, struct ieee80211req) 529#define SIOCG80211STATS _IOWR('i', 236, struct ifreq) 530 531#define IEEE80211_IOC_SSID 1 532#define IEEE80211_IOC_NUMSSIDS 2 533#define IEEE80211_IOC_WEP 3 534#define IEEE80211_WEP_NOSUP -1 535#define IEEE80211_WEP_OFF 0 536#define IEEE80211_WEP_ON 1 537#define IEEE80211_WEP_MIXED 2 538#define IEEE80211_IOC_WEPKEY 4 539#define IEEE80211_IOC_NUMWEPKEYS 5 540#define IEEE80211_IOC_WEPTXKEY 6 541#define IEEE80211_IOC_AUTHMODE 7 542#define IEEE80211_IOC_STATIONNAME 8 543#define IEEE80211_IOC_CHANNEL 9 544#define IEEE80211_IOC_POWERSAVE 10 545#define IEEE80211_POWERSAVE_NOSUP -1 546#define IEEE80211_POWERSAVE_OFF 0 547#define IEEE80211_POWERSAVE_CAM 1 548#define IEEE80211_POWERSAVE_PSP 2 549#define IEEE80211_POWERSAVE_PSP_CAM 3 550#define IEEE80211_POWERSAVE_ON IEEE80211_POWERSAVE_CAM 551#define IEEE80211_IOC_POWERSAVESLEEP 11 552#define IEEE80211_IOC_RTSTHRESHOLD 12 553#define IEEE80211_IOC_PROTMODE 13 554#define IEEE80211_PROTMODE_OFF 0 555#define IEEE80211_PROTMODE_CTS 1 556#define IEEE80211_PROTMODE_RTSCTS 2 557#define IEEE80211_IOC_TXPOWER 14 /* global tx power limit */ 558#define IEEE80211_IOC_BSSID 15 559#define IEEE80211_IOC_ROAMING 16 /* roaming mode */ 560#define IEEE80211_IOC_PRIVACY 17 /* privacy invoked */ 561#define IEEE80211_IOC_DROPUNENCRYPTED 18 /* discard unencrypted frames */ 562#define IEEE80211_IOC_WPAKEY 19 563#define IEEE80211_IOC_DELKEY 20 564#define IEEE80211_IOC_MLME 21 565/* 22 was IEEE80211_IOC_OPTIE, replaced by IEEE80211_IOC_APPIE */ 566/* 23 was IEEE80211_IOC_SCAN_REQ */ 567/* 24 was IEEE80211_IOC_SCAN_RESULTS */ 568#define IEEE80211_IOC_COUNTERMEASURES 25 /* WPA/TKIP countermeasures */ 569#define IEEE80211_IOC_WPA 26 /* WPA mode (0,1,2) */ 570#define IEEE80211_IOC_CHANLIST 27 /* channel list */ 571#define IEEE80211_IOC_WME 28 /* WME mode (on, off) */ 572#define IEEE80211_IOC_HIDESSID 29 /* hide SSID mode (on, off) */ 573#define IEEE80211_IOC_APBRIDGE 30 /* AP inter-sta bridging */ 574/* 31-35,37-38 were for WPA authenticator settings */ 575/* 36 was IEEE80211_IOC_DRIVER_CAPS */ 576#define IEEE80211_IOC_WPAIE 39 /* WPA information element */ 577#define IEEE80211_IOC_STA_STATS 40 /* per-station statistics */ 578#define IEEE80211_IOC_MACCMD 41 /* MAC ACL operation */ 579#define IEEE80211_IOC_CHANINFO 42 /* channel info list */ 580#define IEEE80211_IOC_TXPOWMAX 43 /* max tx power for channel */ 581#define IEEE80211_IOC_STA_TXPOW 44 /* per-station tx power limit */ 582/* 45 was IEEE80211_IOC_STA_INFO */ 583#define IEEE80211_IOC_WME_CWMIN 46 /* WME: ECWmin */ 584#define IEEE80211_IOC_WME_CWMAX 47 /* WME: ECWmax */ 585#define IEEE80211_IOC_WME_AIFS 48 /* WME: AIFSN */ 586#define IEEE80211_IOC_WME_TXOPLIMIT 49 /* WME: txops limit */ 587#define IEEE80211_IOC_WME_ACM 50 /* WME: ACM (bss only) */ 588#define IEEE80211_IOC_WME_ACKPOLICY 51 /* WME: ACK policy (!bss only)*/ 589#define IEEE80211_IOC_DTIM_PERIOD 52 /* DTIM period (beacons) */ 590#define IEEE80211_IOC_BEACON_INTERVAL 53 /* beacon interval (ms) */ 591#define IEEE80211_IOC_ADDMAC 54 /* add sta to MAC ACL table */ 592#define IEEE80211_IOC_DELMAC 55 /* del sta from MAC ACL table */ 593#define IEEE80211_IOC_PUREG 56 /* pure 11g (no 11b stations) */ 594#define IEEE80211_IOC_FF 57 /* ATH fast frames (on, off) */ 595#define IEEE80211_IOC_TURBOP 58 /* ATH turbo' (on, off) */ 596#define IEEE80211_IOC_BGSCAN 59 /* bg scanning (on, off) */ 597#define IEEE80211_IOC_BGSCAN_IDLE 60 /* bg scan idle threshold */ 598#define IEEE80211_IOC_BGSCAN_INTERVAL 61 /* bg scan interval */ 599#define IEEE80211_IOC_SCANVALID 65 /* scan cache valid threshold */ 600/* 66-72 were IEEE80211_IOC_ROAM_* and IEEE80211_IOC_MCAST_RATE */ 601#define IEEE80211_IOC_FRAGTHRESHOLD 73 /* tx fragmentation threshold */ 602#define IEEE80211_IOC_BURST 75 /* packet bursting */ 603#define IEEE80211_IOC_SCAN_RESULTS 76 /* get scan results */ 604#define IEEE80211_IOC_BMISSTHRESHOLD 77 /* beacon miss threshold */ 605#define IEEE80211_IOC_STA_INFO 78 /* station/neighbor info */ 606#define IEEE80211_IOC_WPAIE2 79 /* WPA+RSN info elements */ 607#define IEEE80211_IOC_CURCHAN 80 /* current channel */ 608#define IEEE80211_IOC_SHORTGI 81 /* 802.11n half GI */ 609#define IEEE80211_IOC_AMPDU 82 /* 802.11n A-MPDU (on, off) */ 610#define IEEE80211_IOC_AMPDU_LIMIT 83 /* A-MPDU length limit */ 611#define IEEE80211_IOC_AMPDU_DENSITY 84 /* A-MPDU density */ 612#define IEEE80211_IOC_AMSDU 85 /* 802.11n A-MSDU (on, off) */ 613#define IEEE80211_IOC_AMSDU_LIMIT 86 /* A-MSDU length limit */ 614#define IEEE80211_IOC_PUREN 87 /* pure 11n (no legacy sta's) */ 615#define IEEE80211_IOC_DOTH 88 /* 802.11h (on, off) */ 616/* 89-91 were regulatory items */ 617#define IEEE80211_IOC_HTCOMPAT 92 /* support pre-D1.10 HT ie's */ 618#define IEEE80211_IOC_DWDS 93 /* DWDS/4-address handling */ 619#define IEEE80211_IOC_INACTIVITY 94 /* sta inactivity handling */ 620#define IEEE80211_IOC_APPIE 95 /* application IE's */ 621#define IEEE80211_IOC_WPS 96 /* WPS operation */ 622#define IEEE80211_IOC_TSN 97 /* TSN operation */ 623#define IEEE80211_IOC_DEVCAPS 98 /* driver+device capabilities */ 624#define IEEE80211_IOC_CHANSWITCH 99 /* start 11h channel switch */ 625#define IEEE80211_IOC_DFS 100 /* DFS (on, off) */ 626#define IEEE80211_IOC_DOTD 101 /* 802.11d (on, off) */ 627#define IEEE80211_IOC_HTPROTMODE 102 /* HT protection (off, rts) */ 628#define IEEE80211_IOC_SCAN_REQ 103 /* scan w/ specified params */ 629#define IEEE80211_IOC_SCAN_CANCEL 104 /* cancel ongoing scan */ 630#define IEEE80211_IOC_HTCONF 105 /* HT config (off, HT20, HT40)*/ 631#define IEEE80211_IOC_REGDOMAIN 106 /* regulatory domain info */ 632#define IEEE80211_IOC_ROAM 107 /* roaming params en masse */ 633#define IEEE80211_IOC_TXPARAMS 108 /* tx parameters */ 634#define IEEE80211_IOC_STA_VLAN 109 /* per-station vlan tag */ 635#define IEEE80211_IOC_SMPS 110 /* MIMO power save */ 636#define IEEE80211_IOC_RIFS 111 /* RIFS config (on, off) */ 637#define IEEE80211_IOC_GREENFIELD 112 /* Greenfield (on, off) */ 638#define IEEE80211_IOC_STBC 113 /* STBC Tx/RX (on, off) */ 639 640#define IEEE80211_IOC_TDMA_SLOT 201 /* TDMA: assigned slot */ 641#define IEEE80211_IOC_TDMA_SLOTCNT 202 /* TDMA: slots in bss */ 642#define IEEE80211_IOC_TDMA_SLOTLEN 203 /* TDMA: slot length (usecs) */ 643#define IEEE80211_IOC_TDMA_BINTERVAL 204 /* TDMA: beacon intvl (slots) */ 644 645/* 646 * Parameters for controlling a scan requested with 647 * IEEE80211_IOC_SCAN_REQ. 648 * 649 * Active scans cause ProbeRequest frames to be issued for each 650 * specified ssid and, by default, a broadcast ProbeRequest frame. 651 * The set of ssid's is specified in the request. 652 * 653 * By default the scan will cause a BSS to be joined (in station/adhoc 654 * mode) or a channel to be selected for operation (hostap mode). 655 * To disable that specify IEEE80211_IOC_SCAN_NOPICK and if the 656 * 657 * If the station is currently associated to an AP then a scan request 658 * will cause the station to leave the current channel and potentially 659 * miss frames from the AP. Alternatively the station may notify the 660 * AP that it is going into power save mode before it leaves the channel. 661 * This ensures frames for the station are buffered by the AP. This is 662 * termed a ``bg scan'' and is requested with the IEEE80211_IOC_SCAN_BGSCAN 663 * flag. Background scans may take longer than foreground scans and may 664 * be preempted by traffic. If a station is not associated to an AP 665 * then a request for a background scan is automatically done in the 666 * foreground. 667 * 668 * The results of the scan request are cached by the system. This 669 * information is aged out and/or invalidated based on events like not 670 * being able to associated to an AP. To flush the current cache 671 * contents before doing a scan the IEEE80211_IOC_SCAN_FLUSH flag may 672 * be specified. 673 * 674 * By default the scan will be done until a suitable AP is located 675 * or a channel is found for use. A scan can also be constrained 676 * to be done once (IEEE80211_IOC_SCAN_ONCE) or to last for no more 677 * than a specified duration. 678 */ 679struct ieee80211_scan_req { 680 int sr_flags; 681#define IEEE80211_IOC_SCAN_NOPICK 0x00001 /* scan only, no selection */ 682#define IEEE80211_IOC_SCAN_ACTIVE 0x00002 /* active scan (probe req) */ 683#define IEEE80211_IOC_SCAN_PICK1ST 0x00004 /* ``hey sailor'' mode */ 684#define IEEE80211_IOC_SCAN_BGSCAN 0x00008 /* bg scan, exit ps at end */ 685#define IEEE80211_IOC_SCAN_ONCE 0x00010 /* do one complete pass */ 686#define IEEE80211_IOC_SCAN_NOBCAST 0x00020 /* don't send bcast probe req */ 687#define IEEE80211_IOC_SCAN_NOJOIN 0x00040 /* no auto-sequencing */ 688#define IEEE80211_IOC_SCAN_FLUSH 0x10000 /* flush scan cache first */ 689#define IEEE80211_IOC_SCAN_CHECK 0x20000 /* check scan cache first */ 690 u_int sr_duration; /* duration (ms) */ 691#define IEEE80211_IOC_SCAN_DURATION_MIN 1 692#define IEEE80211_IOC_SCAN_DURATION_MAX 0x7fffffff 693#define IEEE80211_IOC_SCAN_FOREVER IEEE80211_IOC_SCAN_DURATION_MAX 694 u_int sr_mindwell; /* min channel dwelltime (ms) */ 695 u_int sr_maxdwell; /* max channel dwelltime (ms) */ 696 int sr_nssid; 697#define IEEE80211_IOC_SCAN_MAX_SSID 3 698 struct { 699 int len; /* length in bytes */ 700 uint8_t ssid[IEEE80211_NWID_LEN]; /* ssid contents */ 701 } sr_ssid[IEEE80211_IOC_SCAN_MAX_SSID]; 702}; 703 704/* 705 * Scan result data returned for IEEE80211_IOC_SCAN_RESULTS. 706 * Each result is a fixed size structure followed by a variable 707 * length SSID and one or more variable length information elements. 708 * The size of each variable length item is found in the fixed 709 * size structure and the entire length of the record is specified 710 * in isr_len. Result records are rounded to a multiple of 4 bytes. 711 */ 712struct ieee80211req_scan_result { 713 uint16_t isr_len; /* total length (mult of 4) */ 714 uint16_t isr_ie_off; /* offset to SSID+IE data */ 715 uint16_t isr_ie_len; /* IE length */ 716 uint16_t isr_freq; /* MHz */ 717 uint16_t isr_flags; /* channel flags */ 718 int8_t isr_noise; 719 int8_t isr_rssi; 720 uint8_t isr_intval; /* beacon interval */ 721 uint8_t isr_capinfo; /* capabilities */ 722 uint8_t isr_erp; /* ERP element */ 723 uint8_t isr_bssid[IEEE80211_ADDR_LEN]; 724 uint8_t isr_nrates; 725 uint8_t isr_rates[IEEE80211_RATE_MAXSIZE]; 726 uint8_t isr_ssid_len; /* SSID length */ 727 /* variable length SSID followed by IE data */ 728}; 729 730/* 731 * Virtual AP cloning parameters. The parent device must 732 * be a vap-capable device. All parameters specified with 733 * the clone request are fixed for the lifetime of the vap. 734 * 735 * There are two flavors of WDS vaps: legacy and dynamic. 736 * Legacy WDS operation implements a static binding between 737 * two stations encapsulating traffic in 4-address frames. 738 * Dynamic WDS vaps are created when a station associates to 739 * an AP and sends a 4-address frame. If the AP vap is 740 * configured to support WDS then this will generate an 741 * event to user programs listening on the routing socket 742 * and a Dynamic WDS vap will be created to handle traffic 743 * to/from that station. In both cases the bssid of the 744 * peer must be specified when creating the vap. 745 * 746 * By default a vap will inherit the mac address/bssid of 747 * the underlying device. To request a unique address the 748 * IEEE80211_CLONE_BSSID flag should be supplied. This is 749 * meaningless for WDS vaps as they share the bssid of an 750 * AP vap that must otherwise exist. Note that some devices 751 * may not be able to support multiple addresses. 752 * 753 * Station mode vap's normally depend on the device to notice 754 * when the AP stops sending beacon frames. If IEEE80211_CLONE_NOBEACONS 755 * is specified the net80211 layer will do this in s/w. This 756 * is mostly useful when setting up a WDS repeater/extender where 757 * an AP vap is combined with a sta vap and the device isn't able 758 * to track beacon frames in hardware. 759 */ 760struct ieee80211_clone_params { 761 char icp_parent[IFNAMSIZ]; /* parent device */ 762 uint16_t icp_opmode; /* operating mode */ 763 uint16_t icp_flags; /* see below */ 764 uint8_t icp_bssid[IEEE80211_ADDR_LEN]; /* for WDS links */ 765 uint8_t icp_macaddr[IEEE80211_ADDR_LEN];/* local address */ 766}; 767#define IEEE80211_CLONE_BSSID 0x0001 /* allocate unique mac/bssid */ 768#define IEEE80211_CLONE_NOBEACONS 0x0002 /* don't setup beacon timers */ 769#define IEEE80211_CLONE_WDSLEGACY 0x0004 /* legacy WDS processing */ 770#define IEEE80211_CLONE_MACADDR 0x0008 /* use specified mac addr */ 771#define IEEE80211_CLONE_TDMA 0x0010 /* operate in TDMA mode */ 772#endif /* __FreeBSD__ */ 773 774#endif /* _NET80211_IEEE80211_IOCTL_H_ */ 775