pthread_detach

PTHREAD_DETACH(3)           Library Functions Manual           PTHREAD_DETACH(3)



NAME
       pthread_detach - put a running thread in the detached state


SYNOPSIS
       #include <pthread.h>

       int pthread_detach(pthread_t th);


DESCRIPTION
       pthread_detach put the thread th in the detached state. This guarantees
       that the memory resources consumed by th will be freed immediately when
       th terminates. However, this prevents other threads from synchronizing on
       the termination of th using pthread_join.

       A thread can be created initially in the detached state, using the
       detachstate attribute to pthread_create(3).  In contrast, pthread_detach
       applies to threads created in the joinable state, and which need to be
       put in the detached state later.

       After pthread_detach completes, subsequent attempts to perform
       pthread_join on th will fail. If another thread is already joining the
       thread th at the time pthread_detach is called, pthread_detach does
       nothing and leaves th in the joinable state.


RETURN VALUE
       On success, 0 is returned. On error, a non-zero error code is returned.


ERRORS
       ESRCH  No thread could be found corresponding to that specified by th

       EINVAL the thread th is already in the detached state


AUTHOR
       Xavier Leroy <Xavier.Leroy@inria.fr>


SEE ALSO
       pthread_create(3), pthread_join(3), pthread_attr_setdetachstate(3)



                                  LinuxThreads                 PTHREAD_DETACH(3)