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
| 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 Files Reference