NIO CommKit Host Interface Installation and System Administration Manual

DKLOAD(1M) DKLOAD(1M)
E-30 CommKit Host Interface, Release 4.0
DIAGNOSTICS
The following error and diagnostic messages are reported by dkload:
REMOTE could not open logfile as log
When the remote dkload cannot open the requested logfile, this error message is written to the
default logfile.
dkload LOCAL started at time to command PID=process_ID
dkload REMOTE started at time from command PID=process_ID
where command is made up from the command line and looks like:
destination..:–s:size:–n:iterations:–l:logfile.
This initialization information may be used to verify that the correct arguments were sent and
received by dkload.
After the first three bytes are transmitted and each time an additional 2048 bytes of data is
transmitted, an entry is made in the remote logfile specifying the process ID, total number of bytes
transmitted, and the time elapsed in seconds. When dkload detects bad reads, writes, and corrupted
data it writes the error messages to the logfile. The messages to the logfile are distinguished by the
words REMOTE and LOCAL, depending on whether the dkload on the remote or local side of the
virtual circuit wrote the message.
LOCAL TEST FINISHED OK
REMOTE TEST FINISHED OK
The test finished successfully. The message will also include the process ID, time, and number of
messages sent. The nread variable indicates the number of bytes read in the last iteration, and
countread specifies the number of iterations received.
REMOTE TEST FINISHED WITH ERRORS: Data Corruption
Some of the characters received did not match the expected characters. Each corrupted character is
written to the logfile along with the expected character as they are encountered. This message will
also include the process ID, time, and number of messages sent. The nread variable indicates the
number of bytes read in the last iteration, and countread specifies the number of iterations received.
LOCAL WRITE FAILED
REMOTE WRITE FAILED
A write(2) unexpectedly failed.
LOCAL READ FAILED
REMOTE READ FAILED
A read(2) unexpectedly failed.
LOCAL END OF FILE
REMOTE END OF FILE
The local or remote dkload process was killed manually.
LOCAL READ LENGTH ERROR
REMOTE READ LENGTH ERROR
The number of bytes returned from a read(2) was incorrect.
LOCAL Read string != Write string
REMOTE Read string != Write string
dkload detected data corruption. Each corrupted byte is written to the logfile along with the expected
value.