 |
Index for Section 8 |
|
 |
Alphabetical listing for U |
|
uerf(8)
NAME
uerf - Event report formatter
SYNOPSIS
/usr/sbin/uerf [ options ... ]
FLAGS
-c classes Selects classes of events.
err Reports all hardware-detected and software-detected events.
maint Reports any event that occurs during system maintenance (for
example, if you run a system exerciser).
oper Reports information on system status, autoconfiguration, device
status, device events, time stamps, and system startup and shutdown.
-D [disks] Reports events for the specified disk type (for example, rz55)
or class (for example, rz). If you do not specify the disk
type, events for all disk types are reported.
-f filename Outputs event information from the specified file instead of
the /usr/adm/binary.errlog default event log file. The
filename and location of the default event log file is defined
by the *.* entry in the /etc/binlog.conf file. Use the -f
option to examine old or backup event log files. You must
specify the full path name for the file.
-h Displays a brief help message. If you specify any other option
with the -h option, it is ignored.
-H host Reports events from the specified system. Use the -H option
when you want to forward events from multiple remote systems to
the local host.
-M [mainframe_errors]
Reports mainframe event types. If you do not specify any
parameters, all mainframe events are reported. You can specify
the following mainframe event types:
cpu Reports CPU-related events, such as machine checks.
mem Reports memory-related events, such as single-bit corrected read
data (CRD) and double-bit uncorrectable events.
-n Outputs events as they occur in real time before logging the events
in the event log file. This option can be used to monitor events
while you are running a disk or tape exerciser. You cannot use the
-n option with the -f option.
-o output
Outputs events in brief, full, or terse format. The default output
is brief. You can specify the following formats:
brief Reports event information in a short format.
full Reports all available information for each entry.
terse Reports event 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:
aef Arithmetic exception faults
ast Asynchronous trap exception 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
-R reverse chronological order
Outputs event information in reverse chronological order.
-r records Reports events for the specified record code or codes. You can
specify the following record codes:
Hardware-Detected Events
100 CPU machine checks and exceptions
101 Memory events (soft and hard)
102 Disk events
103 Tape events
104 Device controller events
105 Adapter events
106 Bus events
107 Stray interrupts
108 Console events
109 Stack dump
199 CAM (SCSI) events
Software-Detected Events
201 ci ppd events
202 scs events
Informational ASCII Messages
250 Informational
Operational Messages
300 Start up
301 Shutdowns and reboots
302 Panics
350 Diagnostics status
-s sequence_numbers
Reports events that are included in the specified sequence of
numbers. You also can specify other options to select the
event types in the sequence that you want reported.
-S Produces a summary report of the selected events.
-t time_range
Reports the events that are included in the specified time
range. If you do not specify the -t option, the uerf command
processes the event 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 events for the specified tape type (for example, tz30)
or class (for example, tz). If you do not specify any
parameters, events for all tape types are reported.
-u unit number
Reports events for the specified unit number. This option can
be used with -D or -T option.
-x Excludes all the selection options specified in the command
line. This option does not affect the -f, -h, -H, -o, -R, and
-t options.
-Z Produces output in hex format.
DESCRIPTION
The uerf command produces a record of system events. These events include
event messages relating to the system hardware and the software kernel as
well as information about system status, startup, and diagnostics.
The event 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.
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 event 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 event log file
specified by the *.* entry in the /etc/binlog.conf configuration file. To
report on any other event 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 events 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 event information also is logged by the syslogd 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.
The uerf command is not compatible with binary event log files produced by
ULTRIX or DEC OSF/1 Version 1.0 operating systems.
EXAMPLES
The following example produces a report containing all event events,
excluding logged operating system events and operator and maintenance class
events:
uerf -O -x -c oper,maint
The following example produces an event report from the
/usr/adm/binary.errlog.old file:
uerf -f /usr/adm/binary.errlog.old
The following examples produce event reports for the specified record
codes:
uerf -r 100,102
uerf -r 100-109
The following example produces a report of all the events 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 event report of the events 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 events and displays
it in reverse chronological order, starting with the current date and time:
uerf -R
FILES
/usr/adm/binary.errlog default event log file
/etc/binlog.conf binlogd configuration file
/usr/sbin/uerf.err uerf event message file
/usr/sbin/uerf.hlp uerf help file
/usr/sbin/uerf.bin event information data base file
RELATED INFORMATION
binlogd(8)
syslogd(8)
logger(1)