posix_trace_attr_setstreamsize Subroutine

Purpose

Sets the trace stream size.

Library

Posix Trace Library (libposixtrace.a)

Syntax

#include <sys/types.h>
#include <trace.h>

int posix_trace_attr_setstreamsize(attr, streamsize)
trace_attr_t *attr;
size_t streamsize;

Description

The posix_trace_attr_setstreamsize subroutine sets the minimum size that is allowed, in bytes, in the stream_minsize attribute of the attr object, using the size value specified by the streamsize parameter. If the streamsize parameter is smaller than the minimum required size, the posix_trace_attr_setstreamsize subroutine does not fail. It sets this minimum size in the stream_minsize attribute. Further calls to the posix_trace_createsubroutine or the posix_trace_create_withlog subroutines will not fail.

If this subroutine is called with a non-initialized attributes object as parameter, the result is not specified.

Parameters

Item Description
attr Specifies the trace attributes object.
streamsize Specifies where the stream_minsize attribute of the attr object, in bytes, will be attained.

Return Values

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

Errors

The posix_trace_attr_setstreamsize subroutine fails if the following error number returns:
Item Description
EINVAL The requested size for the stream is larger than the segment size. The parameter is null or the other parameter is not valid.

Files

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