summaryrefslogtreecommitdiff
path: root/static/netbsd/man4/cdce.4 4.html
diff options
context:
space:
mode:
authorJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-25 19:55:15 -0400
committerJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-25 19:55:15 -0400
commit253e67c8b3a72b3a4757fdbc5845297628db0a4a (patch)
treeadf53b66087aa30dfbf8bf391a1dadb044c3bf4d /static/netbsd/man4/cdce.4 4.html
parenta9157ce950dfe2fc30795d43b9d79b9d1bffc48b (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.html112
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> &#x2014; <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>
+ &lt;<a class="Mt" href="mailto:craig@tobuj.gank.org">craig@tobuj.gank.org</a>&gt;
+ based on the <a class="Xr">aue(4)</a> driver written by
+ <span class="An">Bill Paul</span>
+ &lt;<a class="Mt" href="mailto:wpaul@windriver.com">wpaul@windriver.com</a>&gt;
+ and ported to <span class="Ux">OpenBSD</span> by <span class="An">Daniel
+ Hartmeier</span>
+ &lt;<a class="Mt" href="mailto:dhartmei@openbsd.org">dhartmei@openbsd.org</a>&gt;.</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>