ERRUNIX(3x,L)               AIX Technical Reference               ERRUNIX(3x,L)



-------------------------------------------------------------------------------
errunix



PURPOSE

Logs application errors.

LIBRARY

Run-time Services Library (librts.a)

SYNTAX

int errunix (buf, cnt)
char *buf;
unsigned short cnt;

DESCRIPTION

The errunix subroutine invokes the application error device driver to record an
error log entry.  errunix is a C run-time subroutine.  Device drivers should
use the errsave kernel subroutine to log error messages.

If the error device driver is not open, errunix opens it.  Then the error log
entry is written to it.

The buf parameter points to a buffer that contains the following information:

  1. A word (int) that contains the class, subclass, mask, and type of the
    message, as defined in the discussion of "error."

  2. An int that specifies the number of words of dependent data for the error
    log entry, including this int itself.

  3. Words that contain the dependent information for the error log entry.  The
    number of dependent data words must be one less than the word count
    specified immediately before them.

The other fields of the error log header (length, date and time, time extended,
and node name) are supplied for you automatically.

The cnt parameter specifies the number of bytes in the buffer pointed to by
buf.  The cnt parameter must be a multiple of 4.

RETURN VALUE

Upon successful completion, a value of 0 is returned.  If the errunix
subroutine fails, an error message is written to the standard error output, and
a value of -1 is returned.




Processed November 7, 1990       ERRUNIX(3x,L)                                1

ERRUNIX(3x,L)               AIX Technical Reference               ERRUNIX(3x,L)



FILE

/dev/error

RELATED INFORMATION

In this book:  "error."
















































Processed November 7, 1990       ERRUNIX(3x,L)                                2