NAME

       pthread_attr_getstackaddr, pthread_attr_setstackaddr - get and set the stackaddr attribute

SYNOPSIS

       #include <pthread.h>

       int pthread_attr_getstackaddr(const pthread_attr_t *restrict attr,
              void **restrict stackaddr);
       int pthread_attr_setstackaddr(pthread_attr_t *attr, void *stackaddr);

DESCRIPTION

       The  pthread_attr_getstackaddr()  and pthread_attr_setstackaddr() functions, respectively,
       shall get and set the thread creation stackaddr attribute in the attr object.

       The stackaddr attribute specifies the location of storage  to  be  used  for  the  created
       thread's stack. The size of the storage shall be at least {PTHREAD_STACK_MIN}.

RETURN VALUE

       Upon  successful  completion,  pthread_attr_getstackaddr() and pthread_attr_setstackaddr()
       shall return a value of 0; otherwise, an error number shall be returned  to  indicate  the
       error.

       The pthread_attr_getstackaddr() function stores the stackaddr attribute value in stackaddr
       if successful.

ERRORS

       No errors are defined.

       These functions shall not return an error code of [EINTR].

       The following sections are informative.

EXAMPLES

       None.

APPLICATION USAGE

       The specification of the  stackaddr  attribute  presents  several  ambiguities  that  make
       portable  use  of  these  interfaces  impossible.  The  description  of the single address
       parameter as a "stack" does not specify a particular relationship between the address  and
       the  "stack"  implied  by  that  address. For example, the address may be taken as the low
       memory address of a buffer intended for use as a stack, or it may be taken as the  address
       to  be  used as the initial stack pointer register value for the new thread. These two are
       not the same except for a machine on which the stack grows "up" from low memory  to  high,
       and  on  which a "push" operation first stores the value in memory and then increments the
       stack pointer register. Further, on a machine where  the  stack  grows  "down"  from  high
       memory  to  low,  interpretation  of  the  address  as the "low memory" address requires a
       determination of the intended size of the stack. IEEE Std 1003.1-2001 has  introduced  the
       new  interfaces  pthread_attr_setstack()  and  pthread_attr_getstack()  to  resolve  these
       ambiguities.

RATIONALE

       None.

FUTURE DIRECTIONS

       None.

SEE ALSO

       pthread_attr_destroy()  ,  pthread_attr_getdetachstate()   ,   pthread_attr_getstack()   ,
       pthread_attr_getstacksize()  ,  pthread_attr_setstack()  ,  pthread_create()  ,  the  Base
       Definitions volume of IEEE Std 1003.1-2001, <limits.h>, <pthread.h>

COPYRIGHT

       Portions of this text are reprinted and  reproduced  in  electronic  form  from  IEEE  Std
       1003.1,  2003  Edition,  Standard  for Information Technology -- Portable Operating System
       Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2003  by
       the  Institute  of  Electrical  and  Electronics Engineers, Inc and The Open Group. In the
       event of any discrepancy between this version and the original IEEE  and  The  Open  Group
       Standard,  the  original  IEEE  and  The  Open Group Standard is the referee document. The
       original Standard can be obtained online at http://www.opengroup.org/unix/online.html .