NIO CommKit Host Interface Installation and System Administration Manual
DKMAINT(1M) DKMAINT(1M)
E-31 CommKit Host Interface, Release 4.0
NAME
dkmaint – host interface maintenance
SYNOPSIS
dkmaint –r –i interface [ –c channel ] [ –v ]
DESCRIPTION
dkmaint is a program used to reset and perform other maintenance operations on host interfaces or channels.
When the -r option is specified, dkmaint sends an ioctl(2) to the host interface driver which eventually causes
M_HANGUP messages to be issued to each process using the specified channel. Use of the -i option without
the -c option resets all channels on a given interface. dkmaint must be run as root.
The following flags are recognized by dkmaint:
–r Reset-Used to reset the host interface or channel specified. Any active connections on the
interface/channel selected will be closed as a result of the reset operation.
-i interface Specifies which host interface to reset. One and only one interface must be specified on the
command line. To reset all host interfaces installed on a system, dkmaint must be run
multiple times.
-c channel Specifies a channel to reset. Combined with the –i option, a single channel on a single
interface is reset.
-v Verbose Option used for debugging and troubleshooting.The dkmaint command works
silently without the –v option.
FILES
/opt/dk/sbin directory in which this command resides
/dev/dk/ctl X Common Signaling Channel device for interface X
SEE ALSO
dkdaemon(1M), dkhs(7), dkux(7).
ioctl(2), close(2) in the UNIX System V Programmer’s Reference Manual.
DIAGNOSTICS
The dkmaint command reports errors when it cannot open the driver control device for the specified
interface. It also reports if the host interface driver returns an error when the ioctl(2) request is issued.
WARNINGS
Resetting a channel with dkmaint will cause the host interface driver to request that the process currently
using the requested channel release [close(2)] the channel. This is done by sending an M_HANGUP message
from the driver up STREAM to the process. This is designed to look like having the remote side of the
connection disappear. The action that the process takes is application dependent.