posix_trace_get_filter Subroutine
Purpose
Retrieves the filter of an initialized trace stream.
Library
Posix Trace Library (libposixtrace.a)
Syntax
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.