pthread_testcancel(3) Library Functions Manual pthread_testcancel(3)
NAME
pthread_testcancel - Requests delivery of a pending cancelation request to the calling thread.
LIBRARY
DECthreads POSIX 1003.1c Library (libpthread.so)
SYNOPSIS
#include <pthread.h>
void pthread_testcancel(void);
STANDARDS
Interfaces documented on this reference page conform to industry standards as follows:
IEEE Std 1003.1c-1995, POSIX System Application Program Interface
PARAMETERS
None
DESCRIPTION
This routine requests delivery of a pending cancelation request to the calling thread. Thus, calling this routine creates a cancelation
point within the calling thread.
The cancelation 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 cancelation requests to itself by calling pthread_setcancelstate(3).)
When called within very long loops, this routine ensures that a pending cancelation request is noticed by the calling thread within a rea-
sonable amount of time.
RETURN VALUES
None
RELATED INFORMATION
Functions: pthread_setcancelstate(3)
Manuals: Guide to DECthreads and Programmer's Guide
delim off
pthread_testcancel(3)
