add the following paragraph from the wi(4) manual page to the

CAVEATS section of all drivers claiming HostAP support:

"Host AP mode doesn't support power saving.  Clients attempting to
 use power saving mode may experience significant packet loss
 (disabling power saving on the client will fix this)."

unfortunately (or not?), more and more clients are using PS mode by
default and will not work properly with an AP running OpenBSD.

proper handling of STAs in PS mode will come in net80211 but is is
very unlikely that all drivers will be ported.

6 files changed, 36 insertions, 12 deletions

diff --git a/share/man/man4/ath.4 b/share/man/man4/ath.4
index 7c12f4db7d6..0a4ed9b8b49 100644
--- a/share/man/man4/ath.4
+++ b/share/man/man4/ath.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: ath.4,v 1.41 2008/07/29 17:03:35 jmc Exp $
+.\"	$OpenBSD: ath.4,v 1.42 2008/08/29 09:03:48 damien Exp $
 .\"     $NetBSD: ath.4,v 1.5 2004/07/03 16:58:18 mycroft Exp $
 .\"
 .\" Copyright (c) 2002, 2003 Sam Leffler, Errno Consulting
@@ -42,7 +42,7 @@
 .\" $FreeBSD: /repoman/r/ncvs/src/share/man/man4/ath.4,v 1.16 2004/02/18 08:30:08 maxim Exp $
 .\" parts from $FreeBSD: /repoman/r/ncvs/src/share/man/man4/ath_hal.4,v 1.7 2004/01/07 20:49:51 blackend Exp $
 .\"
-.Dd $Mdocdate: July 29 2008 $
+.Dd $Mdocdate: August 29 2008 $
 .Dt ATH 4
 .Os
 .Sh NAME
@@ -344,6 +344,10 @@ who also wrote a free replacement of the binary-only HAL.
 Different regulatory domains may not be able to communicate with each
 other with 802.11a as different regulatory domains do not necessarily
 have overlapping channels.
+.Pp
+Host AP mode doesn't support power saving.  Clients attempting to
+use power saving mode may experience significant packet loss (disabling
+power saving on the client will fix this).
 .Sh BUGS
 Performance in lossy environments is suboptimal.
 The algorithm used to select the rate for transmitted packets is
diff --git a/share/man/man4/pgt.4 b/share/man/man4/pgt.4
index ccc85c68a79..51a80ed7a02 100644
--- a/share/man/man4/pgt.4
+++ b/share/man/man4/pgt.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: pgt.4,v 1.27 2008/07/29 17:03:35 jmc Exp $
+.\"	$OpenBSD: pgt.4,v 1.28 2008/08/29 09:03:48 damien Exp $
 .\"
 .\" Copyright (c) 2006 Theo de Raadt.
 .\" Copyright (c) 2006 The DragonFly Project.  All rights reserved.
@@ -30,7 +30,7 @@
 .\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: July 29 2008 $
+.Dd $Mdocdate: August 29 2008 $
 .Os
 .Dt PGT 4
 .Sh NAME
@@ -207,3 +207,7 @@ by
 .An Marcus Glocker
 and
 .An Claudio Jeker .
+.Sh CAVEATS
+Host AP mode doesn't support power saving.  Clients attempting to
+use power saving mode may experience significant packet loss (disabling
+power saving on the client will fix this).
diff --git a/share/man/man4/ral.4 b/share/man/man4/ral.4
index ea0fdb43971..a6718dc5853 100644
--- a/share/man/man4/ral.4
+++ b/share/man/man4/ral.4
@@ -1,4 +1,4 @@
-.\" $OpenBSD: ral.4,v 1.88 2008/08/08 15:57:41 damien Exp $
+.\" $OpenBSD: ral.4,v 1.89 2008/08/29 09:03:48 damien Exp $
 .\"
 .\" Copyright (c) 2005-2008
 .\"	Damien Bergamini <damien.bergamini@free.fr>
