Unix/Linux Go Back    

SuSE 11.3 - man page for posix_trace_eventset_ismember (suse section 3P)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


       This  manual  page  is part of the POSIX Programmer's Manual.  The Linux implementation of
       this interface may differ (consult the corresponding Linux  manual  page  for  details  of
       Linux behavior), or the interface may not be implemented on Linux.

       posix_trace_eventset_add,       posix_trace_eventset_del,      posix_trace_eventset_empty,
       posix_trace_eventset_fill, posix_trace_eventset_ismember -  manipulate  trace  event  type
       sets (TRACING)

       #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);

       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()	functions,  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 following values, as defined in the <trace.h> header:


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


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


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

       Applications shall call either posix_trace_eventset_empty() or posix_trace_eventset_fill()
       at least once for each object of type trace_event_set_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  posix_trace_eventset_add(),  posix_trace_eventset_del(),  or
       posix_trace_eventset_ismember() functions, the results are undefined.

       The posix_trace_eventset_ismember() function shall test whether the trace event type spec-
       ified by the value of the argument event_id is a member of the set pointed to by the argu-
       ment  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.

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

       These functions may fail if:

       EINVAL The value of one of the arguments is invalid.

       The following sections are informative.





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

       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 orig-
       inal Standard can be obtained online at http://www.opengroup.org/unix/online.html .

IEEE/The Open Group			       2003		     POSIX_TRACE_EVENTSET_ADD(3P)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums

All times are GMT -4. The time now is 10:30 AM.