1.\" $NetBSD: usbnet.4,v 1.4 2019/09/20 10:34:54 mrg Exp $ 2.\" 3.\" Copyright (c) 2019 Matthew R. Green 4.\" All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 1. Redistributions of source code must retain the above copyright 10.\" notice, this list of conditions and the following disclaimer. 11.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" notice, this list of conditions and the following disclaimer in the 13.\" documentation and/or other materials provided with the distribution. 14.\" 3. The name of the author may not be used to endorse or promote products 15.\" derived from this software without specific prior written permission. 16.\" 17.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 18.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 19.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 20.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 21.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 22.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 23.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED 24.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 25.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 26.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 27.\" SUCH DAMAGE. 28.\" 29.Dd August 24, 2019 30.Dt USBNET 4 31.Os 32.Sh NAME 33.Nm usbnet 34.Nd generic USB network driver backend diagnostics 35.Sh DESCRIPTION 36The 37.Nm 38subsystem provides support for USB network devices. 39This manual describes diagnostics that may be seen. 40.Sh DIAGNOSTICS 41.Bl -tag -width 10n 42.It "devN: sysctl_createv failed" 43Unable to create debug node for 44.Nx . 45.It "devN: usb errors on rx" 46Error status from device upon Rx interrupt, device may be non-functional. 47.It "devN: usb error on tx" 48Error status from device upon Tx interrupt., device may be non-functional. 49.It "devN: usb error on intr" 50Error status from device upon interrupt, device may be non-functional. 51.It "devN: rxeof: too large transfer" 52Network input rejected. 53.It "devN: close pipe N" 54Closing of Rx, Tx or Interrupt pipe failed, device may be non-functional. 55.It "devN: open rx/tx pipes failed" 56Opening of Rx or Tx pipes failed, device non-functional. 57.It "devN: [rt]x list init failed" 58Creation of Rx or Tx list failed, device non-functional. 59.It "devN: watchdog timeout" 60Time out in transmission. 61.It "devN: pipe abort failed" 62Aborting USB pipes after watchdog timeout failed. 63.It "devN: if_initialize failed" 64Couldn't register network interface, device non-functional. 65.It "devN: couldn't establish power handler" 66Call to 67.Xr pmf_device_register 9 68failed, disabling system suspend. 69.El 70.Pp 71The 72.Nm 73manual lists generic diagnostics generated by USB network devices. 74.Sh SEE ALSO 75.Xr arp 4 , 76.Xr aue 4 , 77.Xr axe 4 , 78.Xr axen 4 , 79.Xr cdce 4 , 80.Xr cue 4 , 81.Xr ifmedia 4 , 82.Xr intro 4 , 83.Xr kue 4 , 84.Xr mos 4 , 85.Xr mue 4 , 86.Xr netintro 4 , 87.Xr smsc 4 , 88.Xr udav 4 , 89.Xr upl 4 , 90.Xr ure 4 , 91.Xr url 4 , 92.Xr urndis 4 , 93.Xr usb 4 , 94.Xr usbnet 9 95.Sh HISTORY 96The 97.Nm 98framework first appeared in 99.Nx 9.0 . 100.Sh AUTHORS 101.An -nosplit 102The 103.Nm 104framework was written by 105.An Matthew R. Green Aq Mt mrg@eterna.com.au 106