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