pthread_attr_setdetachstate(3) [mojave man page]

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

NAME

     pthread_attr_getdetachstate, pthread_attr_setdetachstate -- thread attribute operations

SYNOPSIS

     #include <pthread.h>

     int
     pthread_attr_getdetachstate(const pthread_attr_t *attr, int *detachstate);

     int
     pthread_attr_setdetachstate(pthread_attr_t *attr, int detachstate);

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.

     One of these thread attributes governs the creation state of the new thread. The new thread can be either created "detached" or "joinable".
     The constants corresponding to these states are PTHREAD_CREATE_DETACHED and PTHREAD_CREATE_JOINABLE respectively.	Creating a "joinable"
     thread allows the user to call pthread_join() and pthread_detach(), with the new thread's ID. A "detached" thread's ID cannot be used with
     pthread_join() and pthread_detach().  The default value for the "detachstate" attribute is PTHREAD_CREATE_JOINABLE.

     The pthread_attr_setdetachstate() function sets the thread's "detachstate" attribute.

     The "detachstate" 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_getdetachstate(), on
     success, will copy the value of the thread's "detachstate" attribute to the location pointed to by the second function parameter.

ERRORS

     pthread_attr_getdetachstate() will fail if:

     [EINVAL]		Invalid value for attr

     pthread_attr_setdetachstate() will fail if:

     [EINVAL]		Invalid value for attr or detachstate.

SEE ALSO

     pthread_create(3), pthread_join(3), pthread_attr_init(3), pthread_detach(3)

STANDARDS

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

BSD
								 December 31, 2007							       BSD

PTHREAD_ATTR_SETDETACHSTATE(3)				     Linux Programmer's Manual				    PTHREAD_ATTR_SETDETACHSTATE(3)

NAME

       pthread_attr_setdetachstate, pthread_attr_getdetachstate - set/get detach state attribute in thread attributes object

SYNOPSIS

       #include <pthread.h>

       int pthread_attr_setdetachstate(pthread_attr_t *attr, int detachstate);
       int pthread_attr_getdetachstate(pthread_attr_t *attr, int *detachstate);

       Compile and link with -pthread.

DESCRIPTION

       The pthread_attr_setdetachstate() function sets the detach state attribute of the thread attributes object referred to by attr to the value
       specified in detachstate.  The detach state attribute determines whether a thread created using the thread attributes object attr  will	be
       created in a joinable or a detached state.

       The following values may be specified in detachstate:

       PTHREAD_CREATE_DETACHED
	      Threads that are created using attr will be created in a detached state.

       PTHREAD_CREATE_JOINABLE
	      Threads that are created using attr will be created in a joinable state.

       The default setting of the detach state attribute in a newly initialized thread attributes object is PTHREAD_CREATE_JOINABLE.

       The  pthread_attr_getdetachstate()  returns  the  detach  state	attribute of the thread attributes object attr in the buffer pointed to by
       detachstate.

RETURN VALUE

       On success, these functions return 0; on error, they return a nonzero error number.

ERRORS

       pthread_attr_setdetachstate() can fail with the following error:

       EINVAL An invalid value was specified in detachstate.

CONFORMING TO

       POSIX.1-2001.

NOTES

       See pthread_create(3) for more details on detached and joinable threads.

       A thread that is created in a joinable state should eventually either be joined using pthread_join(3) or detached using	pthread_detach(3);
       see pthread_create(3).

       It  is  an  error  to  specify  the  thread  ID	of  a  thread that was created in a detached state in a later call to pthread_detach(3) or
       pthread_join(3).

EXAMPLE

       See pthread_attr_init(3).

SEE ALSO

       pthread_attr_init(3), pthread_create(3), pthread_detach(3), pthread_join(3), pthreads(7)

COLOPHON

       This page is part of release 3.44 of the Linux man-pages project.  A description of the project, and information about reporting bugs,  can
       be found at http://www.kernel.org/doc/man-pages/.

Linux								    2010-02-03					    PTHREAD_ATTR_SETDETACHSTATE(3)