pthread_attr_setstackaddr(3)pthread_attr_setstackaddr(3)NAME
pthread_attr_setstackaddr - Changes the stack address and size of the
specified thread attributes object
SYNOPSIS
#include <pthread.h>
int pthread_attr_setstackaddr_np(
pthread_attr_t *attr,
void *stackaddr,
size_t size );
LIBRARY
DECthreads POSIX 1003.1c Library (libpthread.so)
STANDARDS
Interfaces documented on this reference page conform to industry stan‐
dards as follows:
IEEE Std 1003.1c-1995, POSIX System Application Program Interface
PARAMETERS
Address of the thread attributes object whose stack address attribute
is to be modified. New value for the address of the stack region of
the thread attributes object specified by attr. The size of the stack
region in bytes.
DESCRIPTION
This routine uses the values specified in the stackaddr and size argu‐
ments to set the base stack address and size of the thread attributes
object specified in the attr argument.
When creating a thread, use a thread attributes object to specify non‐
default values for thread attributes. The default value for the stack
address attribute of an initialized thread attributes object is NULL.
Unlike pthread_attr_setstackaddr(3), this routine is a much more reli‐
able portable interface. With the POSIX standard pthread_attr_setstack‐
addr(3), a stack is specified using a single, undefined, address. An
implementation of the standard can only assume that the specified value
represents the value to which the thread's stack pointer should be set
when beginning execution. However, this requires the application to
know how the machine uses the stack. For example, a stack may grow
either up (to higher addresses) or down (to lower addresses), and may
be decreased (or increased) either before or after storing a new value.
DECthreads provides an alternative interface with pthread_attr_set‐
stackaddr_np(3). Instead of specifying a stack address, you specify the
base (lowest) address and the size.
RETURN VALUES
If an error condition occurs, this routine returns an integer value
indicating the type of error. Possible return values are as follows:
Successful completion. The value specified by attr is not a valid
thread attributes object.
ERRORS
None
SEE ALSO
Functions: pthread_attr_getstackaddr_np(3)
Manuals: Guide to DECthreads and Programmer's Guide
pthread_attr_setstackaddr(3)
