NAME    [Toc]    [Back]

       pthread_attr_setstacksize    -   Changes   the   stacksize
       attribute in the specified thread attributes object

SYNOPSIS    [Toc]    [Back]

       #include <pthread.h>

       int pthread_attr_setstacksize(
               pthread_attr_t *attr,
               size_t stacksize );

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]

       Thread attributes object to be modified.   New  value  for
       the  stacksize  attribute  of the thread attributes object
       specified by the attr  argument.  The  stacksize  argument
       must  be  greater  than  or  equal  to  PTHREAD_STACK_MIN.
       PTHREAD_STACK_MIN specifies the minimum size (in bytes) of
       stack needed for a thread.

DESCRIPTION    [Toc]    [Back]

       This  routine  sets  the stacksize attribute in the thread
       attributes object specified by the attr argument. Use this
       routine  to  adjust  the  size of the writable area of the
       stack for a new thread.

       The size of a thread's stack  is  fixed  at  the  time  of
       thread  creation.  Only the initial thread can dynamically
       extend its stack.

       Many compilers do not check  for  stack  overflow.  Ensure
       that   the  new  thread's  stack  is  sufficient  for  the
       resources required by routines that are  called  from  the
       thread.

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 invalid, or the value specified
       by  stacksize  is less than PTHREAD_STACK_MIN or exceeds a
       DECthreads-imposed limit.

ERRORS    [Toc]    [Back]

       None

SEE ALSO    [Toc]    [Back]

       Functions:  pthread_attr_init(3),   pthread_attr_getstacksize(3), pthread_create(3)

       Manuals: Guide to DECthreads and Programmer's Guide



                                     pthread_attr_setstacksize(3)