Net.ether21x4x

DEC 21040/21041/21140 Ethernet network driver (QNX)

Syntax:

Net.ether21x4x [options] &

Options:

-A

Use the AUI port instead of RJ-45.

-B

Use the BNC port instead of RJ-45.

-c chip

Specify the chipset used in the network card. May be one of 21040, 21041, or 21140. This option is needed only in the unlikely case that both -p io_port and -i irq are specified.

-C

Use the 21x4x's Ethernet capture effect resolution feature. Slightly changes the collision backoff algorithm. The default is normal Ethernet.

-f forget_time

After a driver-level NACK is received from a remote node, Net.ether21x4x will assume that because packets were dropped, throttling the transmit output on that connection would be a good idea. So, the output will be reduced to approximately 400K/sec for 10 seconds, after which the eternally optimistic Net.ether21x4x stops throttling its output. -f allows you to change the default 10 seconds above.

-F

Enable full duplex operation. Be sure you know what you are doing before you enable this. Default is normal Ethernet.

-i irq

Program the card to use the specified hardware interrupt. This option overrides the default autodetect, and should rarely be needed.

If you have more than one 21x4x-based card installed, you could specify -i and -p to each driver. A better idea is to use the -S option.

Note that if you use the -i option, you must also use the -p and -c options, to completely override the autodetect.

-K

Use UTP port in no-link-test mode. (Default is normal UTP)

-l log_net_id

("el") Connect to the specified logical network. The default is 1.

-M

Enable reception of multicast packets. The default is not to.

-n tx_num_retries

After failing to transmit to a remote node, retry transmission no more than this number of times. Default is 3.

-p io_port

Use the specifed I/O port base. This option overrides the default autodetect. The only time you should need to specify -p is if you have more than one 21x4x pci card installed and you cannot use the -S option.

If you have more than one 21x4x-based card installed, you could specify -p and -i to each driver. A better idea is to use the -S option.

Note that if you use the -p option, you must also use the -i and -c options, to completely override the autodetect.

-P

Program the NIC for promiscuous receive mode. All packets will be buffered, regardless of the packet's destination address. The default is non-promiscuous mode — receive only packets addressed to this card's address, or broadcast.

-r media_rate

Advertise the specified bit-transmission rate. The default is 10000000 or 100000000. This information is used by the Network Manager when multiple network drivers are running.

-S pci_slot

Have the driver look at this specific pci_slot for a 21x4x-based card. You should have to specify -S only if you have more than one 21x4x-based card installed. (e.g. -S0, -S1, -S2)

-t tx_retry_ticks

The number of 50 millisecond intervals between transmit retries. The default is 20.

-T xcvr_mode

Specify the data rate and network interface to be used (21140 only) as follows:

xcvr_mode	Data Rate	Network Interface
0	10 Mbit/sec	ENDEC (default)
1	10 Mbit/sec	MII
2	100 Mbit/sec	MII (generic)
3	100 Mbit/sec	MII (100Base-FX w/PCS)
4	100 Mbit/sec MII	(100Base-TX w/PCS)

The default is 0, normal 10 Mbit Ethernet. If you wish to use your 21140-based card in 100 Mbit mode, you will need to specify one of 2, 3 or 4.

Try 4 first. Note that if you specify 2, 3 or 4 the media_rate (above) is automatically bumped up to 100000000.

-v

Be verbose; print out hardware configuration info on the screen when starting up. Multiple -v options may be specified to make Net.ether21x4x increasingly verbose.

Examples:

One 21040 or 21041-based (10 Mbit) Ethernet card is installed:

    Net.ether21x4x &

One 21140-based (10 or 100 Mbit) Ethernet card is installed:

    Net.ether21x4x &

One card is in PCI slot 1, on logical network 1. The second card is in PCI slot 2, on logical network 2.

    Net.ether2100 -S 1        &
    Net.ether2100 -S 2  -l 2  &

Description:

The Net.ether21x4x network driver communicates directly with a PCI Ethernet network card, which uses either the DEC 21040, 21041, or 21140.

Net.ether21x4x provides the Network Manager with reliable data transfer over an Ethernet network.

Before installing your card, you should read the technote contained in the /etc/readme/technotes/Net.ether21x4x file.

If you install more than one network card, you must specify a unique network ID (-l option) to every network driver.

Exit status:

Net.ether21x4x terminates only upon encountering errors during initialization or opon getting a signal (i.e. being killed).

0: Net.ether21x4x has shut down successfully and cleanly deregistered from Net.
>0: An error occurred during initialization.

Files:

Net.ether21x4x closes its standard input, standard output, and standard error immediately after initialization.

Error messages are displayed via the qnx_display_*() functions, not through standard error.