URE(4)                 FreeBSD Kernel Interfaces Manual                 URE(4)

NAME

     ure - Realtek RTL8152/RTL8153/RTL8156 USB Ethernet driver

SYNOPSIS

     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.

     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/RTL8156BG              10, 100, 1000, and 2500
     Realtek RTL8153/RTL8153B                        10, 100, and 1000
     Realtek RTL8152                                 10 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.

SEE ALSO

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

AUTHORS

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

FreeBSD 15.1-STABLE-HBSD         April 8, 2025                          URE(4)