Net.ether1000

NE1000/2000 Ethernet network driver (QNX)

Syntax:


Net.ether1000 [-6] [-P] [-i irq] [-l log_net_id]

              [-n tx_num_entries] [-p io_port]

              [-r media_rate] [-s ram_size]

              [-t tx_retry_ticks] [-v] &

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.
-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.
-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. 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 special software to "sniff" 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.

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 IRQ 2 and I/O port 0x340:


    Net.ether1000 &

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.

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

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.

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.