share/man/man4/net80211.4

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