1 .\" $NetBSD: rtw.4,v 1.3 2005/09/09 14:11:39 drochner Exp $
2 .\" $OpenBSD: rtw.4,v 1.18 2005/06/09 09:03:38 jmc Exp $
4 .\" Copyright (c) 2004 Jonathan Gray <jsg@openbsd.org>
6 .\" Permission to use, copy, modify, and distribute this software for any
7 .\" purpose with or without fee is hereby granted, provided that the above
8 .\" copyright notice and this permission notice appear in all copies.
10 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
23 .Nd Realtek RTL8180L IEEE 802.11b wireless network driver
25 To compile this driver into the kernel,
26 place the following lines in your
27 kernel configuration file:
28 .Bd -ragged -offset indent
32 .Cd "device wlan_ratectl_onoe"
35 Alternatively, to load the driver as a
36 module at boot time, place the following line in
38 .Bd -literal -offset indent
44 driver supports PCI/CardBus 802.11b wireless adapters based on the
47 A variety of radio transceivers can be found in these devices, including
48 the Philips SA2400A, Maxim MAX2820, and GCT GRF5101, though not all of them
49 are currently supported.
51 These are the modes the
53 driver can operate in:
54 .Bl -tag -width "monitor mode"
58 mode, this is used when associating with an access point, through
59 which all traffic passes.
60 This mode is the default.
67 This is the standardized method of operating without an access point.
68 Stations associate with a service set.
69 However, actual connections between stations are peer-to-peer.
71 In this mode the driver acts as an access point (base station)
74 In this mode the driver is able to receive packets without
75 associating with an access point.
76 This disables the internal receive filter and enables the card to
77 capture packets from networks which it wouldn't normally have access to,
78 or to scan for access points.
82 supports software WEP.
83 Wired Equivalent Privacy (WEP) is the de facto encryption standard
84 for wireless networks.
85 It can be typically configured in one of three modes:
86 no encryption; 40-bit encryption; or 104-bit encryption.
87 Unfortunately, due to serious weaknesses in WEP protocol
88 it is strongly recommended that it not be used as the
89 sole mechanism to secure wireless communication.
90 WEP is not enabled by default.
94 driver can be configured at runtime with
96 using the following parameters:
97 .Bl -tag -width ".Fl mediaopt Ar opts"
99 Set the desired BSSID.
101 Unset the desired BSSID.
102 The interface will automatically select a BSSID in this mode, which is
105 Set the channel (radio frequency) to be used by the driver based on
109 Unset the desired channel to be used by the driver.
110 The driver will automatically select a channel in this mode, which is
112 .It Cm media Ar media
115 driver supports the following
119 .Bl -tag -width ".Cm autoselect" -compact
121 Enable autoselection of the media type and options.
123 Set 802.11b DS 1Mbps operation.
125 Set 802.11b DS 2Mbps operation.
127 Set 802.11b DS 5.5Mbps operation.
129 Set 802.11b DS 11Mbps operation.
131 .It Cm mediaopt Ar opts
134 driver supports the following media options:
136 .Bl -tag -width ".Cm monitor" -compact
138 Select Host AP operation.
140 Select IBSS operation.
144 .It Fl mediaopt Ar opts
145 Disable the specified media options on the driver and return it to the
146 default mode of operation (BSS).
151 can either be any text string up to 32 characters in length,
152 or a series of hexadecimal digits up to 64 digits.
155 string allows the interface to connect to any available access points.
158 driver uses an empty string.
159 Note that network ID is synonymous with Extended Service Set ID (ESSID).
161 Enable WEP encryption using the specified
165 can either be a string, a series of hexadecimal digits (preceded by
167 or a set of keys of the form
171 specifies which of the keys will be used for transmitted packets,
176 are configured as WEP keys.
177 If a set of keys is specified, a comma
179 within the key must be escaped with a backslash.
180 Note that if multiple keys are used, their order must be the same within
183 is capable of using both 40-bit (5 characters or 10 hexadecimal digits)
184 or 104-bit (13 characters or 26 hexadecimal digits) keys.
186 Disable WEP encryption.
187 This is the default mode of operation.
189 Enable WEP encryption with the persistent key stored in the network card.
192 The following adapters should work:
194 .Bl -column -compact ".Li Ovislink AirLive WL-1120PCM" "CardBus"
195 .It Em Card Ta Em Bus
196 .\".It Li "Acer Aspire 1357 LMi" Ta Mini PCI
197 .\".It Li "Belkin F5D6001 V3" Ta PCI
198 .It Li "Belkin F5D6020 V3" Ta CardBus
199 .It Li "Buffalo WLI-CB-B11" Ta CardBus
200 .It Li "Corega CG-WLCB11V3" Ta CardBus
201 .\".It Li "D-Link DWL-510" Ta PCI
202 .\".It Li "D-Link DWL-520 rev D" Ta PCI
203 .It Li "D-Link DWL-610" Ta CardBus
204 .\".It Li "Encore ENLWI-PCI1-NT" Ta PCI
205 .\".It Li "Gigabyte GN-WLMR101" Ta PCI
206 .It Li "Level-One WPC-0101" Ta CardBus
207 .It Li "Linksys WPC11 v4" Ta CardBus
208 .It Li "Netgear MA521" Ta CardBus
209 .It Li "Ovislink AirLive WL-1120PCM" Ta CardBus
210 .It Li "Planet WL-3553" Ta CardBus
211 .It Li "TrendNET TEW-266PC" Ta CardBus
212 .\".It Li "TrendNET TEW-288PI" Ta PCI
213 .It Li "VCTnet PC-11B1" Ta CardBus
233 .%O http://www.realtek.com.tw
238 device driver first appeared in
248 driver was written by
249 .An David Young Aq Mt dyoung@NetBSD.org
253 .An Jonathan Gray Aq Mt jsg@openbsd.org ,
254 who wrote this man page.
258 .An Sepherosa Ziehau Aq Mt sepherosa@gmail.com .
260 Only the Philips SA2400A and Maxim MAX2820 RF transceivers are known to work.
261 Devices incorporating a GCT RF transceiver are not supported due to a lack of
262 documentation from GCT.
264 While PCI devices will attach most of them are not able to transmit.