Source-Changes-HG archive

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]

[src/trunk]: src/share/man/man4 document usbnet diagnostics in usbnet(4). re...



details:   https://anonhg.NetBSD.org/src/rev/df38af60b85b
branches:  trunk
changeset: 1003084:df38af60b85b
user:      mrg <mrg%NetBSD.org@localhost>
date:      Fri Aug 30 08:54:58 2019 +0000

description:
document usbnet diagnostics in usbnet(4).  remove all the no longer
present messages in specific drivers for the usbnet drivers.

diffstat:

 distrib/sets/lists/man/mi |    5 +-
 share/man/man4/Makefile   |    4 +-
 share/man/man4/aue.4      |   16 ++----
 share/man/man4/axe.4      |    9 +++-
 share/man/man4/axen.4     |   14 ++---
 share/man/man4/cdce.4     |   22 +++------
 share/man/man4/cue.4      |   16 ++----
 share/man/man4/kue.4      |   16 ++----
 share/man/man4/mue.4      |   11 +++-
 share/man/man4/nfe.4      |    6 +-
 share/man/man4/sk.4       |    7 +-
 share/man/man4/udav.4     |    9 +++-
 share/man/man4/umb.4      |    6 +-
 share/man/man4/upl.4      |    9 +++-
 share/man/man4/ure.4      |    9 +++-
 share/man/man4/url.4      |   16 ++----
 share/man/man4/urndis.4   |    9 +++-
 share/man/man4/usbnet.4   |  107 ++++++++++++++++++++++++++++++++++++++++++++++
 share/man/man4/usmsc.4    |    9 +++-
 19 files changed, 211 insertions(+), 89 deletions(-)

diffs (truncated from 753 to 300 lines):

diff -r 0e5e3e8f5a72 -r df38af60b85b distrib/sets/lists/man/mi
--- a/distrib/sets/lists/man/mi Fri Aug 30 08:40:25 2019 +0000
+++ b/distrib/sets/lists/man/mi Fri Aug 30 08:54:58 2019 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: mi,v 1.1650 2019/08/23 08:17:27 mrg Exp $
+# $NetBSD: mi,v 1.1651 2019/08/30 08:54:58 mrg Exp $
 #
 # Note: don't delete entries from here - mark them as "obsolete" instead.
 #
@@ -1901,6 +1901,7 @@
 ./usr/share/man/cat4/urtw.0                    man-sys-catman          .cat
 ./usr/share/man/cat4/urtwn.0                   man-sys-catman          .cat
 ./usr/share/man/cat4/usb.0                     man-sys-catman          .cat
+./usr/share/man/cat4/usbnet.0                  man-sys-catman          .cat
 ./usr/share/man/cat4/usbtask.0                 man-sys-catman          .cat
 ./usr/share/man/cat4/uscanner.0                        man-sys-catman          .cat
 ./usr/share/man/cat4/userconf.0                        man-sys-catman          .cat
@@ -4994,6 +4995,7 @@
 ./usr/share/man/html4/urtw.html                        man-sys-htmlman         html
 ./usr/share/man/html4/urtwn.html               man-sys-htmlman         html
 ./usr/share/man/html4/usb.html                 man-sys-htmlman         html
+./usr/share/man/html4/usbnet.html              man-sys-htmlman         html
 ./usr/share/man/html4/usbtask.html             man-sys-htmlman         html
 ./usr/share/man/html4/uscanner.html            man-sys-htmlman         html
 ./usr/share/man/html4/userconf.html            man-sys-htmlman         html
@@ -8011,6 +8013,7 @@
 ./usr/share/man/man4/urtw.4                    man-sys-man             .man
 ./usr/share/man/man4/urtwn.4                   man-sys-man             .man
 ./usr/share/man/man4/usb.4                     man-sys-man             .man
+./usr/share/man/man4/usbnet.4                  man-sys-man             .man
 ./usr/share/man/man4/usbtask.4                 man-sys-man             .man
 ./usr/share/man/man4/uscanner.4                        man-sys-man             .man
 ./usr/share/man/man4/userconf.4                        man-sys-man             .man
