man pages section 3: Basic Library Functions

Exit Print View

Updated: July 2014
 
 

pthread_attr_getstacksize(3C)

Name

pthread_attr_getstacksize, pthread_attr_setstacksize - get or set stacksize attribute

Synopsis

cc –mt [ flag... ] file... [ library... ]
#include <pthread.h>

int pthread_attr_getstacksize(const pthread_attr_t *restrict attr,
     size_t *restrict stacksize);
int pthread_attr_setstacksize(pthread_attr_t *attr, size_t stacksize);

Description

The functions pthread_attr_setstacksize() and pthread_attr_getstacksize(), respectively, set and get the thread creation stacksize attribute in the attr object.

The stacksize attribute defines the minimum stack size (in bytes) allocated for the created threads stack. When the stacksize argument is NULL, the default stack size becomes 1 megabyte for 32-bit processes and 2 megabytes for 64-bit processes.

Return Values

Upon successful completion, pthread_attr_setstacksize() and pthread_attr_getstacksize() return a value of 0. Otherwise, an error number is returned to indicate the error. The pthread_attr_getstacksize() function stores the stacksize attribute value in stacksize if successful.

Errors

The pthread_attr_setstacksize() or pthread_attr_getstacksize() function may fail if:

EINVAL

attr or stacksize is invalid.

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Interface Stability
Committed
MT-Level
MT-Safe
Standard

See also

pthread_attr_init(3C), pthread_attr_setstackaddr(3C), pthread_attr_setdetachstate(3C), pthread_create(3C), attributes(5), standards(5)