From nobody Thu Nov 19 07:57:48 2026 X-Original-To: dev-commits-src-all@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 4jVW6N1wSMz722jj for ; Thu, 19 Nov 2026 07:57:48 +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) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 4jVW6N19bFz4V0s for ; Thu, 19 Nov 2026 07:57:48 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1795075068; 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=dCPA+2ddCbIQZxuIXUb9Tiw46m9FcwcNHUQOAA5op+4=; b=vHgxZflGsXQDaipBsEJwIvx/+D7s7oFWQAC60/0iCzPrAbId4GWqbirSVabSR4PFPLggA8 r8yLmIC8buEForyHkb/PG1E+q9ShulcS8MhTxPK7medNEfUO/Y+m2IshQ8bRWpxOiwiNdG 7FP6BqTiBNv2wy+h6S4B8f5te4uFQUPj5XLS9cUO6Dn4WVf3YcozcOygPr7B+rFkyrvYKw fF6+nXkDC/O5zWQcXRmvkVhVQfMk5xSp0KYHmqr99AtTdNwXMGZt6DfSlaYPzZQqluFVpj y8eObhQHtmFdvMk5IFZ0PRtO8+0zHjZ5M6e4xOwV3JhXecg93C32rws+5cSTBA== ARC-Seal: i=1; a=rsa-sha256; d=freebsd.org; s=dkim; cv=none; t=1795075068; b=ApGE5h48Ot4WDm3x4dmskNsVAB31x7dI43pw59cw/2pVls1vs4BOGpE+s0ZWHt6Y/bmW8O GmS9lSJeO2TYRpeRhBaSehD4/g3kVV4DcUrbam6rAC3nMq8BDqWaXnW0XIvnLeLJlv9Ueq uugYmdb8K9dctBZ6eLdAVKJaNy86v5OLWiz2Quz+u1PGZlqwtR3n+xltsfAuPV81HvK9Ok hFAXBmBMkLQets1rNwkv3igX2+T3JuL6/JcMHnFmOjzs8DkKrmx1qSw06+nwz56fxQjDLQ HruO9thIlJktCDoHE0DYVkQLX++/cUgua1KYu3A9rxgyjijCIWRVZc8RdwlTQQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1795075068; 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=dCPA+2ddCbIQZxuIXUb9Tiw46m9FcwcNHUQOAA5op+4=; b=QgupiyxkCnpty0G16efzYPys7bvXeUKJP774UNDSrklyzw1p1OMzREW35i6z6vkfuuV/cS T+KgWLyg/uT6DWc8BjqE5pctNJbvWUZX1opwoKLaii1IdlWTsT6ZmMH08Gqvfdm8fmJFXj gLwyWuSgCLQ+Dzc2Zgz+YYGAoheB5ktC1GELpsGwf35FiA3oXpJeD/XvbPFxC8+DD+drA4 76AmKFF6Z1X+tBwaBxYFb6alX4M39yzn7ZEqdl5NgJTWRFhoY/cpdrWC3Z9Dk/YSZ2SmGY AcLR9aP81G56tltsj/2YARYEUDKo++rwx9jOOfoVxA+Ob3B0N32i2xq3oj/q+g== 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 4jVW6N0L8LzrXn for ; Thu, 19 Nov 2026 07:57:48 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 2503f by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Thu, 19 Nov 2026 07:57:48 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Alexander Ziaee Subject: git: 000c5ecc13db - main - rge.4: Polish List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all X-BeenThere: dev-commits-src-all@freebsd.org List-Id: Commit messages for all branches of the src repository 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/main X-Git-Reftype: branch X-Git-Commit: 000c5ecc13db3e2d2d4e5192830b4e0300d011b7 Auto-Submitted: auto-generated Date: Thu, 19 Nov 2026 07:57:48 +0000 Message-Id: <6afeabfc.2503f.6ca15950@gitrepo.freebsd.org> The branch main has been updated by ziaee: URL: https://cgit.FreeBSD.org/src/commit/?id=000c5ecc13db3e2d2d4e5192830b4e0300d011b7 commit 000c5ecc13db3e2d2d4e5192830b4e0300d011b7 Author: Alexander Ziaee AuthorDate: 2026-11-18 21:53:21 +0000 Commit: Alexander Ziaee CommitDate: 2026-11-19 07:54:25 +0000 rge.4: Polish + trim document description to fit on one line + canonicalize synopsis + move supported speeds to hardware with consistency with latest drivers + organize hardware in descending capability for marketing purposes + fix cursed line wrapping + make link to realtek.com clickable + first shipped in 15.2 actually + fix authors section line break and linter warning Reviewed by: adrian MFC after: immediately because this is shipping in 15.2 Differential Revision: https://reviews.freebsd.org/D61704 --- share/man/man4/rge.4 | 80 ++++++++++++++++++++++++---------------------------- 1 file changed, 37 insertions(+), 43 deletions(-) diff --git a/share/man/man4/rge.4 b/share/man/man4/rge.4 index 12ef0c9953a3..56d4107215e0 100644 --- a/share/man/man4/rge.4 +++ b/share/man/man4/rge.4 @@ -3,49 +3,40 @@ .\" .\" SPDX-License-Identifier: BSD-2-Clause .\" -.Dd May 11, 2026 +.Dd November 18, 2026 .Dt RGE 4 .Os .Sh NAME .Nm rge -.Nd RealTek RTL8125/RTL8126/RTL8127/Killer E3000 PCIe Ethernet adapter driver +.Nd RealTek RTL8125/RTL8126/RTL8127/Killer E3000 PCIe Ethernet driver .Sh SYNOPSIS -To compile this driver into the kernel, -place the following lines in your -kernel configuration file: -.Bd -ragged -offset indent -.Cd "device rge" -.Ed +.Cd device rge .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 -if_rge_load="YES" -.Ed +.Cd dev.rge.%d.disable_aspm +.Cd if_rge_load="YES" +.Pp +In +.Xr loader.conf 5 +or +.Xr sysctl.conf 5 : +.Cd dev.rge.%d.debug +.Cd dev.rge.%d.rx_process_limit .Sh DESCRIPTION The .Nm -driver provides support for various NICs based on the RealTek RTL8125, -RTL8126 and RTL8127 PCIe Ethernet controllers. -.Pp -All of the NICs supported by this driver support 10, 100 and 1000Mbit -over CAT5 cable. -NICs based on the RTL8125 additionally support 2.5Gbit over CAT6 cable. -NICs based on the RTL8126 additionally support 2.5Gbit and 5Gbit over CAT6 -cable. -NICs based on the RTL8127 additionally support 2.5Gbit, 5Gbit and 10Gbit -over CAT6 cable. +driver provides support for NICs based on the +RealTek RTL8125, RTL8126 and RTL8127 PCIe Ethernet controllers. .Pp All NICs supported by the .Nm driver have TCP/IP checksum offload, hardware VLAN tagging/insertion features, Wake On Lan (WOL), and use a descriptor-based DMA mechanism. -They are also -capable of TCP large send (TCP segmentation offload). +They are also capable of TCP large send (TCP segmentation offload). .Pp -The RTL8125, RTL8126 and RTL8127 devices are single-chip solutions combining -both a MAC and PHY. +The RTL8125, RTL8126 and RTL8127 devices are single-chip solutions +combining both a MAC and PHY. The .Nm driver manages the PHY directly rather than using the @@ -53,8 +44,8 @@ driver manages the PHY directly rather than using the interface. Standalone cards are available in 1x PCIe models. .Pp -The RTL8125, RTL8126 and RTL8127 also support jumbo frames, which can be -configured via the interface MTU setting. +The RTL8125, RTL8126 and RTL8127 also support jumbo frames, +which can be configured via the interface MTU setting. The MTU is limited to 9126. Selecting an MTU larger than 1500 bytes with the .Xr ifconfig 8 @@ -130,15 +121,15 @@ driver supports the following PCIe Ethernet adapters: .Pp .Bl -bullet -compact .It -RealTek RTL8125 (up to 2.5 Gbps) +RealTek RTL8127 (10Gb/5Gb/2.5Gb/1Gb/100Mb/10Mb) .It -RealTek RTL8126 (up to 5 Gbps) +RealTek RTL8126 (5Gb/2.5Gb/1Gb/100Mb/10Mb) .It -RealTek RTL8127 (up to 10 Gbps) +RealTek RTL8125 (2.5Gb/1Gb/100Mb/10Mb) .It -Killer E3000 (up to 2.5 Gbps) +Killer E5000 (5Gb/2.5Gb/1Gb/100Mb/10Mb) .It -Killer E5000 (up to 5 Gbps) +Killer E3000 (2.5Gb/1Gb/100Mb/10Mb) .El .Sh SYSCTL VARIABLES The following variables are available as both @@ -146,9 +137,10 @@ The following variables are available as both variables and .Xr loader 8 tunables: -.Bl -tag -width "xxxxxx" +.Bl -tag -width indent .It Va dev.rge.%d.debug -Configure runtime debug output. This is a 32 bit bitmask. +Configure runtime debug output. +This is a 32 bit bitmask. .It Va dev.rge.%d.rx_process_limit Maximum number of RX packets to process per interrupt. The default value is 16. @@ -167,8 +159,8 @@ and requires a reboot to take effect. .Sh DIAGNOSTICS .Bl -diag .It "rge%d: watchdog timeout" -The device has stopped responding to the network, or there is a problem with -the network connection (cable). +The device has stopped responding to the network, +or there is a problem with the network connection (cable). .El .Sh SEE ALSO .Xr altq 4 , @@ -180,18 +172,20 @@ the network connection (cable). .Xr re 4 , .Xr vlan 4 , .Xr ifconfig 8 -.Rs -.%U https://www.realtek.com/ -.Re +.Pp +.Lk https://www.realtek.com/ .Sh HISTORY The .Nm device driver first appeared in -.Fx 16.0 . +.Fx 15.2 . .Sh AUTHORS +.An -nosplit The .Nm driver was written by .An Kevin Lo Aq Mt kevlo@openbsd.org -and ported to FreeBSD by +and ported to +.Fx +by .An Adrian Chadd Aq Mt adrian@FreeBSD.org .