1.\" $NetBSD: usbnet.4,v 1.7 2024/02/04 05:43:06 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.\" 15.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 16.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 17.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 18.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 19.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 20.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 21.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED 22.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 23.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 24.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 25.\" SUCH DAMAGE. 26.\" 27.Dd June 15, 2021 28.Dt USBNET 4 29.Os 30.Sh NAME 31.Nm usbnet 32.Nd generic USB network driver backend diagnostics 33.Sh DESCRIPTION 34The 35.Nm 36subsystem provides support for USB network devices. 37This manual describes diagnostics that may be seen. 38.Sh DIAGNOSTICS 39.Bl -tag -width 10n 40.It "devN: sysctl_createv failed" 41Unable to create debug node for 42.Nx . 43.It "devN: usb errors on rx" 44Error status from device upon Rx interrupt, device may be non-functional. 45.It "devN: usb error on tx" 46Error status from device upon Tx interrupt., device may be non-functional. 47.It "devN: usb error on intr" 48Error status from device upon interrupt, device may be non-functional. 49.It "devN: rxeof: too large transfer" 50Network input rejected. 51.It "devN: close pipe N" 52Closing of Rx, Tx or Interrupt pipe failed, device may be non-functional. 53.It "devN: open rx/tx pipes failed" 54Opening of Rx or Tx pipes failed, device non-functional. 55.It "devN: [rt]x list init failed" 56Creation of Rx or Tx list failed, device non-functional. 57.It "devN: watchdog timeout" 58Time out in transmission. 59.It "devN: pipe abort failed" 60Aborting USB pipes after watchdog timeout failed. 61.It "devN: couldn't establish power handler" 62Call to 63.Xr pmf_device_register 9 64failed, disabling system suspend. 65.El 66.Pp 67The 68.Nm 69manual lists generic diagnostics generated by USB network devices. 70.Sh SEE ALSO 71.Xr arp 4 , 72.Xr aue 4 , 73.Xr axe 4 , 74.Xr axen 4 , 75.Xr cdce 4 , 76.Xr cue 4 , 77.Xr ifmedia 4 , 78.Xr intro 4 , 79.Xr kue 4 , 80.Xr mos 4 , 81.Xr mue 4 , 82.Xr netintro 4 , 83.Xr smsc 4 , 84.Xr udav 4 , 85.Xr upl 4 , 86.Xr ure 4 , 87.Xr url 4 , 88.Xr urndis 4 , 89.Xr usb 4 , 90.Xr usbnet 9 91.Sh HISTORY 92The 93.Nm 94framework first appeared in 95.Nx 9.0 . 96.Sh AUTHORS 97.An -nosplit 98The 99.Nm 100framework was written by 101.An Matthew R. Green Aq Mt mrg@eterna23.net 102