VMS Help
POSIX Threads, PTHREAD routines, pthread_attr_getstackaddr_np
*Conan The Librarian (sorry for the slow response - running on an old VAX)
|
|
Obtains the stack address attribute of the specified thread
attributes object.
#include <pthread.h>
int
pthread_attr_getstackaddr (
const pthread_attr_t *attr,
void **stackaddr,
size_t *size);
attr
Address of the thread attributes object whose stack address
attribute is obtained.
stackaddr
Receives the address of the stack region of the thread attributes
object specified by attr.
size
The size of the stack region in bytes.
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 when
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(), this routine is a much more
reliable portable interface. With the POSIX standard pthread_
attr_getstackaddr(), 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.
The Threads Library provides an alternative interface with
pthread_attr_getstackaddr_np(). Instead of returning a stack
address, it returns the base (lowest) address and the size.
If an error condition occurs, this routine returns an integer
value indicating the type of error. Possible return values are as
follows:
Return Description
0 Successful completion.
[EINVAL] The value specified by attr is not a valid thread
attributes object.
pthread_attr_setstackaddr_np()
[legal]
[privacy]
[GNU]
[policy]
[netiquette]
[sponsors]
[FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.