posix_trace_eventset_add Subroutine

Purpose

Adds a trace event type in a trace event type set.

Library

Posix Trace Library (libposixtrace.a)

Syntax

#include <trace.h>

int posix_trace_eventset_add (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_add subroutine adds the individual trace event type specified by the value of the event_id parameter to the trace event type set pointed to by the set parameter. Adding a trace event type already in the set is not considered as an error.

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

Return Values

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

Errors

Files

The trace.h file in the Files Reference