Net.tr164a

IBM Token Ring 16/4 Adapter network driver (QNX)

Syntax:

Net.tr164a [options] &

Options:

-a

Assume an AT bus adapter (default is autodetect).

-d bitmask

Bitmask for debugging information; default: 0 (disabled).

-F address

Functional address the adapter should respond to (hexadecimal; no leading 0x). See IBM LAN Reference Manual.

-G address

Group address the adapter should respond to (hexadecimal; no leading 0x). This is a locally administered address assigned to two or more adapters to allow the adapters to copy the same frame.

-i irq

Specify the interrupt used. (default: autodetect)

-l log_net_id

("el") Connect to this logical network (default is 1).

-m

Assume a microchannel adapter (default is autodetect).

-n

Specify registered name of Net manager to attach to. (default: qnx/net)

-p io_port

Use this I/O port base address, specified as a hexadecimal number without a leading 0x. This option overrides the driver's autodetect of 0xA20 to 0xA23 (for primary LAN cards) or 0xA24 to 0xA27 (for alternate LAN cards).

-r media_rate

Advertise this bit-transmission rate (default is 16000000). The Network Manager (Net) uses this information when multiple network drivers are running.

-t table_size

Set the source routing table to this size. (Default: 64)

-v

Be verbose: print out hardware configuration info on the console when starting up.

Description:

The Net.tr164a network driver communicates directly with an IBM Token Ring Network 16/4 card. It works with both ISA and MCA cards that operate in shared-memory mode ("busmaster" mode isn't supported). The driver provides the Network Manager (Net) with reliable data transfer over a Token Ring network.

By default, Net.tr164a automatically locates the network adapter at either the primary (0xA20) or the alternate (0xA24) I/O port base. Once it determines the I/O port base, the driver can automatically determine all other hardware parameters.

Note that an ISA bus Token Ring card also uses I/O port 2Fn, where n is the interrupt (e.g. 2, 3, 7). MCA bus cards don't use this port.

Before installing your card, you should read the technote contained in the file /etc/readme/technotes/Net.tr164a.

To install multiple network cards in one machine, you should specify a unique logical network ID (-l option) to every network driver. When installing multiple Token Ring 16/4 cards in one machine, be sure to also specify the -p option to every invocation of Net.tr164a.

Examples:

Use automatic detection of all hardware parameters:

    Net.tr164a &

Do the same as above, but for a card on logical network 2:

    Net.tr164a -l 2 &

Support two cards -- one configured as the "primary LAN adapter" and connected to logical network 1, the other configured as the "alternate LAN adapter" and connected to logical network 2:

    Net.tr164a -p A20 &
    Net.tr164a -p A24 -l 2 &

Files:

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

Exit status:

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

0

Net.tr164a has shut down successfully and cleanly deregistered from Net.

>0

An error occurred during initialization.

See also:

Net, Net.*, netinfo

Installation & Configuration