Net.solotr

IBM PCI Token-Ring network driver (QNX)

Syntax:

Net.solotr [-f tx_forget_time] [-I pci_index] [-i irq]
           [-l log_net_id] [-n tx_num_retries] [-r media_rate]
           [-s speed] [-T table_size] [-t tx_retry_ticks] [-v] &

Options:

-f tx_forget_time

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

-i irq

Program the card to use the specified hardware interrupt. This option overrides the default autodetect. If the autodetect doesn't work on an ISA card, you have a hardware conflict.

-l log_net_id

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

-n tx_num_retries

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

-I pci_index

Have the driver look at this specific PCI Index for a solotr-compatible card. You should have to specify -I only if you have more than one solotr-compatible card installed (e.g. -I0, -I1, -I2).

-p pci_index

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

-r media_rate

Advertise the specified bit-transmission rate. The default is 100000000. This information is used by the Network Manager when multiple network drivers are running.

-s speed

Set the speed at which the card should run (e.g. -s4 or -s16). Only possible with 100Mbit cards. This disables the Ethernet card's auto-negotiation capability.

-T table_size

Set the source routing table to this size. (Default: 64)

-t tx_retry_ticks

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

-v

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

Description:

The Net.solotr network driver has been tested with IBM's PCI Token-Ring Adapter (P/N 41H8900). The driver supports automatic ring-speed detection. Auto-negotiation can be disabled by using the -s speed command-line option.

Net.solotr provides the Network Manager with reliable data transfer over a Token-Ring network.

Most of the time, you shouldn't need to specify the I/O port or the hardware interrupt to Net.solotr -- 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 more than one solotr-compatible PCI card is installed, you'll need to use the -I option (e.g. -I0 for the first card, -I1 for the second, etc.

Examples:

Start the Net.solotr driver with default parameters:

Net.solotr & 

Start the Net.solotr driver and force the speed to 4Mbit:

Net.solotr -s4  & 

Start two copies of the driver running on separate cards, one on logical network 1, the other on logical network 2:

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

Exit status:

0

Successful completion.

>0

An error occurred.

See also:

Net, Net.*, netinfo

Installation & Configuration