diff options
| author | Jacob McDonnell <jacob@jacobmcdonnell.com> | 2026-04-25 19:55:15 -0400 |
|---|---|---|
| committer | Jacob McDonnell <jacob@jacobmcdonnell.com> | 2026-04-25 19:55:15 -0400 |
| commit | 253e67c8b3a72b3a4757fdbc5845297628db0a4a (patch) | |
| tree | adf53b66087aa30dfbf8bf391a1dadb044c3bf4d /static/netbsd/man4/cdce.4 4.html | |
| parent | a9157ce950dfe2fc30795d43b9d79b9d1bffc48b (diff) | |
docs: Added All NetBSD Manuals
Diffstat (limited to 'static/netbsd/man4/cdce.4 4.html')
| -rw-r--r-- | static/netbsd/man4/cdce.4 4.html | 112 |
1 files changed, 112 insertions, 0 deletions
diff --git a/static/netbsd/man4/cdce.4 4.html b/static/netbsd/man4/cdce.4 4.html new file mode 100644 index 00000000..89748f1a --- /dev/null +++ b/static/netbsd/man4/cdce.4 4.html @@ -0,0 +1,112 @@ +<table class="head"> + <tr> + <td class="head-ltitle">CDCE(4)</td> + <td class="head-vol">Device Drivers Manual</td> + <td class="head-rtitle">CDCE(4)</td> + </tr> +</table> +<div class="manual-text"> +<section class="Sh"> +<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1> +<p class="Pp"><code class="Nm">cdce</code> — <span class="Nd">USB + Communication Device Class Ethernet driver</span></p> +</section> +<section class="Sh"> +<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1> +<p class="Pp"><code class="Cd">cdce* at uhub? port ?</code></p> +</section> +<section class="Sh"> +<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1> +<p class="Pp">The <code class="Nm">cdce</code> driver provides support for USB + Host-to-Host (aka USB-to-USB) bridges and USB-to-Ethernet adapters based on + the USB Communication Device Class (CDC) and Ethernet subclass, including + the following:</p> +<p class="Pp"></p> +<ul class="Bl-bullet Bl-compact"> + <li>Acer Labs USB 2.0 Data Link</li> + <li>Anker A7611</li> + <li>Club 3D Adapter LAN-Adapter (CAC-1420)</li> + <li>DIEWU USB-DW8152</li> + <li>G.Mate YP3X00</li> + <li>Huawei E5573s-320s</li> + <li>Motorola USBNET</li> + <li>NetChip EthernetGadget</li> + <li>Prolific PL-2501</li> + <li>Realtek RTL8152B, RTL8156, and RTL8156B Ethernet controllers</li> + <li>Sharp Zaurus</li> +</ul> +<p class="Pp">The USB bridge appears as a regular network interface on both + sides, transporting Ethernet frames.</p> +<p class="Pp">For more information on configuring this device, see + <a class="Xr">ifconfig(8)</a>.</p> +<p class="Pp">USB 1.x bridges support speeds of up to 12Mbps, USB 2.0 speeds of + up to 480Mbps, and USB 3.0 speeds of up to 5Gbps.</p> +<p class="Pp">Packets are received and transmitted over separate USB bulk + transfer endpoints.</p> +<p class="Pp">The <code class="Nm">cdce</code> driver does not support different + media types or options.</p> +</section> +<section class="Sh"> +<h1 class="Sh" id="DIAGNOSTICS"><a class="permalink" href="#DIAGNOSTICS">DIAGNOSTICS</a></h1> +<dl class="Bl-diag"> + <dt>cdce%d: no union descriptor</dt> + <dd>The driver couldn't fetch an interface descriptor from the USB device. For + a manually added USB vendor/product, the CDCE_NO_UNION flag can be tried + to work around the missing descriptor.</dd> + <dt>cdce%d: no data interface</dt> + <dd></dd> + <dt>cdce%d: could not read endpoint descriptor</dt> + <dd></dd> + <dt>cdce%d: unexpected endpoint</dt> + <dd></dd> + <dt>cdce%d: could not find data bulk in/out</dt> + <dd>For a manually added USB vendor/product, these errors indicate that the + bridge is not compatible with the driver.</dd> +</dl> +<p class="Pp">Also see <a class="Xr">usbnet(4)</a> for diagnostics.</p> +</section> +<section class="Sh"> +<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE + ALSO</a></h1> +<p class="Pp"><a class="Xr">arp(4)</a>, <a class="Xr">intro(4)</a>, + <a class="Xr">netintro(4)</a>, <a class="Xr">usb(4)</a>, + <a class="Xr">usbnet(4)</a>, <a class="Xr">ifconfig.if(5)</a>, + <a class="Xr">ifconfig(8)</a></p> +<p class="Pp"><cite class="Rs"><span class="RsT">Universal Serial Bus Class + Definitions for Communication Devices</span>, + <a class="RsU" href="http://www.usb.org/developers/devclass_docs/usbcdc11.pdf">http://www.usb.org/developers/devclass_docs/usbcdc11.pdf</a>.</cite></p> +<p class="Pp"><cite class="Rs"><span class="RsT">Data sheet Prolific PL-2501 + Host-to-Host Bridge/Network Controller</span>, + <a class="RsU" href="http://tech.prolific.com.tw/visitor/fcabdl.asp?fid=20679530">http://tech.prolific.com.tw/visitor/fcabdl.asp?fid=20679530</a>.</cite></p> +</section> +<section class="Sh"> +<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1> +<p class="Pp">The <code class="Nm">cdce</code> device driver first appeared in + <span class="Ux">OpenBSD 3.6</span> and <span class="Ux">NetBSD + 3.0</span>.</p> +</section> +<section class="Sh"> +<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1> +<p class="Pp">The <code class="Nm">cdce</code> driver was written by + <span class="An">Craig Boston</span> + <<a class="Mt" href="mailto:craig@tobuj.gank.org">craig@tobuj.gank.org</a>> + based on the <a class="Xr">aue(4)</a> driver written by + <span class="An">Bill Paul</span> + <<a class="Mt" href="mailto:wpaul@windriver.com">wpaul@windriver.com</a>> + and ported to <span class="Ux">OpenBSD</span> by <span class="An">Daniel + Hartmeier</span> + <<a class="Mt" href="mailto:dhartmei@openbsd.org">dhartmei@openbsd.org</a>>.</p> +</section> +<section class="Sh"> +<h1 class="Sh" id="CAVEATS"><a class="permalink" href="#CAVEATS">CAVEATS</a></h1> +<p class="Pp">Many USB devices notoriously fail to report their class and + interfaces correctly. Undetected products might work flawlessly when their + vendor and product IDs are added to the driver manually.</p> +</section> +</div> +<table class="foot"> + <tr> + <td class="foot-date">November 5, 2023</td> + <td class="foot-os">NetBSD 10.1</td> + </tr> +</table> |
