pthread_attr_getstacksize(3) [mojave man page]

PTHREAD_ATTR(3) 					   BSD Library Functions Manual 					   PTHREAD_ATTR(3)

NAME

     pthread_attr_getstacksize, pthread_attr_setstacksize -- thread attribute operations

SYNOPSIS

     #include <pthread.h>

     int
     pthread_attr_getstacksize(const pthread_attr_t *restrict attr, size_t *restrict stacksize);

     int
     pthread_attr_setstacksize(pthread_attr_t *attr, size_t stacksize);

DESCRIPTION

     Thread attributes are used to specify parameters to pthread_create().  One attribute object can be used in multiple calls to
     pthread_create(), with or without modifications between calls.

     The functions pthread_attr_setstacksize() and pthread_attr_getstacksize(), respectively, set and get the size of the stack that is to be cre-
     ated for the new thread. The stack size attribute is set within the attr argument, which can subsequently be used as an argument to
     pthread_create().

RETURN VALUES

     If successful, these functions return 0.  Otherwise, an error number is returned to indicate the error.  pthread_attr_getstacksize() returns
     the stacksize attribute value in stacksize if successful.

ERRORS

     pthread_attr_getstacksize() will fail if:

     [EINVAL]		Invalid value for attr.

     pthread_attr_setstacksize() will fail if:

     [EINVAL]		Invalid value for attr.

     [EINVAL]		stacksize is less than PTHREAD_STACK_MIN.

     [EINVAL]		stacksize is not a multiple of the system page size.

SEE ALSO

     pthread_create(3), pthread_attr_init(3), pthread_attr_setstackaddr(3)

STANDARDS

     pthread_attr_setstacksize(), pthread_attr_getstacksize() conform to ISO/IEC 9945-1:1996 (``POSIX.1'')

BSD
								 December 31, 2007							       BSD

pthread_attr_getstacksize(3C)											     pthread_attr_getstacksize(3C)

NAME

       pthread_attr_getstacksize, pthread_attr_setstacksize - get or set stacksize attribute

SYNOPSIS

       cc -mt [ flag... ] file... -lpthread [ library... ]
       #include <pthread.h>

       int pthread_attr_getstacksize(const pthread_attr_t *restrict attr, size_t *restrict stacksize);

       int pthread_attr_setstacksize(pthread_attr_t *attr, size_t stacksize);

       The  functions  pthread_attr_setstacksize()  and  pthread_attr_getstacksize(),  respectively,  set  and	get  the thread creation stacksize
       attribute in the attr object.

       The stacksize attribute defines the minimum stack size (in bytes) allocated for the created threads stack. When the stacksize  argument	is
       NULL, the default stack size becomes 1 megabyte for 32-bit processes and  2 megabytes for 64-bit processes.

       Upon successful completion, pthread_attr_setstacksize() and pthread_attr_getstacksize() return a value of  0. Otherwise, an error number is
       returned to indicate the error. The pthread_attr_getstacksize() function stores the stacksize attribute value in stacksize if successful.

       The pthread_attr_setstacksize() or pthread_attr_getstacksize() function may fail if:

       EINVAL	       attr or stacksize is invalid.

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

       pthread_attr_init(3C), pthread_attr_setstackaddr(3C), pthread_attr_setdetachstate(3C), pthread_create(3C), attributes(5), standards(5)

								    23 Mar 2005 				     pthread_attr_getstacksize(3C)