summaryrefslogtreecommitdiff
path: root/share/man/man4/ath.4
diff options
context:
space:
mode:
authorTed Unangst <tedu@cvs.openbsd.org>2013-06-02 20:23:35 +0000
committerTed Unangst <tedu@cvs.openbsd.org>2013-06-02 20:23:35 +0000
commit219d66a345a2096f298f9f7485d8cfcb60c63b85 (patch)
tree5b514129e8227d8dfd3f196be4058ef31d43cba8 /share/man/man4/ath.4
parentb015e94f1fa88a49429bb89efe1abf0724611493 (diff)
change format strings in error messages to reasonable values more likely
to be understood by people who don't program in C. ok everyone
Diffstat (limited to 'share/man/man4/ath.4')
-rw-r--r--share/man/man4/ath.442
1 files changed, 21 insertions, 21 deletions
diff --git a/share/man/man4/ath.4 b/share/man/man4/ath.4
index f2933541748..4f16a56f5fa 100644
--- a/share/man/man4/ath.4
+++ b/share/man/man4/ath.4
@@ -1,4 +1,4 @@
-.\" $OpenBSD: ath.4,v 1.55 2013/02/14 07:40:42 jmc Exp $
+.\" $OpenBSD: ath.4,v 1.56 2013/06/02 20:23:33 tedu 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: February 14 2013 $
+.Dd $Mdocdate: June 2 2013 $
.Dt ATH 4
.Os
.Sh NAME
@@ -222,77 +222,77 @@ wpakey mywpakey
.Ed
.Sh DIAGNOSTICS
.Bl -diag
-.It "ath%d: unable to attach hardware; HAL status %u"
+.It "ath0: unable to attach hardware; HAL status %u"
The Hardware Access Layer was unable to configure the hardware
as requested.
The status code is explained in the HAL include file
.Pa sys/dev/ic/ar5xxx.h .
-.It "ath%d: failed to allocate descriptors: %d"
+.It "ath0: failed to allocate descriptors: N"
The driver was unable to allocate contiguous memory for the transmit
and receive descriptors.
This usually indicates system memory is scarce and/or fragmented.
-.It "ath%d: unable to setup a data xmit queue!"
+.It "ath0: unable to setup a data xmit queue!"
The request to the HAL to set up the transmit queue for normal
data frames failed.
This should not happen.
-.It "ath%d: unable to setup a beacon xmit queue!"
+.It "ath0: unable to setup a beacon xmit queue!"
The request to the HAL to set up the transmit queue for 802.11 beacon frames
failed.
This should not happen.
-.It "ath%d: hardware error; resetting"
+.It "ath0: hardware error; resetting"
An unrecoverable error in the hardware occurred.
Errors of this sort include unrecoverable DMA errors.
The driver will reset the hardware and continue.
-.It "ath%d: rx FIFO overrun; resetting"
+.It "ath0: rx FIFO overrun; resetting"
The receive FIFO in the hardware overflowed before the data could be
transferred to the host.
This typically occurs because the hardware ran short of receive
descriptors and had no place to transfer received data.
The driver will reset the hardware and continue.
-.It "ath%d: unable to reset hardware; hal status %u"
+.It "ath0: unable to reset hardware; hal status N"
The Hardware Access Layer was unable to reset the hardware
as requested.
The status code is explained in the HAL include file
.Pa /sys/dev/ic/ar5xxx.h .
This should not happen.
-.It "ath%d: unable to initialize the key cache"
+.It "ath0: unable to initialize the key cache"
The driver was unable to initialize the hardware key cache.
This should not happen.
-.It "ath%d: unable to start recv logic"
+.It "ath0: unable to start recv logic"
The driver was unable to restart frame reception.
This should not happen.
-.It "ath%d: device timeout"
+.It "ath0: device timeout"
A frame dispatched to the hardware for transmission did not complete in time.
The driver will reset the hardware and continue.
This should not happen.
-.It "ath%d: bogus xmit rate 0x%x"
+.It "ath0: bogus xmit rate 0xNNNN"
An invalid transmit rate was specified for an outgoing frame.
The frame is discarded.
This should not happen.
-.It "ath%d: ath_chan_set: unable to reset channel %u (%u MHz)"
+.It "ath0: ath_chan_set: unable to reset channel N (X MHz)"
The Hardware Access Layer was unable to reset the hardware
when switching channels during scanning.
This should not happen.
-.It "ath%d: unable to allocate channel table"
+.It "ath0: unable to allocate channel table"
The driver was unable to allocate memory for the table used to hold
the set of available channels.
-.It "ath%d: unable to collect channel list from hal"
+.It "ath0: unable to collect channel list from hal"
A problem occurred while querying the HAL to find the set of available
channels for the device.
This should not happen.
-.It "ath%d: failed to enable memory mapping"
+.It "ath0: failed to enable memory mapping"
The driver was unable to enable memory-mapped I/O to the PCI device registers.
This should not happen.
-.It "ath%d: failed to enable bus mastering"
+.It "ath0: failed to enable bus mastering"
The driver was unable to enable the device as a PCI bus master for doing DMA.
This should not happen.
-.It "ath%d: cannot map register space"
+.It "ath0: cannot map register space"
The driver was unable to map the device registers into the host address space.
This should not happen.
-.It "ath%d: could not map interrupt"
+.It "ath0: could not map interrupt"
The driver was unable to allocate an IRQ for the device interrupt.
This should not happen.
-.It "ath%d: could not establish interrupt"
+.It "ath0: could not establish interrupt"
The driver was unable to install the device interrupt handler.
This should not happen.
.El