From nobody Sun Apr 20 19:30:56 2025 X-Original-To: dev-commits-src-main@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 4Zgdrw44Kgz5tXWN; Sun, 20 Apr 2025 19:30:56 +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 "R10" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Zgdrw3J5kz3ZQF; Sun, 20 Apr 2025 19:30:56 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1745177456; 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=Ywg3NFfkxju2mVfQ75lv8Z6WOqzNZok72f8jy3Gjtq0=; b=ZpoMT68HnvOpwDkFe9apDILZkDVvDLDkR94ARkEhik9cLqNJCo23XTqaIkIwrwK6jnkTso O6nPlnIg/ANp4wHyDMm2Pc5FzU3EN0ju0KPiijMgtbpvFPlwJO1EJ2kZNb4HBFbSeW5dif SFwEDFZIT4ydBIbeUX1SoLtbRkrFSasgzCU8pNq92yi2Lq68BoDueDg+K9MaZZ/UUIXr5P aKUEkEGKOGO8rWMNw0Do5x/2he+Wk7WlwAMtkcZN5IRajpVyFtDz3q/b1ZNugmapswji+0 aASWbFkHSfXMx9Ld0Cln/KgkpBPEcxT5CX7ghWO/SBCsI/qCybw+4fnRuJ5jOw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1745177456; a=rsa-sha256; cv=none; b=RXnK+a2xZ0kOxGgZggwCv4hRUMzbw5O/0SgKInhwlq8X++GzsTjaINfp5scF8JBii+VzaJ lhnhH0nTNtPneuK7CuyCRigfOufZetafLVxoEaf6uRPh+kt+S4RFW2+3BrrzId1YjeThjh Kb/WysPiMH/qGgGmWivustXKAOK4QLmxeKN+J2OeyXCRn8QOw7Qdqw52/DmLyiwYKj/Yc6 TH7aKxoFaX7W506+YQhxPXWxbAKKhauDl5IhwA5OzbMoe027LMRNGNkgGj57xDbkOHi+NB BHR9Q5FSnhkXnQRKnOdnYTQ1UZh6YO1UPdG9nNtxj/S1i3Y35jkmD/1Geq2UzA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1745177456; 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=Ywg3NFfkxju2mVfQ75lv8Z6WOqzNZok72f8jy3Gjtq0=; b=kqxWHJ0QtLdzoWD6gvqRWI4WzPljMup4934Yycj+eOmVQAI/AsT7evMetNDbwPP1ZZPRma VL/1t7KTvRaOBY4khGQsNfP6YWox/EmeMeSLZlOUpfvnFUZk6k7opJVMdrFhtALR5zlFvg c0w/jpvAyVn7ZJSphu0vTH6JDUL6XzEX6YTPzAPE40S68DaXJd1K+WnNO5kGTW6w087RfV fYHd/8jG5P0uaAS1GalfKHFhAzSWFgNpkSiBhfW4q30eO9VRi+Bdcd4wE1CZAkkz30Wyd0 OlarakyxQC9XjxB1XA16+T2KxdWRy+cA2SdW7wJMTc+Jjul84dLmo52+RlUUIA== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4Zgdrw2kmmz2Ty; Sun, 20 Apr 2025 19:30:56 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 53KJUubo034649; Sun, 20 Apr 2025 19:30:56 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 53KJUuGO034646; Sun, 20 Apr 2025 19:30:56 GMT (envelope-from git) Date: Sun, 20 Apr 2025 19:30:56 GMT Message-Id: <202504201930.53KJUuGO034646@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Warner Losh Subject: git: 76ed6f2db316 - main - ure.4: add a HARDWARE section + add RTL8156BG as a compatible controller List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: imp X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 76ed6f2db316bf2240d36d3c92316da4d1e5b174 Auto-Submitted: auto-generated The branch main has been updated by imp: URL: https://cgit.FreeBSD.org/src/commit/?id=76ed6f2db316bf2240d36d3c92316da4d1e5b174 commit 76ed6f2db316bf2240d36d3c92316da4d1e5b174 Author: Kenneth Raplee AuthorDate: 2025-04-08 18:30:46 +0000 Commit: Warner Losh CommitDate: 2025-04-20 19:28:32 +0000 ure.4: add a HARDWARE section + add RTL8156BG as a compatible controller While here, rename all instances of "RealTek" to "Realtek" for authenticity. Reviewed by: imp, lwshu, zaiee Pull Request: https://github.com/freebsd/freebsd-src/pull/1649 --- share/man/man4/ure.4 | 30 ++++++++++++++++-------------- 1 file changed, 16 insertions(+), 14 deletions(-) diff --git a/share/man/man4/ure.4 b/share/man/man4/ure.4 index f5452fa8463b..0d14a20f5f44 100644 --- a/share/man/man4/ure.4 +++ b/share/man/man4/ure.4 @@ -25,12 +25,12 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd September 3, 2024 +.Dd April 8, 2025 .Dt URE 4 .Os .Sh NAME .Nm ure -.Nd RealTek RTL8152/RTL8153/RTL8156 USB Ethernet driver +.Nd Realtek RTL8152/RTL8153/RTL8156 USB Ethernet driver .Sh SYNOPSIS To compile this driver into the kernel, place the following lines in your @@ -53,16 +53,7 @@ if_ure_load="YES" .Sh DESCRIPTION The .Nm -driver provides support for USB Ethernet adapters based on the RealTek -RTL8152, RTL8153/RTL8153B, and RTL8156/RTL8156B USB Ethernet controllers, -as well as USB Ethernet PHYs provided by -.Xr rgephy 4 . -.Pp -NICs based on the RTL8152 are capable of 10 and 100Mbps. -NICs based on the RTL8153 or provided by -.Xr rgephy 4 -are capable of 10, 100, and 1000Mbps. -NICs based on the RTL8156 are capable of 10, 100, 1000, and 2500Mbps operation. +driver supports the Realtek USB Ethernet Controller family. .Pp The .Nm @@ -94,12 +85,12 @@ or modes. .It Cm 1000baseTX Set 1000baseTX (Gigabit Ethernet) operation over twisted pair. -The RealTek gigE chips support 1000Mbps in +The Realtek gigE chips support 1000Mbps in .Cm full-duplex mode only. .It Cm 2500base-T Set 2500Base-T operation over twisted pair. -The RealTek 8156/8156B chips support 2500Mbps in +The Realtek 8156/8156B chips support 2500Mbps in .Cm full-duplex mode only. .El @@ -116,6 +107,17 @@ Force half-duplex operation. .Pp For more information on configuring this device, see .Xr ifconfig 8 . +.Sh HARDWARE +The +.Nm +driver supports the following USB Ethernet controllers: +.Bl -column "Realtek RTL8168/8169/8110/8211 via rgephy(4)" "10, 100, 1000, and 2500" +.It Model: Ta Speed (Mbps): +.It Realtek RTL8156/RTL8156B/RTL8156BG Ta 10, 100, 1000, and 2500 +.It Realtek RTL8153/RTL8153B Ta 10, 100, and 1000 +.It Realtek RTL8152 Ta 10 and 100 +.It Realtek RTL8168/8169/8110/8211 via rgephy(4) Ta 10, 100, and 1000 +.El .Sh DIAGNOSTICS .Bl -diag .It "ure%d: watchdog timeout"