NAME
pthreaddetach - detach a thread SYNOPSIS
#include
int pthreaddetach(pthreadt thread); Compile and link with -pthread. DESCRIPTION The pthreaddetach() function marks the thread identified by thread as detached. When a detached thread terminates, its resources are auto‐ matically released back to the system without the need for another thread to join with the terminated thread. Attempting to detach an already detached thread results in unspecified behavior. RETURN VALUE On success, pthreaddetach() returns 0; on error, it returns an error number. ERRORS EINVAL thread is not a joinable thread. ESRCH No thread with the ID thread could be found. CONFORMING TO
POSIX.1-2001. NOTES Once a thread has been detached, it can't be joined with pthreadjoin(3) or be made joinable again. A new thread can be created in a detached state using pthreadattrset‐ detachstate(3) to set the detached attribute of the attr argument of pthreadcreate(3). The detached attribute merely determines the behavior of the system when the thread terminates; it does not prevent the thread from being terminated if the process terminates using exit(3) (or equivalently, if the main thread returns). Either pthreadjoin(3) or pthreaddetach() should be called for each thread that an application creates, so that system resources for the thread can be released. (But note that the resources of all threads are freed when the process terminates.) EXAMPLE The following statement detaches the calling thread: pthreaddetach(pthreadself()); SEE ALSO pthreadattrsetdetachstate(3), pthreadcancel(3), pthreadcreate(3), pthreadexit(3), pthreadjoin(3), pthreads(7) COLOPHON
This page is part of release 3.53 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 2008-11-27 PTHREADDETACH(3)