Threads Library (libpthreads.a)
#include <pthread.h>
int pthread_signal_to_cancel_np (sigset, thread) sigset_t *sigset; pthread_t *target;
The pthread_signal_to_cancel_np subroutine cancels the target thread thread by creating a handler thread. The handler thread calls the sigwait subroutine with the sigset parameter, and cancels the target thread when the sigwait subroutine returns. Successive call to this subroutine override the previous one.
Notes:
sigset | Specifies the set of signals to wait on. |
thread | Specifies the thread to cancel. |
Upon successful completion, 0 is returned. Otherwise, an error code is returned.
The pthread_signal_to_cancel_np subroutine is unsuccessful if the following is true:
EAGAIN | The handler thread cannot be created. |
EINVAL | The sigset or thread parameters are not valid. |
This subroutine is part of the Base Operating System (BOS) Runtime.
This subroutine is not POSIX compliant and is provided only for compatibility with DCE threads. It should not be used when writing new applications.
The pthread_cancel subroutine, sigwait subroutine.