'\"macro stdmacro
.if n .pH g1a.hdelogger @(#)hdelogger	40.5.1.1 of 1/17/90
.\" Copyright 1989 AT&T
.nr X
.if \nX=0 .ds x} hdelogger 1M "Essential Utilities" "\&"
.if \nX=1 .ds x} hdelogger 1M "Essential Utilities"
.if \nX=2 .ds x} hdelogger 1M "" "\&"
.if \nX=3 .ds x} hdelogger "" "" "\&"
.TH \*(x}
.SH NAME
\f4hdelogger\f1 \- Hard Disk Error status report command and Log Daemon
.SH SYNOPSIS
\f4/usr/sbin/hdelogger\f1
[
\f4\-s\f1
] [
\f4\-f\f1
] [
\f4\-D\f1
maj min ]
.SH DESCRIPTION
This command is part of the bad block handling utility.
It is executed automatically by the 
\f4init\f1
in run levels 2, 3 and 4.
.PP
The
\f4hdelogger\fP
command serves two purposes.
When run by the
\f4init\f1
process [process 1 \- see
\f4init\fP(1M)],
this command performs the functions of the Hard Disk Error (HDE) Log Daemon.
These functions include providing summaries of outstanding errors
during system startup and shutdown transitions,
along with adding new errors to HDE Logs and giving the revised
status summaries as errors are reported by hard disk drivers.
When run as the daemon, no options are used.
.P
When run as a normal command (process 1 is not its parent),
this command provides on the spot reports of outstanding errors
as recorded in the HDE Logs of equipped hard disks.
You must be the super-user to run the command this way.
The following options control report generation:
.TP .75i
\f4\-s\f1
Specifies that summary reports are to be generated.
The summary report provides sufficient information
for normal bad block handling operations.
This is the default.
.TP
\f4\-f\f1
Specifies that full reports are to be generated.
This is intended mainly for testing the bad block handling feature,
but is available in case 
additional detail is needed for troubleshooting complicated problems.
.TP
\f4\-D\fP \f2maj\fP \f2min\fP
Restricts the report generation to a specific hard disk.
If this option is omitted,
reports will be generated for all equipped hard disks.
.SH FILES
\f4/dev/hdelog\f1
.SH "SEE ALSO"
\f4hdeadd\fP(1M), \f4hdefix\fP(1M), \f4hdelog\fP(7).
.br
Bad Block Handling, in the \f2System Administrator's
Guide\f1.
.SH DIAGNOSTICS
The HDE commands exit with one of three values:
.TP .5i
0
means NORMAL, or TRUE
.TP
1
means bad command usage or execution errors
.TP
2
means BAD BLOCKS or FALSE (but command executed successfully)
.Ee
