pthread_attr_setdetachstate(3) [netbsd man page]

PTHREAD_ATTR_GETDETACHSTATE(3)				   BSD Library Functions Manual 			    PTHREAD_ATTR_GETDETACHSTATE(3)

NAME

     pthread_attr_getdetachstate -- get and set the ``detach state'' attribute

LIBRARY

     POSIX Threads Library (libpthread, -lpthread)

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

     The attribute parameters for the pthread_attr_getdetachstate() and pthread_attr_setdetachstate() functions are mutually exclusive and must be
     one of:

       PTHREAD_CREATE_JOINABLE	The threads must explicitly be waited for using the pthread_join(3) function once they exit for their status to be
				received and their resources to be freed.  This is the default.

       PTHREAD_CREATE_DETACHED	The thread's resources will automatically be freed once the thread exits, and the thread will not be joined.

     If the thread is created as detached, it is an error to use the thread ID with pthread_detach(3) or pthread_join(3).

RETURN VALUES

     If successful, these functions return 0.  Otherwise, an error number is returned to indicate the error.

ERRORS

     No errors are defined for pthread_attr_getdetachstate().

     The pthread_attr_setdetachstate() function should fail if:

     [EINVAL]		The value specified by detachstate is invalid.

SEE ALSO

     pthread_attr(3), pthread_detach(3), pthread_join(3)

STANDARDS

     Both functions conform to IEEE Std 1003.1-2001 (``POSIX.1'').

BSD
								   July 9, 2010 							       BSD

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