posix_trace_eventset_ismember Subroutine

Purpose

Tests if the trace event type is included in the trace event type set.

Library

Posix Trace Library (libposixtrace.a)

Syntax

#include <trace.h>

int posix_trace_eventset_ismember(event_id, set, ismember)
trace_event_id_t event_id;
const trace_event_set_t *restrict set;
int *restrict ismember;

Description

This subroutine manipulates sets of trace event types. It operates on data objects addressable by the application, not on the current trace event filter of any trace stream.

Applications call either the posix_trace_eventset_empty or posix_trace_eventset_fill subroutine at least once for each object of the trace_event_set_t type before further use of that object. If an object is not initialized in this way, but is supplied as a parameter to any of the posix_trace_eventset_add, posix_trace_eventset_del, or posix_trace_eventset_ismember subroutines, the results are undefined.

The posix_trace_eventset_ismember subroutine tests whether the trace event type specified by the value of the event_id parameter is a member of the set pointed to by the set parameter. The value returned in the object pointed to by the ismember parameter is zero if the trace event type identifier is not a member of the set. It returns a nonzero value if it is a member of the set.

Parameters

Item Description
eventid Specifies the trace event identifier.
set Specifies the set of trace event types.
ismember Specifies the returned value of the posix_trace_eventset_ismember subroutine.

Return Values

Upon successful completion, this subroutine returns a value of zero. Otherwise, it returns the corresponding error number.

Errors

This subroutine fails if the following value is returned:
Item Description
EINVAL The value of one of the parameters is not valid.

Files

The trace.h file in AIX® Version 7.1 Files Reference.