Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

pthread_attr_setdetachstate(3) [osf1 man page]

pthread_attr_setdetachstate(3)				     Library Functions Manual				    pthread_attr_setdetachstate(3)

NAME
pthread_attr_setdetachstate - Changes the detachstate attribute in the specified thread attributes object. LIBRARY
DECthreads POSIX 1003.1c Library (libpthread.so) SYNOPSIS
#include <pthread.h> int pthread_attr_setdetachstate( pthread_attr_t *attr, int detachstate); STANDARDS
Interfaces documented on this reference page conform to industry standards as follows: IEEE Std 1003.1c-1995, POSIX System Application Program Interface PARAMETERS
Thread attributes object to be modified. New value for the detachstate attribute. Valid values are as follows: This the default value. Threads are created in "undetached" state. The created thread is detached immediately, before it begins running. DESCRIPTION
This routine changes the detachstate attribute in the thread attributes object specified by the attr argument. The detachstate attribute specifies whether the thread created using the specified thread attributes object is created in a detached state or not. A value of PTHREAD_CREATE_JOINABLE indicates the thread is not detached, and a value of PTHREAD_CREATE_DETACHED indicates the thread is detached. PTHREAD_CREATE_JOINABLE is the default value. Your program cannot use the thread handle (the value of type pthread_t that is returned by the pthread_create(3) routine) for a detached thread because the thread might terminate asynchronously, and a thread ID is not valid after termination. In particular, it is an error to attempt to detach or join with a detached thread. When a thread that has not been detached completes execution, DECthreads retains the state of that thread to allow another thread to join with it. If the thread is detached before it completes execution, DECthreads is free to immediately reclaim the thread's storage and resources. Failing to detach threads that have completed execution can result in wasting resources, so threads should be detached as soon as the program is done with them. If there is no need to use the thread's handle after creation, create the thread initially detached. RETURN VALUES
If an error condition occurs, this routine returns an integer value indicating the type of error. Possible return values are as follows: Successful completion. The detached state attribute is returned in detachstate. The value specified by the attr argument is not a valid thread attributes object or the detachstate argument is invalid. ERRORS
None RELATED INFORMATION
Functions: pthread_attr_init(3), pthread_attr_getdetachstate(3), pthread_create(3), pthread_join(3) Manuals: Guide to DECthreads and Programmer's Guide delim off pthread_attr_setdetachstate(3)

Check Out this Related Man Page

pthread_attr_getdetachstate(3C) 										   pthread_attr_getdetachstate(3C)

NAME
pthread_attr_getdetachstate, pthread_attr_setdetachstate - get or set detachstate attribute SYNOPSIS
cc -mt [ flag... ] file... -lpthread [ library... ] #include <pthread.h> int pthread_attr_setdetachstate(pthread_attr_t *attr, int detachstate); int pthread_attr_getdetachstate(const pthread_attr_t *attr, int *detachstate); The detachstate attribute controls whether the thread is created in a detached state. If the thread is created detached, then use of the ID of the newly created thread by the pthread_detach() or pthread_join() function is an error. The pthread_attr_setdetachstate() and pthread_attr_getdetachstate(), respectively, set and get the detachstate attribute in the attr object. The detachstate can be set to either PTHREAD_CREATE_DETACHED or PTHREAD_CREATE_JOINABLE. A value of PTHREAD_CREATE_DETACHED causes all threads created with attr to be in the detached state, whereas using a value of PTHREAD_CREATE_JOINABLE causes all threads created with attr to be in the joinable state. The default value of the detachstate attribute is PTHREAD_CREATE_JOINABLE. Upon successful completion, pthread_attr_setdetachstate() and pthread_attr_getdetachstate() return a value of 0. Otherwise, an error num- ber is returned to indicate the error. The pthread_attr_getdetachstate() function stores the value of the detachstate attribute in detachstate if successful. The pthread_attr_setdetachstate() or pthread_attr_getdetachstate() functions may fail if: EINVAL attr or detachstate 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_setstacksize(3C), pthread_create(3C), attributes(5), standards(5) 23 Mar 2005 pthread_attr_getdetachstate(3C)

Featured Tech Videos