2 .\" Copyright (c) 2003 Tom Rhodes
3 .\" All rights reserved.
5 .\" Redistribution and use in source and binary forms, with or without
6 .\" modification, are permitted provided that the following conditions
8 .\" 1. Redistributions of source code must retain the above copyright
9 .\" notice, this list of conditions and the following disclaimer.
10 .\" 2. Redistributions in binary form must reproduce the above copyright
11 .\" notice, this list of conditions and the following disclaimer in the
12 .\" documentation and/or other materials provided with the distribution.
14 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33 .Nd generic 802.11 link-layer support
39 module provides generic code to support 802.11 drivers.
40 Where a device does not directly support 802.11 functionality
56 drivers, with other drivers to follow.
60 module supports multi-mode devices capable of
61 operating in both 2.4GHz and 5GHz bands and supports numerous
62 802.11 protocols: 802.11a, 802.11b, and 802.11g.
63 The WPA, 802.11i, and 802.1x security protocols are supported
64 through a combination of in-kernel code and user-mode applications.
65 The WME and WMM multi-media protocols are supported entirely within
68 module but require a suitably capable hardware device.
72 module defines several mechanisms by which plugin modules may
73 be used to extend functionality.
74 Cryptographic support such as WEP, TKIP, and AES-CCMP are implemented
75 as modules that are loaded on demand (if not statically configured
77 Similarly there is an authenticator framework for defining 802.11
78 authentication services and a framework for integrating access
79 control mechanisms specific to the 802.11 protocol.
81 If the associated interface is marked for debugging with, for example,
83 .Dl "ifconfig wi0 debug"
85 then messages describing the operation of the 802.11 protocol will
86 be sent to the console.
87 Complete debugging controls are available using:
89 .Dl "sysctl net.wlan.X.debug=mask"
95 instance and mask is a bit-or of control bits that determine which
96 debugging messages to enable.
99 .Dl "sysctl net.wlan.0.debug=0x00200000"
101 enables debugging messages related to scanning for an access point,
102 adhoc neighbor, or an unoccupied channel when operation as an access point.
105 tool provides a more user-friendly mechanism for doing the same thing.
107 Many drivers will also display the contents of each 802.11 frame
108 sent and received when the interface is marked with
113 .Dl "ifconfig wi0 debug link2"
115 Beware however that some management frames may be processed entirely within
116 the device and not be received by the host.
120 was used to be compatible with
141 More information can be found in the IEEE 802.11 Standard.
145 driver first appeared in
148 Atsushi Onoe is the author of original
150 software from which this work began.
153 brought the code into
155 and then rewrote it to support multi-mode devices,
156 802.11g, WPA/802.11i, WME, and add the extensible frameworks
157 for cryptographic, authentication, and access control plugins.
158 This manual page was written by
159 .An Tom Rhodes Aq trhodes@FreeBSD.org .