err(7)                         DG/UX 5.4R3.00                         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 loggable 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 loggable 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 an 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

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





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

err(7)                         DG/UX 5.4R3.00                         err(7)


SEE ALSO
       syslogd(1M), syslog(3), syslogd.conf(5), logger(7).























































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