1.\"- 2.\" Copyright (c) 2009 Sam Leffler, Errno Consulting 3.\" All rights reserved. 4.\"" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright 9.\" notice, this list of conditions and the following disclaimer, 10.\" without modification. 11.\" 2. Redistributions in binary form must reproduce at minimum a disclaimer 12.\" similar to the "NO WARRANTY" disclaimer below ("Disclaimer") and any 13.\" redistribution must be conditioned upon including a substantially 14.\" similar Disclaimer requirement for further binary redistribution. 15.\" 16.\" NO WARRANTY 17.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 18.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 19.\" LIMITED TO, THE IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTIBILITY 20.\" AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL 21.\" THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, 22.\" OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 23.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 24.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER 25.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 26.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF 27.\" THE POSSIBILITY OF SUCH DAMAGES. 28.\" 29.Dd August 7, 2020 30.Dt NET80211 4 31.Os 32.Sh NAME 33.Nm net80211 34.Nd standard interface to IEEE 802.11 devices 35.Sh SYNOPSIS 36.In sys/types.h 37.In sys/socket.h 38.In net/if.h 39.In net/ethernet.h 40.In net80211/ieee80211_ioctl.h 41.Sh DESCRIPTION 42This section describes the standard programming 43interface to configure and retrieve status information 44for IEEE 802.11 devices that depend on the 45.Xr wlan 4 46module for operation. 47The interface is via one 48of the following 49.Xr ioctl 2 50calls on a socket: 51.Bl -tag -width ".Dv SIOCG80211" 52.It Dv SIOCG80211 53Get configuration or status information. 54.It Dv SIOCS80211 55Set configuration information. 56.El 57.Pp 58These requests are made via a modified 59.Vt ifreq 60structure. 61This structure is defined as follows: 62.Bd -literal 63struct ieee80211req { 64 char i_name[IFNAMSIZ]; /* if_name, e.g. "wi0" */ 65 uint16_t i_type; /* req type */ 66 int16_t i_val; /* Index or simple value */ 67 int16_t i_len; /* Index or simple value */ 68 void *i_data; /* Extra data */ 69}; 70.Ed 71.Pp 72Requests that are not supported by the underlying device return 73-1 and set the global variable errno to 74.Er EOPNOTSUPP . 75.Dv SIOCG80211 76requests that return data to an application place small values in 77.Va i_val 78or in a user-specified buffer pointed to by 79.Va i_data . 80When an indirect buffer is used 81.Va i_len 82specifies how large the indirect buffer is and on return it is set by the 83system to the actual amount of data returned. 84.Dv SIOCS80211 85requests use a similar scheme with data passed to the system taken either 86from 87.Va i_val 88or an indirect buffer pointed to by 89.Va i_data . 90.Pp 91For 92.Dv SIOCG80211 93the following values of 94.Va i_type 95are valid: 96.Bl -tag -width indent 97.It Dv IEEE80211_IOC_AMPDU 98Return whether or not AMPDU is enabled in 99.Va i_val . 100AMPDU is an aggregation scheme that is part of the 802.11n specification 101and is used only when operating on an HT channel. 102The value returned is one of: 1030 (AMPDU disabled), 1041 (AMPDU enabled for transmit), 1052 (AMPDU enabled for receive), 106and 1073 (AMPDU enabled for transmit and receive). 108The 802.11n specification says a compliant station must receive AMPDU but 109may not support transmitting AMPDU frames. 110Disabling AMPDU receive is mainly useful for testing and working around bugs. 111.It Dv IEEE80211_IOC_AMPDU_DENSITY 112Return the minimum density for bursting AMPDU frames in 113.Va i_val . 114The value returned is one of: 1150 (no time restriction), 1161 (1/4 usec), 1172 (1/2 usec), 1183 (1 usec), 1194 (2 usec), 1205 (4 usec), 1216 (8 usec), 122and 1237 (16 usec). 124.It Dv IEEE80211_IOC_AMPDU_LIMIT 125Return the limit on the size of AMPDU frames in 126.Va i_val . 127The value returned is one of: 1280 (8 kilobytes), 1291 (16 kilobytes), 1302 (32 kilobytes), 131and 1323 (64 kilobytes). 133.It Dv IEEE80211_IOC_AMSDU 134Return whether or not AMSDU is enabled in 135.Va i_val . 136AMSDU is an aggregation scheme that is part of the 802.11n specification 137and is used only when operating on an HT channel. 138The value returned is one of: 1390 (AMSDU disabled), 1401 (AMSDU enabled for transmit), 1412 (AMSDU enabled for receive), 142and 1433 (AMSDU enabled for transmit and receive). 144The 802.11n specification says a compliant station must receive AMSDU but 145may not support transmitting AMSDU frames. 146Disabling AMSDU receive is mainly useful for testing and working around bugs. 147.It Dv IEEE80211_IOC_AMSDU_LIMIT 148Return the limit on the size of AMSDU frames in 149.Va i_val . 150The value returned is one of: 1513839 (bytes) 152and 1537935 (bytes). 154Note these values are specified by 802.11n; arbitrary values are not allowed. 155.It Dv IEEE80211_IOC_APBRIDGE 156Return whether AP bridging is enabled in 157.Va i_val . 158Normally packets sent between stations associated 159to the same access point are delivered without going through system layers 160that do packet filtering; when AP bridging is disabled packets are 161passed up the system to be forwarded using some other mechanism. 162This value will be non-zero when AP bridging is enabled and otherwise zero. 163.It Dv IEEE80211_IOC_APPIE 164Return an application information element via 165.Va i_data . 166Application IE's are maintained for many 802.11 frames; the 167request must identify the frame to return an IE for in 168.Va i_val . 169For example, to retrieve the IE sent in each Beacon frame 170.Va i_val 171would be set to 172.Va IEEE80211_FC0_SUBTYPE_BEACON | IEEE80211_FC0_TYPE_MGT . 173If no information element is installed then 174.Er EINVAL 175is returned. 176If the data buffer for returning data is too small to hold the information 177element the value is truncated; this permits querying the presence of 178data by requesting zero bytes of data be returned. 179.It Dv IEEE80211_IOC_AUTHMODE 180Return the current authentication mode in 181.Va i_val . 182Valid values are 183.Dv IEEE80211_AUTH_NONE 184(no authentication), 185.Dv IEEE80211_AUTH_OPEN 186(open authentication), 187.Dv IEEE80211_AUTH_SHARED 188(shared key authentication), 189.Dv IEEE80211_AUTH_8021X 190(802.1x only authentication), 191and 192.Dv IEEE80211_AUTH_WPA 193(WPA/802.11i/802.1x authentication). 194.It Dv IEEE80211_IOC_BEACON_INTERVAL 195Return the time between Beacon frames (in TU) in 196.Va i_val . 197.It Dv IEEE80211_IOC_BGSCAN 198Return whether background scanning is enabled in 199.Va i_val . 200When this value is non-zero and operating in station mode 201the station will periodically leave 202the current channel and scan for neighboring stations. 203See also 204.Dv IEEE80211_IOC_BGSCAN_IDLE 205and 206.Dv IEEE80211_IOC_BGSCAN_INTERVAL . 207.It Dv IEEE80211_IOC_BGSCAN_IDLE 208Return in 209.Va i_val 210the minimum time (msecs) a station must be idle 211(i.e. not transmitting or receiving frames) 212before it will do a background scan. 213See also 214.Dv IEEE80211_IOC_BGSCAN_INTERVAL . 215.It Dv IEEE80211_IOC_BGSCAN_INTERVAL 216Return in 217.Va i_val 218the minimum time (seconds) between background scan operations. 219See also 220.Dv IEEE80211_IOC_BGSCAN_IDLE . 221.It Dv IEEE80211_IOC_BMISSTHRESHOLD 222Return in 223.Va i_val 224the number of consecutive missed Beacon frames before the system will 225attempt to roam to a different/better access point. 226.It Dv IEEE80211_IOC_BSSID 227Return the MAC address for the current BSS identifier via 228.Va i_data . 229When the interface is running, the bssid is either the value 230configured locally (e.g. for an IBSS network started by the local station) 231or the value adopted when joining an existing network. 232For WDS interfaces this value is the address of the remote station. 233When the interface is not running, the bssid returned is the desired 234bssid, if any, that has been configured. 235.It Dv IEEE80211_IOC_BURST 236Return whether or not packet bursting is enabled in 237.Va i_val . 238If this value is non-zero then the system will try to send packets closely 239spaced to improve throughput. 240.It Dv IEEE80211_IOC_CHANINFO 241Return the set of available channels via 242.Va i_data . 243Note this data should be used by user applications to map between 244channel specifications (frequency and attributes) and IEEE channel numbers 245as user applications may not have the necessary information to do 246this directly (e.g. for 900MHz radios, operation in the Public Safety Band). 247.It Dv IEEE80211_IOC_CHANLIST 248Return the current list of usable channels via 249.Va i_data . 250The channel list is returned as a bit vector with bit N set to 1 if 251IEEE channel number N is available for use. 252.It Dv IEEE80211_IOC_CHANNEL 253Return the IEEE channel number of the current channel in 254.Va i_val . 255Note this request is deprecated; use 256.Dv IEEE80211_IOC_CURCHAN 257instead. 258.It Dv IEEE80211_IOC_COUNTERMEASURES 259Return whether TKIP Countermeasures are enabled in 260.Va i_val . 261This value will be non-zero when Countermeasures are enabled and 262otherwise zero. 263.It Dv IEEE80211_IOC_CURCHAN 264Return information for the current channel via 265.Va i_data . 266This information includes the IEEE channel number, the frequency, and 267attributes that describe the operating constraints (e.g. Passive Scan, 268DFS, usage restrictions). 269.It Dv IEEE80211_IOC_DEVCAPS 270Return device capabilities in the data buffer pointed at by 271.Va i_data . 272The buffer must be large enough to return the number of available 273channels but otherwise may be made small to limit how much information 274is returned. 275.It Dv IEEE80211_IOC_DFS 276Return whether or not Dynamic Frequency Selection (DFS) is enabled in 277.Va i_val . 278DFS embodies several facilities including detection of overlapping 279radar signals, dynamic transmit power control, and channel selection 280according to a least-congested criteria. 281DFS support is mandatory for some 5GHz frequencies in certain 282locales (e.g. ETSI). 283By default DFS is enabled according to the regulatory definitions 284and the current country code, regdomain, and channel. 285.It Dv IEEE80211_IOC_DOTD 286Return whether or not 802.11d support is enabled in 287.Va i_val . 288When 802.11d is enabled in station mode, Beacon frames that advertise 289a country code different than the currently configured country code will 290cause an event to be dispatched to user applications. 291This event can be used by the station to adopt that country code and 292operate according to the associated regulatory constraints. 293When operating as an access point with 802.11d enabled the Beacon and 294ProbeResponse frames transmitted will advertise the current regulatory 295domain settings. 296.It Dv IEEE80211_IOC_DOTH 297Return whether 802.11h support is enabled in 298.Va i_val . 299When 802.11h is enabled Beacon and ProbeResponse frames will have 300the SpectrumMgt bit set in the capabilities field and 301country and power constraint information elements will be present. 302802.11h support also includes handling Channel Switch Announcements (CSA) 303which are a mechanism to coordinate channel changes by an access point. 304By default 802.11h is enabled if the device is capable. 305.It Dv IEEE80211_IOC_DROPUNENCRYPTED 306Return, in 307.Va i_val , 308whether unencrypted packets transmit/received should be discarded. 309This value will be zero if unencrypted packets will be accepted and 310non-zero if they are to be discarded. 311.It Dv IEEE80211_IOC_DTIM_PERIOD 312Return the period (in beacon intervals) between DTIM events in 313.Va i_val . 314.It Dv IEEE80211_IOC_DWDS 315Return, in 316.Va i_val , 317whether or not Dynamic WDS support is enabled. 318Dynamic WDS is a facility by which packets may be tunneled over normal 319Infrastructure BSS associations using 4-address (WDS) frames. 320.It Dv IEEE80211_IOC_FF 321Return, in 322.Va i_val , 323whether Atheros fast-frames support is enabled. 324Fast-frames is a non-standard protocol extension that aggregates multiple 325frames to improve throughput. 326Note that enabling fast-frames support does not guarantee use; 327the client and access point must negotiate its use. 328.It Dv IEEE80211_IOC_FRAGTHRESHOLD 329Return, in 330.Va i_val , 331the threshold (in bytes) for enabling fragmentation frames. 332Packets larger than this value will automatically be split into multiple 333fragmented frames that are sent one after the other. 334.It Dv IEEE80211_IOC_GREENFIELD 335Return, in 336.Va i_val , 337whether or not Greenfield preamble use is enabled. 338This setting is meaningful only when operating with 802.11n on an HT channel. 339.It Dv IEEE80211_IOC_HIDESSID 340Return, in 341.Va i_val , 342whether SSID hiding/cloaking is enabled. 343SSID hiding is only meaningful when operating as an access point. 344When this is enabled Beacon frames do not include the SSID and 345ProbeRequest frames are not answered unless they include the AP's SSID. 346This value will be non-zero when SSID hiding is enabled and otherwise zero. 347.It Dv IEEE80211_IOC_HTCOMPAT 348Return, in 349.Va i_val , 350whether or not 802.11n compatibility support is enabled. 351The 802.11n protocol specification went through several incompatible iterations. 352Some vendors implemented 11n support to older specifications that 353will not interoperate with a purely 11n-compliant station. 354In particular the information elements included in management frames 355for old devices are different. 356When compatibility support is enabled both standard and compatible data 357will be provided and/or accepted. 358.It Dv IEEE80211_IOC_HTCONF 359Return the setting for automatic promotion of HT channels in 360.Va i_val . 361Promotion happens when the system must select a channel and may choose 362between legacy, HT20, and HT40 operation (e.g. when scanning). 363Valid values are: 3640 (do not promote, use legacy), 3651 (promote to HT20), 366and 3672 (promote to HT40). 368.It Dv IEEE80211_IOC_HTPROTMODE 369Return, in 370.Va i_val , 371the technique used to protect HT frames in a mixed 802.11n network. 372Valid values are: 373.Dv IEEE80211_PROTMODE_OFF 374(no protection enabled) 375and 376.Dv IEEE80211_PROTMODE_RTSCTS 377(send RTS and wait for CTS). 378.It Dv IEEE80211_IOC_HWMP_MAXHOPS 379Return the maximum acceptable hop count in an HWMP path in 380.Va i_val . 381.It Dv IEEE80211_IOC_HWMP_ROOTMODE 382Return the setting for Mesh root mode operation in 383.Va i_val . 384Valid values are: 385.Dv IEEE80211_HWMP_ROOTMODE_DISABLED 386(root mode is disabled), 387.Dv IEEE80211_HWMP_ROOTMODE_NORMAL 388(send broadcast Path Request frames), 389.Dv IEEE80211_HWMP_ROOTMODE_PROACTIVE 390(send broadcast Path Request frames and force replies) 391and 392.Dv IEEE80211_HWMP_ROOTMODE_RANN 393(send broadcast Root Announcement (RANN) frames). 394.It Dv IEEE80211_IOC_IC_NAME 395Return the underlying hardware 396.Xr device 9 397name in the buffer pointed to by 398.Va i_data 399and the name length including terminating NUL character in 400.Va i_len . 401If the buffer length is too small to hold the full name 402.Er EINVAL 403will be returned. 404.It Dv IEEE80211_IOC_INACTIVITY 405Return whether or not the system handles inactivity processing in 406.Va i_val . 407When inactivity processing is enabled the system will track stations 408that have not transmitted frames and periodically probe them to 409check if they are still present. 410Stations that are inactive and do not respond to probes are dropped. 411.It Dv IEEE80211_IOC_MACCMD 412Return information about the state of the MAC address 413access control list (ACL) system. 414There are two requests supported: 415.Dv IEEE80211_MACCMD_POLICY 416(to retrieve the current policy in 417.Va i_val ), 418and 419.Dv IEEE80211_MACCMD_LIST 420to retrieve the list installed/active ACL's via 421.Va i_data . 422The 423.Xr wlan_acl 4 424module must be installed and enabled or 425.Er EINVAL 426will be returned. 427.It Dv IEEE80211_IOC_MESH_AP 428Return whether or not Mesh AP support is enabled in 429.Va i_val . 430.It Dv IEEE80211_IOC_MESH_ID 431Return the Mesh ID in the buffer pointed to by 432.Va i_data . 433.It Dv IEEE80211_IOC_MESH_FWRD 434Return whether or not packet forwarding support is enabled in 435.Va i_val . 436.It Dv IEEE80211_IOC_MESH_PP_METRIC 437Return the link metric protocol in the buffer pointed to by 438.Va i_data . 439.It Dv IEEE80211_IOC_MESH_PP_PATH 440Return the path selection protocol in the buffer pointed to by 441.Va i_data . 442.It Dv IEEE80211_IOC_MESH_RTCMD 443Return information about the state of the Mesh routing tables. 444One request is supported: 445.Dv IEEE80211_MESH_RTCMD_LIST 446to retrieve the contents of the routing table in the buffer pointed to by 447.Va i_data . 448.It Dv IEEE80211_IOC_MESH_TTL 449Return, in 450.Va i_val , 451the Mesh Time To Live (TTL) setting installed in packets 452transmitted by this mesh node. 453.It Dv IEEE80211_IOC_NUMSSIDS 454Return the number of SSIDs supported in 455.Va i_val . 456.It Dv IEEE80211_IOC_NUMWEPKEYS 457Return the number of WEP keys supported in 458.Va i_val . 459.It Dv IEEE80211_IOC_POWERSAVE 460Return the current powersaving mode in 461.Va i_val . 462Valid values are 463.Dv IEEE80211_POWERSAVE_OFF 464(power save operation is disabled) 465and 466.Dv IEEE80211_POWERSAVE_ON 467(power save operation is enabled). 468.It Dv IEEE80211_IOC_POWERSAVESLEEP 469Return the powersave sleep time in TU in 470.Va i_val . 471This value is also termed the listen interval and represents the maximum time 472a station will sleep before waking to retrieve packets buffered by 473an access point. 474.It Dv IEEE80211_IOC_PRIVACY 475Return the current MLME setting for PRIVACY in 476.Va i_val . 477When PRIVACY is enabled all data packets must be encrypted. 478This value will be zero if PRIVACY is disabled and 479non-zero when PRIVACY is enabled. 480.It Dv IEEE80211_IOC_PROTMODE 481Return the current 802.11g protection mode in 482.Va i_val . 483Protection is the mechanism used to safeguard 802.11b stations operating 484on an 802.11g network. 485Valid values are 486.Dv IEEE80211_PROTMODE_OFF 487(no protection enabled), 488.Dv IEEE80211_PROTMODE_CTS 489(send CTS to yourself), 490and 491.Dv IEEE80211_PROTMODE_RTSCTS 492(send RTS and wait for CTS). 493.It Dv IEEE80211_IOC_PUREG 494Return whether ``pure 11g'' mode is enabled in 495.Va i_val . 496This setting is meaningful only for access point operation; 497when non-zero, 802.11b stations will not be allowed to associate. 498.It Dv IEEE80211_IOC_PUREN 499Return whether ``pure 11n'' mode is enabled in 500.Va i_val . 501This setting is meaningful only for access point operation; 502when non-zero, legacy (non-11n capable) stations will not be 503allowed to associate. 504.It Dv IEEE80211_IOC_REGDOMAIN 505Return the regulatory state in the buffer pointed to by 506.Va i_data . 507.It Dv IEEE80211_IOC_RIFS 508Return whether or not Reduced InterFrame Spacing (RIFS) is enabled in 509.Va i_val . 510This setting is meaningful only when operating with 802.11n on an HT channel. 511.It Dv IEEE80211_IOC_ROAM 512Return station roaming parameters in the buffer pointed to by 513.Va i_data . 514.It Dv IEEE80211_IOC_ROAMING 515Return the current roaming mode in 516.Va i_val . 517Roaming mode specifies which entity controls operation of the MLME 518state machine when operating as a station in an Infrastructure BSS. 519Valid values are: 520.Dv IEEE80211_ROAMING_DEVICE 521(driver/firmware is in control), 522.Dv IEEE80211_ROAMING_AUTO 523(host 802.11 layer is in control), 524and 525.Dv IEEE80211_ROAMING_MANUAL 526(application is in control). 527.It Dv IEEE80211_IOC_RTSTHRESHOLD 528Return the threshold (in bytes) for enabling transmission of RTS frames in 529.Va i_val . 530Packets larger than this value will automatically have an RTS frame 531sent preceding it to reduce the likelihood of packet loss. 532.It Dv IEEE80211_IOC_SCAN_RESULTS 533Return the current contents of the scan cache in the data area pointed to by 534.Va i_data . 535.It Dv IEEE80211_IOC_SCANVALID 536Return in 537.Va i_val 538how long (in seconds) results from a scan operation will be considered valid. 539When scan results are no longer valid and they are needed (e.g. to roam) the 540system will initiate a scan operation to replenish the scan cache. 541.It Dv IEEE80211_IOC_SHORTGI 542Return whether or not Short Guard Interval (SGI) is enabled in 543.Va i_val . 544Note SGI is only used when operating with 802.11n on an HT channel. 545.It Dv IEEE80211_IOC_SMPS 546Return the Spatial Multiplexing Power Save (SMPS) setting in 547.Va i_val . 548This setting is meaningful only when operating with 802.11n on an HT channel. 549Valid values are: 550.Dv IEEE80211_HTCAP_SMPS_DYNAMIC 551(Dynamic SMPS is enabled), 552.Dv IEEE80211_HTCAP_SMPS_ENA 553(Static SMPS is enabled), 554and 555.Dv IEEE80211_HTCAP_SMPS_OFF 556(SMPS is disabled). 557.It Dv IEEE80211_IOC_SSID 558Return the requested SSID in the buffer pointed to by 559.Va i_data . 560If 561.Va i_val 562is \(>= 0 then the request refers to the configured value for that slot. 563Generally, 0 is the only valid value, but some interfaces support more 564SSIDs. 565.It Dv IEEE80211_IOC_STA_INFO 566Return information about the current state of the specified station(s) via 567.Va i_data . 568The MAC address of a single station may be passed in or, if the broadcast 569address is supplied, information about all stations will be returned. 570If a single station is requested and the MAC address is unknown then 571.Er ENOENT 572will be returned. 573.It Dv IEEE80211_IOC_STA_STATS 574Return collected statistics for the specified station via 575.Va i_data . 576The MAC address of the desired station is passed in; if it is unknown 577.Er ENOENT 578will be returned. 579.It Dv IEEE80211_IOC_STA_VLAN 580Return any VLAN tag assigned to a station via 581.Va i_data . 582.It Dv IEEE80211_IOC_TDMA_SLOT 583Return the slot number for the station in 584.Va i_val . 585Slot number zero is the master station in a TDMA network. 586.It Dv IEEE80211_IOC_TDMA_SLOTCNT 587Return the count of slots in the TDMA network in 588.Va i_val . 589.It Dv IEEE80211_IOC_TDMA_SLOTLEN 590Return the length (in usecs) of the TDMA slot assigned to each 591station in the network in 592.Va i_val . 593.It Dv IEEE80211_IOC_TDMA_BINTERVAL 594Return the number of superframes between Beacon frames in 595.Va i_val . 596A TDMA network with N slots and slot length T has a superframe of NxT. 597.It Dv IEEE80211_IOC_TSN 598Return whether or not Transitional Security Network (TSN) is enabled in 599.Va i_val . 600.It Dv IEEE80211_IOC_TURBOP 601Return whether Atheros Dynamic Turbo mode is enabled in 602.Va i_val . 603Dynamic Turbo mode is a non-standard protocol extension available only 604on Atheros devices where channel width is dynamically 605changed between 20MHz and 40MHz. 606Note that enabling Dynamic Turbo mode support does not guarantee use; 607both client and access point must use Atheros devices and support must 608be enabled on both sides. 609.It Dv IEEE80211_IOC_TXPARAMS 610Return transmit parameters in the buffer pointed to by 611.Va i_data . 612.It Dv IEEE80211_IOC_TXPOWER 613Return the transmit power limit in .5 dBm units in 614.Va i_val . 615This value represents the effective maximum and is calculated according to 616the maximum power allowed by local regulations, any user-specified 617power limit, and the maximum power the device is capable of. 618.It Dv IEEE80211_IOC_TXPOWMAX 619Return the user-specified maximum transmit power in .5 dBm units in 620.Va i_val . 621The maximum setting is applied after any regulatory cap. 622.It Dv IEEE80211_IOC_WEP 623Return the current WEP status in 624.Va i_val . 625Valid values are: 626.Dv IEEE80211_WEP_ON 627(enabled for all packets sent and received), 628.Dv IEEE80211_WEP_OFF 629(disabled), 630and 631.Dv IEEE80211_WEP_MIXED 632(enabled for transmit and receive but also willing to receive 633unencrypted frames). 634This request is deprecated; use 635.Dv IEEE80211_IOC_PRIVACY 636and 637.Dv IEEE80211_IOC_UNENCRYPTED 638instead. 639.It Dv IEEE80211_IOC_WEPKEY 640Return the requested WEP key via 641.Va i_data . 642The key number is specified in 643.Va i_val 644and may be 0-3. 645If the device does not support returning the WEP key or the user is not 646root then the key may be returned as all zeros. 647This request is deprecated in favor of 648.Dv IEEE80211_IOC_WPAKEY . 649.It Dv IEEE80211_IOC_WEPTXKEY 650Return the number of the WEP key used for transmission in 651.Va i_val . 652.It Dv IEEE80211_IOC_WME 653Return whether 802.11e/WME/WMM support is enabled in 654.Va i_val . 655This value will be non-zero when support is enabled and otherwise zero. 656.It Dv IEEE80211_IOC_WME_CWMIN 657Return the WME CWmin setting (log2) for the specified Access Class (AC) in 658.Va i_val . 659The AC is passed in through 660.Va i_len 661together with an optional IEEE80211_WMEPARAM_BSS flag to indicate if the 662parameter for the BSS or the channel is desired. 663If WME is not supported then 664.Er EINVAL 665will be returned. 666.It Dv IEEE80211_IOC_WME_CWMAX 667Return the WME CWmax setting (log2) for the specified Access Class (AC) in 668.Va i_val . 669See 670.Dv IEEE80211_IOC_WME_CWMIN 671above for more details. 672.It Dv IEEE80211_IOC_WME_AIFS 673Return the WME AIFS setting for the specified Access Class (AC) in 674.Va i_val . 675See 676.Dv IEEE80211_IOC_WME_CWMIN 677above for more details. 678.It Dv IEEE80211_IOC_WME_TXOPLIMIT 679Return the WME TxOpLimit (msec) for the specified Access Class (AC) in 680.Va i_val . 681See 682.Dv IEEE80211_IOC_WME_CWMIN 683above for more details. 684.It Dv IEEE80211_IOC_WME_ACM 685Return the WME Admission Control Mechanism (ACM) setting 686for the specified Access Class (AC) in 687.Va i_val . 688This value is meaningful only for the BSS (not channel). 689See 690.Dv IEEE80211_IOC_WME_CWMIN 691above for more details. 692.It Dv IEEE80211_IOC_WME_ACKPOLICY 693Return the WME ACK Policy setting 694for the specified Access Class (AC) in 695.Va i_val . 696When this value is zero frames will be transmitted without waiting for 697an Acknowledgement. 698This value is meaningful only for the channel (not BSS). 699See 700.Dv IEEE80211_IOC_WME_CWMIN 701above for more details. 702.It Dv IEEE80211_IOC_WPA 703Return the WPA configuration in 704.Va i_val . 705Valid values are 7060 (WPA is not enabled), 7071 (WPA1 is enabled), 7082 (WPA2/802.11i is enabled), 709and 7103 (WPA1 and WPA2/802.11i are both enabled). 711.It Dv IEEE80211_IOC_WPAIE 712Return any WPA information element for an associated station via 713.Va i_data . 714The request passed in through 715.Va i_data 716identifies the MAC address of the desired station. 717If an RSN (802.11i) element is present it is returned; otherwise any WPA 718element is returned. 719Note this request is deprecated; use 720.Dv IEEE80211_IOC_WPAIE2 721instead. 722.It Dv IEEE80211_IOC_WPAIE2 723Return any WPA information elements for an associated station via 724.Va i_data . 725The request passed in through 726.Va i_data 727identifies the MAC address of the desired station. 728One or both of RSN (802.11i) and WPA elements may be returned. 729.It Dv IEEE80211_IOC_WPAKEY 730Return the requested cryptographic key in the buffer pointed to by 731.Va i_data . 732The key number is specified in 733.Va i_val 734and may be 0-3. 735A key number of zero is used to retrieve a station's unicast cipher key 736when operating with WPA enabled. 737If the user is not root then the key data returned is all zeros. 738.It Dv IEEE80211_IOC_WPS 739Return whether or not Wi-FI Protected Setup (WPS) is enabled in 740.Va i_val . 741.El 742.Pp 743For 744.Dv SIOCS80211 745the following values of 746.Va i_type 747are valid. 748Note that changing a value on an interface that is running may 749cause the interface to be 750.Sq reset . 751Resets may be handled without altering the state if the parameter 752does not affect the MLME state (e.g. RTS threshold), but in some 753cases the interface may need to scan for a new network or clear 754state (including any associated stations); in that case the interface 755is said to be 756.Sq restarted 757(it is equivalent to marking the interface down and back up). 758The information below identifies whether changing a value affects the 759state of a running interface. 760.Bl -tag -width indent 761.It Dv IEEE80211_IOC_ADDMAC 762Add an entry to the MAC address Access Control List (ACL) database using 763the value pointed to by 764.Va i_data . 765The 766.Xr wlan_acl 4 767module must be installed and enabled or 768.Er EINVAL 769will be returned. 770.It Dv IEEE80211_IOC_AMPDU 771Set whether or not AMPDU is enabled for transmit and/or receive 772using the value in 773.Va i_val . 774This request causes a running interface operating on an HT channel 775to be reset. 776See 777.Dv IEEE80211_IOC_AMPDU 778above for details. 779.It Dv IEEE80211_IOC_AMPDU_DENSITY 780Set the minimum density for bursting AMPDU frames to the value in 781.Va i_val . 782This request causes a running interface to be reset. 783See 784.Dv IEEE80211_IOC_AMPDU_DENSITY 785above for details. 786.It Dv IEEE80211_IOC_AMPDU_LIMIT 787Set the limit on the size of AMPDU frames to the value in 788.Va i_val . 789This request causes a running interface to be reset. 790See 791.Dv IEEE80211_IOC_AMPDU_LIMIT 792above for details. 793.It Dv IEEE80211_IOC_AMSDU 794Set whether or not AMSDU is enabled for transmit and/or receive 795using the value in 796.Va i_val . 797This request causes a running interface operating on an HT channel 798to be reset. 799See 800.Dv IEEE80211_IOC_AMSDU 801above for details. 802.It Dv IEEE80211_IOC_AMSDU_LIMIT 803Set the limit on the size of AMSDU frames to the value in 804.Va i_val . 805This request causes a running interface to be reset. 806See 807.Dv IEEE80211_IOC_AMSDU_LIMIT 808above for details. 809.It Dv IEEE80211_IOC_APBRIDGE 810Set whether AP bridging is enabled using the value in 811.Va i_val . 812See 813.Dv IEEE80211_IOC_APBRIDGE 814above for details. 815.It Dv IEEE80211_IOC_APPIE 816Set an application information element using the data pointed to by 817.Va i_data . 818This request causes a running interface to be restarted if the WPA 819information element is changed. 820See 821.Dv IEEE80211_IOC_APPIE 822above for details. 823.It Dv IEEE80211_IOC_AUTHMODE 824Set the current authentication mode using the value in 825.Va i_val . 826This request causes a running interface to be restarted. 827See 828.Dv IEEE80211_IOC_AUTHMODE 829above for details. 830This request causes a running interface to be restarted. 831.It Dv IEEE80211_IOC_BEACON_INTERVAL 832Set the time between Beacon frames (in TU) to the value in 833.Va i_val . 834This request causes a running interface to be restarted. 835.It Dv IEEE80211_IOC_BGSCAN 836Set whether background scanning is enabled using the value in 837.Va i_val . 838.It Dv IEEE80211_IOC_BGSCAN_IDLE 839Set the minimum time (in msecs) a station must be idle 840before it will do a background scan to the value in 841.Va i_val . 842.It Dv IEEE80211_IOC_BGSCAN_INTERVAL 843Set the minimum time (seconds) between background scan operations to the value in 844.Va i_val . 845.It Dv IEEE80211_IOC_BMISSTHRESHOLD 846Set the number of consecutive missed Beacon frames before the system will 847attempt to roam to the value in 848.Va i_val . 849This request causes a running interface to be reset. 850.It Dv IEEE80211_IOC_BSSID 851Set the 802.11 MAC address for the desired BSS identifier according to 852.Va i_data . 853This request causes a running interface to be restarted. 854.It Dv IEEE80211_IOC_BURST 855Set whether or not packet bursting is enabled using the value in 856.Va i_val . 857This request causes a running interface to be reset. 858.It Dv IEEE80211_IOC_CHANNEL 859Set the desired/current channel to the value given by 860.Va i_val . 861This request causes a running interface to 862immediately change to the specified channel if possible; 863otherwise the interface will be restarted. 864Note this request is deprecated; use 865.Dv IEEE80211_IOC_CURCHAN 866instead. 867.It Dv IEEE80211_IOC_CHANLIST 868Set the list of available channels using the channel list pointed to by 869.Va i_data . 870The channel list is a bit vector with bit N set to 1 if 871IEEE channel number N is available for use. 872The specified channel list is checked against the set of supported 873channels and any channels not supported are silently ignored. 874If the intersection of the channel list and the supported channels is empty 875.Er EINVAL 876is returned. 877Note the current channel may be marked invalid after installing a 878new channel list. 879This request causes a running interface to be restarted. 880.It Dv IEEE80211_IOC_COUNTERMEASURES 881Set whether TKIP Countermeasures are enabled using the value in 882.Va i_val . 883This request can only be used when the authentication mode is set 884WPA; otherwise 885.Er EOPNOTSUPP 886will be returned. 887.It Dv IEEE80211_IOC_CURCHAN 888Set the current channel using the information referenced by 889.Va i_data . 890This request causes a running interface to 891immediately change to the specified channel if possible; 892otherwise the interface will be restarted. 893.It Dv IEEE80211_IOC_DELKEY 894Delete the key specified by the information referenced by 895.Va i_data . 896.It Dv IEEE80211_IOC_DELMAC 897Remove an entry in the MAC address Access Control List (ACL) database using 898the value pointed to by 899.Va i_data . 900The 901.Xr wlan_acl 4 902module must be installed and enabled or 903.Er EINVAL 904will be returned. 905.It Dv IEEE80211_IOC_DFS 906Set whether or not Dynamic Frequency Selection (DFS) is enabled 907using the value in 908.Va i_val . 909This request will fail with 910.Er EINVAL 911if 802.11h support is not enabled. 912See 913.Dv IEEE80211_IOC_DFS 914above for details. 915.It Dv IEEE80211_IOC_DOTD 916Set whether or not 802.11d support is enabled using the value in 917.Va i_val . 918This request causes a running interface to be restarted. 919See 920.Dv IEEE80211_IOC_DOTD 921above for details. 922.It Dv IEEE80211_IOC_DOTH 923Return whether 802.11h support is enabled using the value in 924.Va i_val . 925See 926.Dv IEEE80211_IOC_DOTH 927above for details. 928.It Dv IEEE80211_IOC_DROPUNENCRYPTED 929Set whether unencrypted packets transmit/received should be discarded 930using the value in 931.Va i_val . 932.It Dv IEEE80211_IOC_DTIM_PERIOD 933Set the period (in beacon intervals) between DTIM events to the value in 934.Va i_val . 935This request causes a running interface to be restarted. 936.It Dv IEEE80211_IOC_DWDS 937Set whether or not Dynamic WDS support is enabled using the value in 938.Va i_val . 939See 940.Dv IEEE80211_IOC_DWDS 941above for details. 942.It Dv IEEE80211_IOC_FF 943Set whether Atheros fast-frames support is enabled using the value in 944.Va i_val . 945This request causes a running interface to be restarted. 946See 947.Dv IEEE80211_IOC_FF 948above for details. 949.It Dv IEEE80211_IOC_FRAGTHRESHOLD 950Set the threshold (in bytes) for enabling fragmentation frames using the value in 951.Va i_val . 952This request causes a running interface to be reset. 953See 954.Dv IEEE80211_IOC_FRAGTHRESHOLD 955above for details. 956.It Dv IEEE80211_IOC_GREENFIELD 957Set whether or not Greenfield preamble use is enabled using the value in 958.Va i_val . 959This request causes a running interface to be reset. 960See 961.Dv IEEE80211_IOC_GREENFIELD 962above for details. 963.It Dv IEEE80211_IOC_HIDESSID 964Set whether SSID hiding/cloaking is enabled using the value in 965.Va i_val . 966This request causes a running interface to be reset. 967See 968.Dv IEEE80211_IOC_HIDESSID 969above for details. 970.It Dv IEEE80211_IOC_HTCOMPAT 971Set whether or not 802.11n compatibility support is enabled using the value in 972.Va i_val . 973This request causes a running interface to be reset if operating on HT channel. 974See 975.Dv IEEE80211_IOC_HTCOMPAT 976above for details. 977.It Dv IEEE80211_IOC_HTCONF 978Set automatic promotion of HT channels using the value in 979.Va i_val . 980This request causes a running interface to be restarted. 981See 982.Dv IEEE80211_IOC_HTCONF 983above for details. 984.It Dv IEEE80211_IOC_HTPROTMODE 985Set the technique used to protect HT frames in a mixed 802.11n network 986using the value in 987.Va i_val . 988This request causes a running interface to be reset. 989See 990.Dv IEEE80211_IOC_HTPROTMODE 991above for details. 992.It Dv IEEE80211_IOC_HWMP_MAXHOPS 993Set the maximum acceptable hop count in an HWMP path according to 994.Va i_val . 995Values must be in the range [0-255]. 996.It Dv IEEE80211_IOC_HWMP_ROOTMODE 997Set the Mesh root mode operation according to 998.Va i_val . 999Valid values are 1000.Dv IEEE80211_HWMP_ROOTMODE_DISABLED 1001(root mode is disabled), 1002.Dv IEEE80211_HWMP_ROOTMODE_NORMAL 1003(send broadcast Path Request frames), 1004.Dv IEEE80211_HWMP_ROOTMODE_PROACTIVE 1005(send broadcast Path Request frames and force replies) 1006and 1007.Dv IEEE80211_HWMP_ROOTMODE_RANN 1008(send broadcast Root Announcement (RANN) frames). 1009.It Dv IEEE80211_IOC_INACTIVITY 1010Set whether or not the system handles inactivity processing using the value in 1011.Va i_val . 1012When inactivity processing is enabled the system will track stations 1013that have not transmitted frames and periodically probe them to 1014check if they are still present. 1015Stations that are inactive and do not respond to probes are dropped. 1016.It Dv IEEE80211_IOC_MACCMD 1017Change the state of the MAC address Access Control List (ACL) system. 1018There are several requests supported: 1019.Dv IEEE80211_MACCMD_POLICY_OPEN 1020(set the current policy to disable ACL use), 1021.Dv IEEE80211_MACCMD_POLICY_ALLOW 1022(set the current policy to allow only addresses listed in the database), 1023.Dv IEEE80211_MACCMD_POLICY_DENY 1024(set the current policy to deny addresses listed in the database), 1025.Dv IEEE80211_MACCMD_POLICY_RADUS 1026(set the current policy to enable use of a RADIUS backend), 1027.Dv IEEE80211_MACCMD_FLUSH 1028(flush all addresses from the database), 1029and 1030.Dv IEEE80211_MACCMD_DETACH 1031(detach the ACL subsystem, disabling it). 1032The 1033.Xr wlan_acl 4 1034module must be installed or 1035.Er EINVAL 1036will be returned. 1037.It Dv IEEE80211_IOC_MESH_AP 1038Set whether or not Mesh AP support is enabled using 1039.Va i_val . 1040.It Dv IEEE80211_IOC_MESH_FWRD 1041Set whether or not packet forwarding support is enabled using 1042.Va i_val . 1043.It Dv IEEE80211_IOC_MESH_ID 1044Set the Mesh ID using the value pointed to by 1045.Va i_data . 1046A Mesh ID can be up to 1047.Dv IEEE80211_MESHID_LEN 1048bytes long. 1049.It Dv IEEE80211_IOC_MESH_PP_METRIC 1050Set the link metric protocol using the value pointed to by 1051.Va i_data . 1052.It Dv IEEE80211_IOC_MESH_PP_PATH 1053Set the path selection protocol using the value pointed to by 1054.Va i_data . 1055.It Dv IEEE80211_IOC_MESH_RTCMD 1056Manipulate the state of the Mesh routing tables. 1057Several requests are supported: 1058.Dv IEEE80211_MESH_RTCMD_FLUSH 1059(flush the contents of the routing table), 1060.Dv IEEE80211_MESH_RTCMD_ADD 1061(add an entry for the MAC address specified in 1062.Va i_data 1063and start the Peer discovery process), 1064and 1065.Dv IEEE80211_MESH_RTCMD_DELETE 1066(delete the entry corresponding to the MAC address specified in 1067.Va i_data ). 1068.It Dv IEEE80211_IOC_MESH_TTL 1069Set the Mesh Time To Live (TTL) setting installed in packets 1070transmitted by this mesh node using 1071.Va i_val . 1072.It Dv IEEE80211_IOC_MLME 1073Explicitly control the MLME state machine for a station using the 1074MLME request pointed to by 1075.Va i_data . 1076There are several MLME operations supported: 1077.Dv IEEE80211_MLME_ASSOC 1078(request association to an access point), 1079.Dv IEEE80211_MLME_DIASSOC 1080(diassociate the specified station), 1081.Dv IEEE80211_MLME_DEAUTH 1082(deauthenticate the specified station), 1083.Dv IEEE80211_MLME_AUHORIZE 1084(mark the specified station authorized to pass data frames), 1085.Dv IEEE80211_MLME_UNAUTHORIZE 1086(revoke the specified station's ability to pass data frames), 1087and 1088.Dv IEEE80211_MLME_AUTH 1089(request authentication to an access point). 1090Note when this facility is used for stations operating in infrastructure mode 1091the roaming mode should be set to manual. 1092.It Dv IEEE80211_IOC_POWERSAVE 1093Set the current powersaving mode to the value in 1094.Va i_val . 1095See 1096.Dv IEEE80211_IOC_POWERSAVE 1097above for valid values. 1098This request causes a running interface to be reset. 1099.It Dv IEEE80211_IOC_POWERSAVESLEEP 1100Set the powersave sleep time in TU to the value in 1101.Va i_val . 1102This request causes a running interface to be reset. 1103.It Dv IEEE80211_IOC_PRIVACY 1104Set the current MLME setting for PRIVACY using the value in 1105.Va i_val . 1106See 1107.Dv IEEE80211_IOC_PRIVACY 1108above for details. 1109.It Dv IEEE80211_IOC_PROTMODE 1110Set the current 802.11g protection mode to the value in 1111.Va i_val . 1112This request causes a running interface to be reset. 1113See 1114.Dv IEEE80211_IOC_PROTMODE 1115above for details. 1116This request causes a running interface to be reset. 1117.It Dv IEEE80211_IOC_PUREG 1118Set whether ``pure 11g'' mode is enabled using the value in 1119.Va i_val . 1120This request causes a running interface to be restarted. 1121See 1122.Dv IEEE80211_IOC_PUREG 1123above for details. 1124.It Dv IEEE80211_IOC_PUREN 1125Set whether ``pure 11n'' mode is enabled using the value in 1126.Va i_val . 1127This request causes a running interface to be restarted. 1128See 1129.Dv IEEE80211_IOC_PUREN 1130above for details. 1131.It Dv IEEE80211_IOC_REGDOMAIN 1132Set the regulatory state using the data referenced by 1133.Va i_data . 1134This request can only be issued when all interfaces cloned from the 1135underlying physical device are marked down; otherwise 1136.Er EBUSY 1137is returned. 1138Note the new regulatory data may invalidate any desired channel. 1139.It Dv IEEE80211_IOC_RIFS 1140Set whether or not Reduced InterFrame Spacing (RIFS) is enabled 1141using the value in 1142.Va i_val . 1143This setting is meaningful only when operating with 802.11n on an HT channel. 1144This request causes a running interface to be reset. 1145.It Dv IEEE80211_IOC_ROAM 1146Set station roaming parameters using the data pointed to by 1147.Va i_data . 1148.It Dv IEEE80211_IOC_ROAMING 1149Set the current roaming mode to the value in 1150.Va i_val . 1151See 1152.Dv IEEE80211_IOC_ROAMING 1153above for details. 1154.It Dv IEEE80211_IOC_RTSTHRESHOLD 1155Set the threshold (in bytes) for enabling transmission of RTS frames 1156to the value in 1157.Va i_val . 1158This request causes a running interface to be reset. 1159See 1160.Dv IEEE80211_IOC_RTSTHRESHOLD 1161above for details. 1162.It Dv IEEE80211_IOC_SCANVALID 1163Set the age (in seconds) that results from a scan operation will be 1164considered valid. 1165When scan results are no longer valid and they are needed (e.g. to roam) the 1166system will initiate a scan operation to replenish the scan cache. 1167.It Dv IEEE80211_IOC_SCAN_REQ 1168Request a scan operation using the parameters pointed to by 1169.Va i_val . 1170The underlying device must be running or 1171.Er ENXIO 1172will be returned. 1173Values for 1174.Va sr_duration , 1175.Va sr_mindwell , 1176and 1177.Va sr_maxdwell 1178shorter than 1 clock tick are rounded up to a tick. 1179If more SSID's are supplied than the system is capable of handling 1180the extra ones are silently ignored. 1181If a scan operation is already in progress the request will be 1182(silently) ignored. 1183.It Dv IEEE80211_IOC_SCAN_CANCEL 1184Cancel any pending/active scan operation. 1185.It Dv IEEE80211_IOC_SHORTGI 1186Set whether or not Short Guard Interval (SGI) is enabled using the value in 1187.Va i_val . 1188Note SGI is only used when operating on an HT (802.11n) channel. 1189This request causes a running interface to be reset. 1190.It Dv IEEE80211_IOC_SMPS 1191Set the Spatial Multiplexing Power Save (SMPS) setting to the value in 1192.Va i_val . 1193This request causes a running interface to be reset. 1194See 1195.Dv IEEE80211_IOC_SMPS 1196above for details. 1197.It Dv IEEE80211_IOC_SSID 1198Set the desired SSID using the value pointed to by 1199.Va i_data . 1200The string may be at most IEEE80211_NWID_LEN bytes. 1201This request causes a running interface to be restarted. 1202.It Dv IEEE80211_IOC_STA_STATS 1203Clear accumulated statistics for the specified station. 1204.It Dv IEEE80211_IOC_STA_VLAN 1205Set the VLAN tag for the specified station using the information pointed to by 1206.Va i_data . 1207.It Dv IEEE80211_IOC_TDMA_BINTERVAL 1208Set the interval between Beacon frames to the value in 1209.Va i_val . 1210Values must be positive. 1211This request causes a running interface to be reset. 1212.It Dv IEEE80211_IOC_TDMA_SLOT 1213Set the current TDMA slot to the value in 1214.Va i_val . 1215Values must be in the range [0-slotcnt]. 1216Slot 0 identifies the master in the TDMA network; if it running it will 1217immediately start sending Beacon frames. 1218.It Dv IEEE80211_IOC_TDMA_SLOTCNT 1219Set the number of slots in the TDMA network to the value in 1220.Va i_val . 1221This request causes a running interface to be reset. 1222.It Dv IEEE80211_IOC_TDMA_SLOTLEN 1223Set the length of the TDMA slot assigned to each station in the network 1224to the value in 1225.Va i_val . 1226Slot lengths must be in the range 200 usecs to 1024 milliseconds 1227(though values outside the range 1-200ms are unlikely to work well). 1228This request causes a running interface to be reset. 1229.It Dv IEEE80211_IOC_TSN 1230Set whether or not Transitional Security Network (TSN) is enabled 1231using the value in 1232.Va i_val . 1233.It Dv IEEE80211_IOC_TURBOP 1234Set whether Atheros Dynamic Turbo mode is enabled using the value in 1235.Va i_val . 1236This request causes a running interface to be restarted. 1237.It Dv IEEE80211_IOC_TXPARAMS 1238Set transmit parameters using the data pointed to be 1239.Va i_data . 1240This request causes a running interface to be restarted. 1241.It Dv IEEE80211_IOC_TXPOWER 1242Set the maximum transmit power limit in .5 dBm units to the value in 1243.Va i_val . 1244This request causes a running interface to be reset. 1245.It Dv IEEE80211_IOC_WEP 1246Set the current WEP mode to the value in 1247.Va i_val . 1248See 1249.Dv IEEE80211_IOC_WEP 1250above for valid values. 1251This request causes a running interface to be restarted. 1252Note this request is deprecated; use 1253.Dv IEEE80211_IOC_PRIVACY 1254and 1255.Dv IEEE80211_IOC_DROPUNENCRYPTED 1256instead. 1257.It Dv IEEE80211_IOC_WEPKEY 1258Set the WEP key indicated by 1259.Va i_val 1260using the data pointed to by 1261.Va i_data . 1262Note this request is deprecated; use 1263.Dv IEEE80211_IOC_WPAKEY 1264instead. 1265.It Dv IEEE80211_IOC_WEPTXKEY 1266Set the default transmit key used for transmission to the value in 1267.Va i_val . 1268.It Dv IEEE80211_IOC_WME 1269Set whether or not WME/WMM support is enabled using the value in 1270.Va i_val . 1271This request causes a running interface to be reset. 1272.It Dv IEEE80211_IOC_WME_ACKPOLICY 1273Set the WME ACK Policy for the Access Class (AC) specified in 1274.Va i_len 1275using the value in 1276.Va i_val . 1277.It Dv IEEE80211_IOC_WME_ACM 1278Set the WME Admission Control Mechanism for the Access Class (AC) specified in 1279.Va i_len 1280using the value in 1281.Va i_val . 1282.It Dv IEEE80211_IOC_WME_AIFS 1283Set the WME AIFS parameter for the Access Class (AC) specified in 1284.Va i_len 1285using the value in 1286.Va i_val . 1287.It Dv IEEE80211_IOC_WME_CWMAX 1288Set the WME CWmax parameter for the Access Class (AC) specified in 1289.Va i_len 1290using the value in 1291.Va i_val . 1292.It Dv IEEE80211_IOC_WME_CWMIN 1293Set the WME CWmin parameter for the Access Class (AC) specified in 1294.Va i_len 1295using the value in 1296.Va i_val . 1297.It Dv IEEE80211_IOC_WME_TXOPLIMIT 1298Set the WME TxOpLimit parameter for the Access Class (AC) specified in 1299.Va i_len 1300using the value in 1301.Va i_val . 1302.It Dv IEEE80211_IOC_WPA 1303Set the WPA configuration using the value in 1304.Va i_val . 1305This request causes a running interface to be reset. 1306See 1307.Dv IEEE80211_IOC_WPA 1308above for details. 1309.It Dv IEEE80211_IOC_WPAKEY 1310Set the requested cryptographic key using data in the buffer pointed to by 1311.Va i_data . 1312See 1313.Dv IEEE80211_IOC_WPAKEY 1314for details. 1315.It Dv IEEE80211_IOC_WPS 1316Set whether or not Wi-FI Protected Setup (WPS) is enabled using the value in 1317.Va i_val . 1318.El 1319.Sh SEE ALSO 1320.Xr ioctl 2 , 1321.Xr wlan 4 , 1322.Xr wlan_acl 4 , 1323.Xr wlan_xauth 4 , 1324.Xr hostapd 8 , 1325.Xr ifconfig 8 , 1326.Xr wpa_supplicant 8 1327