NAME    [Toc]    [Back]

       pthread_testcancel  -  Requests delivery of a pending cancellation
 request to the calling thread

SYNOPSIS    [Toc]    [Back]

       #include <pthread.h>

       void pthread_testcancel(
               void );

LIBRARY    [Toc]    [Back]

       DECthreads POSIX 1003.1c Library (libpthread.so)

STANDARDS    [Toc]    [Back]

       Interfaces documented on this reference  page  conform  to
       industry standards as follows:

       IEEE  Std  1003.1c-1995,  POSIX System Application Program
       Interface

PARAMETERS    [Toc]    [Back]

       None

DESCRIPTION    [Toc]    [Back]

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

       None

SEE ALSO    [Toc]    [Back]

       Functions: pthread_setcancelstate(3)

       Manuals: Guide to DECthreads and Programmer's Guide



                                            pthread_testcancel(3)