- monitor mode for wpi(4)

- document more DIAGNOSTICS messages for wpi(4)
- the firmware is loaded when the interface is brought up, not during
  attachment of the device (ipw, iwi, wpi)

3 files changed, 31 insertions, 7 deletions

diff --git a/share/man/man4/ipw.4 b/share/man/man4/ipw.4
index eac809e7e94..ac0c5790a5b 100644
--- a/share/man/man4/ipw.4
+++ b/share/man/man4/ipw.4
@@ -1,4 +1,4 @@
-.\" $OpenBSD: ipw.4,v 1.18 2006/05/01 09:35:21 damien Exp $
+.\" $OpenBSD: ipw.4,v 1.19 2006/05/20 14:02:04 damien Exp $
 .\"
 .\" Copyright (c) 2004
 .\"	Damien Bergamini <damien.bergamini@free.fr>. All rights reserved.
@@ -159,7 +159,7 @@ This is the default mode of operation.
 .El
 .Sh FILES
 The driver needs at least version 1.3 of the following firmware files,
-which are loaded on demand when the device is attached:
+which are loaded when an interface is brought up:
 .Pp
 .Bl -tag -width Ds -offset indent -compact
 .It Pa /etc/firmware/ipw-bss
diff --git a/share/man/man4/iwi.4 b/share/man/man4/iwi.4
index f395abab35b..3c3d60ec56e 100644
--- a/share/man/man4/iwi.4
+++ b/share/man/man4/iwi.4
@@ -1,4 +1,4 @@
-.\" $OpenBSD: iwi.4,v 1.23 2006/05/01 09:35:21 damien Exp $
+.\" $OpenBSD: iwi.4,v 1.24 2006/05/20 14:02:04 damien Exp $
 .\"
 .\" Copyright (c) 2004
 .\"	Damien Bergamini <damien.bergamini@free.fr>. All rights reserved.
@@ -182,7 +182,7 @@ This is the default mode of operation.
 .El
 .Sh FILES
 The driver needs at least version 3.0 of the following firmware files,
-which are loaded on demand when the device is attached:
+which are loaded when an interface is brought up:
 .Pp
 .Bl -tag -width Ds -offset indent -compact
 .It Pa /etc/firmware/iwi-bss
@@ -248,7 +248,7 @@ This should not happen.
 .Xr hostname.if 5 ,
 .Xr ifconfig 8
 .Rs
-.%T The IWI Web Page
+.%T The IPW Web Page
 .%O http://damien.bergamini.free.fr/ipw/
 .Re
 .Sh AUTHORS
diff --git a/share/man/man4/wpi.4 b/share/man/man4/wpi.4
index 7026648c177..78b6fa51b52 100644
--- a/share/man/man4/wpi.4
+++ b/share/man/man4/wpi.4
@@ -1,4 +1,4 @@
-.\" $OpenBSD: wpi.4,v 1.3 2006/05/14 19:05:43 miod Exp $
+.\" $OpenBSD: wpi.4,v 1.4 2006/05/20 14:02:04 damien Exp $
 .\"
 .\" Copyright (c) 2006
 .\"	Damien Bergamini <damien.bergamini@free.fr>. All rights reserved.
@@ -50,6 +50,12 @@ Also known as
 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
 .Nm
@@ -165,7 +171,7 @@ This is the default mode of operation.
 .El
 .Sh FILES
 The driver needs at least version 1.13 of the following firmware file,
-which is loaded on demand when the device is attached:
+which is loaded when an interface is brought up:
 .Pp
 .Bl -tag -width Ds -offset indent -compact
 .It Pa /etc/firmware/wpi-ucode
@@ -216,8 +222,26 @@ Join an existing BSS network,
 .Sh DIAGNOSTICS
 .Bl -diag
 .It "wpi%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.
+.It "wpi%d: fatal firmware error"
+For some reason, the firmware crashed.
+The driver will reset the hardware.
+This should not happen.
+.It "wpi%d: Radio transmitter is off"
+The radio transmitter is off and thus no packet can go out.
+The driver will reset the hardware.
+Make sure your laptop radio switch is on.
+.It "wpi%d: could not read firmware file"
+For some reason, the driver was unable to read the firmware image from the
+filesystem.
+The file might be missing or corrupted.
+.It "wpi%d: firmware file too short: %d bytes"
+The firmware image is corrupted and can't be loaded into the adapter.
+.It "wpi%d: could not load firmware"
+An attempt to load the firmware into the adapter failed.
+The driver will reset the hardware.
 .El
 .Sh SEE ALSO
 .Xr pkg_add 1 ,