[Previous] [Contents] [Next]

Net.ether1000

NE1000/2000 Ethernet network driver (QNX)

Syntax:

Net.ether1000 [-6] [-a] [-D id] [-f forget_time]
              [-h hang_ticks] [-i irq] [-I index]
              [-l log_net_id] [-M] [-n tx_num_entries]
              [-p io_port] [-P] [-r media_rate]
              [-R] [-s ram_size] [-t tx_retry_ticks]
              [-v] [-V id] &

Options:

-6
Instruct the driver that a 16-bit NE2000 card with 16K RAM is installed. This option overrides the driver's automatic detection of the NE2000 card, and should rarely be needed.
-a
Use a 16-bit AT/LANTIC card run in 8-bit mode.
-D id
Specify device ID.
-f forget_time
After a driver-level NACK is received from a remote node, Net.ether1000 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 driver stops throttling its output. -f allows you to change the default 10 seconds above.
-h hang_ticks
Specify the number of 50ms ticks to wait until the driver concludes that the chip is hung and resets it. Default: 10 (500ms).
-i irq
Use this interrupt line (IRQ). This option overrides the automatic IRQ detection the driver performs if a boot ROM is installed and should rarely be needed.
-I index
Specify the PCI index of the controller in the machine, where index is a value between 0 and the number of adapters.
-l log_net_id
("el") Connect to this logical network (default is 1).
-M
Enable reception of multicast packets.
-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 io_port
Use this base I/O port address, specified as a hexadecimal number without a leading 0x. This option overrides the automatic port detection the driver performs.
-P
Run promiscuously: buffer every packet, whether or not it's destined for this node. (A node usually discards any packet not addressed to it.)

You may use this option in conjunction with netsniff to monitor other traffic on the network.

-r media_rate
Advertise this bit-transmission rate (default is 10000000). The Network Manager uses this information only when multiple drivers are running.
-R
Perform time-consuming data integrity checks. Use only with PCMCIA cards.
-s ram_size
Set the shared RAM segment on the card to this length (given in kilobytes). This option overrides the default of 8K for the NE1000 and 16K for the NE2000, and should rarely be needed.
-t tx_retry_ticks
Wait this many 50-millisecond intervals between transmit retries (default is 20).
-v
Be verbose: print out hardware info on the console when starting up.
-V id
Specify vendor ID.

Description:

The Net.ether1000 network driver communicates directly with a Novell NE1000 (8-bit) or NE2000 (16-bit) Ethernet network card; it also works with compatible cards. The driver provides the Network Manager (Net) with reliable data transfer over an Ethernet network.

The driver autodetects the following PCI NE2000 clones:

Caution: Installing a card at I/O port 360 may result in a conflict with the parallel port!

If you have installed a boot ROM you must use one of the following Novell configurations; Net.ether1000 will automatically detect any IRQ.

Novell option ROM address I/O port Default boot from:
0 C800 300 network
2 D000 340 disk
9 CC00 320 network
X D400 360 network

Before installing a boot ROM or network card, note the following:

To install: You should:
a boot ROM read the documentation that came with the boot ROM
an NE1000 or NE2000 card read the technote contained in the file Net.ether1000 in /etc/readme/technotes.
multiple network cards in one machine specify a unique logical network ID (-l option) to every network driver
multiple NE1000 or NE2000 or compatible cards in one machine specify -p to every invocation of Net.ether1000 even if a boot ROM is installed in one or more of the cards

Examples:

With a boot ROM installed...

Start the driving using Novell option 9 (IRQ 5, I/O port 0x320, ROM at 0xCC00):

    Net.ether1000 &

Support two cards -- one using Novell option 4 (IRQ 2, I/O port 0x300) on logical network 1, and the other using Novell option 9 (IRQ 5, I/O port 0x320, ROM at 0xCC00) on logical network 2: 

    Net.ether1000 -p 300 &
    Net.ether1000 -p 320 -l 2 &

With no boot ROM installed...

Start the driver using IRQ 10 and I/O port 0x300:

    Net.ether1000 &

Start the driver using IRQ 5 and I/O port 0x320:

    Net.ether1000 &

Start the driver using IRQ 2 and I/O port 0x340:

    Net.ether1000 &

Files:

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

Exit status:

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

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

See also:

Net, Net.*, netinfo

Installation & Configuration

[Previous] [Contents] [Next]