redhat man page for pthread_kill_other_threads_np

PTHREAD_KILL_OTHER_THREADS_NP(3)			     Library Functions Manual				  PTHREAD_KILL_OTHER_THREADS_NP(3)

NAME
       pthread_kill_other_threads_np - terminate all threads in program except calling thread

SYNOPSIS
       #include <pthread.h>

       void pthread_kill_other_threads_np(void);

DESCRIPTION
       pthread_kill_other_threads_np  is  a  non-portable  LinuxThreads extension.  It causes all threads in the program to terminate immediately,
       except the calling thread which proceeds normally. It is intended to be called just before a thread calls one of the exec  functions,  e.g.
       execve(2).

       Termination  of the other threads is not performed through pthread_cancel(3) and completely bypasses the cancellation mechanism. Hence, the
       current settings for cancellation state and cancellation type are ignored, and the cleanup handlers are	not  executed  in  the	terminated
       threads.

AUTHOR
       Xavier Leroy <Xavier.Leroy@inria.fr>

SEE ALSO
       execve(2), pthread_setcancelstate(3), pthread_setcanceltype(3), pthread_cancel(3).

BUGS
       According to POSIX 1003.1c, a successful exec* in one of the threads should terminate automatically all other threads in the program.  This
       behavior is not yet implemented in LinuxThreads.  Calling pthread_kill_other_threads_np before exec* achieves much of  the  same  behavior,
       except that if exec* ultimately fails, then all other threads are already killed.

								   LinuxThreads 				  PTHREAD_KILL_OTHER_THREADS_NP(3)