Intro(D3eels)

Intro -- EELS kernel logging library routines

Description

The Enhanced Event Logging System (EELS) supplies two programming interfaces for the committing of records to an event database. The first of these, the Distributed Audit Service (XDAS) implements a four stage record committal:

allocate a record
populate the record with data
timestamp the record
commit the record to the database

These functions are described in the Section 3xdas manual pages in Section 3xdas manual pages.

For applications requiring a ``generic'' logging interface for error conditions or debug information, for example, this four-stage process may impose unacceptable overheads. Accordingly, the generic logging API is supplied for systems requiring a single-stage event record committal, similar to the process used by syslog or cmn_err.

The generic logging API consists of the following functions:

eels_initialise(D3eels) Initialize an event logging session.

eels_log(D3eels) Log a message.

eels_terminate(D3eels) Close an event logging session.

The session descriptor returned by eels_initialise(D3eels) can be used by the XDAS functions as well as by the other generic logging functions.

The XDAS API also supports a generic logging capability. For details of this, including a list of the supported generic logging events, see Intro(D3xdas).

References

eels_initialise(D3eels), eels_log(D3eels), eels_terminate(D3eels), Intro(D3xdas)

Standards compliance

These library functions are not a part of any currently supported standard; they are an extension of AT&T System V provided by The Santa Cruz Operation, Inc.

eels_initialise(D3eels)	Initialize an event logging session.
eels_log(D3eels)	Log a message.
eels_terminate(D3eels)	Close an event logging session.