uerf(8) — Maintenance
Digital
NAME
uerf − Error report formatter
SYNOPSIS
/usr/sbin/uerf [ options ... ]
DESCRIPTION
The uerf command produces a record of system events. These events include error messages relating to the system hardware and the software kernel as well as information about system status, startup, and diagnostics.
The error log files are created with 640 mode. The files are owned by root and belong to the system group. If you want to use the uerf command, you must belong to the system group or have superuser privileges.
FLAGS
-c classesSelects classes of events.
errReports all hardware-detected and software-detected errors.
maintReports any event that occurs during system maintenance (for example, if you run a system exerciser).
operReports information on system status, autoconfiguration, device status, device errors, time stamps, and system startup and shutdown.
-D [disks]Reports errors for the specified disk type (for example, rz55) or class (for example, rz). If you do not specify the disk type, errors for all disk types are reported.
-f filenameOutputs error information from the specified file instead of the /usr/adm/binary.errlog default error log file. The filename and location of the default error log file is defined by the ∗.∗ entry in the /etc/binlog.conf file. Use the -f option to examine old or backup error log files. You must specify the full path name for the file.
-hDisplays a brief help message. If you specify any other option with the −h option, it is ignored.
-H hostReports errors from the specified system. Use the −H option when you want to forward errors from multiple remote systems to the local host.
-M [mainframe_errors]
Reports mainframe error types. If you do not specify any parameters, all mainframe errors are reported. You can specify the following mainframe error types:
cpuReports CPU-related errors, such as machine checks.
memReports memory-related errors, such as single-bit corrected read data (CRD) and double-bit uncorrectable errors.
-nOutputs errors as they occur in real time before logging the errors in the error log file. This option can be used to monitor errors while you are running a disk or tape exerciser. You cannot use the -n option with the -f option.
-o output
Outputs errors in brief, full, or terse format. The default output is brief. You can specify the following formats:
briefReports error information in a short format.
fullReports all available information for each entry.
terseReports error information and displays register values, but does not translate.
-O [operating_system_events]
Reports operating system events such as panics and exceptions and faults. If you do not specify any parameters, all operating system events are reported. You can specify the following events:
aefArithmetic exception faults
astAsynchronous trap exception faults
pagPage faults
pifPrivileged instruction faults
proProtection faults
ptfPage table faults
rafReserved address faults
rofReserved operand faults
scfSystem call exception faults
segSegmentation faults
-R reverse chronological order
Outputs error information in reverse chronological order.
-r recordsReports errors for the specified record code or codes. You can specify the following record codes:
Hardware-Detected Errors
100CPU machine checks and exceptions
101Memory errors (soft and hard)
102Disk errors
103Tape errors
104Device controller errors
105Adapter errors
106Bus errors
107Stray interrupts
108Console events
109Stack dump
199CAM (SCSI) events
Software-Detected Events
201ci ppd events
202scs events
Informational ASCII Messages
250Informational
Operational Messages
300Start up
301Shutdowns and reboots
302Panics
350Diagnostics status
-s sequence_numbers
Reports errors that are included in the specified sequence of numbers. You also can specify other options to select the error types in the sequence that you want reported.
−SProduces a summary report of the selected events.
-t time_range
Reports the errors that are included in the specified time range. If you do not specify the −t option, the uerf command processes the error log file from beginning to end. You can specify a starting time and ending time. The default date is the current date, the default starting time is 00:00:00, and the default ending time is 23:59:59. Use the following syntax to specify the time sequence:
uerf −t s: dd-mmm-yyyy,hh:mm:ss e: dd-mmm-yyyy,hh:mm:ss
The s: parameter specifies the starting time, and the e: parameter specifies the ending time.
-T [tapes]Reports errors for the specified tape type (for example, tz30) or class (for example, tz). If you do not specify any parameters, errors for all tape types are reported.
-u unit number
Reports errors for the specified unit number. This option can be used with −D or −T option.
-xExcludes all the selection options specified in the command line. This option does not affect the −f, −h, −H, −o, −R, and -t options.
-ZProduces ouput in hex format.
RESTRICTIONS
The uerf command uses the uerf.bin, uerf.hlp, and uerf.err data files. The uerf.bin file is the event information data base. The uerf.hlp file is the help file. The uerf.err file is the error message file. The uerf command expects to find the data files in the /usr/sbin directory.
By default, the uerf command outputs the contents of the error log file specified by the ∗.∗ entry in the /etc/binlog.conf configuration file. To report on any other error log file or if there is no ∗.∗ entry, you must use the uerf command with the −f option.
Do not specify any other option with the −h option.
Some hardware and system errors are logged as ASCII informational messages. Use the logger command with the -b option to log informational messages. Use the uerf command with the -r 250 option to report information messages.
Additional error information also is logged by the daemon in the file specified by the kern.debug and syslog.debug entries in the /etc/syslog.conf file. These log files are in ASCII format; you do not have to use the uerf command to read these files.
RESTRICTIONS
The uerf command is not compatible with binary error log files produced by ULTRIX or DEC OSF/1 Version 1.0 operating systems.
EXAMPLES
The following example produces a report containing all error events, excluding logged operating system errors and operator and maintenance class errors:
uerf -O -x -c oper,maint
The following example produces an error report from the /usr/adm/binary.errlog.old file:
uerf -f /usr/adm/binary.errlog.old
The following examples produce error reports for the specifiedrecord codes:
uerf -r 100,102
uerf -r 100-109
The following example produces a report of all the errors that occurred between 10:47 a.m. on April 13, 1986 and 5:30 p.m. on April 20, 1986:
uerf -t s:13-apr-1986,10:47:00 e:20-apr-1986,17:30:00
The following example produces an error report of the errors that occurred on the current day and year, starting at 1:20 p.m. and ending at the current time:
uerf -t s:13:20
The following example produces a report of all logged errors and displays it in reverse chronological order, starting with the current date and time:
uerf -R
FILES
/usr/adm/binary.errlog default error log file
/etc/binlog.conf binlogd configuration file
/usr/sbin/uerf.err uerf error message file
/usr/sbin/uerf.hlp uerf help file
/usr/sbin/uerf.bin event information data base file