1.\" $OpenBSD: kue.4,v 1.21 2013/07/16 16:05:49 schwarze Exp $ 2.\" $NetBSD: kue.4,v 1.5 2000/03/20 01:34:22 augustss Exp $ 3.\" 4.\" Copyright (c) 1997, 1998, 1999, 2000 5.\" Bill Paul <wpaul@ee.columbia.edu>. All rights reserved. 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions 9.\" are met: 10.\" 1. Redistributions of source code must retain the above copyright 11.\" notice, this list of conditions and the following disclaimer. 12.\" 2. Redistributions in binary form must reproduce the above copyright 13.\" notice, this list of conditions and the following disclaimer in the 14.\" documentation and/or other materials provided with the distribution. 15.\" 3. All advertising materials mentioning features or use of this software 16.\" must display the following acknowledgement: 17.\" This product includes software developed by Bill Paul. 18.\" 4. Neither the name of the author nor the names of any co-contributors 19.\" may be used to endorse or promote products derived from this software 20.\" without specific prior written permission. 21.\" 22.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND 23.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 24.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 25.\" ARE DISCLAIMED. IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD 26.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 27.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 28.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 29.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 30.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 31.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF 32.\" THE POSSIBILITY OF SUCH DAMAGE. 33.\" 34.\" $FreeBSD: src/share/man/man4/kue.4,v 1.2 2000/01/07 22:18:48 wpaul Exp $ 35.\" 36.Dd $Mdocdate: July 16 2013 $ 37.Dt KUE 4 38.Os 39.Sh NAME 40.Nm kue 41.Nd Kawasaki LSI KL5KUSB101B USB Ethernet device 42.Sh SYNOPSIS 43.Cd "kue* at uhub?" 44.Sh DESCRIPTION 45The 46.Nm 47driver provides support for USB Ethernet adapters based on the Kawasaki 48LSI KL5KLUSB101B chipset. 49This includes the following adapters: 50.Pp 51.Bl -tag -width Ds -offset indent -compact 52.It Tn 3Com 3c19250 53.It Tn 3Com 3c460 HomeConnect 54.It Tn AboCom Systems URE450 Ethernet 55.It Tn ADS Technologies USB-10BT 56.It Tn Aox USB101 57.It Tn Asante USB to Ethernet 58.It Tn ATen DSB-650C 59.It Tn ATen UC10T 60.It Tn Corega USB-T 61.It Tn D-Link DSB-650C 62.It Tn Entrega NET-USB-E45 63.It Tn I/O Data USB-ET/T 64.It Tn Jaton USB XpressNet 65.It Tn Kawasaki USB101 66.It Tn Kingston Ethernet 67.It Tn Linksys USB10T 68.It Tn Mobility Ethernet 69.It Tn Netgear EA101 70.It Tn Peracom USB 71.It Tn Portgear Ethernet 72.It Tn Portsmith Express Ethernet 73.It Tn Psion Dacom Gold Port Ethernet 74.It Tn Shark Pocket Adapter 75.It Tn Silicom U2E 76.It Tn SMC 2102USB 77.It Tn SMC 2104USB 78.El 79.Pp 80The KL5KLUSB101B supports a 128-entry multicast filter, single perfect 81filter entry for the station address and promiscuous mode. 82Packets are 83received and transmitted over separate USB bulk transfer endpoints. 84.Pp 85The Kawasaki adapter supports only 10Mbps half-duplex mode, hence there 86are no 87.Xr ifmedia 4 88modes to select. 89.Pp 90For more information on configuring this device, see 91.Xr ifconfig 8 . 92.Sh FILES 93The driver needs a firmware file, 94which is loaded on demand when the device is attached: 95.Pp 96.Bl -tag -width Ds -offset indent -compact 97.It Pa /etc/firmware/kue 98.El 99.Sh DIAGNOSTICS 100.Bl -diag 101.It "kue0: watchdog timeout" 102A packet was queued for transmission and a transmit command was 103issued, however the device failed to acknowledge the transmission 104before a timeout expired. 105.It "kue0: no memory for rx list" 106The driver failed to allocate an mbuf for the receiver ring. 107.El 108.Sh SEE ALSO 109.Xr arp 4 , 110.Xr intro 4 , 111.Xr netintro 4 , 112.Xr usb 4 , 113.Xr hostname.if 5 , 114.Xr ifconfig 8 115.Sh HISTORY 116The 117.Nm 118device driver first appeared in 119.Fx 4.0 . 120.Ox 121support was added in 122.Ox 2.7 . 123.Sh AUTHORS 124.An -nosplit 125The 126.Nm 127driver was written by 128.An Bill Paul Aq Mt wpaul@ee.columbia.edu 129and ported to 130.Ox 131by 132.An Aaron Campbell Aq Mt aaron@openbsd.org . 133.Sh BUGS 134The 135.Nm 136driver does not accumulate Ethernet collisions statistics because the 137Kawasaki firmware does not appear to maintain any internal statistics. 138