uerf(8)

NAME

uerf − ULTRIX error report formatter

SYNTAX

/etc/uerf [ option ... ]

DESCRIPTION

The uerf command prints 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.

OPTIONS

-c classesSelects classes of events.

errReports all hardware- and software-detected errors.

maintReports any event that occurs during system maintenance, for example, running the on-line functional exercisers.

operReports information on system status, autoconfiguration messages, device status or error messages, time stamps, and system startup and shutdown messages.

-D disksSelects the disk device type. If you do not specify any parameters, all disk types are reported.

-f filenameOutputs error information from the specified file rather than the default errorlog file /usr/adm/syserr/syserr.hostname. Hostname is the name of the local system. Use this option to look at old or backup errorlog files not in the default location /usr/adm/syserr. You can also use this option to access the default single-user errorlog file /syserr.hostname. Specify the full path name for the file. Do not use the −n option with this option.

-hDisplays a brief help message. If you specify any other option with the −h option, it is ignored.

-H hostSelects errors for the system indicated. Use the −H option when you are logging errors from multiple remote systems to a single errorlog file on the local host.

-M mainframe_errors
Selects mainframe error types. If you do not specify any parameters, all error types are reported.

cpuReports CPU-related errors such as machine checks.

memReports memory-related errors such as single-bit CRD (corrected read data) and double-bit uncorrectable errors.

-nDisplays errors as they occur in real time before logging them in the errorlog file. This option is useful in monitoring errors while a disk or tape exerciser is run. You cannot use this option with the −f option.

-o outputOutputs errors in brief, full, or terse format. The default output is brief.

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
Selects operating system events such as panics and exceptions and faults. If you do not specify any parameters, all ULTRIX operating system events are reported. Reports are as follows:

aefArithmetic exception faults

astAsynchronous trap exception faults

bptBreakpoint instruction faults

cmpCompatibility mode faults

pagPage faults

pifPrivileged instruction faults

proProtection faults

ptfPage table faults

rafReserved address faults

rofReserved operand faults

scfSystem call exception faults

segSegmentation faults

traTrace exception faults

xfcReports xfc instruction faults

-R reverse chronological order
Outputs selected error information in reverse chronological order.

-r recordsReports errors for the selected record codes. Valid codes are:

Hardware-Detected Errors

100Machine check

101Memory corrected read data/read data substitute (crd/rds)

102Disk errors

103Tape errors

104Device controller errors

106Bus errors

107Stray interrupts

108Asynchronous write errors

109Exceptions/faults

112Stack dump

Software Detected Errors

200Panics (bug checks)

Informational ASCII Messages

250Informational

Operational Messages

300Start up

301Shutdown

310Time change

350Diagnostic information

351Repair information

-s sequence_numbers
Reports errors for selected sequence numbers. When used by itself, this option will give all records with specified sequence numbers in the file.

-t time_range
Selects errors for the specified time range. Without the −t option, the uerf command processes the errorlog file from beginning to end. A start date or time or an end date or time must be specified with the −t option. For partial entries, the default date is the current date, the default start time is 00:00:00, and the default end time is 23:59:59. The format is as follows:

uerf −t s:dd-mmm-yyyy,hh:mm:ss e:dd-mmm-yyyy,hh:mm:ss

Where:

sSpecifies the start date and time

eSpecifies the end date and time

ddDay

mmmMonth

yyyyYear

hhHour

mmMinute

ssSecond

-T tapesSelects the tape device type. If you do not specify any parameters, all tape types are reported.

-xExcludes specified selection options from the report, whether they appear before or after the option. This option does not affect the −f, −h, −H, −n, −o, −R, −t options.

-ZDisplays the entry in hex format.

RESTRICTIONS

The uerf command uses the data files uerf.bin, uerf.hlp, and uerf.err. The uerf.bin file is the event information data base, the uerf.hlp file is the help file, and the uerf.err file is the error message file.

The uerf command searches for the uerf data files as follows:

1.If uerf is invoked with a full pathname, the uerf first checks that directory for the uerf data files.

2.Then the /etc directory is checked.

3.And finally, directories specified in the Shell PATH environment variable are checked.

The uerf command outputs the contents of the errorlog file in the directory specified in /etc/elcsd.conf. To report on any other errorlog file, such as the single-user errorlog file, you must use uerf with the −f option.

Do not specify any other option with the −h option.

You cannot use the −n option and the −f option together.

Some hardware and system-related errors are logged as ASCII informational messages. Use the −r option with record type 250 to output these errors.

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 named file:

uerf -f /usr/adm/syslog/olderrorfile

The following examples show how to produce error reports for specific record codes:

uerf -r 100,102
uerf -r 100-109

The following examples show how to produce error reports using the −t option. This example lists all errors 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 for all logged errors on the current day and year, which starts at 1:20 p.m. and ends at the current time.

uerf -t s:13:20

The next example produces an error report for all logged errors and displays it in reverse chronological order, starting with the current date and time.

uerf -R

FILES

/usr/adm/syserr/syserr.system namemultiuser default errorlog file

/etc/uerf.erruerf error message file

/etc/uerf.hlpuerf help file

/etc/uerf.binevent information data base file

Museum

Related Articles