[Previous] [Contents] [Next]

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.

Description:

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.

See also:

Net, Net.*, netinfo

Installation & Configuration


[Previous] [Contents] [Next]