NAME

pthread_attr_setstacksize pthread_attr_getstacksize — set and get stacksize attribute

SYNOPSIS

#include <pthread.h>

int pthread_attr_setstacksize(pthread_attr_t *attr, size_t stacksize);
int pthread_attr_getstacksize(const 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.

RETURN VALUE

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() function will fail if:

[EINVAL]

The value of stacksize is less than PTHREAD_STACK_MIN or exceeds a system-imposed limit.

These functions will not return an error code of [EINTR].

EXAMPLES

None.

APPLICATION USAGE

None.

FUTURE DIRECTIONS

None.

SEE ALSO

pthread_attr_init(3) , pthread_attr_setstackaddr(3) , pthread_attr_setdetachstate(3) , pthread_create(3) , <limits.h> , <pthread.h> .

DERIVATION

Derived from the POSIX Threads Extension (1003.1c-1995)