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


NAME
       hken - Hawk Ethernet network interface

SYNOPSIS
       hken([vmebus,][def])
       hken([vmebus,]def,ethernetaddress)
       hken@devicecode([vmebus,]VMEA16addr,VMEA32addr[,0|ethernetaddr])

DESCRIPTION
       The hken device driver allows an AViiON system that includes a
       V/Ethernet 3207 Hawk Local Area Network (LAN) Controller to access an
       Ethernet network. To set up this interface, you enter one or more
       hken statements in the DG/UX system configuration file.

       The hken statement has three formats (shown above and illustrated
       below). The first format accepts all defaults for a specified 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
                      hken 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, hken(3) is equivalent to
                      hken(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

       VMEA16addr   The VME A16 (short I/O) address of the controller

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




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

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


            hken(0)
            hken(1)

       Note that either hken() or hken(0) will create the initial node.

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

            hken(0,,08001b123456)

       The following statement configures a Hawk controller with device code
       17, VME A16 address ffff4800, and VME A32 address e1280000, but
       accepts the default ethernet address.

            hken@17(ffff4800,e1280000,0)

       For details about setting the I/O and VME addresses on the board, see
       V/Ethernet 3207 Hawk Local Area Network Controller for Ethernet
       User's Guide (014-001818).

       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), vme(7), intro(7),
       inet(6F).



























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