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:
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 &
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.
See also:
- Net manager (Network manager)
- Net.* drivers (Network drivers)
- netinfo utility (Display network events)
- QNX Installation & Configuration