diff options
author | Kevin Lo <kevlo@cvs.openbsd.org> | 2008-11-27 14:08:08 +0000 |
---|---|---|
committer | Kevin Lo <kevlo@cvs.openbsd.org> | 2008-11-27 14:08:08 +0000 |
commit | 0e8171ee3e236cedaa8c846eba17f42be94b897a (patch) | |
tree | 2cf979779ffd8934cd256d6a8a64cd95308e17d0 /share | |
parent | 1edb860465fd642089c912055e5f145e85c2c1a2 (diff) |
initial import of Weongyo Jeon's FreeBSD driver for the RealTek RTL8187L
802.11 devices.
currently it has issues scanning.
ok jsg@
Diffstat (limited to 'share')
-rw-r--r-- | share/man/man4/Makefile | 16 | ||||
-rw-r--r-- | share/man/man4/urtw.4 | 157 |
2 files changed, 165 insertions, 8 deletions
diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile index 2620f1be31c..9ad73c5060f 100644 --- a/share/man/man4/Makefile +++ b/share/man/man4/Makefile @@ -1,4 +1,4 @@ -# $OpenBSD: Makefile,v 1.467 2008/10/31 15:55:43 jmc Exp $ +# $OpenBSD: Makefile,v 1.468 2008/11/27 14:08:07 kevlo Exp $ MAN= aac.4 ac97.4 acphy.4 \ acpi.4 acpiac.4 acpiasus.4 acpibat.4 acpibtn.4 acpicpu.4 acpidock.4 \ @@ -52,13 +52,13 @@ MAN= aac.4 ac97.4 acphy.4 \ ucom.4 uchcom.4 ucycom.4 udav.4 udcf.4 udp.4 udsbr.4 \ ueagle.4 uftdi.4 ugen.4 uhci.4 uhid.4 uhidev.4 uipaq.4 uk.4 ukbd.4 \ ukphy.4 ulpt.4 umass.4 umbg.4 umct.4 umidi.4 umodem.4 ums.4 umsm.4 \ - unix.4 uow.4 upgt.4 upl.4 uplcom.4 ural.4 urio.4 url.4 urlphy.4 usb.4 \ - usbf.4 uscanner.4 uslcom.4 usscanner.4 uticom.4 uts.4 uvideo.4 uvisor.4 \ - uvscom.4 uyap.4 vga.4 vgafb.4 vge.4 viaenv.4 viapm.4 viasio.4 vic.4 \ - video.4 vlan.4 vmt.4 vnd.4 vr.4 watchdog.4 wb.4 wbenv.4 wbng.4 \ - wbsio.4 wd.4 wdc.4 we.4 wi.4tbl wpi.4 wscons.4 wsdisplay.4 wskbd.4 \ - wsmouse.4 wsmux.4 xe.4 xf86.4 xge.4 xl.4 xmphy.4 yds.4 ym.4 zero.4 \ - zyd.4 + unix.4 uow.4 upgt.4 upl.4 uplcom.4 ural.4 urio.4 url.4 urlphy.4 \ + urtw.4 usb.4 usbf.4 uscanner.4 uslcom.4 usscanner.4 uticom.4 uts.4 \ + uts.4 uvideo.4 uvisor.4 uvscom.4 uyap.4 vga.4 vgafb.4 vge.4 \ + viaenv.4 viapm.4 viasio.4 vic.4 video.4 vlan.4 vmt.4 vnd.4 vr.4 \ + watchdog.4 wb.4 wbenv.4 wbng.4 wbsio.4 wd.4 wdc.4 we.4 wi.4tbl wpi.4 \ + wscons.4 wsdisplay.4 wskbd.4 wsmouse.4 wsmux.4 xe.4 xf86.4 xge.4 \ + xl.4 xmphy.4 yds.4 ym.4 zero.4 zyd.4 MLINKS+=adv.4 advansys.4 adv.4 adw.4 MLINKS+=art.4 musycc.4 diff --git a/share/man/man4/urtw.4 b/share/man/man4/urtw.4 new file mode 100644 index 00000000000..c0d2a9878f1 --- /dev/null +++ b/share/man/man4/urtw.4 @@ -0,0 +1,157 @@ +.\" $OpenBSD: urtw.4,v 1.1 2008/11/27 14:08:07 kevlo Exp $ +.\" +.\" Copyright (c) 2008 Weongyo Jeong +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.Dd $Mdocdate: November 27 2008 $ +.Os +.Dt URTW 4 +.Sh NAME +.Nm urtw +.Nd Realtek RTL8187L USB IEEE 802.11b/g wireless network device +.Sh SYNOPSIS +.Cd "urtw* at uhub? port ?" +.Sh DESCRIPTION +The +.Nm +driver supports USB 802.11b/g wireless adapters based on the +Realtek RTL8187L. +.Pp +These are the modes the +.Nm +driver can operate in: +.Bl -tag -width "IBSS-masterXX" +.It BSS mode +Also known as +.Em infrastructure +mode, this is used when associating with an access point, through +which all traffic passes. +This mode is the default. +.It IBSS mode +Also known as +.Em IEEE ad-hoc +mode or +.Em peer-to-peer +mode. +This is the standardized method of operating without an access point. +Stations associate with a service set. +However, actual connections between stations are peer-to-peer. +.It monitor mode +In this mode the driver is able to receive packets without +associating with an access point. +This disables the internal receive filter and enables the card to +capture packets from networks which it wouldn't normally have access to, +or to scan for access points. +.El +.Pp +The +.Nm +driver can be configured to use +Wireless Equivalent Privacy (WEP) or +Wi-Fi Protected Access (WPA-PSK and WPA2-PSK). +WPA is the de facto encryption standard for wireless networks. +It is strongly recommended that WEP +not be used as the sole mechanism +to secure wireless communication, +due to serious weaknesses in it. +The +.Nm +driver relies on the software 802.11 stack for both encryption and decryption +of data frames. +.Pp +The +.Nm +driver can be configured at runtime with +.Xr ifconfig 8 +or on boot with +.Xr hostname.if 5 . +.Sh HARDWARE +The following adapters should work: +.Pp +.Bl -tag -width Ds -offset indent -compact +.It Netgear WG111v2 +.It Shuttle XPC Accessory PN20 +.El +.Sh EXAMPLES +The following +.Xr hostname.if 5 +example configures urtw0 to join whatever network is available on boot, +using WEP key +.Dq 0x1deadbeef1 , +channel 11, obtaining an IP address using DHCP: +.Bd -literal -offset indent +dhcp NONE NONE NONE nwkey 0x1deadbeef1 chan 11 +.Ed +.Pp +The following +.Xr hostname.if 5 +example creates a host-based access point on boot: +.Bd -literal -offset indent +inet 192.168.1.1 255.255.255.0 NONE media autoselect \e + mediaopt hostap nwid my_net chan 11 +.Ed +.Pp +Configure urtw0 to join network +.Dq my_net +using WPA-PSK with passphrase +.Dq my_passphrase : +.Bd -literal -offset indent +# ifconfig urtw0 nwid my_net wpa wpapsk \e + $(wpa-psk my_net my_passphrase) +.Ed +.Pp +Return urtw0 to its default settings: +.Bd -literal -offset indent +# ifconfig urtw0 -bssid -chan media autoselect \e + nwid "" -nwkey -wpa -wpapsk +.Ed +.Pp +Join an existing BSS network, +.Dq my_net : +.Bd -literal -offset indent +# ifconfig urtw0 192.168.1.1 netmask 0xffffff00 nwid my_net +.Ed +.Sh SEE ALSO +.Xr arp 4 , +.Xr ifmedia 4 , +.Xr intro 4 , +.Xr netintro 4 , +.Xr usb 4 , +.Xr hostname.if 5 , +.Xr hostapd 8 , +.Xr ifconfig 8 , +.Xr wpa-psk 8 +.Pp +RealTek Semiconductor: +.Pa http://www.realtek.com.tw/ +.Sh HISTORY +The +.Nm +device driver first appeared in +.Ox 4.5 . +.Sh AUTHORS +The +.Nm +driver was written by +.An Weongyo Jeong Aq weongyo@FreeBSD.org . |