pthread_kill_other_threads_np(3) — Linux manual page

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | ATTRIBUTES | VERSIONS | STANDARDS | HISTORY | NOTES | SEE ALSO | COLOPHON

pthread_...hreads_np(3) Library Functions Manual pthread_...hreads_np(3)

NAME         top

       pthread_kill_other_threads_np - terminate all other threads in
       process

LIBRARY         top

       POSIX threads library (libpthread, -lpthread)

SYNOPSIS         top

       #include <pthread.h>

       void pthread_kill_other_threads_np(void);

DESCRIPTION         top

       pthread_kill_other_threads_np() has an effect only in the
       LinuxThreads threading implementation.  On that implementation,
       calling this function causes the immediate termination of all
       threads in the application, except the calling thread.  The
       cancelation state and cancelation type of the to-be-terminated
       threads are ignored, and the cleanup handlers are not called in
       those threads.

ATTRIBUTES         top

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

VERSIONS         top

       In the NPTL threading implementation,
       pthread_kill_other_threads_np() exists, but does nothing.
       (Nothing needs to be done, because the implementation does the
       right thing during an execve(2).)

STANDARDS         top

       GNU; hence the suffix "_np" (nonportable) in the name.

HISTORY         top

       glibc 2.0

NOTES         top

       pthread_kill_other_threads_np() is intended to be called just
       before a thread calls execve(2) or a similar function.  This
       function is designed to address a limitation in the obsolete
       LinuxThreads implementation whereby the other threads of an
       application are not automatically terminated (as POSIX.1-2001
       requires) during execve(2).

SEE ALSO         top

       execve(2), pthread_cancel(3), pthread_setcancelstate(3),
       pthread_setcanceltype(3), pthreads(7)

COLOPHON         top

       This page is part of the man-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.9.1.tar.gz
       fetched from
       ⟨https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/⟩ on
       2024-06-26.  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 is not
       part of the original manual page), send a mail to
       [email protected]

Linux man-pages 6.9.1          2024-05-02        pthread_...hreads_np(3)