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


NAME
       dgen - ILACC Ethernet network controller (88K only)

SYNOPSIS
       dgen([controller-num[,,alt-ether-addr]])

DESCRIPTION
       The dgen device driver allows an AViiON system that includes an
       Integrated Local Area Communications Controller (ILACC) 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 controller-num parameter is a hexadecimal number in the range
           0 through E which distinguishes the various instances of the
           controller that are available.  The default value for controller-
           num is 0.  Systems that support the dgen device will always have
           dgen(0) integrated onto the system board or the primary I/O
           Controller (IOC) board.  On systems that can support multiple
           IOCs, up to three dgen devices are possible for each IOC:  one
           integrated device and two expansion slot devices.  For IOC number
           n, the controller number of the integrated dgen device will be (n
           * 3); the controller number for a dgen device (if present) in
           expansion slot 0 of that IOC will be (n * 3) + 1; and the
           controller number for a dgen device (if present) in expansion
           slot 1 of that IOC will be (n * 3) + 2.

       ·   The second parameter position is unused, and is reserved for
           reasons of backward compatibility.

       ·   The alt-ether-addr parameter can be used to override the
           controller's default Ethernet address with a user-specified
           value, which must be represented as a string of exactly 12
           hexadecimal digits.  If no alt-ether-addr parameter is specified,
           the controller-resident default Ethernet address is used.

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

       In conjunction with the dgen system file entries, the following
       tunable kernel parameters are used by all dgen devices configured
       into the system:

       ·   ILACCPAD specifies the number of dummy frame descriptors to
           insert between back-to-back frame transmissions.  This can be
           used to extend the inter-packet gap (IPG) and is useful in
           networks where there are large numbers of collisions.  The range
           of valid values is {0 .. 20}; values outside this range result in
           an effective value of 20.  The default value of 4 is strongly
           recommended, since smaller values may be ineffective, and much
           larger values may cause performance degradation.

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

           /dev/net/dgen(controller-num)


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

       The dgen device driver is a clonable Streams driver.  This means that
       you can open a single dgen 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 entries in a DG/UX configuration file configure two
       ILACC controllers: the first one integrated on IOC 0, and the second
       one in epxansion slot 0 of IOC 1.  Both devices use their on-board
       default Ethernet addresses:

            dgen(0)
            dgen(4)


       The following statement configures ILACC controller number 0, but
       specifies an alternate Ethernet address:

            dgen(0,,08001b123456)


       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), system(4), arp(6P), inet(6F),
       chk.devlink(1M), devlinktab(4M), intro(7).


Licensed material--property of copyright holder(s)