NAME

tis_testcancel − Creates a cancellation point in the calling thread

SYNOPSIS

#include <tis.h>
void tis_testcancel(
        void );

LIBRARY

Standard C Library (libc.so, libc.a)

STANDARDS

None

PARAMETERS

None

DESCRIPTION

This routine requests delivery of a pending cancellation request to the calling thread. Thus, this routine creates a cancellation point in 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 tis_setcancelstate(3).) 

This routine, when called within very long loops, ensures that a pending cancellation request is noticed within a reasonable amount of time. 

RETURN VALUES

None

SEE ALSO

Functions: tis_setcancelstate(3)

Manuals: Guide to DECthreads and Programmer’s Guide