pthread_attr_getstackaddr(3)pthread_attr_getstackaddr(3)NAME
pthread_attr_getstackaddr - Obtains the stack address attribute of the
specified thread attributes object
SYNOPSIS
#include <pthread.h>
int pthread_attr_getstackaddr_np(
const 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 obtained. Receives 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 obtains the value of the stack address attribute of the
thread attributes object specified in the attr argument and stores it
in the location specified by the stackaddr argument. The specified
attributes object must already be initialized at the time this routine
is called.
The stack address attribute of a thread attributes object points to the
origin of the stack for a new thread.
Unlike pthread_attr_getstackaddr(3), this routine is a much more reli‐
able portable interface. With the POSIX standard pthread_attr_getstack‐
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_get‐
stackaddr_np(3). Instead of returning a stack address, it returns 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_setstackaddr_np(3)
Manuals: Guide to DECthreads and Programmer's Guide
pthread_attr_getstackaddr(3)