tptr(7) DG/UX R4.11 tptr(7)
NAME
tptr - Model 7452 PCI 4/16 Mbit Token Ring Network Interface
SYNOPSIS
tptr(parentbus,slotnumber[,functionnumber[,hardwareaddress,
product-id, media-parameters]])
DESCRIPTION
The tptr device driver allows a DG/UX system that includes one or
more Model 7452 PCI 4/16 Mbit Token Ring local area network (LAN)
adapters to access a Token Ring network. To configure such devices,
you must add one or more device name entries (as described in the
synopsis) to the DG/UX system configuration file. The parameters in
the device name entry are defined as follows:
parentbus The device name of the parent bus to which the
tptr adapter is attached. The Model 7452 PCI
4/16 Mbit adapter can be attached only to a PCI
bus.
slotnumber The parentbus slot in which the Model 7452 PCI
4/16 Mbit Token Ring adapter resides.
functionnumber The network interface instance number for those
PCI cards with more than one Token Ring
interface. This parameter must have a value of
zero, since no multi-function adapters are
currently supported.
hardwareaddress
An overriding alternate IEEE 802.5/Token Ring address
for this adapter on the network with a user-specified
value, which must be represented as a string of
exactly 12 hexadecimal digits. If no hardwareaddress
parameter is specified, the controller-resident
default Token Ring address is used.
product-id This 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.
media parameters
This parameter can be used to specify a non-default
Data Rate or Connector Type. A special value (i.e.,
"N") in the media parameter field of the tptr device
name in the system file can be used to disable
Outbound Source Routing. The default is to leave
Outbound Source Routing "ENABLED". An informational
message will be written to console and STREAMS error
log when Outbound Source Routing is DISABLED. The
following describes the supported variations of the
media parameters:
4 : Data Rate 4mb, Connector = STP
4N : Data Rate 4mb, Connector = STP, No Outbound Source Routing
4S : Data Rate 4mb, Connector = STP
4SN : Data Rate 4mb, Connector = STP, No Outbound Source Routing
4U : Data Rate 4mb, Connector = UTP
4UN : Data Rate 4mb, Connector = UTP, No Outbound Source Routing
16 : Data Rate 16mb, Connector = STP
16N : Data Rate 16mb, Connector = STP, No Outbound Source Routing
16S : Data Rate 16mb, Connector = STP
16SN : Data Rate 16mb, Connector = STP, No Outbound Source Routing
16U : Data Rate 16mb, Connector = UTP
16UN : Data Rate 16mb, Connector = STP, No Outbound Source Routing
Default values are :
Data Rate = Determined from TI TMS-380 Controller.
Connector = Determined from TI TMS-380 Controller.
Source Routing Enabled.
These default values are normally set by the board vendor or by the
board vendor's MS-DOS based configuration/diagnostic utility.
Each tptr device creates a single character-special device node when
it is configured:
/dev/net/tptr(parentbus, slotnumber, functionnumber)
Later, during system initialization, symbolic links are created in
/dev, in the form /dev/tptr[adapternumber], as defined by the
corresponding entries in /etc/devlinktab. These symbolic links
provide for more convenient user access.
The chk.devlink command also is responsible for creating and
maintaining an additional link to each tptr device node, with a
pathname of the form /dev/net/tptr[0-n]. See the chk.devlink(1M) and
devlinktab(4M) man pages.
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 entries in a DG/UX configuration file configure two
Model 7452 PCI 4/16 Mbit Token Ring adapters at nodes
/dev/net/tptr(pci(0),4,0) and /dev/net/tptr(pci(0),6,0). The first
example is attached to the pci(0) bus in slot 4, and the second
example is attached to the pci(0) bus in slot 6.
tptr(pci(0),4,0)
tptr(pci(0),6,0)
The following statement configures a Model 7452 PCI 4/16 Mbit Token
Ring adapter with 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(1C).
Use the -o specify, -o configure, or -o deconfigure option with
admdevice(1M).
SEE ALSO
ifconfig(1M), netinit(1M), netstat(1C), admdevice(1M), system(4),
chk.devlink(1M), devlinktab(4M), arp(6P), inet(6F), pcibus(7),
intro(7).
Licensed material--property of copyright holder(s)