BSD Ports

net/realtek-re-kmod 1102.01.1405500_2 FreeBSD

Kernel driver for Realtek PCIe Ethernet Controllers

System
FreeBSD
Repository
FreeBSD ports
Maintainer
[email protected]
Last update
Commit
245182c472
License
BSD4CLAUSE
Categories
net, kld
Package size
172.4 KiB, 823.4 KiB installed

Description

Realtek PCIe FE / GBE / 2.5G / 5G / 10G Ethernet Family Controller kernel driver.

This is the official driver from Realtek with a few patches to improve stability and performance. It can be loaded instead of the FreeBSD driver built into the GENERIC kernel if you experience issues with it (eg. watchdog timeouts), or your card is not supported.

Supported devices:

* 10G Gigabit Ethernet

  • RTL8127 / RTL8127AT / RTL8127ATF

* 5G Gigabit Ethernet

  • RTL8126

* 2.5G Gigabit Ethernet

  • RTL8125 / RTL8125B(G) / RTL8125D / RTL8125K
  • RTL8125BP / RTL8125CP

* 10/100/1000M Gigabit Ethernet

  • RTL8111B / RTL8111C / RTL8111D / RTL8111E / RTL8111F / RTL8111G / RTL8111H(S) / RTL8118A / RTL8119i / RTL8111L / RTL8111K / RTL8116AF
  • RTL8168B / RTL8168E / RTL8168G / RTL8168H
  • RTL8111DP / RTL8111EP(P)(V) / RTL8111FP

* 10/100M Fast Ethernet

  • RTL8101E / RTL8102E / RTL8103E / RTL8105E / RTL8106E / RTL8107E

See also: https://www.realtek.com/Download/List?cate_id=584

In the other systems

The newest version among them is 1102.01.1501503, as upstream numbers it.

SystemPortVersionVulnerabilitiesStatusMaintainerLast update
FreeBSDnet/realtek-re-kmod1102.01.1405500_2none known-[email protected]2026-09-24
MidnightBSDnet/realtek-re-kmod1100.00no data-[email protected]-
HardenedBSDnet/realtek-re-kmod1102.01.1501503_2 newestno data-[email protected]-
GhostBSDnet/realtek-re-kmod1102.01.1500068_1no data-[email protected]-
OPNsensenet/realtek-re-kmod1102.01.1403000no data-[email protected]-

Install

Binary package:

pkg install realtek-re-kmod

From the ports tree:

cd /usr/ports/net/realtek-re-kmod/ && make install clean

To depend on this port in another port's Makefile:

RUN_DEPENDS=	realtek-re-kmod>0:net/realtek-re-kmod

Packages

The version each package repository carries. “-” means the repository builds no package of it, “n/a” that there is no such repository.

Repositoryaarch64amd64armv6armv7i386
FreeBSD:14:latest1102.01.1404000_21102.01.1404000_2198.00-1102.01.1404000_2
FreeBSD:14:quarterly1102.01.1404000_21102.01.1404000_2n/a-1102.01.1404000_2
FreeBSD:15:latest1102.01.1501000_21102.01.1501000_2n/a-1100.00.1500063_1
FreeBSD:15:quarterly1102.01.1501000_21102.01.1501000_2n/an/an/a
FreeBSD:16:latest1102.01.1600026_21102.01.1600029_2n/an/an/a
FreeBSD:16:quarterlyn/an/an/an/an/a

Dependencies

The Makefile names none itself; they come from USES and USE_*.

The full lists below include those, and their dependencies in turn.

No port depends on this one.

Configuration

No options to configure.

USES
kmod tar:tgz uidfix
Service scripts
none

Message after installing

Add the following lines to your /boot/loader.conf
to override the built-in FreeBSD re(4) driver.

if_re_load="YES"
if_re_name="/boot/modules/if_re.ko"

By default, the size of allocated mbufs is enough
to receive the largest Ethernet frame supported
by the card.  If your memory is highly fragmented,
trying to allocate contiguous pages (more than
4096 bytes) may result in driver hangs.
For this reason the value is tunable at boot time,
e.g. if you don't need Jumbo frames you can lower
the memory requirements and avoid this issue with:

hw.re.max_rx_mbuf_sz="2048"

To enable Wake on LAN (WoL) support you might need
to set the following tunables:

hw.re.s5wol="1"
hw.re.s0_magic_packet="1"

By default the driver negotiates 802.3x flow
control with the link partner.  If a congested
peer throttles your transmit path with pause
frames (e.g. a 2.5GbE card behind a 1GbE switch),
you can disable flow control with:

hw.re.flow_control="0"

The driver programs the PCIe Max Read Request
Size for better transmit performance.  On Realtek
SoC platforms this can be disabled with:

hw.re.config_soc_lan="1"

Driver versions before 1102.01 could hang the
RTL8125 transmitter when sending small UDP
packets (e.g. IPv6 DNS queries).  This is fixed,
but if you still experience network hangs with
IPv6 enabled, you can disable the checksum
offloading by adding the following parameters to
the related ifconfig line in your /etc/rc.conf
file, and please report the issue:

-rxcsum -txcsum -rxcsum6 -txcsum6

Files

distinfo 1
FileSizeSHA256
alexdupre-rtl_bsd_drv-v1102.01-cea3599_GH0.tar.gz22705815bbb1f84cea49ca3872faa017195ecf371d29cd95b7c898234ce4dfbbd9af1e

Commit history 2

DateCommitCreditsLog message
245182c472 Alex Dupre net/realtek-re-kmod: fix output packet counter.
ccdb34c15c Alex Dupre net/realtek-re-kmod: update to latest version to fix a regression