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