NAME    [Toc]    [Back]

       pthread_attr_getstackaddr  -  Obtains  the  stack  address
       attribute of the specified thread attributes object

SYNOPSIS    [Toc]    [Back]

       #include <pthread.h>

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

LIBRARY    [Toc]    [Back]

       DECthreads POSIX 1003.1c Library (libpthread.so)

STANDARDS    [Toc]    [Back]

       Interfaces documented on this reference  page  conform  to
       industry standards as follows:

       IEEE  Std  1003.1c-1995,  POSIX System Application Program
       Interface

PARAMETERS    [Toc]    [Back]

       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    [Toc]    [Back]

       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 reliable  portable  interface.  With  the  POSIX
       standard  pthread_attr_getstackaddr(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_getstackaddr_np(3).  Instead  of  returning a
       stack address, it returns the base  (lowest)  address  and
       the size.

RETURN VALUES    [Toc]    [Back]

       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    [Toc]    [Back]

       None

SEE ALSO    [Toc]    [Back]

       Functions: pthread_attr_setstackaddr_np(3)

       Manuals: Guide to DECthreads and Programmer's Guide



                                     pthread_attr_getstackaddr(3)