xref: /freebsd/share/man/man4/wlan.4 (revision 2357939bc239bd5334a169b62313806178dd8f30)
1.\"
2.\" Copyright (c) 2003 Tom Rhodes
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.\" 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.
13.\"
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
24.\" SUCH DAMAGE.
25.\"
26.\" $FreeBSD$
27.\"
28.Dd September 25, 2003
29.Dt WLAN 4
30.Os
31.Sh NAME
32.Nm wlan
33.Nd generic 802.11 link-layer support
34.Sh SYNOPSIS
35.Cd "device wlan"
36.Sh DESCRIPTION
37The
38.Nm
39device provides generic code to support 802.11
40drivers, including host AP mode.
41Currently it is required for the
42.Xr wi 4 ,
43.Xr an 4
44and
45.Xr ath 4
46drivers but will eventually be required by all 802.11 drivers.
47.Pp
48If the associated interface is marked for debugging with, for example,
49.Bd -literal -offset indent
50ifconfig wi0 debug
51.Ed
52.Pp
53then messages describing the operation of the 802.11 protocol will
54be sent to the console.
55With the interface marked for debugging, doing:
56.Bd -literal -offset indent
57sysctl debug.ieee80211=1
58.Ed
59.Pp
60causes additional messages to be generated.
61Many drivers will also display the contents of each 802.11 frame
62sent and received when the interface is marked with
63both debugging and ``link2''; e.g.
64.Bd -literal -offset indent
65ifconfig wi0 debug link2
66.Ed
67.Pp
68Beware however that some management frames may be processed entirely within
69the device and not be received by the host.
70.Sh COMPATIBILITY
71The module name of
72.Nm
73was used to be compatible with
74.Nx .
75.Sh SEE ALSO
76.Xr an 4 ,
77.Xr ath 4 ,
78.Xr awi 4 ,
79.Xr netintro 4 ,
80.Xr wi 4
81.Sh STANDARDS
82More information can be found in the IEEE 802.11 Standard.
83.Sh HISTORY
84The
85.Nm
86driver first appeared in
87.Fx 5.0 .
88.Sh AUTHORS
89Atsushi Onoe is the original author of this software.
90The
91.Nx
92support was adapted to
93.Fx
94by
95.An -nosplit
96.An Sam Leffler .
97This manual page was written by
98.An Tom Rhodes Aq trhodes@FreeBSD.org .
99