erruser(1M)                                                     erruser(1M)

NAME
     erruser - browse through system error log files

SYNOPSIS
     /usr/bin/erruser -f file -p pattern [-C criteriafile]

DESCRIPTION
     erruser allows a user to browse through the vsm error log files that
     reside in the /var/adm/error directory. Since these files are in
     binary format, they are unreadable and must be interpreted.

OPTIONS
     -f   The name of the error log file to browse through.

     -p   device pattern. Use this to browse through log entries that were
          made by a specific device logger. For example to browse through
          only the entries that were logged by the ios disk driver, specify
          "pyr_iosdisk". The pattern can be any regular expression that
          conforms to gmatch(3G). More examples are given below in the
          EXAMPLES section.

     -C   full pathname of criteriafile. A criteria file is used to carry
          out extensive filtering of log entries. Here are some rules
          regarding the criteria.

          The format of a criteria file is:

          identifier operator value [logical identifier operator value ...] $

          Legal operators are:

          EQ    -      Equal to
          NEQ   -      Not equal to
          LT    -      Less than
          LTE   -      Less than or equal to
          GT    -      Greater than
          GTE   -      Greater than or equal to

          Legal identifiers and their range of field operators:

          log date    EQ, LT, LTE, GT, GTE
          error type  EQ, NEQ
          severity    EQ, NEQ
          device name EQ, NEQ

          Legal values are:

          log date    "Month day year"
          error type  ETNONE, ETGOTS, ETSTOP, ETSOFT, ETHARD, ETMEDIA
          severity    ESNONE, ESNOTE, ESWARN, ESERROR, ESPANIC,
                      ESCONT, ESCOR, ESUNCOR
          device name Any regular expression that conforms to gmatch(3G).



Page 1                       Reliant UNIX 5.44                Printed 11/98

erruser(1M)                                                     erruser(1M)

          logical operators are:

          AND         And
          OR          Or

NOTES
     Any field identifier or field value that is more than one word in
     length must be enclosed in quotes. Do not forget the $ sign at the end
     of line in the criteria file.

EXAMPLES
     Specifying a device pattern:

          To print all log entries that were logged by a SCSI driver:

           erruser -f file -p pyrios*

          To print all log entries in a file:

           erruser -f file -p pyr*

     Criteria format:

          To print the log entries that have a severity of ESERROR:

           severity EQ ESERROR $

          To print all the log entries that have a severity of ESERROR and
          an error type of ETHARD:

           severity EQ ESERROR AND "error type" EQ ETHARD $

          To print all the log entries that were logged between April 1st,
          1991 and June 12th, 1991:

           "log date" GTE "Apr 1 1991" AND "log date" LTE "Jun 12 1991" $

FILES
     /var/adm/error/vsmerrfile.current
          current vsm error log file

     /var/adm/error/errlog.db
          default vsm error log database

SEE ALSO
     errsum(1M), error(7), errord(8).








Page 2                       Reliant UNIX 5.44                Printed 11/98