- 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)

1 files changed, 26 insertions, 2 deletions

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 ,