URE(4)

💖 ure(4) — Realtek RTL8152/RTL8153/RTL8156 USB Ethernet driver 💖

✨ NAME ✨

ure — Realtek RTL8152/RTL8153/RTL8156 USB Ethernet driver. That's the whole vibe, bestie: it's the driver for these Realtek USB Ethernet controllers. 🦋

✨ SYNOPSIS ✨

Okay so there are two ways to get this driver in: compile it into the kernel, or load it as a module at boot. Both are valid, pick your fighter. 💅

To compile this driver into the kernel, place the following lines in your kernel configuration file:

device uhci
device ohci
device usb
device miibus
device uether
device ure

Alternatively, to load the driver as a module at boot time, place the following line in loader.conf(5):

if_ure_load="YES"

✨ DESCRIPTION ✨

The ure driver supports the Realtek USB Ethernet Controller family. No cap. 🌈

🎀 media types 🎀

The ure driver supports the following media types:

• autoselect — Enable auto selection of the media type and options. The user can manually override the auto selected mode by adding media options to the /etc/rc.conf file.
• 10baseT/UTP — Set 10Mbps operation. The mediaopt option can also be used to select either full-duplex or half-duplex modes.
• 100baseTX — Set 100Mbps (Fast Ethernet) operation. The mediaopt option can also be used to select either full-duplex or half-duplex modes.
• 1000baseTX — Set 1000baseTX (Gigabit Ethernet) operation over twisted pair. The Realtek gigE chips support 1000Mbps in full-duplex mode only.
• 2500base-T — Set 2500Base-T operation over twisted pair. The Realtek 8156/8156B chips support 2500Mbps in full-duplex mode only.

🎀 media options for 10/100 operation 🎀

The ure driver supports the following media options for 10/100 operation:

• full-duplex — Force full-duplex operation.
• half-duplex — Force half-duplex operation.

For more information on configuring this device, see ifconfig(8). 🫶

✨ HARDWARE ✨

The ure driver supports the following USB Ethernet controllers:

• Realtek RTL8156/RTL8156B/RTL8156BG — Speed (Mbps): 10, 100, 1000, and 2500.
• Realtek RTL8153/RTL8153B — Speed (Mbps): 10, 100, and 1000.
• Realtek RTL8152 — Speed (Mbps): 10 and 100.
• Realtek RTL8168/8169/8110/8211 via rgephy(4) — Speed (Mbps): 10, 100, and 1000.

✨ DIAGNOSTICS ✨

• ure%d: watchdog timeout — A packet was queued for transmission and a transmit command was issued, however the device failed to acknowledge the transmission before a timeout expired. And that's the dramatic part, bestie. 😭

✨ SEE ALSO ✨

Go read these when you want the full lore:

• arp(4)
• miibus(4)
• netintro(4)
• ng_ether(4)
• ifconfig(8)

✨ AUTHORS ✨

The ure driver was written by Kevin Lo <kevlo@FreeBSD.org>. 💜

---

💖 That's the tea, bestie — source/version: Debian, date: April 8, 2025, and the manual is URE(4). Periodt. 💖