cien(7)                        DG/UX 5.4R3.00                        cien(7)


NAME
       cien - CMC-130 Ethernet network interface

SYNOPSIS
       cien([vmebus,][def]) or
       cien([vmebus,]def,,ethernetaddress) or
       cien@devicecode ([vmebus,]VMEA32addr[,0|ethernetaddr])

DESCRIPTION
       The cien device driver allows an AViiON system that includes an
       intelligent local area network (LAN) controller (VLCi) to access an
       Ethernet network. To set up this interface, you enter one or more
       cien statements in the DG/UX system configuration file.

       The cien statement has three formats (shown above and illustrated
       below). The first format accepts all defaults for a specified
       controller board.  The second format specifies an alternate ethernet
       address but accepts all other board defaults.  The third format
       specifies all values:

       vmebus        The device name of the parent VME bus to which the
                      cien controller is attached, such as vme(0) or vme(1).
                      If this parameter is omitted, a parent bus of vme(0)
                      is assumed, and all subsequent parameters move up one
                      position.  Thus, cien(3) is equivalent to
                      cien(vme(0),3).

       def            A number from 0 to 7, or null for 0, identifying the
                      controller board defaults to use

       @devicecode   The network controller device code, preceded by the @
                      character

       VMEA32addr   The VME A32 address of the controller

       ethernetaddr  An overriding alternate address for this controller on
                      the network.  Null or 0 accepts the ethernet address
                      that is set on the board.

       The cien device is implemented as a clonable Streams driver.  This
       means that you can open a single node, such as /dev/cien0, 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
       VLCi controllers with default values, at nodes /dev/cien0 and
       /dev/cien1:

            cien(0)



Licensed material--property of copyright holder(s)                         1

cien(7)                        DG/UX 5.4R3.00                        cien(7)


            cien(4)

       Note that either cien() or cien(0) will create the initial node.
       Note also that the /dev/cien* device nodes are created on a first-
       come, first-served basis:  the first cien entry in the system file is
       the first cien device configured, so it gets the node named
       /dev/cien0; the second entry gets the node named /dev/cien1, and so
       on.

       The following statement configures a VLCi controller with board 0
       defaults, but specifies an alternate ethernet address:

            cien(0,,08001b123456)

       The following statement configures a VLCi controller with device code
       4F and VME A32 address E1A00000, but accepts the default ethernet
       address.

            cien@4F(E1A00000)

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

       For a full discussion of device naming conventions and a list of
       board defaults, see Customizing the DG/UX System.

SEE ALSO
       ifconfig(1M), netinit(1M), system(4), arp(6P), inet(6F), vme(7),
       intro(7).



























Licensed material--property of copyright holder(s)                         2