posix_trace_attr_destroy Subroutine
Purpose
Destroys a trace stream attribute object.
Library
Posix Trace Library (libposixtrace.a)
Syntax
#include <trace.h>
int posix_trace_attr_destroy(attr)
trace_attr_t * attr;
Description
The posix_trace_attr_destroy subroutine destroys an initialized trace attributes object. A destroyed attr attributes object can be initialized again using the posix_trace_attr_init subroutine. The results of referencing the object after it has been destroyed are not defined.
If the posix_trace_attr_destroy subroutine is called with a non-initialized attributes object as a parameter, the result is not specified.
Parameters
| Item | Description |
|---|---|
| attr | Specifies the trace attributes object to destroy. |
Return Values
Upon successful completion, it returns a value of zero. Otherwise, it returns the corresponding error number.
Errors
The following
error code return when the posix_trace_attr_destroy subroutine
fails:
| Item | Description |
|---|---|
| EINVAL | The value of the attr parameter is null. |
Files
The trace.h file in Files Reference