posix_trace_get_filter Subroutine

Edit online

Purpose

Retrieves the filter of an initialized trace stream.

Library

Posix Trace Library (libposixtrace.a)

Syntax

#include <trace.h>

int posix_trace_get_filter(trid, set)
trace_id_t trid;
trace_event_set_t *set;

Description

The posix_trace_get_filter subroutine retrieves into the set parameter the actual trace event filter from the trace stream specified by the trid parameter.

Parameters

Item Description
trid Specifies the trace stream identifier.
set Points to the set of trace event types.

Return Values

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

If successful, the posix_trace_get_filter subroutine stores the set of filtered trace event types in the set parameter.

Errors

It fails if the following value returns:
Item Description
EINVAL The value of the trid parameter does not correspond to an active trace stream or the value of the parameter pointed to by the set parameter is not valid.

Files

The trace.h file in Files Reference.