Content-type: text/html
Man page of uerf
uerf
Section: Maintenance Commands (8)
Index
Return to Main Contents
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)
delim off
Index
- NAME
-
- SYNOPSIS
-
- FLAGS
-
- DESCRIPTION
-
- RESTRICTIONS
-
- EXAMPLES
-
- FILES
-
- RELATED INFORMATION
-
This document was created by
man2html,
using the manual pages.
Time: 02:40:34 GMT, October 02, 2010