NAME

delog − diagnostic event logger for I/O subsystem. 

SYNOPSIS

delog [ [-e [number]] | [-w] ]  [-b]  [-d dev file]
[-f outfile] [-L error log] [-U vmunix] [-V version]

DESCRIPTION

In general, delog only reads in an event message from the diagnostic driver and then writes it to a log file, with no information being sent to the system console.  The event message can then by decoded into human-readable format at some later time by decode.  By using various options delog can write a synopsis of the messages to the system console and/or to a designated file.  These options, as described below, allow the user to tune the output of delog to the needs of the system. 
 
Delog accepts the following list of parameters:
 

-e number print out a brief synopsis for only fatal diagnostic events.  See below for a description of number.  Number can be 1 or 2. 

-w print out a brief synopsis of the diagnostic event. 

-b send a synopsis to both the system console and a user defined file. 

-d dev file set the device file path name (defaults to /dev/diag0). 

-f outfile set the output file path name (defaults to /dev/null). 

-L error log set the error log path name (defaults to /usr/adm/diaglog). 

-U vmunix set the vmunix path name (defaults to /hp-ux). 

-V version set the version number of the vmunix file (default is to be determined). 

Messages sent either to the system console or a user defined file take on the following format:
 

    Diagnostic class type from XX (at a.b.c) status = x
    Hw stat = (hardware status printout as a HEX string)

Where:

class is replaced with either hardware or software. 

type is replaced with either error or warning. 

XX is the name of the driver that reported the event. 

a.b.c is the hardware path derived from the I/O tree. 

x is an ASCII string corresponding to the LLIO status. 

The -w option prints out, on the system console, warning and error information.  Warnings are informational and are not usually significant.  Errors may be informational or they may be reports of fatal errors.  Therefore, a large amount of data, mostly informational, will go to the system console. 
 
The -e option causes delog to print messages that are only I/O subsystem errors.  However, because of the nature of I/O subsystem messages, not all superfluous informational messages can be suppressed.  To further reduce the amount of data written to the system console, the -e option has a numeric parameter, number.  The default value of number is 1 if nothing is specified.  When number is 2, the hardware status is suppressed.  The format of the output for the -e option is the same as that of the -w option.  (Note: the -e and -w options are mutually exclusive.) 
 
The synopsis message can be redirected to a file using the -f option.  In combination with the -b option the messages can be sent to the system console and the designated file.  If the -b option is used by itself, the result is the same as if the -w option were specified. 
 
Because the read function of the diagnostic driver is exclusive, only one delog logging process can be run at a time. 

RETURNS

If the diagnostic driver cannot be opened, delog will exit with a non-zero status.  If the log file cannot be opened, delog will not complain, instead delog prints a synopsis of the event on the system console (and the user defined file, if specified) and continues. 

WARNINGS

Delog does not do any error log manipulation.  If the file used for error logging becomes too large, it is up to a system administrator to clear it out. 

AUTHOR

Delog was developed by HP. 

FILES

/etc/rc
/dev/diag0
/usr/adm/diaglog
/hp-ux

SEE ALSO

decode(1M), diag0(7). 

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