--------------------------------------------------------------------------------
AIX Version 4.3 Base Operating System and Extensions Technical Reference, Volume
                                       1
--------------------------------------------------------------------------------

pthread_attr_getstacksize Subroutine

Purpose

Returns the value of the stacksize attribute of a thread attributes object.

Library

Threads Library (libpthreads.a)

Syntax

#include 

int pthread_attr_getstacksize (attr, stacksize)

const pthread_attr_t *attr;

size_t *stacksize;

Description

The pthread_attr_getstacksize subroutine returns the value of the stacksize
attribute of the thread attributes object attr. This attribute specifies the
minimum stack size of a thread created with this attributes object. The value is
given in bytes. The default stack size is PTHREAD_STACK_MIN, *12 defined in
pthread.h.

    Note: The pthread.h header file must be the first included file of each
    source file using the threads library. Otherwise, the -D_THREAD_SAFE
    compilation flag should be used, or the cc_r compiler used. In this case, the
    flag is automatically set.

Parameters

attr Specifies the thread attributes object.

stacksize Points to where the stacksize attribute value will be stored.

Return Values

Upon successful completion, the value of the stacksize attribute is returned via
the stacksize parameter, and 0 is returned. Otherwise, an error code is returned.

Error Codes

The pthread_attr_getstacksize subroutine is unsuccessful if the following is
true:

EINVAL The attr or stacksize parameters are not valid.

This function will not return an error code of [EINTR].

Implementation Specifics

This subroutine is part of the Base Operating System (BOS) Runtime.

Related Information

The pthread_attr_setstacksize subroutine, pthread_attr_init subroutine, the
pthread.h file.

Advanced Attributes in AIX Version 4.3 General Programming Concepts: Writing and
Debugging Programs.

Threads Library Options and Threads Library Quick Reference in AIX Version 4.3
General Programming Concepts: Writing and Debugging Programs.
--------------------------------------------------------------------------------