RTEMS Logo

RTEMS 4.6.0 On-Line Library


Event Logging Manager log_notify - Notify Process of writes to the system log.

PREV UP NEXT Bookshelf New Chapters

1.4.6: log_notify - Notify Process of writes to the system log.

CALLING SEQUENCE:

#include <evlog.h>

int log_notify(
  const logd_t           logdes,
  const struct sigevent *notification
);

STATUS CODES:

A successful call to log_notify() returns a value of zero and an unsuccessful call returns the errno.

EBADF
The logdes argument is not a valid log file descriptor.
EINVAL
The notification argument specifies an invalid signal.
EINVAL
The process has requested a notify on a log that will not be written to.
ENOSYS
The function log_notify() is not supported by this implementation.

DESCRIPTION:

If the argument notification is not NULL this function registers the calling process to be notified of event records received by the system log, which match the query parameters associated with the open log descriptor specified by logdes. The notification specified by the notification argument shall be sent to the process when an event record received by the system log is matched by the query attribute of the open log file description associated with the logdes log file descriptor. If the calling process has already registered a notification for the logdes log file descriptor, the new notification shall replace the existing notification registration.

If the notification argument is NULL and the calling process is currently registered to be notified for the logdes log file descriptor, the existing registration shall be removed.

NOTES:

The _POSIX_LOGGING feature flag is defined to indicate this service is available.


PREV UP NEXT Bookshelf New Chapters

Copyright © 1988-2004 OAR Corporation