diff -r 0e5e3e8f5a72 -r df38af60b85b share/man/man4/Makefile
--- a/share/man/man4/Makefile   Fri Aug 30 08:40:25 2019 +0000
+++ b/share/man/man4/Makefile   Fri Aug 30 08:54:58 2019 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: Makefile,v 1.680 2019/03/26 12:21:28 pgoyette Exp $
+#      $NetBSD: Makefile,v 1.681 2019/08/30 08:54:58 mrg Exp $
 #      @(#)Makefile    8.1 (Berkeley) 6/18/93
 
 MAN=   aac.4 ac97.4 acardide.4 aceride.4 acphy.4 \
@@ -83,7 +83,7 @@
        uhidev.4 uhmodem.4 uhso.4 uipad.4 uipaq.4 uirda.4 ukbd.4 ukyopon.4 \
        ulpt.4 umass.4 umcs.4 umct.4 umidi.4 umodem.4 ums.4 upgt.4 upl.4 \
        uplcom.4 ure.4 urio.4 url.4 urndis.4 urtw.4 urtwn.4 \
-       usb.4 uscanner.4 uslsa.4 usmsc.4 usscanner.4 \
+       usb.4 usbnet.4 uscanner.4 uslsa.4 usmsc.4 usscanner.4 \
        ustir.4 uthum.4 utoppy.4 uts.4 uvideo.4 uvisor.4 uvscom.4 uyap.4 \
        uyurex.4 \
        xhci.4 \
diff -r 0e5e3e8f5a72 -r df38af60b85b share/man/man4/aue.4
--- a/share/man/man4/aue.4      Fri Aug 30 08:40:25 2019 +0000
+++ b/share/man/man4/aue.4      Fri Aug 30 08:54:58 2019 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: aue.4,v 1.20 2010/09/25 22:14:07 wiz Exp $
+.\"    $NetBSD: aue.4,v 1.21 2019/08/30 08:54:58 mrg Exp $
 .\"
 .\" Copyright (c) 1997, 1998, 1999
 .\"     Bill Paul <wpaul%ee.columbia.edu@localhost>. All rights reserved.
@@ -32,7 +32,7 @@
 .\"
 .\" FreeBSD: src/share/man/man4/aue.4,v 1.2 2000/01/07 22:18:47 wpaul Exp
 .\"
-.Dd September 25, 2010
+.Dd August 24 2019
 .Dt AUE 4
 .Os
 .Sh NAME
@@ -145,18 +145,14 @@
 For more information on configuring this device, see
 .Xr ifconfig 8 .
 .Sh DIAGNOSTICS
-.Bl -diag
-.It "aue%d: watchdog timeout"
-A packet was queued for transmission and a transmit command was
-issued, however the device failed to acknowledge the transmission
-before a timeout expired.
-.It "aue%d: no memory for rx list"
-The driver failed to allocate an mbuf for the receiver ring.
-.El
+See
+.Xr usbnet 4
+for diagnostics.
 .Sh SEE ALSO
 .Xr arp 4 ,
 .Xr netintro 4 ,
 .Xr usb 4 ,
+.Xr usbnet 4 ,
 .Xr ifconfig 8
 .Rs
 .%T ADMtek AN986 data sheet
diff -r 0e5e3e8f5a72 -r df38af60b85b share/man/man4/axe.4
--- a/share/man/man4/axe.4      Fri Aug 30 08:40:25 2019 +0000
+++ b/share/man/man4/axe.4      Fri Aug 30 08:54:58 2019 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: axe.4,v 1.15 2018/08/31 17:35:06 wiz Exp $
+.\" $NetBSD: axe.4,v 1.16 2019/08/30 08:54:58 mrg Exp $
 .\"
 .\" Copyright (c) 2003-2004 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -60,7 +60,7 @@
 .\" $FreeBSD: /repoman/r/ncvs/src/share/man/man4/axe.4,v 1.3 2003/05/29 21:28:35 ru Exp $
 .\" $OpenBSD: axe.4,v 1.37 2009/11/08 20:25:29 jasper Exp $
 .\"
