posix_trace_close Subroutine
Purpose
Closes a trace log.
Library
Posix Trace Library (libposixtrace.a)
Syntax
#include <trace.h>
int posix_trace_close (trid)
trace_id_t trid;
Description
The posix_trace_close subroutine deallocates the trace log identifier indicated by the trid parameter, and all of its associated resources. If there is no valid trace log pointed to by the trid parameter, this subroutine fails.
Parameters
| Item | Description |
|---|---|
| trid | Specifies the trace stream identifier. |
Return Values
Upon successful completion, this subroutine returns a value of zero. Otherwise, it returns the corresponding error number.
Errors
The posix_trace_close subroutine
fails if the following error returns:
| Item | Description |
|---|---|
| EINVAL | The object pointed to by the trid parameter does not correspond to a valid trace log. |
Files
The trace.h file in the Files Reference