Net.ether82595

Intel 82595 Ethernet network driver

Syntax:

Net.ether82595 [-A] [-B] [-f tx_forget_time]
               [-F] [-i irq]
               [-l log_net_id] [-M]
               [-n tx_num_retries] [-P]
               [-p io_port] [-r media_rate]
               [-R] [-s speed]
               [-t tx_retry_ticks] [-v] &

Options:

-a io_port

This option is no longer valid in QNX 4.25 and later. Use -p instead.

-A

Use the AUI port on the card. Disables auto selection.

-B

Use the BNC port on the card. Disables auto selection.

-f tx_forget_time

After a driver-level NACK is received from a remote node, Net.ether82595 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 3 seconds, after which the eternally optimistic Net.ether82595 stops throttling its output. The -f option allows you to change the default 3 seconds above.

-F

Force full-duplex operation of the card. The default is half-duplex.

-i irq

Program the card to use the specified hardware interrupt. This option overrides the default autodetect. If the autodetect does not work on an ISA card, you have a hardware conflict. This option should rarely be used.

-l log_net_id

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

-M

Program the NIC for multicast rx mode. All packets with multicast destination addresses will be buffered.

-n tx_num_retries

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

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

You may use this option in conjunction with netsniff to monitor other traffic on the network.

-p io_port

Use the given I/O port base, specified as a hexadecimal number without a leading 0x. This option overrides the default auto-detect, which uses the PCI BIOS to return a port address.

-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 network drivers are running.

-R

The card is Removable (PCMCIA). Setting this command line option will cause the driver to monitor the PCMCIA manager for removal of the card. If the card is removed, the driver will terminate.

-t tx_retry_ticks

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

-v

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

Description:

The Net.ether82595 network driver communicates with a Intel 82595 or compatible network adapter to provide the Network Manager with reliable data transfer over an Ethernet network.

Most of the time, you should not need to specify the I/O port or the hardware interrupt to Net.ether82595 -- it should autodetect these parameters.

Full-duplex operation can also be forced, using the -F command line option.

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

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

If you install more than one 82595 compatible PCI network card, you must specify the -p option on each invocation of Net.ether82595.

Examples:

Start the driver and let it autodetect the hardware:

    Net.ether82595 &

Start the driver on an 82595 compatible PCMCIA adapter, specifying the port and IRQ:

                                                                                
    Net.ether82595 -p340 -i5 -R &

Start two Net.ether82595 drivers for two adapters installed in one machine. One card is using I/O port 300h and IRQ 10 on logical network 1. The second card is using I/O port 340 and IRQ 12 on logical network 2.

    Net.ether82595 -p300            &
    Net.ether82595 -p340 -i12  -l2  &

Files:

Net.ether82595 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.ether82595 driver ignores SIGPWR.

Exit status:

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

0

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

>0

An error occurred during initialization.

See also:

Net, Net.*, netinfo, netmap

Installation & Configuration