@@ -15,7 +15,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: August 8 2008 $
+.Dd $Mdocdate: August 29 2008 $
 .Os
 .Dt RAL 4
 .Sh NAME
@@ -361,6 +361,10 @@ Additional work is required in
 .Xr ieee80211 9
 before those features can be supported.
 .Pp
+Host AP mode doesn't support power saving.  Clients attempting to
+use power saving mode may experience significant packet loss (disabling
+power saving on the client will fix this).
+.Pp
 Some PCI
 .Nm
 adapters seem to strictly require a system supporting PCI 2.2 or greater and
diff --git a/share/man/man4/rtw.4 b/share/man/man4/rtw.4
index 0206d5b906c..e5ac46adf32 100644
--- a/share/man/man4/rtw.4
+++ b/share/man/man4/rtw.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: rtw.4,v 1.33 2008/07/29 17:03:35 jmc Exp $
+.\"	$OpenBSD: rtw.4,v 1.34 2008/08/29 09:03:48 damien Exp $
 .\"
 .\" Copyright (c) 2004 Jonathan Gray <jsg@openbsd.org>
 .\"
@@ -14,7 +14,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: July 29 2008 $
+.Dd $Mdocdate: August 29 2008 $
 .Dt RTW 4
 .Os
 .Sh NAME
@@ -193,3 +193,7 @@ by
 GCT refuse to release any documentation on their GRF5101 RF transceiver.
 .Pp
 While PCI devices will attach most of them are not able to transmit.
+.Pp
+Host AP mode doesn't support power saving.  Clients attempting to
+use power saving mode may experience significant packet loss (disabling
+power saving on the client will fix this).
diff --git a/share/man/man4/rum.4 b/share/man/man4/rum.4
index 33c94c5ced0..441fad41fe6 100644
--- a/share/man/man4/rum.4
+++ b/share/man/man4/rum.4
@@ -1,4 +1,4 @@
-.\" $OpenBSD: rum.4,v 1.40 2008/08/19 02:37:26 deraadt Exp $
+.\" $OpenBSD: rum.4,v 1.41 2008/08/29 09:03:48 damien Exp $
 .\"
 .\" Copyright (c) 2005-2007
 .\"	Damien Bergamini <damien.bergamini@free.fr>
@@ -15,7 +15,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: August 19 2008 $
+.Dd $Mdocdate: August 29 2008 $
 .Os
 .Dt RUM 4
 .Sh NAME
@@ -230,3 +230,7 @@ driver supports automatic control of the transmit speed in BSS mode only.
 Therefore the use of a
 .Nm
 adapter in Host AP mode is discouraged.
+.Pp
+Host AP mode doesn't support power saving.  Clients attempting to
+use power saving mode may experience significant packet loss (disabling
+power saving on the client will fix this).
diff --git a/share/man/man4/ural.4 b/share/man/man4/ural.4
index e8ee1d05dd2..d20e04bac91 100644
--- a/share/man/man4/ural.4
+++ b/share/man/man4/ural.4
@@ -1,4 +1,4 @@
-.\" $OpenBSD: ural.4,v 1.7 2008/07/29 16:44:19 jmc Exp $
+.\" $OpenBSD: ural.4,v 1.8 2008/08/29 09:03:48 damien Exp $
 .\"
 .\" Copyright (c) 2005-2007
 .\"	Damien Bergamini <damien.bergamini@free.fr>
@@ -15,7 +15,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: July 29 2008 $
+.Dd $Mdocdate: August 29 2008 $
 .Os
 .Dt URAL 4
 .Sh NAME
@@ -203,3 +203,7 @@ driver supports automatic control of the transmit speed in BSS mode only.
 Therefore the use of an
 .Nm
 adapter in Host AP mode is discouraged.
+.Pp
+Host AP mode doesn't support power saving.  Clients attempting to
+use power saving mode may experience significant packet loss (disabling
+power saving on the client will fix this).