devn-rtl.so

Driver for Realtek 8139 PCI cards

Syntax:

io-pkt-variant -d rtl [option[,option ...]] ...

where variant is one of v4, v4-hc, or v6-hc.

Runs on:

Neutrino

Options:

---

Use commas, not spaces, to separate the options.

---

connector=0|1|2|3

Network cable connector type:

0

BNC

1

UTP

2

AUI

3

FIBER

deviceindex=0xXXXX

PCI index of the controller. Only attach to device with this PCI index.

did=0xXXXX

The PCI device ID. The default is automatically detected on supported hardware.

dma=num

The DMA channel.

duplex=0|1

Half (0) or full (1) duplex mode. The default is automatically detected on supported hardware. If you specify duplex, specify speed as well; if duplex alone is specified, it is ignored and both speed and duplex are auto-negotiated.

iftype=num

Interface type (from <net/if_types.h>). The default is IFT_ETHER.

iorange=0xXXXXXXXX

The I/O base address. The 0xXXXXXXXX parameter must be a hex address (e.g. 0x320). The default is automatically detected on supported hardware.

irq=num

IRQ of the interface. The default is automatically detected on supported hardware.

lan=num

LAN number. The default is 0.

mac=XXXXXXXXXXXX

MAC address of controller. The default is automatically detected on supported hardware.

media=num

Media type (from <hw/nicinfo.h>). The default is NIC_MEDIA_802_3.

memrange=0xXXXXXXXX

Register base physical memory address.

mmap

Use memory-mapped registers. The default is IO mapped.

mru=num

Maximum receive unit. The default is 1514.

mtu=X

Maximum transmission unit. The default (1514) is automatically detected on supported hardware.

nomulticast

Disables the driver from sending or receiving multicast packets. By default, multicast is enabled.

pci=0xXXXX

PCI index of the controller. The default is automatically detected on supported hardware.

phy=num

Address of the connected PHY device.

priority=N

Priority of the driver-event thread. The default is 21.

probe_phy=0|1

Select whether or not to probe the PHY at regular intervals. For the default value of 0, the PHY is polled only at regular intervals when the interface is down or doesn't receive any packets over the polling interval. If you specify 1, the PHY is always probed at regular intervals to see if the duplex and/or speed of the connection has changed.

promiscuous

Enable promiscuous mode. The default is off.

receive=num

Set the number of receive descriptors. The default is 30.

speed=10|100

Media data rate (10Mbit or 100Mbit operation). The default is automatically detected on supported hardware. If you specify speed, specify duplex as well; if speed alone is specified, the specified speed will be correctly set, but duplex will default to half (0).

uptype=name

Interface name. The default is “en”.

verbose
verbose=num

Be verbose. Specify num for more verbosity (num can be 1-4, the higher the number, the more detailed the output). The default is 0. The output goes to slogger; invoke sloginfo to view it.

vid=0xXXXX

The PCI vendor ID of the controller. The default is automatically detected on supported hardware.

Description:

The devn-rtl.so driver controls Realtek 8139 PCI cards. This is a legacy io-net driver; its interface names are in the form enX, where X is an integer.

---

If the device enumerators (see enum-devices) don't recognize your device, try explicitly specifying the device ID with the did option when you start the driver.

---

Some devices support hardware checksums, although some might do so in only one direction; to determine if your device does, type:

ifconfig enX

and look for the following in the list of supported options:

• ip4csum, ip4csum-rx, ip4csum-tx
• tcp4csum, tcp4csum-rx, tcp4csum-tx
• tcp6csum, tcp6csum-rx, tcp6csum-tx
• udp4csum, udp4csum-rx, udp4csum-tx
• udp6csum, udp6csum-rx, udp6csum-tx

You can then use ifconfig to enable or disable whichever of these options your device supports.

Examples:

Start io-pkt-v4-hc using the Realtek 8139 PCI card driver:

io-pkt-v4-hc -d rtl
ifconfig en0 10.1.0.184

Files:

/dev/io-net

The directory where, by default, drivers and protocol modules add entries. For more information, see the documentation for io-pkt*.

See also:

devn-*, devnp-*, ifconfig, io-pkt*