`Net.soho`

Macronix MX98715 Ethernet network driver (QNX4)

Syntax:

Net.soho   [-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] [-s speed] 
           [-t tx_retry_ticks] [-v]

Options:

-F: Force full-duplex operation of the card. The default is half-duplex unless the PHY auto-negotiates full-duplex.
-f tx_forget_time: After a driver-level NACK is received from a remote node, Net.soho temporarily throttles the transmit output on that connection because of the dropped packets. The output is reduced to approximately 400K/sec for tx_forget_time seconds. The default tx_forget_time time is 10 seconds.
-I pci_index: Instruct the driver look at this specific PCI Index for an MX98715-compatible card. You would use this option only if you have more than one MX98715-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.
-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. The default is 7.
-P: Program the NIC for promiscuous rx mode. All packets will be buffered, regardless of the packet's destination address. The default is non-promiscuous mode.
-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 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. This is possible only with 100Mbit cards (e.g. -s10 or -s100). This option disables the auto-negotiation capability of your Ethernet card.
-t tx_retry_ticks: The number of 50-millisecond intervals between tx retries. The default is 6.
-v: Be verbose; print hardware configuration information on the screen when starting up.

Description:

The Net.soho driver provides the Network Manager with reliable data transfer over an Ethernet network.

The Net.soho network driver has been tested with Sohoware MX98715A PCI Ethernet adapter. The driver supports PHY auto-negotiation with auto-negotiating partners. Auto-negotiation can be disabled by using the -s option. Full-duplex operation can also be forced, using the -F option.

Most of the time, you should not need to specify the I/O port or the hardware interrupt to Net.soho: the driver 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 MX98715-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 Net.soho driver with default parameters:

Net.soho &

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

Net.soho -s100  &

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

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

Exit status:

0: Successful completion.
>0: An error occurred.