[Previous] [Contents] [Next]

Net.ns83815

National Semiconductor DP83815 network driver (QNX)

Syntax:

Net.ns83815 [-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]
            [-x vendor_ID] [-y device_ID]  &

Options:

-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 DP83815-compatible card. You should have to specify -I only if you have more than one DP83815-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.
-x vendor_ID
Use this vendor ID.
-y device_ID
Use this device ID.

Description:

The Net.ns83815 network driver communicates with a National Semiconductor DP83815 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.ns83815 -- 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 DP83815-compatible PCI network card, you must also specify the -I option for every invocation of Net.ns83815. (Use -I0 for the first card, -I1 for the second, etc.)

Examples:

Start the Net.ns83815 driver with default parameters: 

    Net.ns83815 &

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

    Net.ns83815 -s100  &

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

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

Files:

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

Exit status:

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

0
Net.ns83815 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]