tcen(7)                        DG/UX R4.11MU05                       tcen(7)


NAME
       tcen - 3Com PCI Ethernet Network Interface (Intel only)

SYNOPSIS
       tcen(parent-bus[,pci-device-num[,pci-function-num[,alt-ether-
       addr[,network-speed]]]])

DESCRIPTION
       The tcen device driver allows a DG/UX system that includes a 3Com PCI
       Ethernet local area network (LAN) adapter (Model 3C595-TX) to access
       an Ethernet network.  To configure such devices, you must add to the
       DG/UX system configuration file one or more device name entries 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-ether-addr parameter can be used to override the
           adapter's default Ethernet address with a user-specified value.
           The alternate address must be expressed in one of two ways:
           either as a string of exactly 12 hexadecimal digits, or as a
           sequence of six pairs of two hexadecimal digits with each pair
           separated by a colon (:) character.  If no alt-ether-addr
           parameter is specified, the adapter-resident default Ethernet
           address is used.

       ·   The network-speed parameter is used to configure the 3Com adapter
           to either 100Mbps or 10Mbps.  The legal values of this parameter
           are 10 and 100.  By default, the driver will
           autosense/autoconfigure to the correct data rate.

       The Internet address for each interface is specified at network
       configuration time with the SIOCSIFADDR ioctl; see ifconfig(1M) for
       details.

FILES
       Each standard tcen device creates a single character-special device
       node when it is configured, with the pathname:

           /dev/net/tcen(parent-bus,pci-device-num)


       The chk.devlink command is responsible for creating and maintaining
       an additional link to each tcen device node, with a pathname of the
       form /dev/net/tcen[0-9]*.  See the chk.devlink(1M) and devlinktab(4M)
       man pages for details.

       The tcen device driver is a clonable Streams driver.  This means that
       you can open a single tcen device node 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.

DIAGNOSTICS
       Use the -i option with netstat(1C).

EXAMPLES
       The following entry in a DG/UX configuration file configures a tcen
       device in the PCI slot that uses PCI device number 5 on the primary
       PC PCI host bridge:

            tcen(pci(0),5)


       The following statement configures the device from the example above,
       but specifies an alternate Ethernet address:

            tcen(pci(0),5,,08:00:1b:12:34:56)


       For more information about DG/UX device configuration, refer to
       "Writing a Device Driver" in Programming in the DG/UX Kernel
       Environment.

SEE ALSO
       ifconfig(1M), netinit(1M), netstat(1C), system(4), arp(6P), inet(6F),
       chk.devlink(1M), devlinktab(4M), pci_bus(7), intro(7).


Licensed material--property of copyright holder(s)