`Net.ether509`

3Com 509 Ethernet network driver (QNX)

Syntax:

Net.ether509 [options] &

Options:

-f tx_forget_time: After a driver-level NACK is received from a remote node, Net.ether509 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.ether509 stops throttling its output. -f allows you to change the default 10 seconds above.
-i irq: Use this interrupt line (IRQ). The default is autodetect.
-l log_net_id: ("el") Connect to this logical network (default is 1).
-M: Program card to receive 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 this I/O port base, specified as a hexadecimal number without a leading 0x. You should need this option only when multiple 509 cards are installed.
-P: Run promiscuously: buffer every packet, whether or not it's destined for this node. (A node usually discards any packet not addressed to it.)
You may use this option in conjunction with netsniff to monitor other traffic on the network.
-r media_rate: Advertise this bit-transmission rate (default is 10000000). The Network Manager uses this information only when multiple network drivers are running.
-t tx_retry_ticks: Wait this many 50-millisecond intervals between transmit retries (default is 20).
-v: Be verbose: print out hardware info on the console when starting up.

The Net.ether509 network driver communicates directly with a 3Com 509 Etherlink III Ethernet network card. The driver provides the Network Manager (Net) with reliable data transfer over an Ethernet network.

By default, Net.ether509 automatically determines the I/O port base and the IRQ.

Before installing your card, note the following:

To install:	You should:
a 3Com 509 card	read the technote contained in the file `Net.ether509` in `/etc/readme/technotes`.
multiple network cards in one machine	specify a unique logical network ID (`-l` option) to every network driver
multiple 3Com 509 network cards in one machine	specify the `-p` option to every invocation of `Net.ether509`

Examples:

One 509 card is installed. Use automatic detection of I/O port and IRQ:

    Net.ether509 &

Support two cards -- one using IRQ 2 and an I/O port base of 0x220 on logical network 1, the other using IRQ 5 and an I/O port base of 0x300 on logical network 2:

    Net.ether509 -p 220 &
    Net.ether509 -p 300 -l 2 &

Files:

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

Exit status:

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

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