devn-tulip.so

Driver for DEC 21x4x (Tulip) compatible Ethernet adapters

Syntax:

io-pkt-variant -d tulip [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

The default is automatically detected on supported hardware.

did=0xXXXX

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

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.

mac=XXXXXXXXXXXX

MAC address of the controller. If no SROM is available, the MAC will default to 00:00:00:00:00:00.

nomulticast

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

nosrom

Informs the driver that there is no valid connected SROM: the driver will default to using media independent interface (MII), physical media interface (PHY) auto-negotiation. (A valid MAC address must be supplied on the command line.)

pci=0xXXXX

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

phyaddr=num

Override the MII routines and use the specified PHY address.

pktque=num

Limit the number of packets in the queue. The default is 100.

priority=num

Priority of the driver thread. The default is 21.

promiscuous

Enable the driver to pass all data packets received, regardless of address. By default, promiscuous mode is disabled.

receive=num

Number of receive descriptors/buffers. The default is 64.

single

Use this option if you have multiple Tulip cards in your system and want to configure them differently. The single option tells the driver to stop after configuring the first Tulip card it finds. The order of the search can't be determined because it depends on the PCI server and PCI BIOS used. After the first card has been configured, when the driver is invoked again, it will find and configure the next card in order, and so on until all Tulip cards have been configured. The default is to enable all Tulip cards found.

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).

threshold=N

Amount of packet data that must be in TX FIFO before transmission is initiated. The range is 0-4. The default is 3. If you observe transmit underruns, set the number to 4.

transmit=num

Number of transmit descriptors/buffers. The default is 128.

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 output goes to slogger, invoke sloginfo to view.

vid=0xXXXX

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

Description:

The devn-tulip.so driver controls DEC 21x4x (Tulip) compatible Ethernet adapters. This is a legacy io-net driver; its interface names are in the form enX, where X is an integer.

---

When you start a single instance of the Tulip driver on a multiport board (using the pci= option), the board might not function unless this instance is on the first interface. On NICs with multiple interfaces sharing a single SROM, the first NIC is the only one that can read the SROM.

---

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-v6-hc using the Tulip driver:

io-pkt-v6-hc -d tulip
ifconfig en0 10.0.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*