NAME
pthread_attr_setstackaddr,
pthread_attr_getstackaddr —
set and get stackaddr
attribute
SYNOPSIS
#include
<pthread.h>
int
pthread_attr_setstackaddr(pthread_attr_t
*attr, void
*stackaddr);
int
pthread_attr_getstackaddr(const
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 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.
On OpenBSD the stack must have been allocated using mmap with the MAP_STACK attribute. Otherwise, use of the stack will cause SIGABRT faults. pthread_attr_setstack(3) can avoid this problem because it knows the size of the stack to remap.
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.
The pthread_attr_getstackaddr() function
stores the stackaddr attribute value in
stackaddr if successful.
ERRORS
No errors are defined.
These functions will not return an error code of
[EINTR].
SEE ALSO
pthread_attr_init(3), pthread_attr_setdetachstate(3), pthread_attr_setguardsize(3), pthread_attr_setstack(3), pthread_attr_setstacksize(3), pthread_create(3), pthreads(3)
STANDARDS
pthread_attr_setstackaddr() and
pthread_attr_getstackaddr() conform to ISO/IEC
9945-1 ANSI/IEEE (“POSIX”) Std 1003.1 Second Edition
1996-07-12.