Open System Services System Calls Reference Manual (G06.29+, H06.08+, J06.03+)

System Functions (n - p) pthread_attr_setstacksize(2)
NAME
pthread_attr_setstacksize - Sets the stacksize attribute of a thread attributes object
LIBRARY
G-series native OSS processes: /G/system/sysnn/zsptsrl
32-bit H-series and J-series OSS processes that use the POSIX User Thread Model library:
/G/system/zdllnnn/zputdll
64-bit H-series and J-series OSS processes that use the POSIX User Thread Model library:
/G/system/zdllnnn/yputdll
H-series and J-series OSS processes that use the Standard POSIX Threads library:
/G/system/zdllnnn/zsptdll
SYNOPSIS
#include <pthread.h> | #include <spthread.h>
/* pthread.h is required to use POSIX User Thread Model library */
/* spthread.h is required to use Standard POSIX Threads library */
int pthread_attr_setstacksize(
pthread_attr_t *attr,
size_t stacksize);
PARAMETERS
attr Specifies the address of the thread attributes object whose stacksize attribute is
to be set.
stacksize Specifies the new value for the stacksize attribute. The stacksize parameter must
be greater than or equal to PTHREAD_STACK_MIN, which is the minimum
size (in bytes) of stack needed for a thread.
DESCRIPTION
This function sets the value of the stacksize attribute in the thread attributes object specified by
the attr parameter to the value specified by the stacksize parameter. Use this function to adjust
the size of the writable area of the stack for a new thread.
The size of a thread’s stack is fixed at the time of thread creation. Only the initial thread can
dynamically extend its stack.
On systems running H06.21 or later H-series RVUs or J06.10 or later J-series RVUs, you can use
either the POSIX User Thread Model library or the Standard POSIX Threads library for threaded
applications.
To use this function in a threaded application that uses the POSIX User Thread Model library on
systems running H06.21 or later RVUs or J06.10 or later RVUs, you must perform all of the fol-
lowing tasks:
• Include the pthread.h header file in the application.
• Compile the application using the _PUT_MODEL_ feature test macro or equivalent
compiler command option.
• Link the application to the zputdll library (/G/system/zdllnnn/zputdll).
On systems running H06.24 or later H-series RVUs or J06.13 or later J-series RVUs, you can use
the POSIX User Thread Model library with 32-bit or 64-bit threaded applications.
To use this function in a 32-bit threaded application that uses the POSIX User Thread Model
library on systems running H06.24 or later RVUs or J06.13 or later RVUs, perform the same
tasks (described above) used to enable the POSIX User Thread Model library on systems running
H06.21/J06.10 or later RVUs.
527186-023 Hewlett-Packard Company 5−71