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

SYNOPSIS
  #include <pthread.h>

  int pthread_attr_setstacksize(
	  pthread_attr_t *attr,
	  size_t stacksize );

LIBRARY
  DECthreads POSIX 1003.1c Library (libpthread.so)

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

SEE ALSO
  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