nettrap

Autodetect network card and start appropriate drivers (QNX)

Syntax:

Print command lines necessary to start drivers:

    nettrap [options] [query]

Start drivers:

    nettrap [options] start

Options:

-e port,port

Exclude scan in this range of I/O ports (specified in hexadecimal; no leading 0x).

-l lan

("el") The first driver started should use this logical LAN number; additional drivers will be assigned LAN numbers incrementally from this value. (Default: 1)

-v

Verbose output to help debugging failed detection. Shows which cards are being scanned for.

-vv

More verbose output. Shows which cards are being scanned for, and which I/O or memory locations are being hit.

start

Start the appropriate drivers.

query

List the drivers that would be invoked by nettrap start. This is the default action.

Description:

The nettrap utility scans the machine it is run on for network cards. If start is not specified, the command line that would be used to start the network drivers will be printed out. If start is specified, Net, the appropriate Net drivers, and netmap -f will be executed. This is ideal for the sysinit file on a machine booting from hard disk.

Since the nettrap utility reads and writes to I/O ports and memory, running nettrap may cause drivers and their hardware (and not just other Net.* drivers) to behave in unpredictable ways. If sensitive or hazardous equipment is controlled by the computer, avoid using the *trap trap utilities or disconnect those peripherals before using them.

The network cards scanned for include the following hardware types:

• 3Com 503 Etherlink II Ethernet
• 3Com 509 Etherlink III Ethernet
• 3Com 905 Fast Etherlink XL
• Arcnet (Corman)
• Arcnet (standard)
• DEC FDDI
• IBM (and TROPIC) Token-Ring ISA/MCA
• IBM PCI Token-Ring
• Intel 82557/8 10/100 Ethernet
• Intel 82595 Ethernet
• Intel PRO/100 VE
• National Semiconductor DP83815 Ethernet
• NE1000/2000 Ethernet
• NE2100 (AMD 79c960/961/965/970/974) Ethernet
• SMC EtherPower (DEC 21040/21041/21140) 10/100 Ethernet
• SMC 91C90/92 Ethernet
• SMC 9432 (Epic) Etherpower II 10/100
• SMC/WD 8003/8013/elite/ultra Ethernet
• SymBios 53C885 Ethernet

See the usage message (use nettrap) for a definitive list of currently supported network hardware types.

The first Net driver started will be assigned logical LAN number one (-l1). The second Net driver will be started with -l2, etc. The starting logical LAN number may be made something higher than 1 by using the -l lan option.

The nettrap utility may be run only by root.

Files:

The standard input is unused.

Card information and -v output is written to the standard output.

In start mode, the standard output is unused.

Exit status:

>0

Failed to detect card and/or start driver.

0

Successfully detected card/started driver.

See also:

Net, Net.*, disktrap, mousetrap, pcmciatrap, ramtrap

Installation & Configuration