posix_trace_eventset_del Subroutine

Purpose

Deletes a trace event type from a trace event type set.

Library

Posix Trace Library (libposixtrace.a)

Syntax

#include <trace.h>

int posix_trace_eventset_del(event_id, set)
trace_event_id_t event_id;
trace_event_set_t *set;

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.

The posix_trace_eventset_del subroutine deletes the individual trace event type specified by the value of the event_id parameter from the trace event type set pointed to by the set argument.

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 not defined.

Parameters

Item	Description
eventid	Specifies the trace event identifier.
set	Specifies the set of trace event types.

Return Values

On 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.