pthread_testcancel(3)pthread_testcancel(3)NAMEpthread_testcancel - Requests delivery of a pending cancellation
request to the calling thread
SYNOPSIS
#include <pthread.h>
void pthread_testcancel(
void );
LIBRARY
DECthreads POSIX 1003.1c Library (libpthread.so)
STANDARDS
Interfaces documented on this reference page conform to industry stan‐
dards as follows:
IEEE Std 1003.1c-1995, POSIX System Application Program Interface
PARAMETERS
None
DESCRIPTION
This routine requests delivery of a pending cancellation request to the
calling thread. Thus, calling this routine creates a cancellation point
within the calling thread.
The cancellation request is delivered only if a request is pending for
the calling thread and the calling thread's cancelability state is
enabled. (A thread disables delivery of cancellation requests to
itself by calling pthread_setcancelstate(3).)
When called within very long loops, this routine ensures that a pending
cancellation request is noticed by the calling thread within a reason‐
able amount of time.
RETURN VALUES
None
SEE ALSO
Functions: pthread_setcancelstate(3)
Manuals: Guide to DECthreads and Programmer's Guide
pthread_testcancel(3)