FreeBSD Man Pages

pthread_detach(3)

NAME

     pthread_detach -- detach a thread

LIBRARY

     Reentrant C Library (libc_r, -lc_r)
     POSIX Threads Library (libpthread, -lpthread)
     1:1 Threading Library (libthr, -lthr)

SYNOPSIS

     #include <pthread.h>

     int
     pthread_detach(pthread_t thread);

DESCRIPTION

     The pthread_detach() function is used to indicate to the implementation
     that storage for the thread thread can be reclaimed when the thread ter-
     minates.  If thread has not terminated, pthread_detach() will not cause
     it to terminate.  The effect of multiple pthread_detach() calls on the
     same target thread is unspecified.

RETURN VALUES

     If successful, the pthread_detach() function will return zero.  Otherwise
     an error number will be returned to indicate the error.  Note that the
     function does not change the value of errno as it did for some drafts of
     the standard.  These early drafts also passed a pointer to pthread_t as
     the argument.  Beware!

ERRORS

     The pthread_detach() function will fail if:

     [EINVAL]		The implementation has detected that the value speci-
			fied by thread does not refer to a joinable thread.

     [ESRCH]		No thread could be found corresponding to that speci-
			fied by the given thread ID, thread.

SEE ALSO

     pthread_join(3)

STANDARDS

     The pthread_detach() function conforms to ISO/IEC 9945-1:1996
     (``POSIX.1'').

FreeBSD 5.4			 April 4, 1996			   FreeBSD 5.4

SPONSORED LINKS