Module Name: src
Committed By: uebayasi
Date: Sat Nov 6 08:05:45 UTC 2010
Modified Files:
src/share/man/man4 [uebayasi-xip]: Makefile acpi.4 acpivga.4 acpiwmi.4
fss.4 swwdog.4 wapbl.4
Added Files:
src/share/man/man4 [uebayasi-xip]: fujitsu.4 otus.4
Log Message:
Sync with HEAD.
To generate a diff of this commit:
cvs rdiff -u -r1.516.2.2 -r1.516.2.3 src/share/man/man4/Makefile
cvs rdiff -u -r1.50.2.2 -r1.50.2.3 src/share/man/man4/acpi.4
cvs rdiff -u -r1.1.2.2 -r1.1.2.3 src/share/man/man4/acpivga.4
cvs rdiff -u -r1.4 -r1.4.2.1 src/share/man/man4/acpiwmi.4
cvs rdiff -u -r1.13 -r1.13.2.1 src/share/man/man4/fss.4
cvs rdiff -u -r0 -r1.4.2.2 src/share/man/man4/fujitsu.4
cvs rdiff -u -r0 -r1.3.2.2 src/share/man/man4/otus.4
cvs rdiff -u -r1.4.2.1 -r1.4.2.2 src/share/man/man4/swwdog.4
cvs rdiff -u -r1.12 -r1.12.2.1 src/share/man/man4/wapbl.4
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/share/man/man4/Makefile
diff -u src/share/man/man4/Makefile:1.516.2.2 src/share/man/man4/Makefile:1.516.2.3
--- src/share/man/man4/Makefile:1.516.2.2 Fri Oct 22 07:11:53 2010
+++ src/share/man/man4/Makefile Sat Nov 6 08:05:44 2010
@@ -1,4 +1,4 @@
-# $NetBSD: Makefile,v 1.516.2.2 2010/10/22 07:11:53 uebayasi Exp $
+# $NetBSD: Makefile,v 1.516.2.3 2010/11/06 08:05:44 uebayasi Exp $
# @(#)Makefile 8.1 (Berkeley) 6/18/93
MAN= aac.4 ac97.4 acardide.4 aceride.4 acphy.4 \
@@ -24,7 +24,7 @@
dmphy.4 dpt.4 dpti.4 drm.4 drum.4 \
eap.4 ebus.4 edc.4 elmc.4 emuxki.4 en.4 envsys.4 ep.4 esh.4 esis.4 \
esa.4 esiop.4 esm.4 eso.4 etherip.4 exphy.4 \
- fast_ipsec.4 fd.4 finsio.4 fpa.4 fms.4 fss.4 fxp.4 \
+ fast_ipsec.4 fd.4 finsio.4 fpa.4 fms.4 fss.4 fujitsu.4 fxp.4 \
gcscaudio.4 gem.4 genfb.4 gentbi.4 geodeide.4 \
glxtphy.4 gpib.4 gpio.4 gpiolock.4 gpiosim.4 gre.4 gphyter.4 gsip.4 \
hdaudio.4 hifn.4 hme.4 hpqlb.4 hptide.4 \
@@ -41,7 +41,7 @@
mtio.4 multicast.4 mvsata.4 \
nadb.4 ne.4 neo.4 netintro.4 nfe.4 nfsmb.4 njata.4 njs.4 \
nsclpcsio.4 nsp.4 nsphy.4 nsphyter.4 ntwoc.4 null.4 nsmb.4 \
- oak.4 oosiop.4 opl.4 options.4 optiide.4 osiop.4 \
+ oak.4 oosiop.4 opl.4 options.4 optiide.4 osiop.4 otus.4 \
pad.4 pas.4 pcdisplay.4 pciide.4 pckbc.4 pckbd.4 pcn.4 pcppi.4 \
pcscp.4 pcweasel.4 pdcide.4 pdcsata.4 piixide.4 piixpcib.4 piixpm.4 \
pim.4 plip.4 pms.4 pmu.4 pnaphy.4 ppbus.4 ppp.4 pppoe.4 pseye.4 \
@@ -148,7 +148,9 @@
MLINKS+=acpiec.4 acpiecdt.4
MLINKS+=acpivga.4 acpiout.4
-MLINKS+=acpiwmi.4 wmidell.4 acpiwmi.4 wmihp.4
+MLINKS+=acpiwmi.4 wmidell.4 \
+ acpiwmi.4 wmihp.4 \
+ acpiwmi.4 wmimsi.4
MLINKS+=aibs.4 aiboost.4
MLINKS+=ata.4 atabus.4
MLINKS+=audio.4 audioctl.4
@@ -172,6 +174,7 @@
MLINKS+=dbcool.4 adt7476.4
MLINKS+=fd.4 stderr.4 fd.4 stdin.4 fd.4 stdout.4
MLINKS+=fpa.4 fea.4 fpa.4 fta.4
+MLINKS+=fujitsu.4 fujbp.4 fujitsu.4 fujhk.4
MLINKS+=hdaudio.4 hdafg.4
MLINKS+=hdaudio.4 hdaudiobus.4
MLINKS+=icp.4 icpsp.4
Index: src/share/man/man4/acpi.4
diff -u src/share/man/man4/acpi.4:1.50.2.2 src/share/man/man4/acpi.4:1.50.2.3
--- src/share/man/man4/acpi.4:1.50.2.2 Fri Oct 22 07:11:53 2010
+++ src/share/man/man4/acpi.4 Sat Nov 6 08:05:44 2010
@@ -1,4 +1,4 @@
-.\" $NetBSD: acpi.4,v 1.50.2.2 2010/10/22 07:11:53 uebayasi Exp $
+.\" $NetBSD: acpi.4,v 1.50.2.3 2010/11/06 08:05:44 uebayasi Exp $
.\"
.\" Copyright (c) 2002, 2004, 2010 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -24,7 +24,7 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd September 6, 2010
+.Dd October 24, 2010
.Dt ACPI 4
.Os
.Sh NAME
@@ -225,6 +225,9 @@
.It Xr acpitz 4
.Tn ACPI
thermal zones.
+.It Xr acpivga 4
+.Tn ACPI
+display adapter and output devices.
.It Xr acpiwmi 4
.Tn ACPI
support for Windows Management Instrumentation.
@@ -442,6 +445,7 @@
.It Li ACPI_LID_COMPONENT Ta ACPI_LV_OPTIMIZATIONS
.It Li ACPI_RESOURCE_COMPONENT Ta ACPI_LV_VERBOSITY2 *
.It Li ACPI_TZ_COMPONENT Ta
+.It Li ACPI_DISPLAY_COMPONENT Ta
.It Li ACPI_ALL_DRIVERS * Ta ACPI_LV_MUTEX
.It Ta ACPI_LV_THREADS
.It Ta ACPI_LV_IO
@@ -569,6 +573,8 @@
.%A Len Brown
.%T ACPI in Linux - Myths vs. Reality
.%D June 27-30, 2007
+.%O Proceedings of the Linux Symposium
+.%P 65-74
.%U http://www.linuxsymposium.org/archives/OLS/Reprints-2007/brown_1-Reprint.pdf
.Re
.Rs
@@ -577,7 +583,8 @@
.%T Sleeping Beauty - NetBSD on Modern Laptops
.%D February 3, 2008
.%O Proceedings of AsiaBSDCon 2008
-.%P pp. 127-134
+.%P 127-134
+.%U http://2008.asiabsdcon.org/papers/P9A-paper.pdf
.Re
.Sh HISTORY
The
Index: src/share/man/man4/acpivga.4
diff -u src/share/man/man4/acpivga.4:1.1.2.2 src/share/man/man4/acpivga.4:1.1.2.3
--- src/share/man/man4/acpivga.4:1.1.2.2 Fri Oct 22 07:11:53 2010
+++ src/share/man/man4/acpivga.4 Sat Nov 6 08:05:44 2010
@@ -1,4 +1,4 @@
-.\" $NetBSD: acpivga.4,v 1.1.2.2 2010/10/22 07:11:53 uebayasi Exp $
+.\" $NetBSD: acpivga.4,v 1.1.2.3 2010/11/06 08:05:44 uebayasi Exp $
.\"
.\" Copyright (c) 2010 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -24,7 +24,7 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd October 12, 2010
+.Dd October 28, 2010
.Dt ACPIVGA 4
.Os
.Sh NAME
@@ -47,22 +47,29 @@
.Tn ACPI
BIOS.
.Pp
-The driver handles brightness hotkeys and output switch hotkeys.
+The driver handles brightness hotkeys and display switch hotkeys.
In addition, the following
.Xr sysctl 8
read/write variables are provided (when hardware support is available):
.Bl -tag -width Ds
-.It Va hw.acpi.acpivga0.policy
-BIOS switch policy.
-Accepted values range from 0 to 7.
-For more information, refer to the documentation of the _DOS method,
-in Section B.4.1 of the
-.Tn ACPI
-specification (revision 4.0a).
+.It Va hw.acpi.acpivga0.bios_switch
+BIOS output switching policy.
+This boolean variable controls the behavior of the BIOS when a display
+switch hotkey is pressed.
+.Bl -tag -width xxx -compact
+.It Sy 1
+the BIOS should automatically switch outputs, with no interaction from
+.Nm .
+.It Sy 0
+the BIOS should only notify
+.Nm
+of the desired output state changes.
+.El
.It Va hw.acpi.acpiout0.brightness
Brightness level.
-Typical values range from 0 to 100, but any integer value is accepted (the
-driver uses the closest brightness level supported by the device).
+This integer variable typically ranges from 0 to 100, but any integer value
+is accepted (the driver uses the closest brightness level supported by the
+device).
.El
.Pp
Please note, however, that future versions of
@@ -72,26 +79,14 @@
variables without prior notice.
.Sh SEE ALSO
.Xr acpi 4 ,
+.Xr vga 4 ,
.Xr sysctl 8
-.Sh STANDARDS
-The
-.Nm
-driver supports the
-.Em ACPI Extensions for Display Adapters
-given in Appendix B of the
-.Tn ACPI
-specification.
-.Pp
.Rs
-.%A Hewlett-Packard Corporation
-.%A Intel Corporation
.%A Microsoft Corporation
-.%A Phoenix Technologies Ltd.
-.%A Toshiba Corporation
-.%B Advanced Configuration and Power Interface Specification
-.%V Revision 4.0a
-.%D April 5, 2010
-.%U http://www.acpi.info/spec.htm
+.%D December 4, 2001
+.%T Mobile System Displays and Windows
+.%N Version 1.2c
+.%U http://www.microsoft.com/whdc/archive/mobiledisplay.mspx
.Re
.Sh HISTORY
The
@@ -111,7 +106,17 @@
BIOSes implement only part of the
.Tn ACPI
video extensions.
-In particular, display output switching often does not work.
+In particular, display output switching via these extensions often does not
+work.
+For this reason,
+.Nm
+enables
+.Va hw.acpi.acpivga0.bios_switch
+by default.
+If the display switch hotkey does not work with this default setting, try
+setting
+.Va hw.acpi.acpivga0.bios_switch
+to 0.
.Pp
Brightness level should be controlled via
.Xr wsconsctl 8
Index: src/share/man/man4/acpiwmi.4
diff -u src/share/man/man4/acpiwmi.4:1.4 src/share/man/man4/acpiwmi.4:1.4.2.1
--- src/share/man/man4/acpiwmi.4:1.4 Thu Apr 8 18:31:53 2010
+++ src/share/man/man4/acpiwmi.4 Sat Nov 6 08:05:44 2010
@@ -1,4 +1,4 @@
-.\" $NetBSD: acpiwmi.4,v 1.4 2010/04/08 18:31:53 jruoho Exp $
+.\" $NetBSD: acpiwmi.4,v 1.4.2.1 2010/11/06 08:05:44 uebayasi Exp $
.\"
.\" Copyright (c) 2010 Jukka Ruohonen <jruoho...@iki.fi>
.\" All rights reserved.
@@ -24,7 +24,7 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd March 23, 2010
+.Dd October 24, 2010
.Dt ACPIWMI 4
.Os
.Sh NAME
@@ -36,10 +36,11 @@
.Cd "acpiwmibus* at acpiwmi?"
.Cd "wmidell* at acpiwmibus?"
.Cd "wmihp* at acpiwmibus?"
+.Cd "wmimsi* at acpiwmibus?"
.Sh DESCRIPTION
The
.Nm
-driver provides an
+device driver provides an
.Tn ACPI
interface for Windows Management Instrumentation
.Pq Tn WMI .
@@ -57,13 +58,16 @@
Dell laptops
.It Sy wmihp
Hewlett-Packard laptops
+.It Sy wmimsi
+MSI laptops
.El
.Pp
The functionality varies from vendor to vendor.
Typically the interface is used for function and hotkey handling,
but additional features may be present.
.Sh SEE ALSO
-.Xr acpi 4
+.Xr acpi 4 ,
+.Xr acpidalb 4
.Rs
.%A Microsoft Corporation
.%D December 4, 2001
@@ -78,19 +82,9 @@
.Sh AUTHORS
.An Jukka Ruohonen
.Aq jruoho...@iki.fi
-wrote the actual
+wrote
.Nm
-as well as
-.Sy wmidell
-and
-.Sy wmihp .
-The
-.Sy wmihp
-was based on the earlier work done by
-.An Michael Gmelin
-.Aq free...@grem.de
-for
-.Fx .
+and most of the mappings.
.Sh CAVEATS
While
.Tn WMI
@@ -100,5 +94,5 @@
.Pp
The
.Sy wmihp
-driver conflicts with
+driver may conflict with
.Xr hpqlb 4 .
Index: src/share/man/man4/fss.4
diff -u src/share/man/man4/fss.4:1.13 src/share/man/man4/fss.4:1.13.2.1
--- src/share/man/man4/fss.4:1.13 Mon Mar 22 18:58:31 2010
+++ src/share/man/man4/fss.4 Sat Nov 6 08:05:44 2010
@@ -1,4 +1,4 @@
-.\" $NetBSD: fss.4,v 1.13 2010/03/22 18:58:31 joerg Exp $ */
+.\" $NetBSD: fss.4,v 1.13.2.1 2010/11/06 08:05:44 uebayasi Exp $ */
.\"
.\"
.\" Copyright (c) 2003 The NetBSD Foundation, Inc.
@@ -28,7 +28,7 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd September 21, 2008
+.Dd November 5, 2010
.Dt FSS 4
.Os
.Sh NAME
@@ -148,7 +148,3 @@
.Nm
device appeared in
.Nx 2.0 .
-.Sh BUGS
-This driver is
-.Em experimental .
-Be sure you have a backup before you use it.
Index: src/share/man/man4/swwdog.4
diff -u src/share/man/man4/swwdog.4:1.4.2.1 src/share/man/man4/swwdog.4:1.4.2.2
--- src/share/man/man4/swwdog.4:1.4.2.1 Tue Aug 17 06:40:02 2010
+++ src/share/man/man4/swwdog.4 Sat Nov 6 08:05:44 2010
@@ -1,4 +1,4 @@
-.\" $NetBSD: swwdog.4,v 1.4.2.1 2010/08/17 06:40:02 uebayasi Exp $
+.\" $NetBSD: swwdog.4,v 1.4.2.2 2010/11/06 08:05:44 uebayasi Exp $
.\"
.\" Copyright (c) 2004, 2005 Steven M. Bellovin
.\" All rights reserved.
@@ -31,7 +31,7 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd July 21, 2010
+.Dd October 23, 2010
.\" Written by Steven M. Bellovin
.Dt SWWDOG 4
.Os
@@ -53,7 +53,7 @@
.Va swwdog_reboot
is accessible as a
.Xr sysctl 8
-variable, machdep.swwdog0.reboot and defaults to
+variable, hw.swwdog0.reboot and defaults to
.Dv false .
.Pp
The default period of
Index: src/share/man/man4/wapbl.4
diff -u src/share/man/man4/wapbl.4:1.12 src/share/man/man4/wapbl.4:1.12.2.1
--- src/share/man/man4/wapbl.4:1.12 Mon Nov 23 16:41:26 2009
+++ src/share/man/man4/wapbl.4 Sat Nov 6 08:05:44 2010
@@ -1,4 +1,4 @@
-.\" $NetBSD: wapbl.4,v 1.12 2009/11/23 16:41:26 pooka Exp $
+.\" $NetBSD: wapbl.4,v 1.12.2.1 2010/11/06 08:05:44 uebayasi Exp $
.\"
.\" Copyright (c) 2008, 2009 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -24,7 +24,7 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd November 23, 2009
+.Dd November 5, 2010
.Dt WAPBL 4
.Os
.Sh NAME
@@ -193,9 +193,7 @@
.Xr fsync 2
often.
.Pp
-File system snapshots
-.Pq Xr fss 4
-and quotas do not yet work with
+Quotas do not yet work with
.Nm .
.Pp
In-file system log allocation should be done on a relatively quiet
Added files:
Index: src/share/man/man4/fujitsu.4
diff -u /dev/null src/share/man/man4/fujitsu.4:1.4.2.2
--- /dev/null Sat Nov 6 08:05:45 2010
+++ src/share/man/man4/fujitsu.4 Sat Nov 6 08:05:44 2010
@@ -0,0 +1,91 @@
+.\" $NetBSD: fujitsu.4,v 1.4.2.2 2010/11/06 08:05:44 uebayasi Exp $
+.\"
+.\" Copyright (c) 2010 The NetBSD Foundation, Inc.
+.\" 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 NETBSD FOUNDATION, INC. 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 FOUNDATION 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 November 5, 2010
+.Dt FUJITSU 4
+.Os
+.Sh NAME
+.Nm fujitsu
+.Nd Fujitsu Brightness, Pointer, and Hotkeys
+.Sh SYNOPSIS
+.Cd "fujbp* at acpi?"
+.Cd "fujhk* at acpi?"
+.Sh DESCRIPTION
+Some Fujitsu laptops come with vendor-specific
+.Tn ACPI
+devices to manage the laptop hotkeys (such as the
+.Sq Eco
+button), and to control various built-in components (such as the display,
+the touchpad and the speakers).
+The
+.Nm
+drivers provide support, through these
+.Tn ACPI
+devices, for hotkeys, backlight on/off switch, brightness level control, and
+pointer on/off switch.
+.Pp
+The following
+.Xr sysctl 8
+read/write variables are provided (when hardware support is available):
+.Bl -tag -width hw.acpi.fujbp0.brightness -offset indent
+.It Va hw.acpi.fujbp0.brightness
+Brightness level (integer).
+.It Va hw.acpi.fujbp0.pointer
+Pointer switch state (boolean).
+.It Va hw.acpi.fujhk0.backlight
+Backlight switch state (boolean).
+.El
+.Pp
+Please note, however, that future versions of the
+.Nm
+drivers may remove these
+.Xr sysctl 8
+variables without prior notice.
+.Sh SEE ALSO
+.Xr acpi 4 ,
+.Xr acpivga 4 ,
+.Xr sysctl 8 ,
+.Xr pmf 9 ,
+.Xr sysmon_pswitch 9
+.Sh HISTORY
+The
+.Nm
+drivers appeared in
+.Nx 6.0 .
+.Sh AUTHORS
+.An Gr\('egoire Sutre
+.Aq gsu...@netbsd.org
+.Sh CAVEATS
+Brightness level and backlight switch state should be controlled via
+.Xr wsconsctl 8
+instead of
+.Xr sysctl 8 .
+.Pp
+The
+.Xr sysctl 8
+variable
+.Va hw.acpi.fujbp0.pointer
+should be replaced by a platform-independent userland control.
Index: src/share/man/man4/otus.4
diff -u /dev/null src/share/man/man4/otus.4:1.3.2.2
--- /dev/null Sat Nov 6 08:05:45 2010
+++ src/share/man/man4/otus.4 Sat Nov 6 08:05:44 2010
@@ -0,0 +1,181 @@
+.\" $NetBSD: otus.4,v 1.3.2.2 2010/11/06 08:05:44 uebayasi Exp $
+.\" $OpenBSD: otus.4,v 1.14 2010/08/18 18:49:36 damien Exp $
+.\"
+.\" Copyright (c) 2009 Damien Bergamini <damien.bergam...@free.fr>
+.\"
+.\" Permission to use, copy, modify, and distribute this software for any
+.\" purpose with or without fee is hereby granted, provided that the above
+.\" copyright notice and this permission notice appear in all copies.
+.\"
+.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+.\"
+.Dd November 4, 2010
+.Dt OTUS 4
+.Os
+.Sh NAME
+.Nm otus
+.Nd Atheros USB IEEE 802.11a/g/n wireless network device
+.Sh SYNOPSIS
+.Cd "otus* at uhub? port ?"
+.Sh DESCRIPTION
+The
+.Nm
+driver supports USB 2.0 wireless network devices based on Atheros
+Communications AR9001U chipset.
+.Pp
+The AR9001U chipset is made of an AR9170 MAC/Baseband
+and an AR9101 (1T2R), AR9102 (2T2R) or AR9104 (dual-band 2T2R)
+Radio.
+.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 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
+Wired 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.
+.Pp
+The
+.Nm
+driver can be configured at runtime with
+.Xr ifconfig 8
+or on boot with
+.Xr ifconfig.if 5 .
+.Sh FILES
+The driver needs at least version 1.0 of the following firmware files,
+which are loaded when an interface is attached:
+.Pp
+.Bl -tag -width Ds -offset indent -compact
+.It /libdata/firmware/if_otus/otus-init
+.It /libdata/firmware/if_otus/otus-main
+.El
+.Pp
+Although these firmware files are freely redistributable, their usage
+is restricted.
+.Sh HARDWARE
+The following adapters should work:
+.Pp
+.Bl -tag -width Ds -offset indent -compact
+.It Arcadyan WN7512
+.\" .It AVM FRITZ!WLAN USB Stick N
+.It CACE AirPcap \&Nx
+.It D-Link DWA-130 rev \&D1
+.It D-Link DWA-160 rev A1
+.It D-Link DWA-160 rev A2
+.It IO-Data WN-GDN/US2
+.It NEC Aterm WL300NU-G
+.It Netgear WNDA3100
+.It Netgear WN111 v2
+.It Planex GW-US300
+.It TP-Link TL-WN821N
+.It Ubiquiti SR71 USB
+.It Unex DNUA-81
+.It Z-Com UB81
+.It Z-Com UB82
+.It ZyXEL NWD-271N
+.El
+.Sh EXAMPLES
+The following
+.Xr ifconfig.if 5
+example configures otus0 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
+nwkey 0x1deadbeef1 chan 11
+dhcp
+.Ed
+.Pp
+Join an existing BSS network,
+.Dq my_net :
+.Bd -literal -offset indent
+# ifconfig otus0 192.168.1.1 netmask 0xffffff00 nwid my_net
+.Ed
+.Pp
+To use WPA, see
+.Xr wpa_supplicant 8
+and
+.Xr wpa_supplicant.conf 5 .
+.Sh DIAGNOSTICS
+.Bl -diag
+.It "otus%d: error %d, could not read firmware %s"
+For some reason, the driver was unable to read the microcode file from the
+filesystem.
+The file might be missing or corrupted.
+.It "otus%d: device timeout"
+A frame dispatched to the hardware for transmission did not complete in time.
+The driver will reset the hardware.
+This should not happen.
+.El
+.Sh SEE ALSO
+.Xr arp 4 ,
+.Xr ifmedia 4 ,
+.\" .Xr intro 4 ,
+.Xr netintro 4 ,
+.Xr usb 4 ,
+.Xr wpa_supplicant.conf 5 ,
+.Xr ifconfig 8 ,
+.Xr wpa_supplicant 8 ,
+.Pp
+Atheros Communications AR9001U-2NX/AR9001U-2NG/AR9001U-NG:
+.Pa http://www.atheros.com/pt/bulletins/AR9001USBBulletin.pdf
+.Sh HISTORY
+The
+.Nm
+driver first appeared in
+.Ox 4.6 .
+It was ported to
+.Nx
+by Anon Ymous and first appeared in
+.Nx 6.0 .
+.Sh AUTHORS
+The
+.Nm
+driver was written by
+.An Damien Bergamini Aq dam...@openbsd.org
+based on source code licensed under the ISC released in 2008 by Atheros
+Communications for Linux.
+.Sh CAVEATS
+The AVM FRITZ!WLAN USB Stick N adapter is currently not supported.
+.Pp
+The
+.Nm
+driver does not support any of the 802.11n capabilities offered by the
+AR9001U chipset.
+Additional work is required in
+.Xr ieee80211 9
+before those features can be supported.
+.Pp
+The
+.Nm
+driver also does not currently support EDCA as this is missing in the
+.Nx
+network stack.
+The hooks for it are in the driver code.