-.Dd August 31, 2018
+.Dd August 24 2019
 .Dt AXE 4
 .Os
 .Sh NAME
@@ -178,11 +178,16 @@
 .Pp
 For more information on configuring this device, see
 .Xr ifconfig 8 .
+.Sh DIAGNOSTICS
+See
+.Xr usbnet 4
+for diagnostics.
 .Sh SEE ALSO
 .Xr arp 4 ,
 .Xr ifmedia 4 ,
 .Xr netintro 4 ,
 .Xr usb 4 ,
+.Xr usbnet 4 ,
 .Xr ifconfig 8
 .Rs
 .%T ASIX AX88172 data sheet
diff -r 0e5e3e8f5a72 -r df38af60b85b share/man/man4/axen.4
--- a/share/man/man4/axen.4     Fri Aug 30 08:40:25 2019 +0000
+++ b/share/man/man4/axen.4     Fri Aug 30 08:54:58 2019 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: axen.4,v 1.7 2018/07/27 19:11:56 snj Exp $
+.\"    $NetBSD: axen.4,v 1.8 2019/08/30 08:54:58 mrg Exp $
 .\"    $OpenBSD: axen.4,v 1.2 2013/10/07 07:18:36 jmc Exp $
 .\"
 .\" Copyright (c) 2013 Yojiro UO <yuo%nui.org@localhost>
@@ -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 July 27, 2018
+.Dd August 24 2019
 .Dt AXEN 4
 .Os
 .Sh NAME
@@ -62,18 +62,16 @@
 For more information on configuring this device, see
 .Xr ifconfig 8 .
 .Sh DIAGNOSTICS
-.Bl -diag
-.It "axen%d: watchdog timeout"
-A packet was queued for transmission and a transmit command was
-issued, however the device failed to acknowledge the transmission
-before a timeout expired.
-.El
+See
+.Xr usbnet 4
+for diagnostics.
 .Sh SEE ALSO
 .Xr arp 4 ,
 .Xr mii 4 ,
 .Xr netintro 4 ,
 .Xr rgephy 4 ,
 .Xr usb 4 ,
+.Xr usbnet 4 ,
 .Xr ifconfig.if 5 ,
 .Xr ifconfig 8
 .Sh HISTORY
diff -r 0e5e3e8f5a72 -r df38af60b85b share/man/man4/cdce.4
--- a/share/man/man4/cdce.4     Fri Aug 30 08:40:25 2019 +0000
+++ b/share/man/man4/cdce.4     Fri Aug 30 08:54:58 2019 +0000
@@ -25,9 +25,9 @@
 .\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.\" $NetBSD: cdce.4,v 1.15 2019/03/23 23:15:11 wiz Exp $
+.\" $NetBSD: cdce.4,v 1.16 2019/08/30 08:54:58 mrg Exp $
 .\"
-.Dd March 23, 2019
+.Dd August 24 2019
 .Dt CDCE 4
 .Os
 .Sh NAME
@@ -94,24 +94,18 @@
 .It "cdce%d: could not find data bulk in/out"
 For a manually added USB vendor/product, these errors indicate
 that the bridge is not compatible with the driver.
-.It "cdce%d: watchdog timeout"
-A packet was queued for transmission and a transmit command was
-issued, however the device failed to acknowledge the transmission
-before a timeout expired.
-.It "cdce%d: no memory for rx list -- packet dropped!"
-Memory allocation through MGETHDR or MCLGET failed, the system
-is running low on mbufs.
-.It "cdce%d: abort/close rx/tx pipe failed"
-.It "cdce%d: rx/tx list init failed"
-.It "cdce%d: open rx/tx pipe failed"
-.It "cdce%d: usb error on rx/tx"
 .El
+.Pp
+Also see
+.Xr usbnet 4
+for diagnostics.
 .Sh SEE ALSO
 .Xr arp 4 ,
 .Xr intro 4 ,
 .Xr netintro 4 ,
 .Xr usb 4 ,
