pthread_kill_other_threads_np

PTHREAD_KILL_OTHER_THREADS_Linux Programmer's PTHREAD_KILL_OTHER_THREADS_NP(3)

NAME
       pthread_kill_other_threads_np - terminate all other threads in process

SYNOPSIS
       #include <pthread.h>

       void pthread_kill_other_threads_np(void);

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

ATTRIBUTES
       For an  explanation  of  the  terms  used  in  this  section,  see  at-
       tributes(7).

       +--------------------------------+---------------+---------+
       |Interface                       | Attribute     | Value   |
       +--------------------------------+---------------+---------+
       |pthread_kill_other_threads_np() | Thread safety | MT-Safe |
       +--------------------------------+---------------+---------+
CONFORMING TO
       This  function  is  a nonstandard GNU extension; hence the suffix "_np"
       (nonportable) in the name.

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

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

SEE ALSO
       execve(2), pthread_cancel(3),  pthread_setcancelstate(3),  pthread_set-
       canceltype(3), pthreads(7)

COLOPHON
       This  page  is  part of release 5.05 of the Linux man-pages project.  A
       description of the project, information about reporting bugs,  and  the
       latest     version     of     this    page,    can    be    found    at
       https://www.kernel.org/doc/man-pages/.

Linux                             2017-09-15  PTHREAD_KILL_OTHER_THREADS_NP(3)