1.\" $NetBSD: usbnet.4,v 1.5 2021/06/16 00:21:17 riastradh 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 June 15, 2021 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: couldn't establish power handler" 64Call to 65.Xr pmf_device_register 9 66failed, disabling system suspend. 67.El 68.Pp 69The 70.Nm 71manual lists generic diagnostics generated by USB network devices. 72.Sh SEE ALSO 73.Xr arp 4 , 74.Xr aue 4 , 75.Xr axe 4 , 76.Xr axen 4 , 77.Xr cdce 4 , 78.Xr cue 4 , 79.Xr ifmedia 4 , 80.Xr intro 4 , 81.Xr kue 4 , 82.Xr mos 4 , 83.Xr mue 4 , 84.Xr netintro 4 , 85.Xr smsc 4 , 86.Xr udav 4 , 87.Xr upl 4 , 88.Xr ure 4 , 89.Xr url 4 , 90.Xr urndis 4 , 91.Xr usb 4 , 92.Xr usbnet 9 93.Sh HISTORY 94The 95.Nm 96framework first appeared in 97.Nx 9.0 . 98.Sh AUTHORS 99.An -nosplit 100The 101.Nm 102framework was written by 103.An Matthew R. Green Aq Mt mrg@eterna.com.au 104