tptr(7) DG/UX R4.11MU05 tptr(7)
NAME
tptr - TI Token Ring Network Interface
SYNOPSIS
tptr(parent-bus[,pci-device-num[,pci-function-num[,alt-tr-
addr[,product-id[,media]]]]])
DESCRIPTION
The tptr device driver allows a DG/UX system that includes one or
more Model 7452 PCI 4/16 Mb/s Token Ring local area network (LAN)
adapters which use the Texas Instruments (TI) TMS-380 Token Ring
controller chip to access a Token Ring network. To configure such
devices, you must add to the DG/UX system configuration file a device
name entry of the form described in the synopsis above. The
parameters in a device name have the following meanings:
· The parent-bus parameter is itself a device name, representing
the PCI bus device to which the controller is attached (pci(0),
for example). There is no default value for this parameter; it
must always be specified explicitly.
· The pci-device-num parameter is a hexadecimal number in the range
0 through 1F; it represents the PCI device number ("slot number")
used by the device. The default value for pci-device-num is 0.
· The pci-function-num parameter is a hexadecimal number in the
range 0 through 7; it represents the PCI function number used by
the controller within pci-device-num. The default value for pci-
device-num is 0; non-zero values will be used only if the
controller lies on a multi-function card.
· The alt-tr-addr parameter can be used to override the
controller's default Token Ring (IEEE 802.5) address with a user-
specified value, which must be represented as a string of exactly
12 hexadecimal digits. If no alt-tr-addr parameter is specified,
the controller-resident default Token Ring address is used.
· The product-id parameter can be used to specify a non-default
Product ID. Information on the product ID may be found in the
IBM Token-Ring Network Architecture Reference. The default value
for product-id is 0.
· The media parameter can be used to specify a non-default data
rate, connector type, or to disable Outbound Source Routing. The
following media parameter variations are supported:
Value Data Connector Outbound
Rate Type Source
(Mb/s) Routing?
4 4 STP Yes
4N 4 STP No
4S 4 STP Yes
4SN 4 STP No
4U 4 UTP Yes
4UN 4 UTP No
16 16 STP Yes
16N 16 STP No
16S 16 STP Yes
16SN 16 STP No
16U 16 UTP Yes
16UN 16 STP No
The default media setting enables Outbound Source Routing and
determines the data rate and connector type from the controller.
These default values are normally set by the board vendor or by the
board vendor's MS-DOS based configuration/diagnostic utility. An
informational message will be written to console and STREAMS error
log when Outbound Source Routing is disabled.
Each tptr device creates a single character-special device node when
it is configured:
/dev/net/tptr(parent-bus,pci-device-num,pci-function-num)
The chk.devlink command is responsible for creating and maintaining
an additional link to each tptr device node, with a pathname of the
form /dev/net/tptr[0-9]*. See the chk.devlink(1M) and devlinktab(4M)
man pages for details.
The tptr device is implemented as a clonable Streams driver. This
means that you can open a single node, such as /dev/tptr0, to access
any unused minor device. Each subsequent access of the node via the
open(2) system call allocates a separate Stream (minor number) to the
device driver.
EXAMPLES
The following entry in a DG/UX configuration file configures a tptr
adapter in slot 2 of the secondary Corollary PCI host bridge:
tptr(cpci(1),2)
The following statement configures a tptr adapter using an alternate
Token Ring address:
tptr(pci(0),6,0,08001b123456)
For more information about DG/UX device configuration, see "Writing
a Device Driver" in Programming in the DG/UX Kernel Environment.
FILES
/etc/devlinktab This file contains entries used to make short-named
links to device nodes.
DIAGNOSTICS
Use the -i option with netstat(1M).
Use the -o specify, -o configure, or -o deconfigure option with
admdevice(1M).
SEE ALSO
ifconfig(1M), netinit(1M), netstat(1M), admdevice(1M), system(4),
chk.devlink(1M), devlinktab(4M), arp(6P), inet(6F), pci_bus(7),
intro(7).
Licensed material--property of copyright holder(s)