err(7)                     DG/UX 4.30                      err(7)



     NAME
          err - error-logging interface

     DESCRIPTION
          The error logger  character  special  pseudo-device  is  the
          means  by  which  information about various system events is
          obtained  from  the  DG/UX  kernel  for  recording  in  more
          permanent storage, such as a disk file.

          Information about logable events is collected regardless  of
          whether  the  error  logger  device  is  open.   However, an
          implementation of the error logger may limit the  number  of
          error  events that is stored internally.  If a logable event
          occurs and there is no space for the error  event,  the  new
          event may be discarded.  Space occupied by an error event is
          freed when the event is read using the read system call.

          The open system call makes the error logger device available
          for  reading.   The  error logger may not be opened if it is
          currently open; the error  EBUSY  is  returned  on  such  an
          attempt.

          The close system call makes the error logger available to be
          opened again.

          The read system call transfers  one  error  event  from  the
          internal  error logger database to the caller's buffer.  The
          file pointer is ignored; each call to read returns  at  most
          one,  or part of one, error event.  The data returned to the
          user consists of a error  priority  string  followed  by  an
          ASCII  error  message.   The  error  priority string has the
          format "<error priority>" where error priority is defined in
          <sys/syslog.h>.   If  the  total  size of the error event is
          greater than the size of  the  caller's  buffer,  the  error
          event  is  truncated  to the size of the caller's buffer and
          the remaining data is left in the database for a  subsequent
          read.  If  no  error event is available to be read, the read
          pends until a event is available (unless the file descriptor
          NDELAY flag is set).

          The error logger does not support the write system call. The
          error ENODEV is always returned.

          There are no  ioctl  system  calls  specific  to  the  error
          logger.  The error EINVAL is always returned.

          Select always returns READY for  write  operations.   Select
          returns  READY for read operations only if there is an error
          event available to be read.

     FILES
          /dev/error          Error logger device node



     Licensed material--property of copyright holder(s)         Page 1

     err(7)                     DG/UX 4.30                      err(7)



          /usr/include/sys/syslog.h     Include   file   with    error
          priority definitions

     SEE ALSO
          syslogd(8), syslog(3), syslogd.conf(5).


















































     Licensed material--property of copyright holder(s)         Page 2