errpt(1M)

NAME

errpt − process a report of logged errors

SYNOPSIS

errpt [ options ] [ files ]

DESCRIPTION

errpt processes data collected by the error logging mechanism ( 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, errpt attempts to use /var/adm/errfile as file.

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 errpt has difficulty reading input data is included as read errors.

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 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.

A report may be limited to certain records in the following ways:

−s date Ignore all records posted earlier than date, where date has the form mmddhhmmyy, consistent in meaning with the date(1) command.

−e date Ignore all records posted later than date, whose form is as described above.

−a Produce a detailed report that includes all error types.

−ddev A detailed report is limited to data about devices preceded with the -d option. errpt is familiar with the identifiers disk, tape, rdisk, and rtape, which stand for the block disk device, the block tape device, the raw disk device and the raw tape device, respectively. The additional identifiers int, fault (or mem), ioerr, and sys include detailed reports of stray-interrupts, SYSFAULT errors (including memory parity errors), HVME and VME I/O buserrors, and system events respectively.

−p n Limit the size of a detailed report to n pages.

−f In a detailed report, limit the reporting of block device errors to unrecovered errors.

HDC ERRORS

The first line of each HDC error includes the error number, a brief description of the error, and the number of times the error occurred (the operation may have been retried). The second line of each error may or may not be present. It includes the logical disk address and a diagnostic word. The diagnostic word is useful only to someone familiar with the HDC hardware. Up to five errors are listed for each disk operation. If there are more than five errors, then the total number of errors is printed. If the error involved a disk media flaw, then a line of the form "cyl xxx head xx offset xxxx length xxxx" is printed. This is the ascii flaw record which, when added to the disk’s flawmap, corrects the flaw - see format(1M). The next line includes the drive model code, the HDC command number, and a brief description of the command. For some errors, a line is printed which indicates a possible diagnosis of why the error occurred. The last information provided for HDC errors is a dump of the mcb and master mcb - this is useful only to someone familiar with the HDC hardware or software.

FILES

/var/adm/errfile default error file

Museum