if_rue (4)

Leading comments

Copyright (c) 2001-2003, Shunsuke Akiyama <akiyama@FreeBSD.org>.
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
   notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
   notice, this list of conditions and the following disclaimer in ...

(The comments found at the beginning of the groff file "man4/if_rue.4freebsd".)

NAME

rue - RealTek RTL8150 USB to Fast Ethernet controller 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 rue

Alternatively, to load the driver as a module at boot time, place the following line in loader.conf5:

if_rue_load="YES"

DESCRIPTION

The ifconfig driver provides support for USB Ethernet adapters based on the RealTek RTL8150 USB to Fast Ethernet controller chip.

The RTL8150 contains an integrated Fast Ethernet MAC, which supports both 10 and 100Mbps speeds in either full or half duplex. Although designed to interface with 100Mbps peripheral, the existing USB standard specifies a maximum transfer speed of 12Mbps. Users should therefore not expect to actually achieve 100Mbps speeds with this device.

The ifconfig 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.

The ifconfig driver supports the following media options:

full-duplex

Force full duplex operation.

half-duplex

Force half duplex operation.

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

HARDWARE

The ifconfig driver supports RealTek RTL8150 based USB Ethernet adapters including:

• Buffalo (Melco Inc.) LUA-KTX
• Green House GH-USB100B
• LinkSys USB100M
• Billionton 10/100 FastEthernet USBKR2

DIAGNOSTICS

"rue%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.

"rue%d: rx list init failed"

The driver failed to allocate an mbuf for the transmitter ring.

"rue%d: no memory for rx list"

The driver failed to allocate an mbuf for the receiver ring.

SEE ALSO

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

"RealTek RTL8150 data sheet"

HISTORY

The ifconfig device driver first appeared in Fx 5.1 .

AUTHORS

The ifconfig driver was written by An Shunsuke Akiyama Aq akiyama@FreeBSD.org .