NAME    [Toc]    [Back]

       tis_testcancel - Creates a cancellation point in the calling
 thread

SYNOPSIS    [Toc]    [Back]

       #include <tis.h>

       void tis_testcancel(
               void );

LIBRARY    [Toc]    [Back]

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

STANDARDS    [Toc]    [Back]

       None

PARAMETERS    [Toc]    [Back]

       None

DESCRIPTION    [Toc]    [Back]

       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    [Toc]    [Back]

       None

SEE ALSO    [Toc]    [Back]

       Functions: tis_setcancelstate(3)

       Manuals: Guide to DECthreads and Programmer's Guide



                                                tis_testcancel(3)