PTHREAD_KILL_OTHER_THREADS_NP(3)    Linux Programmer's Manual    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 implemen‐
       tation.  On that implementation, calling this function causes the immediate termination of
       all  threads  in  the  application, except the calling thread.  The cancellation state and
       cancellation type of the to-be-terminated threads are ignored, and  the  cleanup  handlers
       are not called in those threads.

ATTRIBUTES
   Multithreading (see pthreads(7))
       The pthread_kill_other_threads_np() function is thread-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 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).

       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  dur‐
       ing an execve(2).)

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

COLOPHON
       This page is part of release 3.74 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 http://www.kernel.org/doc/man-pages/.



Linux                                       2014-05-13           PTHREAD_KILL_OTHER_THREADS_NP(3)