hken(7) DG/UX R4.11MU05 hken(7)
NAME
hken - Hawk VME Ethernet network controller (88K only)
SYNOPSIS
hken(parent-bus[,controller-num[,,alt-ether-addr]])
DESCRIPTION
The hken device driver allows an AViiON system that includes a
V/Ethernet 3207 Hawk VME Local Area Network controller (VLC) 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 VME bus device to which the controller is attached (vme(0) or
vme(1), for example). There is no default value for this
parameter; it must always be specified explicitly.
· The controller-num parameter is a hexadecimal number in the range
0 through 7 which distinguishes the various standard addressing
values to which the controller may be jumpered. Consult the
table below for details on these address settings. The default
value for controller-num is 0.
· The third 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.
Each hken controller board contains three jumperable VME board
address settings: the interrupt vector number used by the board, the
A16 address of the board's 16-bit control register space, and the A32
address of the board's 32-bit control register space. The following
hexadecimal address values are used for the 8 standard controller-num
instances supported by the device driver on each parent VME bus:
Controller Interrupt A16 Address A32 Address
Number Vector
Number
0 15 FFFF4000 E1000000 or 55900000
1 16 FFFF5000 E1080000 or 55980000
2 10 FFFF4200 E1100000
3 11 FFFF4400 E1180000
4 12 FFFF4600 E1200000
5 13 FFFF4800 E1280000
6 14 FFFF4A00 E1300000
7 17 FFFF4C00 E1380000
A hken device can still be used even if it is not jumpered to one of
the standard address settings. However, such a device is referred to
as a non-standard instance, and it requires a different device name
format:
hken@intr-vec-num(parent-bus,a16-addr,a32-addr[,alt-ether-addr])
The parameters in a non-standard device name have the following
meanings:
· The intr-vec-num value is the hexadecimal VME interrupt vector
number used by the board. There is no default value for this
parameter; it must always be specified explicitly.
· The parent-bus parameter has exactly the same meaning here as it
does in the standard device name format.
· The a16-addr parameter is the hexadecimal value of the VME A16
address of the board's 16-bit control register space. There is
no default value for this parameter; it must always be specified
explicitly.
· The a32-addr parameter is the hexadecimal value of the VME A32
address of the board's 32-bit control register space. There is
no default value for this parameter; it must always be specified
explicitly.
· The alt-ether-addr parameter has exactly the same meaning here as
it does in the standard device name format.
FILES
Each standard hken device creates a single character-special device
node when it is configured, with the pathname:
/dev/net/hken(parent-bus,controller-num)
The pathname of the device node created for non-standard device
instances is:
/dev/net/hken@intr-vec-num(parent-bus,a16-addr,a32-addr)
The chk.devlink command is responsible for creating and maintaining
an additional link to each hken device node, with a pathname of the
form /dev/net/hken[0-9]*. See the chk.devlink(1M) and devlinktab(4M)
man pages for details.
The hken device driver is a clonable Streams driver. This means that
you can open a single hken 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 VLC
controllers that use two of the standard sets of addressing values,
and which use their on-board default Ethernet addresses:
hken(vme(1),0)
hken(vme(0),4)
The following statement configures a VLC device using the address
settings for controller number 0, but specifies an alternate Ethernet
address:
hken(vme(0),0,,08001b123456)
The following statement configures a non-standard VLC device which
uses interrupt vector 0x17, VME A16 address 0xFFFF4800, and VME A32
address 0xE1280000, but which accepts the default Ethernet address:
hken@17(vme(0),ffff4800,e1280000)
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.
SEE ALSO
ifconfig(1M), netinit(1M), system(4), arp(6P), inet(6F), vme(7),
chk.devlink(1M), devlinktab(4M), intro(7).
Licensed material--property of copyright holder(s)