xref: /freebsd/share/man/man4/cue.4 (revision 6b7b2d80ed4d728d3ffd12c422e57798c1b63a84)
1.\" Copyright (c) 1997, 1998, 1999, 2000
2.\"	Bill Paul <wpaul@ee.columbia.edu>. All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\"    notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\"    notice, this list of conditions and the following disclaimer in the
11.\"    documentation and/or other materials provided with the distribution.
12.\" 3. All advertising materials mentioning features or use of this software
13.\"    must display the following acknowledgement:
14.\"	This product includes software developed by Bill Paul.
15.\" 4. Neither the name of the author nor the names of any co-contributors
16.\"    may be used to endorse or promote products derived from this software
17.\"   without specific prior written permission.
18.\"
19.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND
20.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22.\" ARE DISCLAIMED.  IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD
23.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
29.\" THE POSSIBILITY OF SUCH DAMAGE.
30.\"
31.\" $FreeBSD$
32.\"
33.Dd November 24, 2015
34.Dt CUE 4
35.Os
36.Sh NAME
37.Nm cue
38.Nd "CATC USB-EL1210A USB Ethernet driver"
39.Sh SYNOPSIS
40To compile this driver into the kernel,
41place the following lines in your
42kernel configuration file:
43.Bd -ragged -offset indent
44.Cd "device uhci"
45.Cd "device ohci"
46.Cd "device usb"
47.Cd "device miibus"
48.Cd "device uether"
49.Cd "device cue"
50.Ed
51.Pp
52Alternatively, to load the driver as a
53module at boot time, place the following line in
54.Xr loader.conf 5 :
55.Bd -literal -offset indent
56if_cue_load="YES"
57.Ed
58.Sh DESCRIPTION
59The
60.Nm
61driver provides support for USB Ethernet adapters based on the Computer
62Access Technology Corporation's USB-EL1210A chipset.
63.Pp
64The USB-EL1210A supports a 512-bit multicast hash filter, single perfect
65filter entry for the station address and promiscuous mode.
66Packets are
67received and transmitted over separate USB bulk transfer endpoints.
68.Pp
69The CATC chipset supports only 10Mbps half-duplex mode, hence there
70are no
71.Xr ifmedia 4
72modes to select.
73.Pp
74For more information on configuring this device, see
75.Xr ifconfig 8 .
76.Sh HARDWARE
77The
78.Nm
79driver supports CATC USB-EL1210A based USB Ethernet
80adapters including:
81.Pp
82.Bl -bullet -compact
83.It
84Belkin F5U011/F5U111
85.It
86CATC Netmate
87.It
88CATC Netmate II
89.It
90SmartBridges SmartLink
91.El
92.Sh DIAGNOSTICS
93.Bl -diag
94.It "cue%d: watchdog timeout"
95A packet was queued for transmission and a transmit command was
96issued, however the device failed to acknowledge the transmission
97before a timeout expired.
98.It "cue%d: no memory for rx list"
99The driver failed to allocate an mbuf for the receiver ring.
100.El
101.Sh SEE ALSO
102.Xr arp 4 ,
103.Xr netintro 4 ,
104.Xr ng_ether 4 ,
105.Xr ifconfig 8
106.Sh HISTORY
107The
108.Nm
109device driver first appeared in
110.Fx 4.0 .
111.Sh AUTHORS
112The
113.Nm
114driver was written by
115.An Bill Paul Aq Mt wpaul@ee.columbia.edu .
116