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 AIX® Version 7.1 Files Reference