NAME

decode − read and decode diagnostic events from the error log

SYNOPSIS

decode [−L logfile] [−d devicefile] [−e phys_path] [−m major] [−n driver] [−p port] [−t n] [−w]

DESCRIPTION

Decode reads a series of encoded diagnostic event messages, selects some of them based on the options, and writes them in a human-readable format to the standard output. 

By default, if the standard input is a terminal, the event messages are read from the default log file /usr/adm/diaglog.  If the standard input is not a terminal, the event messages are read from the standard input. 

By default, all the logged events are shown. 

Options

-L logfile Read events from the named logfile instead of from the standard input or the default log file. 

−d devicefile Restrict the output to describe only events pertaining to the named device file. 

−e phys_path Restrict the output to describe only events pertaining to the specified physical hardware path.  The phys_path is expressed in the 1.2.3 notation. 

−m major Restrict the output to describe only events pertaining to devices with the specified major number. 

−n driver Restrict the output to describe only events pertaining to devices using the named driver. 

−p port Restrict the output to describe only events occuring on the specified port number. 

−t n If n is a positive integer, decode shows the last n selected events in the logfile.

If n is a negative integer, decode skips the first n selected events from the beginning of the file, and then shows any remaining selected events.  If there are fewer than n selected events in the file, nothing is shown. 

−w Wait for a newline to be entered from the standard input after displaying each event, so that the user can look at it before continuing.  If the user enters a line beginning with ’q’ (quit), decode exits immediately.  This option cannot be used if the diagnostic events are being read from the standard input. 

Each event written to standard output is in the following format:

Diagnostic event A number identifying the entry of the diagnostic event, assigned sequentially from the beginning of the log file. 

Time of event The date and time that diag0(7) processed the event. 

Reporting entity Manager name of reporting port number, derived from the I/O tree. 

Port number Port number of the I/O subsystem entity that reported the event. 

Physical path Physical path derived from the I/O tree and the manager-specific information. 

Classification Hardware event or software event. 

Low-level I/O status The unique number used to identify the status error and the I/O subsystem entity detecting the error. 

Hardware status Numerical data expressed as bytes in a hexadecimal string. 

Manager-specific information
Numerical data expressed as bytes in a hexadecimal string.

Other fields might appear, depending on the reporting entity.  Specific manager information and hardware status might also vary. 

RETURN VALUE

If the named logfile cannot be opened, decode exits with a non-zero status. 

WARNINGS

Decode attempts to decode the device manager-specific information for some diagnostic events into human-readable form.  In other cases, it displays the information in hexadecimal format. 

AUTHOR

Decode was developed by HP. 

FILES

/dev/diag0
/usr/adm/diaglog

SEE ALSO

delog(1M), diag0(7). 

Hewlett-Packard Company  —  HP-UX Release 7.0: Sept 1989