PTHREAD_ATTR_GETSTACKADDR(3C) Standard C Library Functions
NAME
pthread_attr_getstackaddr, pthread_attr_setstackaddr - get or set
stackaddr attribute
SYNOPSIS
cc -mt [
flag... ]
file... -lpthread [
library... ]
#include <pthread.h>
int pthread_attr_getstackaddr(
const pthread_attr_t *restrict attr,
void **restrict stackaddr);
int pthread_attr_setstackaddr(
pthread_attr_t *attr,
void *stackaddr);
DESCRIPTION
The functions
pthread_attr_setstackaddr() and
pthread_attr_getstackaddr(), respectively, set and get the thread
creation
stackaddr attribute in the
attr object. The
stackaddr default is
NULL. See
pthread_create(3C).
The
stackaddr attribute specifies the location of storage to be used
for the created thread's stack. The size of the storage is at least
PTHREAD_STACK_MIN.RETURN VALUES
Upon successful completion,
pthread_attr_setstackaddr() and
pthread_attr_getstackaddr() return a value of
0. Otherwise, an error
number is returned to indicate the error.
If successful, the
pthread_attr_getstackaddr() function stores the
stackaddr attribute value in
stackaddr.
ERRORS
The
pthread_attr_setstackaddr() function may fail if:
EINVAL attr is invalid.
The
pthread_attr_getstackaddr() function may fail if:
EINVAL attr or
stackaddr is invalid.
ATTRIBUTES
See
attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+
SEE ALSO
pthread_attr_init(3C),
pthread_attr_setdetachstate(3C),
pthread_attr_setstacksize(3C),
pthread_create(3C),
attributes(7),
standards(7) March 23, 2005 PTHREAD_ATTR_GETSTACKADDR(3C)