Obtains the stack address attribute of the specified thread
    attributes object.

1  –  C Binding

    #include <pthread.h>

    int
    pthread_attr_getstackaddr (
                const pthread_attr_t   *attr,
                void   **stackaddr,
                size_t   *size);

2  –  Arguments

 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.

3  –  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 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.

4  –  Return Values

    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.

5  –  Associated Routines

       pthread_attr_setstackaddr_np()