Net.sym

SymBios 53C885 network driver (QNX)

Syntax:

Net.sym [-D port_speed] [-F] [-I pci_index] [-i irq]
        [-k] [-L Net_Manager_name] [-l log_net_id] [-M]
        [-m MAC_ADDR] [-n tx_num_retries]
        [-P] [-p io_port] [-R num_rx] [-r media_rate]
        [-s speed] [-T num_tx] [-t tx_retry_ticks] [-v] &

Options:

-D port_speed

Send output to serial port (for debugging).

-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 Sym-compatible card. You should have to specify -I only if you have more than one Sym-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 doesn't work on an ISA card, you have a hardware conflict. This option should rarely be used.

-k

Use store-forward mode. Copy complete message to NIC before transmitting.

-L Net_Manager_name

The default is qnx/net.

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

-m MAC_ADDR

Use this Ethernet physical address.

-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

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 some 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 num_rx

Specify this number of rx descriptors. The default is 32.

-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

Set the speed at which the card should run. Only possible with 100Mbit cards. (e.g. -s10 or -s100) This disables the auto-negotiation capability of Ethernet card.

-T num_tx

Specify this number of tx descriptors. The default is 32.

-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.sym network driver communicates with a SymBios 53C885-based 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. Full-duplex operation can also be forced, using the -F option.

Most of the time, you shouldn't need to specify the I/O port or the hardware interrupt to Net.sym -- 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 SymBios-compatible PCI network card, you must also specify the -I option for every invocation of Net.sym. (Use -I0 for the first card, -I1 for the second, etc.)

Examples:

Start the Net.sym driver with default parameters:

    Net.sym &

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

    Net.sym -s100  &

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

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

Files:

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

Exit status:

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

0

Net.sym has shut down successfully and cleanly deregistered from Net.

>0

An error occurred during initialization.

See also:

Net, Net.*, netinfo, netmap

Installation & Configuration