share/man/man4/wlan.4

   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 November 26, 2005
  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
  37 The
  38 .Nm
  39 module provides generic code to support 802.11 drivers.
  40 Where a device does not directly support 802.11 functionality
  41 this layer fills in.
  42 The
  43 .Nm
  44 is required for the
  45 .Xr an 4 ,
  46 .Xr ath 4 ,
  47 .Xr awi 4 ,
  48 .Xr ipw 4 ,
  49 .Xr iwi 4 ,
  50 .Xr ral 4 ,
  51 .Xr rum 4 ,
  52 .Xr ural 4 ,
  53 and
  54 .Xr wi 4
  55 drivers, with other drivers to follow.
  56 .Pp
  57 The
  58 .Nm
  59 module supports multi-mode devices capable of
  60 operating in both 2.4GHz and 5GHz bands and supports numerous
  61 802.11 protocols: 802.11a, 802.11b, and 802.11g.
  62 The WPA, 802.11i, and 802.1x security protocols are supported
  63 through a combination of in-kernel code and user-mode applications.
  64 The WME and WMM multi-media protocols are supported entirely within
  65 the
  66 .Nm
  67 module but require a suitably capable hardware device.
  68 .Pp
  69 The
  70 .Nm
  71 module defines several mechanisms by which plugin modules may
  72 be used to extend functionality.
  73 Cryptographic support such as WEP, TKIP, and AES-CCMP are implemented
  74 as modules that are loaded on demand (if not statically configured
  75 into a system).
  76 Similarly there is an authenticator framework for defining 802.11
  77 authentication services and a framework for integrating access
  78 control mechanisms specific to the 802.11 protocol.
  79 .Sh DEBUGGING
  80 If the associated interface is marked for debugging with, for example,
  81 .Pp
  82 .Dl "ifconfig wi0 debug"
  83 .Pp
  84 then messages describing the operation of the 802.11 protocol will
  85 be sent to the console.
  86 Complete debugging controls are available using:
  87 .Pp
  88 .Dl "sysctl net.wlan.X.debug=mask"
  89 .Pp
  90 where
  91 .Ar X
  92 is the number of the
  93 .Nm
  94 instance and mask is a bit-or of control bits that determine which
  95 debugging messages to enable.
  96 For example,
  97 .Pp
  98 .Dl "sysctl net.wlan.0.debug=0x00200000"
  99 .Pp
 100 enables debugging messages related to scanning for an access point,
 101 adhoc neighbor, or an unoccupied channel when operation as an access point.
 102 The
 103 .Xr 80211debug
 104 tool provides a more user-friendly mechanism for doing the same thing.
 105 .Pp
 106 Many drivers will also display the contents of each 802.11 frame
 107 sent and received when the interface is marked with
 108 both debugging and
 109 .Cm link2 ;
 110 e.g.,
 111 .Pp
 112 .Dl "ifconfig wi0 debug link2"
 113 .Pp
 114 Beware however that some management frames may be processed entirely within
 115 the device and not be received by the host.
 116 .Sh COMPATIBILITY
 117 The module name of
 118 .Nm
 119 was used to be compatible with
 120 .Nx .
 121 .Sh SEE ALSO
 122 .Xr an 4 ,
 123 .Xr ath 4 ,
 124 .Xr awi 4 ,
 125 .Xr ipw 4 ,
 126 .Xr iwi 4 ,
 127 .Xr netintro 4 ,
 128 .Xr ral 4 ,
 129 .Xr rum 4 ,
 130 .Xr ural 4 ,
 131 .Xr wi 4 ,
 132 .Xr wlan_acl 4 ,
 133 .Xr wlan_ccmp 4 ,
 134 .Xr wlan_tkip 4 ,
 135 .Xr wlan_wep 4 ,
 136 .Xr wlan_xauth 4
 137 .Sh STANDARDS
 138 More information can be found in the IEEE 802.11 Standard.
 139 .Sh HISTORY
 140 The
 141 .Nm
 142 driver first appeared in
 143 .Fx 5.0 .
 144 .Sh AUTHORS
 145 Atsushi Onoe is the author of original
 146 .Nx
 147 software from which this work began.
 148 .An -nosplit
 149 .An Sam Leffler
 150 brought the code into
 151 .Fx
 152 and then rewrote it to support multi-mode devices,
 153 802.11g, WPA/802.11i, WME, and add the extensible frameworks
 154 for cryptographic, authentication, and access control plugins.
 155 This manual page was written by
 156 .An Tom Rhodes Aq trhodes@FreeBSD.org .