uerf(8)uerf(8)Nameuerf - 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 intercon‐
nect.
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 main‐
tenance, for example, running the on-line func‐
tional exercisers.
oper Reports information on system status, autoconfigu‐
ration messages, device status or error messages,
time stamps, and system startup and shutdown mes‐
sages.
-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.host‐
name. 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.
-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 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.
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 uncor‐
rectable errors.
-n Displays errors as they occur in real time before logging
them in the errorlog file. This option is useful in moni‐
toring 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 excep‐
tions 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 environ‐
ment 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 single-
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 informa‐
tional 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 Alsoelcsd.conf(5), elcsd(8), eli(8)
Guide to the Error Logger
uerf(8)
