share/man/man9/ieee80211.9

   1 .\"
   2 .\" Copyright (c) 2004 Bruce M. Simpson <bms@spc.org>
   3 .\" Copyright (c) 2004 Darron Broad <darron@kewl.org>
   4 .\" Copyright (c) 2009 Sam Leffler, Errno Consulting
   5 .\" All rights reserved.
   6 .\"
   7 .\" Redistribution and use in source and binary forms, with or without
   8 .\" modification, are permitted provided that the following conditions
   9 .\" are met:
  10 .\" 1. Redistributions of source code must retain the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer.
  12 .\" 2. Redistributions in binary form must reproduce the above copyright
  13 .\"    notice, this list of conditions and the following disclaimer in the
  14 .\"    documentation and/or other materials provided with the distribution.
  15 .\"
  16 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  17 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  18 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  19 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  20 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  21 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  22 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  23 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  24 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  25 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  26 .\" SUCH DAMAGE.
  27 .\"
  28 .\" $FreeBSD$
  29 .\"
  30 .Dd January 26, 2021
  31 .Dt IEEE80211 9
  32 .Os
  33 .Sh NAME
  34 .Nm IEEE80211
  35 .Nd 802.11 network layer
  36 .Sh SYNOPSIS
  37 .In net80211/ieee80211_var.h
  38 .Ft void
  39 .Fn ieee80211_ifattach "struct ieee80211com *ic"
  40 .Ft void
  41 .Fn ieee80211_ifdetach "struct ieee80211com *ic"
  42 .Ft int
  43 .Fn ieee80211_mhz2ieee "u_int freq" "u_int flags"
  44 .Ft int
  45 .Fn ieee80211_chan2ieee "struct ieee80211com *ic" "const struct ieee80211_channel *c"
  46 .Ft u_int
  47 .Fn ieee80211_ieee2mhz "u_int chan" "u_int flags"
  48 .Ft int
  49 .Fn ieee80211_media_change "struct ifnet *ifp"
  50 .Ft void
  51 .Fn ieee80211_media_status "struct ifnet *ifp" "struct ifmediareq *imr"
  52 .Ft int
  53 .Fn ieee80211_setmode "struct ieee80211com *ic" "enum ieee80211_phymode mode"
  54 .Ft enum ieee80211_phymode
  55 .Fo ieee80211_chan2mode
  56 .Fa "const struct ieee80211_channel *chan"
  57 .Fc
  58 .Ft int
  59 .Fo ieee80211_rate2media
  60 .Fa "struct ieee80211com *ic" "int rate" "enum ieee80211_phymode mode"
  61 .Fc
  62 .Ft int
  63 .Fn ieee80211_media2rate "int mword"
  64 .Sh DESCRIPTION
  65 IEEE 802.11 device drivers are written to use the infrastructure provided
  66 by the
  67 .Nm
  68 software layer.
  69 This software provides a support framework for drivers that includes
  70 ifnet cloning, state management, and a user management API by which
  71 applications interact with 802.11 devices.
  72 Most drivers depend on the
  73 .Nm
  74 layer for protocol services but devices that off-load functionality
  75 may bypass the layer to connect directly to the device.
  76 .Pp
  77 A
  78 .Nm
  79 device driver implements a virtual radio API that is exported to
  80 users through network interfaces (aka vaps) that are cloned from the
  81 underlying device.
  82 These interfaces have an operating mode
  83 (station, adhoc, hostap, wds, monitor, etc.\&)
  84 that is fixed for the lifetime of the interface.
  85 Devices that can support multiple concurrent interfaces allow
  86 multiple vaps to be cloned.
  87 This enables construction of interesting applications such as
  88 an AP vap and one or more WDS vaps
  89 or multiple AP vaps, each with a different security model.
  90 The
  91 .Nm
  92 layer virtualizes most 802.11 state
  93 and coordinates vap state changes including scheduling multiple vaps.
  94 State that is not virtualized includes the current channel and
  95 WME/WMM parameters.
  96 Protocol processing is typically handled entirely in the
  97 .Nm
  98 layer with drivers responsible purely for moving data between the host
  99 and device.
 100 Similarly,
 101 .Nm
 102 handles most
 103 .Xr ioctl 2
 104 requests without entering the driver;
 105 instead drivers are notified of state changes that
 106 require their involvement.
 107 .Pp
 108 The virtual radio interface defined by the
 109 .Nm
 110 layer means that drivers must be structured to follow specific rules.
 111 Drivers that support only a single interface at any time must still
 112 follow these rules.
 113 .Pp
 114 Most of these functions require that attachment to the stack is performed
 115 before calling.
 116 .Pp
 117 .\"
 118 The
 119 .Fn ieee80211_ifattach
 120 function attaches the wireless network interface
 121 .Fa ic
 122 to the 802.11 network stack layer.
 123 This function must be called before using any of the
 124 .Nm
 125 functions which need to store driver state across invocations.
 126 .Pp
 127 .\"
 128 The
 129 .Fn ieee80211_ifdetach
 130 function frees any
 131 .Nm
 132 structures associated with the driver, and performs Ethernet and BPF
 133 detachment on behalf of the caller.
 134 .Pp
 135 .\"
 136 The
 137 .Fn ieee80211_mhz2ieee
 138 utility function converts the frequency
 139 .Fa freq
 140 (specified in MHz) to an IEEE 802.11 channel number.
 141 The
 142 .Fa flags
 143 argument is a hint which specifies whether the frequency is in
 144 the 2GHz ISM band
 145 .Pq Vt IEEE80211_CHAN_2GHZ
 146 or the 5GHz band
 147 .Pq Vt IEEE80211_CHAN_5GHZ ;
 148 appropriate clipping of the result is then performed.
 149 .Pp
 150 .\"
 151 The
 152 .Fn ieee80211_chan2ieee
 153 function converts the channel specified in
 154 .Fa *c
 155 to an IEEE channel number for the driver
 156 .Fa ic .
 157 If the conversion would be invalid, an error message is printed to the
 158 system console.
 159 This function REQUIRES that the driver is hooked up to the
 160 .Nm
 161 subsystem.
 162 .Pp
 163 .\"
 164 The
 165 .Fn ieee80211_ieee2mhz
 166 utility function converts the IEEE channel number
 167 .Ft chan
 168 to a frequency (in MHz).
 169 The
 170 .Fa flags
 171 argument is a hint which specifies whether the frequency is in
 172 the 2GHz ISM band
 173 .Pq Vt IEEE80211_CHAN_2GHZ
 174 or the 5GHz band
 175 .Pq Vt IEEE80211_CHAN_5GHZ ;
 176 appropriate clipping of the result is then performed.
 177 .Pp
 178 .\"
 179 The
 180 .Fn ieee80211_media_status
 181 and
 182 .Fn ieee80211_media_change
 183 functions are device-independent handlers for
 184 .Vt ifmedia
 185 commands and are not intended to be called directly.
 186 .Pp
 187 .\"
 188 The
 189 .Fn ieee80211_setmode
 190 function is called from within the 802.11 stack to change the mode
 191 of the driver's PHY; it is not intended to be called directly.
 192 .Pp
 193 .\"
 194 The
 195 .Fn ieee80211_chan2mode
 196 function returns the PHY mode required for use with the channel
 197 .Fa chan .
 198 This is typically used when selecting a rate set, to be advertised in
 199 beacons, for example.
 200 .Pp
 201 .\"
 202 The
 203 .Fn ieee80211_rate2media
 204 function converts the bit rate
 205 .Fa rate
 206 (measured in units of 0.5Mbps) to an
 207 .Vt ifmedia
 208 sub-type, for the device
 209 .Fa ic
 210 running in PHY mode
 211 .Fa mode .
 212 The
 213 .Fn ieee80211_media2rate
 214 performs the reverse of this conversion, returning the bit rate (in 0.5Mbps
 215 units) corresponding to an
 216 .Vt ifmedia
 217 sub-type.
 218 .
 219 .Sh DATA STRUCTURES
 220 The virtual radio architecture splits state between a single per-device
 221 .Vt ieee80211com
 222 structure and one or more
 223 .Vt ieee80211vap
 224 structures.
 225 Drivers are expected to setup various shared state in these structures
 226 at device attach and during vap creation but otherwise should treat them
 227 as read-only.
 228 The
 229 .Vt ieee80211com
 230 structure is allocated by the
 231 .Nm
 232 layer as adjunct data to a device's
 233 .Vt ifnet ;
 234 it is accessed through the
 235 .Vt if_l2com
 236 structure member.
 237 The
 238 .Vt ieee80211vap
 239 structure is allocated by the driver in the
 240 .Dq vap create
 241 method
 242 and should be extended with any driver-private state.
 243 This technique of giving the driver control to allocate data structures
 244 is used for other
 245 .Nm
 246 data structures and should be exploited to maintain driver-private state
 247 together with public
 248 .Nm
 249 state.
 250 .Pp
 251 The other main data structures are the station, or node, table
 252 that tracks peers in the local BSS, and the channel table that defines
 253 the current set of available radio channels.
 254 Both tables are bound to the
 255 .Vt ieee80211com
 256 structure and shared by all vaps.
 257 Long-lasting references to a node are counted to guard against
 258 premature reclamation.
 259 In particular every packet sent/received holds a node reference
 260 (either explicitly for transmit or implicitly on receive).
 261 .Pp
 262 The
 263 .Vt ieee80211com
 264 and
 265 .Vt ieee80211vap
 266 structures also hold a collection of method pointers that drivers
 267 fill-in and/or override to take control of certain operations.
 268 These methods are the primary way drivers are bound to the
 269 .Nm
 270 layer and are described below.
 271 .Sh DRIVER ATTACH/DETACH
 272 Drivers attach to the
 273 .Nm
 274 layer with the
 275 .Fn ieee80211_ifattach
 276 function.
 277 The driver is expected to allocate and setup any device-private
 278 data structures before passing control.
 279 The
 280 .Vt ieee80211com
 281 structure must be pre-initialized with state required to setup the
 282 .Nm
 283 layer:
 284 .Bl -tag -width ic_channels
 285 .It Dv ic_ifp
 286 Backpointer to the physical device's ifnet.
 287 .It Dv ic_caps
 288 Device/driver capabilities; see below for a complete description.
 289 .It Dv ic_channels
 290 Table of channels the device is capable of operating on.
 291 This is initially provided by the driver but may be changed
 292 through calls that change the regulatory state.
 293 .It Dv ic_nchan
 294 Number of entries in
 295 .Dv ic_channels .
 296 .El
 297 .Pp
 298 On return from
 299 .Fn ieee80211_ifattach
 300 the driver is expected to override default callback functions in the
 301 .Vt ieee80211com
 302 structure to register it's private routines.
 303 Methods marked with a
 304 .Dq *
 305 must be provided by the driver.
 306 .Bl -tag -width ic_channels
 307 .It Dv ic_vap_create*
 308 Create a vap instance of the specified type (operating mode).
 309 Any fixed BSSID and/or MAC address is provided.
 310 Drivers that support multi-bssid operation may honor the requested BSSID
 311 or assign their own.
 312 .It Dv ic_vap_delete*
 313 Destroy a vap instance created with
 314 .Dv ic_vap_create .
 315 .It Dv ic_getradiocaps
 316 Return the list of calibrated channels for the radio.
 317 The default method returns the current list of channels
 318 (space permitting).
 319 .It Dv ic_setregdomain
 320 Process a request to change regulatory state.
 321 The routine may reject a request or constrain changes (e.g. reduce
 322 transmit power caps).
 323 The default method accepts all proposed changes.
 324 .It Dv ic_send_mgmt
 325 Send an 802.11 management frame.
 326 The default method fabricates the frame using
 327 .Nm
 328 state and passes it to the driver through the
 329 .Dv ic_raw_xmit
 330 method.
 331 .It Dv ic_raw_xmit
 332 Transmit a raw 802.11 frame.
 333 The default method drops the frame and generates a message on the console.
 334 .It Dv ic_updateslot
 335 Update hardware state after an 802.11 IFS slot time change.
 336 There is no default method; the pointer may be NULL in which case
 337 it will not be used.
 338 .It Dv ic_update_mcast
 339 Update hardware for a change in the multicast packet filter.
 340 The default method prints a console message.
 341 .It Dv ic_update_promisc
 342 Update hardware for a change in the promiscuous mode setting.
 343 The default method prints a console message.
 344 .It Dv ic_newassoc
 345 Update driver/device state for association to a new AP (in station mode)
 346 or when a new station associates (e.g. in AP mode).
 347 There is no default method; the pointer may be NULL in which case
 348 it will not be used.
 349 .It Dv ic_node_alloc
 350 Allocate and initialize a
 351 .Vt ieee80211_node
 352 structure.
 353 This method cannot sleep.
 354 The default method allocates zero'd memory using
 355 .Xr malloc 9 .
 356 Drivers should override this method to allocate extended storage
 357 for their own needs.
 358 Memory allocated by the driver must be tagged with
 359 .Dv M_80211_NODE
 360 to balance the memory allocation statistics.
 361 .It Dv ic_node_free
 362 Reclaim storage of a node allocated by
 363 .Dv ic_node_alloc  .
 364 Drivers are expected to
 365 .Em interpose
 366 their own method to cleanup private state but must call through
 367 this method to allow
 368 .Nm
 369 to reclaim it's private state.
 370 .It Dv ic_node_cleanup
 371 Cleanup state in a
 372 .Vt ieee80211_node
 373 created by
 374 .Dv ic_node_alloc .
 375 This operation is distinguished from
 376 .Dv ic_node_free
 377 in that it may be called long before the node is actually reclaimed
 378 to cleanup adjunct state.
 379 This can happen, for example, when a node must not be reclaimed
 380 due to references held by packets in the transmit queue.
 381 Drivers typically interpose
 382 .Dv ic_node_cleanup
 383 instead of
 384 .Dv ic_node_free .
 385 .It Dv ic_node_age
 386 Age, and potentially reclaim, resources associated with a node.
 387 The default method ages frames on the power-save queue (in AP mode)
 388 and pending frames in the receive reorder queues (for stations using A-MPDU).
 389 .It Dv ic_node_drain
 390 Reclaim all optional resources associated with a node.
 391 This call is used to free up resources when they are in short supply.
 392 .It Dv ic_node_getrssi
 393 Return the Receive Signal Strength Indication (RSSI) in .5 dBm units for
 394 the specified node.
 395 This interface returns a subset of the information
 396 returned by
 397 .Dv ic_node_getsignal .
 398 The default method calculates a filtered average over the last ten
 399 samples passed in to
 400 .Xr ieee80211_input 9
 401 or
 402 .Xr ieee80211_input_all 9 .
 403 .It Dv ic_node_getsignal
 404 Return the RSSI and noise floor (in .5 dBm units) for a station.
 405 The default method calculates RSSI as described above;
 406 the noise floor returned is the last value supplied to
 407 .Xr ieee80211_input 9
 408 or
 409 .Xr ieee80211_input_all 9 .
 410 .It Dv ic_node_getmimoinfo
 411 Return MIMO radio state for a station in support of the
 412 .Dv IEEE80211_IOC_STA_INFO
 413 ioctl request.
 414 The default method returns nothing.
 415 .It Dv ic_scan_start*
 416 Prepare driver/hardware state for scanning.
 417 This callback is done in a sleepable context.
 418 .It Dv ic_scan_end*
 419 Restore driver/hardware state after scanning completes.
 420 This callback is done in a sleepable context.
 421 .It Dv ic_set_channel*
 422 Set the current radio channel using
 423 .Vt ic_curchan .
 424 This callback is done in a sleepable context.
 425 .It Dv ic_scan_curchan
 426 Start scanning on a channel.
 427 This method is called immediately after each channel change
 428 and must initiate the work to scan a channel and schedule a timer
 429 to advance to the next channel in the scan list.
 430 This callback is done in a sleepable context.
 431 The default method handles active scan work (e.g. sending ProbeRequest
 432 frames), and schedules a call to
 433 .Xr ieee80211_scan_next 9
 434 according to the maximum dwell time for the channel.
 435 Drivers that off-load scan work to firmware typically use this method
 436 to trigger per-channel scan activity.
 437 .It Dv ic_scan_mindwell
 438 Handle reaching the minimum dwell time on a channel when scanning.
 439 This event is triggered when one or more stations have been found on
 440 a channel and the minimum dwell time has been reached.
 441 This callback is done in a sleepable context.
 442 The default method signals the scan machinery to advance
 443 to the next channel as soon as possible.
 444 Drivers can use this method to preempt further work (e.g. if scanning
 445 is handled by firmware) or ignore the request to force maximum dwell time
 446 on a channel.
 447 .It Dv ic_recv_action
 448 Process a received Action frame.
 449 The default method points to
 450 .Xr ieee80211_recv_action 9
 451 which provides a mechanism for setting up handlers for each Action frame class.
 452 .It Dv ic_send_action
 453 Transmit an Action frame.
 454 The default method points to
 455 .Xr ieee80211_send_action 9
 456 which provides a mechanism for setting up handlers for each Action frame class.
 457 .It Dv ic_ampdu_enable
 458 Check if transmit A-MPDU should be enabled for the specified station and AC.
 459 The default method checks a per-AC traffic rate against a per-vap
 460 threshold to decide if A-MPDU should be enabled.
 461 This method also rate-limits ADDBA requests so that requests are not
 462 made too frequently when a receiver has limited resources.
 463 .It Dv ic_addba_request
 464 Request A-MPDU transmit aggregation.
 465 The default method sets up local state and issues an
 466 ADDBA Request Action frame.
 467 Drivers may interpose this method if they need to setup private state
 468 for handling transmit A-MPDU.
 469 .It Dv ic_addb_response
 470 Process a received ADDBA Response Action frame and setup resources as
 471 needed for doing transmit A-MPDU.
 472 .It Dv ic_addb_stop
 473 Shutdown an A-MPDU transmit stream for the specified station and AC.
 474 The default method reclaims local state after sending a DelBA Action frame.
 475 .It Dv ic_bar_response
 476 Process a response to a transmitted BAR control frame.
 477 .It Dv ic_ampdu_rx_start
 478 Prepare to receive A-MPDU data from the specified station for the TID.
 479 .It Dv ic_ampdu_rx_stop
 480 Terminate receipt of A-MPDU data from the specified station for the TID.
 481 .El
 482 .Pp
 483 Once the
 484 .Nm
 485 layer is attached to a driver there are two more steps typically done
 486 to complete the work:
 487 .Bl -enum
 488 .It
 489 Setup
 490 .Dq radiotap support
 491 for capturing raw 802.11 packets that pass through the device.
 492 This is done with a call to
 493 .Xr ieee80211_radiotap_attach 9 .
 494 .It
 495 Do any final device setup like enabling interrupts.
 496 .El
 497 .Pp
 498 State is torn down and reclaimed with a call to
 499 .Fn ieee80211_ifdetach .
 500 Note this call may result in multiple callbacks into the driver
 501 so it should be done before any critical driver state is reclaimed.
 502 On return from
 503 .Fn ieee80211_ifdetach
 504 all associated vaps and ifnet structures are reclaimed or inaccessible
 505 to user applications so it is safe to teardown driver state without
 506 worry about being re-entered.
 507 The driver is responsible for calling
 508 .Xr if_free 9
 509 on the ifnet it allocated for the physical device.
 510 .Sh DRIVER CAPABILITIES
 511 Driver/device capabilities are specified using several sets of flags
 512 in the
 513 .Vt ieee80211com
 514 structure.
 515 General capabilities are specified by
 516 .Vt ic_caps .
 517 Hardware cryptographic capabilities are specified by
 518 .Vt ic_cryptocaps .
 519 802.11n capabilities, if any, are specified by
 520 .Vt ic_htcaps .
 521 The
 522 .Nm
 523 layer propagates a subset of these capabilities to each vap through
 524 the equivalent fields:
 525 .Vt iv_caps ,
 526 .Vt iv_cryptocaps ,
 527 and
 528 .Vt iv_htcaps .
 529 The following general capabilities are defined:
 530 .Bl -tag -width IEEE80211_C_8023ENCAP
 531 .It Dv IEEE80211_C_STA
 532 Device is capable of operating in station (aka Infrastructure) mode.
 533 .It Dv IEEE80211_C_8023ENCAP
 534 Device requires 802.3-encapsulated frames be passed for transmit.
 535 By default
 536 .Nm
 537 will encapsulate all outbound frames as 802.11 frames (without a PLCP header).
 538 .It Dv IEEE80211_C_FF
 539 Device supports Atheros Fast-Frames.
 540 .It Dv IEEE80211_C_TURBOP
 541 Device supports Atheros Dynamic Turbo mode.
 542 .It Dv IEEE80211_C_IBSS
 543 Device is capable of operating in adhoc/IBSS mode.
 544 .It Dv IEEE80211_C_PMGT
 545 Device supports dynamic power-management (aka power save) in station mode.
 546 .It Dv IEEE80211_C_HOSTAP
 547 Device is capable of operating as an Access Point in Infrastructure mode.
 548 .It Dv IEEE80211_C_AHDEMO
 549 Device is capable of operating in Adhoc Demo mode.
 550 In this mode the device is used purely to send/receive raw 802.11 frames.
 551 .It Dv IEEE80211_C_SWRETRY
 552 Device supports software retry of transmitted frames.
 553 .It Dv IEEE80211_C_TXPMGT
 554 Device support dynamic transmit power changes on transmitted frames;
 555 also known as Transmit Power Control (TPC).
 556 .It Dv IEEE80211_C_SHSLOT
 557 Device supports short slot time operation (for 802.11g).
 558 .It Dv IEEE80211_C_SHPREAMBLE
 559 Device supports short preamble operation (for 802.11g).
 560 .It Dv IEEE80211_C_MONITOR
 561 Device is capable of operating in monitor mode.
 562 .It Dv IEEE80211_C_DFS
 563 Device supports radar detection and/or DFS.
 564 DFS protocol support can be handled by
 565 .Nm
 566 but the device must be capable of detecting radar events.
 567 .It Dv IEEE80211_C_MBSS
 568 Device is capable of operating in MeshBSS (MBSS) mode
 569 (as defined by 802.11s Draft 3.0).
 570 .It Dv IEEE80211_C_WPA1
 571 Device supports WPA1 operation.
 572 .It Dv IEEE80211_C_WPA2
 573 Device supports WPA2/802.11i operation.
 574 .It Dv IEEE80211_C_BURST
 575 Device supports frame bursting.
 576 .It Dv IEEE80211_C_WME
 577 Device supports WME/WMM operation
 578 (at the moment this is mostly support for sending and receiving
 579 QoS frames with EDCF).
 580 .It Dv IEEE80211_C_WDS
 581 Device supports transmit/receive of 4-address frames.
 582 .It Dv IEEE80211_C_BGSCAN
 583 Device supports background scanning.
 584 .It Dv IEEE80211_C_TXFRAG
 585 Device supports transmit of fragmented 802.11 frames.
 586 .It Dv IEEE80211_C_TDMA
 587 Device is capable of operating in TDMA mode.
 588 .El
 589 .Pp
 590 The follow general crypto capabilities are defined.
 591 In general
 592 .Nm
 593 will fall-back to software support when a device is not capable
 594 of hardware acceleration of a cipher.
 595 This can be done on a per-key basis.
 596 .Nm
 597 can also handle software
 598 .Dv Michael
 599 calculation combined with hardware
 600 .Dv AES
 601 acceleration.
 602 .Bl -tag -width IEEE80211_C_8023ENCAP
 603 .It Dv IEEE80211_CRYPTO_WEP
 604 Device supports hardware WEP cipher.
 605 .It Dv IEEE80211_CRYPTO_TKIP
 606 Device supports hardware TKIP cipher.
 607 .It Dv IEEE80211_CRYPTO_AES_OCB
 608 Device supports hardware AES-OCB cipher.
 609 .It Dv IEEE80211_CRYPTO_AES_CCM
 610 Device supports hardware AES-CCM cipher.
 611 .It Dv IEEE80211_CRYPTO_TKIPMIC
 612 Device supports hardware Michael for use with TKIP.
 613 .It Dv IEEE80211_CRYPTO_CKIP
 614 Devices supports hardware CKIP cipher.
 615 .El
 616 .Pp
 617 The follow general 802.11n capabilities are defined.
 618 The first capabilities are defined exactly as they appear in the
 619 802.11n specification.
 620 Capabilities beginning with IEEE80211_HTC_AMPDU are used solely by the
 621 .Nm
 622 layer.
 623 .Bl -tag -width IEEE80211_C_8023ENCAP
 624 .It Dv IEEE80211_HTCAP_CHWIDTH40
 625 Device supports 20/40 channel width operation.
 626 .It Dv IEEE80211_HTCAP_SMPS_DYNAMIC
 627 Device supports dynamic SM power save operation.
 628 .It Dv IEEE80211_HTCAP_SMPS_ENA
 629 Device supports static SM power save operation.
 630 .It Dv IEEE80211_HTCAP_GREENFIELD
 631 Device supports Greenfield preamble.
 632 .It Dv IEEE80211_HTCAP_SHORTGI20
 633 Device supports Short Guard Interval on 20MHz channels.
 634 .It Dv IEEE80211_HTCAP_SHORTGI40
 635 Device supports Short Guard Interval on 40MHz channels.
 636 .It Dv IEEE80211_HTCAP_TXSTBC
 637 Device supports Space Time Block Convolution (STBC) for transmit.
 638 .It Dv IEEE80211_HTCAP_RXSTBC_1STREAM
 639 Device supports 1 spatial stream for STBC receive.
 640 .It Dv IEEE80211_HTCAP_RXSTBC_2STREAM
 641 Device supports 1-2 spatial streams for STBC receive.
 642 .It Dv IEEE80211_HTCAP_RXSTBC_3STREAM
 643 Device supports 1-3 spatial streams for STBC receive.
 644 .It Dv IEEE80211_HTCAP_MAXAMSDU_7935
 645 Device supports A-MSDU frames up to 7935 octets.
 646 .It Dv IEEE80211_HTCAP_MAXAMSDU_3839
 647 Device supports A-MSDU frames up to 3839 octets.
 648 .It Dv IEEE80211_HTCAP_DSSSCCK40
 649 Device supports use of DSSS/CCK on 40MHz channels.
 650 .It Dv IEEE80211_HTCAP_PSMP
 651 Device supports PSMP.
 652 .It Dv IEEE80211_HTCAP_40INTOLERANT
 653 Device is intolerant of 40MHz wide channel use.
 654 .It Dv IEEE80211_HTCAP_LSIGTXOPPROT
 655 Device supports L-SIG TXOP protection.
 656 .It Dv IEEE80211_HTC_AMPDU
 657 Device supports A-MPDU aggregation.
 658 Note that any 802.11n compliant device must support A-MPDU receive
 659 so this implicitly means support for
 660 .Em transmit
 661 of A-MPDU frames.
 662 .It Dv IEEE80211_HTC_AMSDU
 663 Device supports A-MSDU aggregation.
 664 Note that any 802.11n compliant device must support A-MSDU receive
 665 so this implicitly means support for
 666 .Em transmit
 667 of A-MSDU frames.
 668 .It Dv IEEE80211_HTC_HT
 669 Device supports High Throughput (HT) operation.
 670 This capability must be set to enable 802.11n functionality
 671 in
 672 .Nm .
 673 .It Dv IEEE80211_HTC_SMPS
 674 Device supports MIMO Power Save operation.
 675 .It Dv IEEE80211_HTC_RIFS
 676 Device supports Reduced Inter Frame Spacing (RIFS).
 677 .El
 678 .Sh SEE ALSO
 679 .Xr ioctl 2 ,
 680 .Xr ieee80211_amrr 9 ,
 681 .Xr ieee80211_beacon 9 ,
 682 .Xr ieee80211_bmiss 9 ,
 683 .Xr ieee80211_crypto 9 ,
 684 .Xr ieee80211_ddb 9 ,
 685 .Xr ieee80211_input 9 ,
 686 .Xr ieee80211_node 9 ,
 687 .Xr ieee80211_output 9 ,
 688 .Xr ieee80211_proto 9 ,
 689 .Xr ieee80211_radiotap 9 ,
 690 .Xr ieee80211_regdomain 9 ,
 691 .Xr ieee80211_scan 9 ,
 692 .Xr ieee80211_vap 9 ,
 693 .Xr ifnet 9 ,
 694 .Xr malloc 9
 695 .Sh HISTORY
 696 The
 697 .Nm
 698 series of functions first appeared in
 699 .Nx 1.5 ,
 700 and were later ported to
 701 .Fx 4.6 .
 702 This man page was updated with the information from
 703 .Nx
 704 .Nm
 705 man page.
 706 .Sh AUTHORS
 707 .An -nosplit
 708 The original
 709 .Nx
 710 .Nm
 711 man page was written by
 712 .An Bruce M. Simpson Aq Mt bms@FreeBSD.org
 713 and
 714 .An Darron Broad Aq Mt darron@kewl.org .