uerf(8) System Manager's Manual uerf(8)
Name
uerf - ULTRIX error report formatter
Syntax
/etc/uerf [ option ... ]
Description
The 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
-A adapter ...
Selects adapter and device controller errors. All adapter error types are selected if none is specified.
aie Reports errors for BVP-type controller.
aio Reports errors for BVP-type controller.
bla Reports errors for the BI LESI adapter.
bua Reports errors for the BI UNIBUS adapter.
nmi Reports errors for the Nautilus memory interconnect.
uba Reports errors for the VAX UNIBUS adapter.
-c classes Selects classes of events.
err Reports all hardware- and software-detected errors.
maint Reports any event that occurs during system maintenance, for example, running the on-line functional exercisers.
oper Reports information on system status, autoconfiguration messages, device status or error messages, time stamps, and
system startup and shutdown messages.
-D disks Selects the mscp or scsi disk device type, for example, ra60 or rx23, or class, for example, ra or rx, about which to report
errors. If you do not specify any parameters, all disk types are reported. See for a list of supported
-f filename Outputs error information from the specified file rather than the default errorlog file /usr/adm/syserr/syserr.hostname. Host-
name 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.
-h Displays a brief help message. If you specify any other option with the -h option, it is ignored.
-H host Selects errors for the system indicated. Use the -H option when you are logging errors from multiple remote systems to a sin-
gle 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.
cpu Reports CPU-related errors such as machine checks.
mem Reports memory-related errors such as single-bit CRD (corrected read data) and double-bit uncorrectable errors.
-n Displays 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 output Outputs errors in brief, full, or terse format. The default output is brief.
brief Reports error information in a short format.
full Reports all available information for each entry.
terse Reports 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:
aef Arithmetic exception faults
ast Asynchronous trap exception faults
bpt Breakpoint instruction faults
cmp Compatibility mode faults
pag Page faults
pif Privileged instruction faults
pro Protection faults
ptf Page table faults
raf Reserved address faults
rof Reserved operand faults
scf System call exception faults
seg Segmentation faults
tra Trace exception faults
xfc Reports xfc instruction faults
-R reverse chronological order
Outputs selected error information in reverse chronological order.
-r records Reports errors for the selected record codes. Valid codes are:
Hardware-Detected Errors
100 Machine check
101 Memory corrected read data/read data substitute (crd/rds)
102 Disk errors
103 Tape errors
104 Device controller errors
105 Adapter errors
106 Bus errors
107 Stray interrupts
108 Asynchronous write errors
109 Exceptions/faults
110 8800 EMM exceptions/faults
111 Console timeouts
112 Stack dump
113 ka650 error and status
114 6200 vector 60
115 6200 vector 54
116 ka420 error and status registers
117 ka3100 error and status registers
118 6400 vector 60
119 6400 vector 54
120 ka60 mbus error
121 ka60 error and status registers
130 General Error and status registers
131 General Interrupt 60 errors
132 General Interrupt 54 errors
133 v9000 syndrome error
134 v9000 Keep Alive Failure
135 v9000 clock error entry
136 v9000 scan entry
137 v9000 configuration entry
138 Vector Entry
200 Panics (bug checks)
201 ci ppd info
202 scs events
Informational ASCII Messages
250 Informational
251 8600/8650 snapshot taken
Operational Messages
300 Start up
301 Shutdown
310 Time change
350 Diagnostic information
351 Repair 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.
-S Produces a summary report of selected events.
-t time_range
Selects errors for the specified time range. Without the -t option, the 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:
s Specifies the start date and time
e Specifies the end date and time
dd Day
mmm Month
yyyy Year
hh Hour
mm Minute
ss Second
-T tapes Selects the tmscp or scsi tape types (tk50 or tz30, for example) or class (tk or tz, for example) for which to report errors.
If you do not specify any parameters, all tape types are reported. See for a list of supported tmscp tape types.
-u unit number
Selects records by unit number. This option can be used with -D and/or -T option.
-x Excludes 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.
-Z Displays the entry in hex format.
Restrictions
The 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 command searches for the data files as follows:
1. If is invoked with a full pathname, the first checks that directory for the data files.
2. Then the directory is checked.
3. And finally, directories specified in the Shell PATH environment variable are checked.
The command outputs the contents of the errorlog file in the directory specified in To report on any other errorlog file, such as the sin-
gle-user errorlog file, you must use 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, for example, MASSBUS device errors and UNIBUS communi-
cation device errors. Use the -r option with record type 250 to output these errors.
Examples
The following example produces a report containing all uba and nmi errors:
uerf -A uba,nmi
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
multiuser default errorlog file
uerf error message file
/etc/uerf.hlp uerf help file
event information data base file
See Also
elcsd.conf(5), elcsd(8), eli(8)
Guide to the Error Logger
uerf(8)