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