Net.ether8003

WD/SMC 8003 Ethernet network driver (QNX)

Syntax:

Net.ether8003 [options] &

Options:

-8

Force 8-bit operation on 16-bit cards to reduce memory conflicts.

-f tx_forget_time

After a driver-level NACK is received from a remote node, Net.ether8003 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 Net.ether8003 stops throttling its output. -f allows you to change the default 10 seconds above.

-h hang_ticks

Specify the number of 50ms ticks to wait until the driver concludes that the chip is hung and resets it. Default: 10 (500ms).

-i irq

Use the specified interrupt line (IRQ). This option overrides automatic IRQ detection, and should rarely be used.

-l log_net_id

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

-m mem

Use the specified memory segment (hexadecimal; no leading 0x). This option overrides automatic RAM detection, and should rarely be used.

-M

Enable reception of multicast packets.

-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 given base I/O port address, specified as a hexadecimal number without a leading 0x. This option overrides the automatic I/O port detection.

-P

Run promiscuously:buffer every packet, whether or not it's destined for this node.

This option may be used in conjunction with netsniff to monitor other traffic on the network.

-r media_rate

Advertise the specified bit-transmission rate. The default is 10000000. This information is used by the Network Manager (Net) only when multiple drivers are running.

-s ram_size

Use the specified length (given in Kbytes) for the shared RAM segment on the card. This option overrides auto-detect, and should rarely be needed.

-S ps2_slot

Specify PS/2 slot when using multiple microchannel cards.

-t tx_retry_ticks

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

-v

Be verbose; print out hardware info on the console when starting up.

Description:

The Net.ether8003 network driver communicates directly with a WD/SMC 8003, 8013, 8416 Elite or Ultra series Ethernet network card. It provides the Network Manager with reliable data transfer over an Ethernet network.

By default, Net.ether8003 detects all hardware parameters automatically. However, you can specify any or all of these parameters by using the options described above.

Before installing your card, you should read the technote contained in the /etc/readme/technotes/Net.ether8003 file. If you install multiple Ethernet cards, you must specify a unique logical network ID (-l option) for every driver. On an ISA Bus computer, you must also specify a unique base I/O port (-p option) for every driver.

Examples:

Use automatic detection of all parameters for a single WD/SMC 8003, 8013, Elite or Ultra card:

    Net.ether8003 &

Specify I/O port 0x220:

    Net.ether8003 -p 220 &

One card is using I/O port 0x240 and logical network ID 1; the other is using I/O port 0x300 and logical network ID 2. Use automatic memory and IRQ detection for both:

    Net.ether8003 -p 240 -l 1 &
    Net.ether8003 -p 300 -l 2 &

Files:

Net.ether8003 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.

Signals:

The Net.ether8003 driver ignores SIGPWR.

Exit status:

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

0

Net.ether8003 has shut down successfully and cleanly deregistered from Net.

>0

An error occurred during initialization.

See also:

Net, Net.*, netinfo

Installation & Configuration