*** UNIX MANUAL PAGE BROWSER ***

uerf(8) System Manager's Manual 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-de- tected events. maint Reports any event that occurs during system main- tenance (for example, if you run a system exer- ciser). oper Reports information on system status, autoconfigu- ration, 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 de- fined 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 op- tion when you want to forward events from multiple remote systems to the local host. -M ainframe_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 uncor- rectable 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 ex- erciser. You cannot use the -n option with the -f option. -o output Outputs events in brief, full, or terse format. The de- fault output is brief. You can specify the following for- mats: 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 excep- tions 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 com- mand processes the event log file from beginning to end. You can specify a starting time and ending time. The de- fault 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 in- clude event messages relating to the system hardware and the software kernel as well as information about system status, startup, and diag- nostics. 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 com- mand, 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 mes- sages. Use the logger command with the -b option to log informational messages. Use the uerf command with the -r 250 option to report infor- mation 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/bi- nary.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 ex- ample produces an event report of the events that occurred on the cur- rent 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 dis- plays 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 uerf(8)