error

Purpose

     Logs system events.

Synopsis

     #include <sys/err.h>
     #include <sys/erec.h>

Description

     The  format of  an event  record depends  on the  type of
     event encountered.   Each record,  however, has  a header
     with the following format:

          struct errhdr {
              unsigned  e_len;      /* word in record (with header) */
              time_t    e_time;     /* time of day */
              long      e_timex;    /* clock ticks */
              char      e_nid[8];   /* node ID */
              char      e_vmid[8];  /* virtual machine ID */
              union {
                 struct  {
                    char  ex_class;
                    char  ex_subclass[2];
                    char  ex_type;  /* record type */
                 } ex;
                 int csmt;
              } exx;
          };

     The  error daemon  searches  the  RAS configuration  file
     /etc/rasconf  for  a  stanza labeled  /dev/error.   Minor
     device 0 of  the error driver is the  interface between a
     process and  the routines  that collect  error-records in
     the system.  This  driver can be opened  only for reading
     by a  process (usually  the error daemon)  with superuser
     permission.  Each read retrieves  an entire error record.
     A read request of less  than the entire record causes the
     retrieved record to be truncated.  Multiple processes can
     open the error file to write.

File

     /dev/error

Related Information

     In this book:  "errunix," and  "rasconf."

     The  errdemon command  in AIX  Operating System  Commands
     Reference.

     Device Driver Development Guide.