NAME    [Toc]    [Back]

       pthread_attr_setstackaddr  - Changes the stack address and
       size of the specified thread attributes object

SYNOPSIS    [Toc]    [Back]

       #include <pthread.h>

       int pthread_attr_setstackaddr_np(
               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  to be modified.  New value for 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 uses the values specified  in  the  stackaddr
       and  size arguments to set the base stack address and size
       of the thread attributes  object  specified  in  the  attr
       argument.

       When  creating a thread, use a thread attributes object to
       specify  nondefault  values  for  thread  attributes.  The
       default  value  for the stack address attribute of an initialized
 thread attributes object is NULL.

       Unlike pthread_attr_setstackaddr(3),  this  routine  is  a
       much  more  reliable  portable  interface.  With the POSIX
       standard pthread_attr_setstackaddr(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_setstackaddr_np(3). Instead of  specifying  a
       stack  address,  you specify 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_getstackaddr_np(3)

       Manuals: Guide to DECthreads and Programmer's Guide



                                     pthread_attr_setstackaddr(3)