unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



uerf(8)								      uerf(8)



NAME

  uerf - Event report formatter

SYNOPSIS

  /usr/sbin/uerf [options]

OPTIONS

  -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 exam-
	  ple, if you run a system exerciser).

      oper
	  Reports information on system	status,	autoconfiguration, device
	  status, device events, time stamps, and system startup and shut-
	  down.

  -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 loca-
      tion 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	main-
      frame 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 start-
      ing 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

   1.  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

   2.  The following example produces an event report from the
       /usr/adm/binary.errlog.old file:
	    uerf -f /usr/adm/binary.errlog.old

   3.  The following examples produce event reports for	the specified record
       codes:
	    uerf -r 100,102

	    uerf -r 100-109

   4.  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

   5.  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

   6.  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

SEE ALSO

  Commands: logger(1), binlogd(8), syslogd(8)