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 reasonable amount of time. 

RETURN VALUES

None

RELATED INFORMATION

Functions: pthread_setcancelstate(3)

Manuals: Guide to DECthreads and Programmer’s Guide