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


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

SYNOPSIS
       tcen(parent-bus,slot-num[,functionnum[,alt-ether-
       addr[,networkspeed]]])

DESCRIPTION
       The tcen device driver allows an DG/UX system that includes a 3Com
       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 bus device to which the adapter is attached (pci(0), for
           example).  There is no default value for this parameter; it must
           always be specified explicitly.  The 3Com 3C595-TX must be
           attached to a PCI bus.

       ·   The slot-num parameter is a hexadecimal number in the range 0
           through 1F which represents the slot number in parent-bus used by
           the device.  There is no default value for this parameter; it
           must always be specified explicitly.

       ·   The functionnum parameter is a hexadecimal number specifying the
           function of the adapter.  This value is always zero and defaults
           to zero if not specified.  It is used as part of the device
           specification for consistency with other ethernet device drivers.

       ·   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 networkspeed parameter is used to configure the 3Com adapter
           to either 100Mbps or 10Mbps.  The legal values of this parameter
           are either a decimal 10 or 100.  By default, the tcen 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,slot-num)


       The chk.devlink command is responsible for creating and maintaining
       additional links to each tcen device node, with pathnames of the form
       /dev/net/tcen[0-n] and /dev/tcen[0-n].  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 slot 5 on the PCI bus:

            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), pcibus(7), intro(7).


Licensed material--property of copyright holder(s)