Movatterモバイル変換

pthread_detach(3) — Linux manual page

pthread_detach(3)        Library Functions Manualpthread_detach(3)

NAME        top

       pthread_detach - detach a thread

LIBRARY        top

       POSIX threads library (libpthread,-lpthread)

SYNOPSIS        top

#include <pthread.h>int pthread_detach(pthread_tthread);

DESCRIPTION        top

       Thepthread_detach() function marks the thread identified bythread as detached.  When a detached thread terminates, its       resources are automatically 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        top

       On success,pthread_detach() returns 0; on error, it returns an       error number.

ERRORS        top

EINVALthread is not a joinable thread.ESRCHNo thread with the IDthread could be found.

ATTRIBUTES        top

       For an explanation of the terms used in this section, seeattributes(7).       ┌──────────────────────────────────────┬───────────────┬─────────┐       │Interface│Attribute│Value│       ├──────────────────────────────────────┼───────────────┼─────────┤       │pthread_detach()                     │ Thread safety │ MT-Safe │       └──────────────────────────────────────┴───────────────┴─────────┘

STANDARDS        top

       POSIX.1-2008.

HISTORY        top

       POSIX.1-2001.

NOTES        top

       Once a thread has been detached, it can't be joined withpthread_join(3) or be made joinable again.       A new thread can be created in a detached state usingpthread_attr_setdetachstate(3) to set the detached attribute of       theattr argument ofpthread_create(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 usingexit(3) (or       equivalently, if the main thread returns).       Eitherpthread_join(3) orpthread_detach() 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       any threads for which one of these actions has not been done will       be freed when the process terminates.)

EXAMPLES        top

       The following statement detaches the calling thread:           pthread_detach(pthread_self());

SEE ALSO        top

pthread_attr_setdetachstate(3),pthread_cancel(3),pthread_create(3),pthread_exit(3),pthread_join(3),pthreads(7)

COLOPHON        top

       This page is part of theman-pages (Linux kernel and C library       user-space interface documentation) project.  Information about       the project can be found at        ⟨https://www.kernel.org/doc/man-pages/⟩.  If you have a bug report       for this manual page, see       ⟨https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/CONTRIBUTING⟩.       This page was obtained from the tarball man-pages-6.15.tar.gz       fetched from       ⟨https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/⟩ on       2025-08-11.  If you discover any rendering problems in this HTML       version of the page, or you believe there is a better or more up-       to-date source for the page, or you have corrections or       improvements to the information in this COLOPHON (which isnot       part of the original manual page), send a mail to       man-pages@man7.orgLinux man-pages 6.15            2025-05-17pthread_detach(3)

Pages that refer to this page:pthread_attr_setdetachstate(3), pthread_create(3), pthread_join(3), pthreads(7)

HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface. For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere. Hosting byjambit GmbH.