VMS Help DCE_THREADS, Application Routines, pthread_attr_setstacksize  *Conan The Librarian (sorry for the slow response - running on an old VAX)

  NAME

    pthread_attr_setstacksize - Changes the stacksize attribute of thread
                                creation

  SYNOPSIS

      #include <pthread.h>

      int pthread_attr_setstacksize( pthread_attr_t *attr,
                                     long stacksize );

  PARAMETERS

      attr                Thread attributes object modified.

      stacksize           New value for the stacksize attribute.  The
                          stacksize parameter specifies the minimum size
                          (in bytes) of the stack needed for a thread.

  DESCRIPTION

  The pthread_attr_setstacksize() routine sets the minimum size (in bytes)
  of the stack needed for a thread created using the attributes object
  specified by the attr parameter. Use this routine to adjust the size of
  the writable area of the stack. The default value of the stacksize
  attribute is machine specific.

  A thread's stack is fixed at the time of thread creation. Only the main
  or initial thread can dynamically extend its stack.

  Most compilers do not check for stack overflow.  Ensure that your thread
  stack is large enough for anything that you call from the thread.

  RETURN VALUES

  If the function fails, errno may be set to one of the following values:

    Return   Error      Description
    ___________________________________________________________
    0                   Successful completion.

    -1     [EINVAL]     The value specified by attr is invalid.

    -1     [EINVAL]     The value specified by stacksize is invalid.

  RELATED INFORMATION

      FUNCTIONS: pthread_attr_create
                 pthread_attr_getstacksize
                 pthread_create