*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> uerf (8)              



NAME    [Toc]    [Back]

       uerf - Event report formatter

SYNOPSIS    [Toc]    [Back]

       /usr/sbin/uerf [options]

OPTIONS    [Toc]    [Back]

       Selects  classes of events.  Reports all hardware-detected
       and software-detected  events.   Reports  any  event  that
       occurs  during system maintenance (for example, if you run
       a system exerciser).  Reports information on  system  status,
 autoconfiguration, device status, device events, time
       stamps, and system startup and shutdown.   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.  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.  Displays a brief
       help message.  If you specify any other option with the -h
       option,  it is ignored.  Reports events from the specified
       system.  Use the -H option when you want to forward events
       from  multiple  remote systems to the local host.  Reports
       mainframe event types.  If you do not specify any  parameters,
  all mainframe events are reported.  You can specify
       the following mainframe event types:  Reports  CPU-related
       events,  such  as  machine checks.  Reports memory-related
       events, such as single-bit corrected read data  (CRD)  and
       double-bit  uncorrectable  events.  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.  Outputs events in
       brief, full, or  terse  format.   The  default  output  is
       brief.   You  can  specify  the following formats: Reports
       event information in a short format.  Reports  all  available
  information  for each entry.  Reports event information
 and displays register values, but does not translate.
       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: Arithmetic  exception  faults  Asynchronous
  trap  exception  faults  Page  faults Privileged
       instruction faults Protection  faults  Page  table  faults
       Reserved  address  faults  Reserved  operand faults System
       call exception faults Segmentation  faults  Outputs  event
       information   in  reverse  chronological  order.   Reports
       events for the specified record code or  codes.   You  can
       specify the following record codes: CPU machine checks and
       exceptions Memory events (soft and hard) Disk events  Tape
       events  Device controller events Adapter events Bus events
       Stray interrupts Console  events  Stack  dump  CAM  (SCSI)
       events  ci  ppd  events  scs events Informational Start up
       Shutdowns and reboots Panics  Diagnostics  status  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.  Produces
 a summary report of the  selected  events.   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.
              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.  Reports events for the specified
 unit number.  This option can be used with  -D
              or  -T  option.  Excludes all the selection options
              specified in the command line. This option does not
              affect  the  -f,  -h,  -H,  -o, -R, and -t options.
              Produces output in hex format.

DESCRIPTION    [Toc]    [Back]

       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    [Toc]    [Back]

       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

EXAMPLES    [Toc]    [Back]

       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

       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    [Toc]    [Back]

       default  event  log  file  binlogd configuration file uerf
       event message file uerf help file event  information  data
       base file

SEE ALSO    [Toc]    [Back]

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

[ Back ]
 Similar pages
Name OS Title
ecstats IRIX report global event counter activity
ecfind IRIX report processes using process-based event counters
fmt OpenBSD simple text formatter
fmt IRIX simple text formatter
fmt FreeBSD simple text formatter
adjust HP-UX simple text formatter
fmt Linux simple optimal text formatter
awf IRIX amazingly workable (text) formatter
alPendingEvents IRIX Get total number of event queued in event queue
alCheckEvent IRIX Looks for an event in the event queue and retrieves it.
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service