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