Index for Section 3

Alphabetical listing for P

Bottom of page

pthread_attr_setstacksize(3)
NAME
  pthread_attr_setstacksize - Changes the stacksize attribute in the
  specified thread attributes object.

LIBRARY
  DECthreads POSIX 1003.1c Library (libpthread.so)

SYNOPSIS
  #include <pthread.h>

  int pthread_attr_setstacksize(
		  pthread_attr_t  *attr,
		  size_t	  stacksize);

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

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

PARAMETERS
  attr	    Thread attributes object to be modified.

  stacksize 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
  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
  If an error condition occurs, this routine returns an integer value
  indicating the type of error.	 Possible return values are as follows:

  0	    Successful completion.

  [EINVAL]  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
  None

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

  Manuals: Guide to DECthreads and Programmer's Guide

Index for Section 3

Alphabetical listing for P

Top of page