pthread_attr_set_getstackaddr(3) [osx man page]

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

NAME

     pthread_attr_getstackaddr, pthread_attr_setstackaddr -- thread attribute operations

SYNOPSIS

     #include <pthread.h>

     int
     pthread_attr_getstackaddr(const pthread_attr_t *restrict attr, void **restrict stackaddr);

     int
     pthread_attr_setstackaddr(pthread_attr_t *attr, void *stackaddr);

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_setstackaddr() and pthread_attr_getstackaddr() respectively, set and get the address at which the stack of the
     newly created thread should be located.  The stackaddr attribute is set within the attr argument, which can subsequently be used as an argu-
     ment to pthread_create().

RETURN VALUES

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

ERRORS

     pthread_attr_setstackaddr() will fail if:

     [EINVAL]		Invalid value for attr.

     pthread_attr_getstackaddr() will fail if:

     [EINVAL]		Invalid value for attr.

SEE ALSO

     pthread_create(3), pthread_attr_init(3), pthread_attr_setdetachstate(3), pthread_attr_setstacksize(3)

STANDARDS

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

BSD
								 December 31, 2007							       BSD

pthread_attr_getstackaddr(3C)											     pthread_attr_getstackaddr(3C)

NAME

       pthread_attr_getstackaddr, pthread_attr_setstackaddr - get or set stackaddr attribute

SYNOPSIS

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

       int pthread_attr_getstackaddr(const pthread_attr_t *restrict attr, void **restrict stackaddr);

       int pthread_attr_setstackaddr(pthread_attr_t *attr, void *stackaddr);

       The  functions  pthread_attr_setstackaddr()  and  pthread_attr_getstackaddr(),  respectively,  set  and	get  the thread creation stackaddr
       attribute in the attr object. The stackaddr default is NULL. See pthread_create(3C).

       The stackaddr attribute specifies the location of storage to be used for the created thread's stack. The size of the storage  is  at  least
       PTHREAD_STACK_MIN.

       Upon successful completion, pthread_attr_setstackaddr() and pthread_attr_getstackaddr() return a value of  0. Otherwise, an error number is
       returned to indicate the error.

       If successful, the pthread_attr_getstackaddr() function stores the stackaddr attribute value in stackaddr.

       The pthread_attr_setstackaddr() function may fail if:

       EINVAL	       attr is invalid.

       The  pthread_attr_getstackaddr() function may fail if:

       EINVAL	       attr or stackaddr 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_setdetachstate(3C), pthread_attr_setstacksize(3C), pthread_create(3C), attributes(5), standards(5)

								    23 Mar 2005 				     pthread_attr_getstackaddr(3C)