[Previous] [Contents] [Next]

Net.ether905

3Com 905 Ethernet network driver (QNX)

Syntax:

Net.ether905 [-d device_id] [-F] [-f tx_forget_time]
             [-I pci_index] [-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.
-d device_id
Start the driver on a specific device_id. For example, -d9055 would start the driver on a 905B card.
-f tx_forget_time
After a driver-level NACK is received from a remote node, Net.ether905 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.ether905 stops throttling its output. The -f option allows you to change the default 10 seconds above.
-F
Force full-duplex operation of the card. The default is half-duplex unless the PHY auto-negotiates full-duplex.
-I pci_index
Have the driver look at this specific PCI Index for a 905 compatible card. You should only have to specify -I if you have more than one 905 compatible card installed. (e.g. -I0, -I1, -I2)
-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. In earlier versions of QNX, the -p option was used to specify the PCI index. Use the -I option to specify the PCI Index of the card being used.
-r media_rate
Advertise the specified bit-transmission rate. The default is 100000000. This information is used by the Network Manager (Net) only when multiple network drivers are running.
-s speed
Specify the data rate, e.g. -s10 or -s100. Default is auto-negotiate. Use of this option disables the auto-negotiation capability of the ethernet card.
-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.ether905 network driver communicates with 3Com's 3C905-TX PCI Ethernet adapter to provide the Network Manager with reliable data transfer over an Ethernet network.

The driver supports PHY auto-negotiation with auto-negotiating partners. Auto-negotiation can be disabled by using the -s (speed) command line option.

Most of the time, you should not need to specify the I/O port

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

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

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 905 compatible PCI network card, you must specify the -p option on each invocation of Net.ether905. If more than one 905 compatible PCI card is installed, you will need to use the -I option (-I0 for the first card, -I1 for the second, etc.)

Examples:

Start the driver and let it autodetect the hardware: 

    Net.ether905 &

Start the Net.ether905 driver and force the speed to 100Mbit: 

                                                                             
    Net.ether905 -s100  &

Start two Net.ether905 drivers for two adapters installed in one machine:

    Net.ether905 -I0 -l1  &
    Net.ether905 -I1 -l2  &

Files:

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

Exit status:

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

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

See also:

Net, Net.*, netinfo, netmap

Installation & Configuration

[Previous] [Contents] [Next]