pthread_testcancel(3) — Subroutines

NAME

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

RETURN VALUES