NIO CommKit Host Interface Installation and System Administration Manual

DKSTAT(1M) DKSTAT(1M)
E-35 CommKit Host Interface, Release 4.0
NAME
dkstat – print AT&T data switch interface status information
SYNOPSIS
dkstat [ –i interface ] [ –c channel | –s ] [ -gn ] [ -r | - x ] [ interval [ iterations ] ]
DESCRIPTION
dkstat retrieves and reports various data switch interface and channel statistics and performance information
that is collected by the dkhs(7) driver as it operates. This information is formatted and printed on the user’s
terminal or may be piped into another program for further analysis. Cumulative statistics for an interface may
be gathered and reported, or the statistics may be retrieved for a specified interval one or more times.
The available options are:
–i interface Report statistics for interface instead of interface 0 which is the default. Only a single
interface may be specified per command invocation.
–c channel Report statistics for a specific single channel on the selected interface. The statistics
for a channel are only available while that channel is open. Once a channel is closed,
the statistics are summed into the channel summary statistics available through the -s
flag. Only root may specify this flag and only a single channel may be examined
during one command invocation.
–g Report global interface statistics for the selected interface.
–s Report summary of all channel statistics for the interface. This flag reports the sum of
the channel summary statistics and the individual channel statistics for all open
channels on the selected interface.
–n Suppress all headers. This option allows the output of dkstat to be piped into another
program for graphing or tabulation of the data.
-r Report only receiver related statistics.
–x Report only transmitter related statistics.
interval Gathers and reports statistics for the specified interval in seconds. If no interval is
specified, the cumulative statistics of the type selected are gathered and reported.
iterations Specifies a repeat count for statistics gathering and reporting. The output of dkstat is
displayed in horizontal format when iterations is greater than one. If no iterations is
specified, the default value is one.
The Interface Statistics include statistics about hardware interrupts and errors, driver scheduling and
resource problems. The statistics collected are:
x_intr Transmitter interrupts from the data switch interface board. These interrupts occur
whenever the interface board detects the transmit FIFO has made a transition from
more than half-full to less than half-full. Transmitter interrupts are also software
simulated by dkhs(7) whenever a receiver interrupt occurs and the transmit work queue
is not empty.
x_xhf The dkhs(7) transmitter processing routine detected the transmit FIFO was more than
half-full at some point during the transmission of data.
r_intr Receiver interrupts from the data switch interface board. These interrupts occur
whenever the interface board loads incoming packet data into the receive FIFO
causing the FIFO to make a transition from empty to not-empty.