ure(4)

ure4

Realtek rtl8152/rtl8153/rtl8156 usb ethernet driver

Usage

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"

Overview

The ure driver supports the Realtek USB Ethernet Controller family.

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.

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:

Model:Speed (Mbps):
Realtek RTL8156/RTL8156B/RTL8156BG10, 100, 1000, and 2500
Realtek RTL8153/RTL8153B10, 100, and 1000
Realtek RTL815210 and 100
Realtek RTL8168/8169/8110/8211 via rgephy(4)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.

Releases

25 releases since FreeBSD 11.0-RELEASE; the text changed 15 times.

  1. 11.0
  2. 11.1
  3. 11.2
  4. 11.3
  5. 11.4
  6. 12.0
  7. 12.1
  8. 12.2
  9. 12.3
  10. 12.4
  11. 13.0–13.2
  12. 13.3–13.4
  13. 13.5
  14. 14.0–14.1
  15. 14.2
  16. 14.3–16.0

Authors

The ure driver was written by Kevin Lo ⟨[email protected]⟩.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.