-.\" .Xr hostname.if 5 ,
+.Xr usbnet 4 ,
+.Xr ifconfig.if 5 ,
 .Xr ifconfig 8
 .Rs
 .%T "Universal Serial Bus Class Definitions for Communication Devices"
diff -r 0e5e3e8f5a72 -r df38af60b85b share/man/man4/cue.4
--- a/share/man/man4/cue.4      Fri Aug 30 08:40:25 2019 +0000
+++ b/share/man/man4/cue.4      Fri Aug 30 08:54:58 2019 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: cue.4,v 1.8 2014/03/18 18:20:39 riastradh Exp $
+.\"    $NetBSD: cue.4,v 1.9 2019/08/30 08:54:58 mrg Exp $
 .\"
 .\" Copyright (c) 1997, 1998, 1999, 2000
 .\"     Bill Paul <wpaul%ee.columbia.edu@localhost>. All rights reserved.
@@ -32,7 +32,7 @@
 .\"
 .\" FreeBSD: src/share/man/man4/cue.4,v 1.1 2000/01/14 03:14:47 wpaul Exp
 .\"
-.Dd January 13, 2000
+.Dd August 24 2019
 .Dt CUE 4
 .Os
 .Sh NAME
@@ -69,18 +69,14 @@
 For more information on configuring this device, see
 .Xr ifconfig 8 .
 .Sh DIAGNOSTICS
-.Bl -diag
-.It "cue%d: watchdog timeout"
-A packet was queued for transmission and a transmit command was
-issued, however the device failed to acknowledge the transmission
-before a timeout expired.
-.It "cue%d: no memory for rx list"
-The driver failed to allocate an mbuf for the receiver ring.
-.El
+See
+.Xr usbnet 4
+for diagnostics.
 .Sh SEE ALSO
 .Xr arp 4 ,
 .Xr netintro 4 ,
 .Xr usb 4 ,
+.Xr usbnet 4 ,
 .Xr ifconfig 8
 .Sh HISTORY
 The
diff -r 0e5e3e8f5a72 -r df38af60b85b share/man/man4/kue.4
--- a/share/man/man4/kue.4      Fri Aug 30 08:40:25 2019 +0000
+++ b/share/man/man4/kue.4      Fri Aug 30 08:54:58 2019 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: kue.4,v 1.12 2002/02/07 03:15:08 ross Exp $
+.\"    $NetBSD: kue.4,v 1.13 2019/08/30 08:54:58 mrg Exp $
 .\"
 .\" Copyright (c) 1997, 1998, 1999, 2000
 .\"     Bill Paul <wpaul%ee.columbia.edu@localhost>. All rights reserved.
@@ -32,7 +32,7 @@
 .\"
 .\" $FreeBSD: src/share/man/man4/kue.4,v 1.2 2000/01/07 22:18:48 wpaul Exp $
 .\"
-.Dd January 4, 2000
+.Dd August 24 2019
 .Dt KUE 4
 .Os
 .Sh NAME
@@ -82,18 +82,14 @@
 For more information on configuring this device, see
 .Xr ifconfig 8 .
 .Sh DIAGNOSTICS
-.Bl -diag
-.It "kue%d: watchdog timeout"
-A packet was queued for transmission and a transmit command was
-issued, however the device failed to acknowledge the transmission
-before a timeout expired.
-.It "kue%d: no memory for rx list"
-The driver failed to allocate an mbuf for the receiver ring.
-.El
+See
+.Xr usbnet 4
+for diagnostics.
 .Sh SEE ALSO
 .Xr arp 4 ,
 .Xr netintro 4 ,
 .Xr usb 4 ,
+.Xr usbnet 4 ,
 .Xr ifconfig 8
 .Sh HISTORY
 The
diff -r 0e5e3e8f5a72 -r df38af60b85b share/man/man4/mue.4
--- a/share/man/man4/mue.4      Fri Aug 30 08:40:25 2019 +0000
+++ b/share/man/man4/mue.4      Fri Aug 30 08:54:58 2019 +0000
@@ -1,4 +1,4 @@



Home | Main Index | Thread Index | Old Index