SMC 83C170 Ethernet network driver (QNX)
Net.epic [-a io_port] [-f tx_forget_time] [-F] [-i irq]
[-l log_net_id] [-M] [-n tx_num_retries]
[-p pci_index] [-P] [-r media_rate]
[-s speed] [-t tx_retry_ticks] [-v] &
- -a io_port
- Use the specifed I/O port base. This option
overrides the default auto-detect, which uses
the PCI BIOS to return a port address.
- -f tx_forget_time
- After a driver-level NACK is received from
a remote node, Net.epic 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 2 seconds, after
which the eternally optimistic Net.epic
stops throttling its output. The -f option allows you
to change the default 2 seconds above.
- -F
- Force full-duplex operation of the card. The
default is half-duplex unless the PHY
auto-negotiates full-duplex.
- -i irq
- Program the card to use the specified
hardware interrupt. This option overrides
the default autodetect. If the autodetect
does not work on an ISA card, you have a
hardware conflict. This option should rarely be used.
- -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.
- -n tx_num_retries
- After failing to transmit to a remote node,
retry transmission no more than this number
of times. Default is 7.
- -p pci_index
- Have the driver look at this specific PCI Index
for an epic compatible card. You should only have to
specify -p if you have more than one epic compatible
card installed. (e.g. -p0, -p1, -p2).
- -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.
- -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 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.
The Net.epic network driver communicates with SMC's
83C170 PCI ethernet 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 command line option.
Most of the time, you should not need to specify the I/O port
or the hardware interrupt to Net.epic - it should autodetect
these parameters from the PCI BIOS.
Before installing your card, you should read the technote
contained in the /etc/readme/technotes/Net.epic file.
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 epic compatible PCI network
card, you must also specify the -p option for every invocation
of Net.epic. (Use -p0 for the first card, -p1
for the second, etc.)
Start the Net.epic driver with default parameters:
Net.epic &
Start the Net.epic driver and force the speed to 100Mbit:
Net.epic -s100 &
Start two copies of the driver running on seperate cards; one
on logical network 1, the other on logical network 2:
Net.epic -p0 -l1 &
Net.epic -p1 -l2 &
Net.epic 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.
The Net.epic driver ignores SIGPWR.
Net.epic terminates only upon encountering errors during
initialization or upon getting a signal (i.e. being killed).
- 0
- Net.epic has shut down successfully and cleanly
deregistered from Net.
- >0
- An error occurred during initialization.
- Net manager (Network manager)
- Net.* drivers (Network drivers)
- netinfo utility (Display network events)
- netmap utility (Load logical-to-physical node ID mapping table)
- QNX Installation & Configuration