NIO CommKit Host Interface Installation and System Administration Manual

DKDIAG(1M) DKDIAG(1M)
E-26 CommKit Host Interface, Release 4.0
NAME
dkdiag – diagnose AT&T host interface hardware
SYNOPSIS
dkdiag { –a | p phases} -i interface [ -n iterations –s ] [ -l ] [ –v ]
DESCRIPTION
dkdiag allows the administrator to diagnose the host interface hardware when the interface is not active. A
number of options are supported which modify the execution and reporting characteristics of the diagnostics.
These options are described below.
–a Run ALL diagnostic phases. This option is logically equivalent to –p0,1,2,3,4,5,6,7,8. This
option may not be used in conjunction with the -p option.
–p phases Run diagnostic phases specified in the comma separated list of numerical phase IDs. The
phases may be specified in any order but must be valid codes. This option may not be used
in conjunction with the –a option.
–i interface Diagnose interface board interface. Use 0 for the first interface board, 1 for the second
interface board, etc.
–n iterations Run iterations repetitions of the selected diagnostic phases. If neither the -n nor the –s
option is specified, dkdiag assumes -n 1. This option may not be used in conjunction with
the -s option.
–s Run the selected diagnostic phases in SOAK mode. This option causes the selected
diagnostic phases to be run continuously until terminated by a QUIT signal. The key
sequence that produces the QUIT signal can be determined by executing stty –a and
examining the "quit" field. Note that the ’^’ character represents the CTRL key as defined
in the stty(1) manual page. The –s option may not be used in conjunction with the –n
option.
–l Test Local loopback with loop-around fiber. This option uses an algorithmic design to
prevent spurious errors when testing with a local loop-around fiber.
–v Turn on VERBOSE mode which radically increases the amount of information printed.
Normally, only errors or problem conditions result in printed messages. VERBOSE mode
causes printed messages for all phases and tests even if they are successful.
When more than a single iteration of the diagnostics are run with either the –n or –s options, a status report
may be scheduled for printing at the end of the current iteration by typing the INTERRUPT character. This
allows the administrator to periodically query a long-running or SOAK mode set of diagnostics. The QUIT
character is interpreted by dkdiag as a request for it to terminate at the end of the current iteration.
The individual diagnostic phases are:
0 Dump Registers
Perform a read of the interface CSR. This phase always passes, and the result is reported
only when the –v flag is specified.
1 Read/Write Control Register
Verify that the control and status register command bits and status flags perform as
expected.
2 FIFO Flags
Measure the depth of the Receive and Transmit FIFOs and test operation of the FIFO
utilization indicators.
3 FIFO Operation
Perform an internal loop-around transmission of all possible URP channel numbers, data
values, and control code values to verify proper operation of FIFO circuitry.