posix_trace_stop Subroutine

Purpose

Stops a trace.

Library

Posix Trace Library (libposixtrace.a)

Syntax

#include <trace.h>

int posix_trace_stop(trid)
trace_id_t trid;

Description

The posix_trace_stop subroutine stops the trace stream identified by the trid parameter.

The effect of calling the posix_trace_stop subroutine is recorded in the trace stream as the POSIX_TRACE_STOP system trace event, and the status of the trace stream becomes POSIX_TRACE_SUSPENDED. If the trace stream is suspended when this subroutine is called, the POSIX_TRACE_STOP system trace event is not recorded, and the trace stream remains suspended. If the trace stream is full, the POSIX_TRACE_STOP system trace event is not recorded, and the status of the trace stream is not changed.

Parameters

Item	Description
trid	Specifies the trace stream identifier.

Return Values

On successful completion, this subroutine returns a value of zero. Otherwise, it returns the corresponding error number.

Errors

The subroutine fails if the following error number returns:

Item	Description
EINVAL	The value of the trid parameter does not correspond to an active trace stream and thus no trace stream is started or stopped.

Files

The trace.h file in AIX® Version 7.1 Files Reference.