RTEMS Logo

RTEMS 4.6.0 On-Line Library


Event Logging Manager log_facilityisvalid - Manipulate log facility sets

PREV UP NEXT Bookshelf New Chapters

1.4.15: log_facilityisvalid - Manipulate log facility sets

CALLING SEQUENCE:

#include <evlog.h>

int log_facilityisvalid(
  log_facility_t        facilityno
);

STATUS CODES:

A return value of zero indicates that the facilityno is valid and a return value other than zero represents an errno.

EFAULT
The set or member argument is an invalid pointer.
EINVAL
The facilityno argument is not a valid facility.

DESCRIPTION:

The log_facilityisvalid() function tests whether the facility specified by the value of the argument facilityno is a valid facility number. Upon successful completion, the the log_facilityisvalid() function either returns a value of 0 if the specified facility is a valid facility or value of EINVAL if the specified facility is not a valid facility.

NOTES:

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

Applications shall call either log_facilityemptyset() or log_facilityfillset() at least once for each object of type log_facilityset_t prior to any other use of that object. If such an object is not initialized in this way, but is nonetheless supplied as an argument to any of the log_facilityaddset(), logfacilitydelset(), log_facilityismember() or log_open() functions, the results are undefined.


PREV UP NEXT Bookshelf New Chapters

Copyright © 1988-2004 OAR Corporation