SysIII/usr/src/man/man1/errpt.1m

.TH ERRPT 1M
.SH NAME
errpt \- process a report of logged errors
.SH SYNOPSIS
.B errpt
.RB [\| \-a \|] 
.RB [\| \- dev\|] .\|.\|.
.RB [\| \-int \|]
.B [\| \-mem \|]
.RB [\| \-s " date\|]"
.RB [\| \-e " date\|]"
.RB [\| \-p n\|]
.B [\| \-f \|]
[\|files\|]
.SH DESCRIPTION
.I Errpt\^
processes data collected by the error logging
mechanism
.RI ( errdemon (1M))
and generates a report of that data.
The default report is a summary of all errors posted in the files named.
Options apply to all files and are described below.
If no files are specified,
.I errpt\^
attempts to use
.B /usr/adm/errfile
as
.IR file .
.PP
A summary report notes the options that may
limit its completeness, records the time stamped on
the earliest and latest errors encountered, and
gives the total number of errors of one or more types.
Each device summary contains the total number
of unrecovered errors, recovered errors,
errors unabled to be logged,
I/O operations on the device,
and miscellaneous activities that occurred on the device.
The number of times that
.I errpt\^
has difficulty reading input data
is included as read errors.
.PP
Any detailed report contains, in addition to specific error information,
all instances of the error logging process being started
and stopped, and any time changes (via
.IR date (1))
that took
place during the interval being processed.
A summary of each error type included in the report is
appended to a detailed report.
.PP
A report may be limited to certain records in the
following ways:
.PP
.TP 16
.BI \-s " date\^"
Ignore all records posted earlier than
\fIdate\fR,
where
.I date\^
has the form \fBmmddhhmmyy\fR,
consistent in meaning with the
.IR date (1)
command.
.TP
.BI \-e " date\^"
Ignore all records posted later than
.IR date ,
whose form is as described above.
.TP
.BR \-a	
Produce a detailed report that includes all error types.
.TP
.I \-dev\^
A detailed report is limited to 
.IR dev ,
a block device identifier.
.I Errpt\^
is familiar with the common form of identifiers (e.g., rs03, \s-1RS\s+1\&04, hs;
see Section\ 4 of this volume).
Currently, the block devices for which errors
are logged are
.SM RP\*S03,
.SM RP\*S04,
.SM RP\*S05,
.SM RP\*S06,
.SM RS\*S03,
.SM RS\*S04,
.SM TU\*S10,
.SM TU\*S16,
.SM RK\*S05,
and
.SM RF\*S11.
.TP
.B \-int
Include in a detailed report errors of the stray-interrupt type.
.TP
.B \-mem
Include in a detailed report errors of the memory-parity type.
.TP
.BI \-p " n\^"
Limit the size of a detailed report to
.I n\^
pages.
.TP
.B \-f
In a detailed report, limit the reporting of block device errors to
unrecovered errors.
.SH FILES
/usr/adm/errfile	default error file
.SH SEE ALSO
errdemon(1M),
errfile(5).