From nobody Wed Sep 16 12:05:25 2026 X-Original-To: dev-commits-src-branches@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4hlHdd6gX5z6t6jZ for ; Wed, 16 Sep 2026 12:05:25 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange x25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "YR2" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 4hlHdd4S0Tz4LmX for ; Wed, 16 Sep 2026 12:05:25 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1789560325; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=Al4qrKc7o0fRS389pOrQ2yr7/uGULCEaP/15SD4MD6I=; b=Y2FR/X451cFjCCal4fTaCNi1QFuaSGDMr5xH0NXYx+sHDJPRPCUrJcdMvCv4g1kPlP/qMH NQ5Pyn+eCTiQfw+tySOZMxCX+4sGt9KFYGBf4EE5zMEDXayITn7WLls89NNkYFGx7AFAzr ++ubDrA0kI3lbwuQhIjLXaxxK3XIRy1jttirtKm1y0btotjitq3crfapfidUi/zhpIfH9w wYpL5amZ6+XG78/WHhWD4ztaQpWDgoFSfEtshYhQcx5HpogFwF3Nz+K4ejnQVgZwqmeBmT sx9wtca8UkmEzGI9CC8CjtZhSjOH57eLsCDW79a+soxMT8Fb3U5ZQQ5Hx/Tw7w== ARC-Seal: i=1; a=rsa-sha256; d=freebsd.org; s=dkim; cv=none; t=1789560325; b=JI5L3Ty1S2xn/Xy2yNCma17XlpFmGk6dFlcyKEW1kf2W/n57c9T/Qd8rO5c4Ji+illnc6R JAu+3nygU8V7WB4L/etDyZLLRpPT8f/6o3E5ciYu4Wz5WUa1emkjxwEe9POUVdAAYfJLqi sSItMuHoT/VS9X2fc6PCvDRfpTlnezDIBNLduOpMTymtelH5oqVQ+YnmYVPxh7a/NQLr46 nRl5NiQoUKR3bzUzEMP7kVyY/9txlAFUXZVf5J7jyzwPkzwZtVa8tvBrraKwqaOKL4VTaD xOBrTntPns1S3RiPnPdQqosEYPsCnTW6kFnQV1/7iNI08dBqo8UMbnKXhRpv0g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1789560325; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=Al4qrKc7o0fRS389pOrQ2yr7/uGULCEaP/15SD4MD6I=; b=Bj38tZpPIjEcyFcIl6jIxc1D+cUCyXO9bxz31DuGjzfSYuXYwhwiA2hR/z+Ihk2t1aWGMO zJVvXCD+TT9s0OVCcZ3CWjriRpjtgnaQN2GbDs7py45xIX9lxGYn87Qr0QTkealaCNx2Yo U/nWy6tlfl2rJA99H3ThUMj7RgBxcZ/OB8yyeEvJLu7/IP50jcIPzLpclUuKH2UlKjRW0b TfKqi7cu5gecPyklCnw5SXtUT0oaA1A00e0ycfG7hM2joSQkfBKZzBOcCIpqKDAAQLk2WG q5jHtZ3FRwgfjZiUNp4uQXy280O6RuB+4kwO8lDwM5gY3HSzaq0xpdRfB2fbLw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4hlHdd3Wqbzm6q for ; Wed, 16 Sep 2026 12:05:25 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 216e2 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Wed, 16 Sep 2026 12:05:25 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Alexander Ziaee Subject: git: c6793d2e503f - stable/15 - udbp.4: Canonicalize SYNOPSIS, structure, SPDX List-Id: Commits to the stable branches of the FreeBSD src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-branches List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-branches@freebsd.org Sender: owner-dev-commits-src-branches@FreeBSD.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: ziaee X-Git-Repository: src X-Git-Refname: refs/heads/stable/15 X-Git-Reftype: branch X-Git-Commit: c6793d2e503fb0a0c7431118cec25345a3426bbf Auto-Submitted: auto-generated Date: Wed, 16 Sep 2026 12:05:25 +0000 Message-Id: <6aaa8605.216e2.4109acd9@gitrepo.freebsd.org> The branch stable/15 has been updated by ziaee: URL: https://cgit.FreeBSD.org/src/commit/?id=c6793d2e503fb0a0c7431118cec25345a3426bbf commit c6793d2e503fb0a0c7431118cec25345a3426bbf Author: Alexander Ziaee AuthorDate: 2026-09-13 15:41:51 +0000 Commit: Alexander Ziaee CommitDate: 2026-09-16 12:03:54 +0000 udbp.4: Canonicalize SYNOPSIS, structure, SPDX Event: EuroBSDcon 2026 MFC after: 3 days (cherry picked from commit bba2aebcebc1d46b15e1b6d86c041186dc8d49f0) --- share/man/man4/udbp.4 | 94 ++++++++++++++++++--------------------------------- 1 file changed, 33 insertions(+), 61 deletions(-) diff --git a/share/man/man4/udbp.4 b/share/man/man4/udbp.4 index f6ec43ae8b2d..53283ac5b531 100644 --- a/share/man/man4/udbp.4 +++ b/share/man/man4/udbp.4 @@ -1,3 +1,6 @@ +.\" +.\" SPDX-License-Identifier: BSD-2-Clause +.\" .\" Copyright (c) 1999 .\" Nick Hibma . All rights reserved. .\" @@ -22,26 +25,20 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd October 20, 2017 +.Dd September 13, 2026 .Dt UDBP 4 .Os .Sh NAME .Nm udbp .Nd USB Double Bulk Pipe driver .Sh SYNOPSIS -To compile this driver into the kernel, -place the following line in your -kernel configuration file: -.Bd -ragged -offset indent -.Cd "device udbp" -.Ed +.Cd device netgraph +.Cd device udbp .Pp -Alternatively, to load the driver as a -module at boot time, place the following line in +In .Xr loader.conf 5 : -.Bd -literal -offset indent -udbp_load="YES" -.Ed +.Cd netgraph_load="YES" +.Cd udbp_load="YES" .Sh DESCRIPTION The .Nm @@ -55,56 +52,30 @@ is listed in the .Sx SEE ALSO section below. .Pp -.\" XXX The description of how to add netgraph to the kernel -.\" is out of place here. It should be limited to the -.\" netgraph(4) manpage only. However, that page does -.\" not yet give instructions for kldload(8) for the -.\" clueless. Working on it -- sheldonh It requires .Xr netgraph 4 to be available. -This can be done either by adding -.Cd "options NETGRAPH" -to your kernel configuration file, or alternatively loading -.Xr netgraph 4 -as a module, either from -.Pa /boot/loader.conf -or from the command line, before the -.Nm -module. .Sh EXAMPLES -.Dl options NETGRAPH -.Dl device udbp -.Pp -Add the -.Nm -driver to the kernel. -.Pp -.Dl kldload netgraph -.Dl kldload udbp -.Pp -Load the -.Xr netgraph 4 -module and then the +Create a new Ethernet network interface node +and connect its ether hook to the data hook of the .Nm -driver. +driver: .Pp .Dl ngctl mkpeer udbp0: eiface data ether .Dl ifconfig ngeth0 ether aa:dd:xx:xx:xx .Dl ifconfig ngeth0 inet 169.254.x.x/16 .Pp -Create a new Ethernet network interface node -and connect its ether hook to the data hook of the -.Nm -driver. -.Pp -This enables FreeBSD to communicate with a Linux peer (e.g. using the +This enables +.Fx +to communicate with a Linux peer (e.g. using the .Sy plusb driver). The Linux node should be configured to prefer link-local IPv4 addresses (e.g. using Network Manager in Debian and Red Hat derived distributions). .Pp -Whilst both FreeBSD and Linux are able to interoperate by +Whilst both +.Fx +and Linux are able to interoperate by loosely following CDC EEM 1.0 in their behaviour, neither implementation has been expressly designed to follow its specification. .Sh SEE ALSO @@ -128,25 +99,11 @@ has been expressly designed to follow its specification. .%I Ghisler Software GmbH. .%U https://www.ghisler.com/cables/index.htm .Re -.Sh CAVEATS -The point-to-point nature and additional latency of USB host-host links -makes them unsuitable as a "drop-in" replacement for an Ethernet LAN; -for a USB 3.0 SuperSpeed cable, latency is comparable to 100BaseTX Ethernet -(but often worse), with throughput comparable to 2.5GBASE-T. -.Pp -However, their energy efficiency makes them attractive for embedded applications. -A Plugable PL27A1 cable claims 24mA of USB3 bus power, -as compared to 150mA for a typical USB 3.0 to Gigabit Ethernet interface. .Sh HISTORY The .Nm driver first appeared in .Fx 5.0 . -.Sh BUGS -The -.Nm -driver does not support the special packets described in section 5.1 -of the CDC EEM specification. .Sh AUTHORS .An -nosplit The @@ -161,3 +118,18 @@ This manual page was written by .An Nick Hibma Aq Mt n_hibma@FreeBSD.org and updated by .An Bruce Simpson Aq Mt bms@FreeBSD.org . +.Sh CAVEATS +The point-to-point nature and additional latency of USB host-host links +makes them unsuitable as a "drop-in" replacement for an Ethernet LAN; +for a USB 3.0 SuperSpeed cable, latency is comparable to 100BaseTX Ethernet +(but often worse), with throughput comparable to 2.5GBASE-T. +.Pp +However, +their energy efficiency makes them attractive for embedded applications. +A Plugable PL27A1 cable claims 24mA of USB3 bus power, +as compared to 150mA for a typical USB 3.0 to Gigabit Ethernet interface. +.Sh BUGS +The +.Nm +driver does not support the special packets described in section 5.1 +of the CDC EEM specification.