posix_trace_eventset_fill

       posix_trace_eventset_empty,                  posix_trace_eventset_fill,
       posix_trace_eventset_ismember - manipulate trace event type sets (TRAC-
       ING)

SYNOPSIS
       #include <trace.h>

       int posix_trace_eventset_add(trace_event_id_t event_id,
              trace_event_set_t *set);
       int posix_trace_eventset_del(trace_event_id_t event_id,
              trace_event_set_t *set);
       int posix_trace_eventset_empty(trace_event_set_t *set);
       int posix_trace_eventset_fill(trace_event_set_t *set, int what);
       int posix_trace_eventset_ismember(trace_event_id_t event_id,
              const trace_event_set_t *restrict set, int *restrict ismember);


DESCRIPTION
       These primitives manipulate sets of trace event types. They operate  on
       data  objects  addressable by the application, not on the current trace
       event filter of any trace stream.

       The  posix_trace_eventset_add()  and  posix_trace_eventset_del()  func-
       tions,  respectively,  shall  add  or delete the individual trace event
       type specified by the value of the argument event_id  to  or  from  the
       trace  event  type  set  pointed to by the argument set. Adding a trace
       event type already in the set or deleting a trace event type not in the
       set shall not be considered an error.

       The  posix_trace_eventset_empty()  function  shall initialize the trace
       event type set pointed to by the set argument such that all trace event
       types defined, both system and user, shall be excluded from the set.

       The  posix_trace_eventset_fill()  function  shall  initialize the trace
       event type set pointed to by the argument set, such  that  the  set  of
       trace event types defined by the argument what shall be included in the
       set. The value of the argument what shall consist of one of the follow-
       ing values, as defined in the <trace.h> header:

       POSIX_TRACE_WOPID_EVENTS

              All  the process-independent implementation-defined system trace
              event types are included in the set.

       POSIX_TRACE_SYSTEM_EVENTS

              All the implementation-defined  system  trace  event  types  are
              included    in    the    set,    as   are   those   defined   in
              IEEE Std 1003.1-2001.

       POSIX_TRACE_ALL_EVENTS

              All trace  event  types  defined,  both  system  and  user,  are
              included in the set.

       member of the set pointed to by the argument set. The value returned in
       the object pointed to by ismember argument is zero if the  trace  event
       type  identifier  is not a member of the set and a value different from
       zero if it is a member of the set.

RETURN VALUE
       Upon successful completion, these functions shall  return  a  value  of
       zero. Otherwise, they shall return the corresponding error number.

ERRORS
       These functions may fail if:

       EINVAL The value of one of the arguments is invalid.


       The following sections are informative.

EXAMPLES
       None.

APPLICATION USAGE
       None.

RATIONALE
       None.

FUTURE DIRECTIONS
       None.

SEE ALSO
       posix_trace_set_filter()  ,  posix_trace_trid_eventid_open() , the Base
       Definitions volume of IEEE Std 1003.1-2001, <trace.h>

COPYRIGHT
       Portions of this text are reprinted and reproduced in  electronic  form
       from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
       -- Portable Operating System Interface (POSIX),  The  Open  Group  Base
       Specifications  Issue  6,  Copyright  (C) 2001-2003 by the Institute of
       Electrical and Electronics Engineers, Inc and The Open  Group.  In  the
       event of any discrepancy between this version and the original IEEE and
       The Open Group Standard, the original IEEE and The Open Group  Standard
       is  the  referee document. The original Standard can be obtained online
       at http://www.opengroup.org/unix/online.html .



IEEE/The Open Group                  2003          POSIX_TRACE_EVENTSET_ADD(P)