NAME

     pthread_testcancel - Requests delivery of a pending cancel to the
                          current thread

 SYNOPSIS

     #include <pthread.h>

     void pthread_testcancel();

 DESCRIPTION

 The pthread_testcancel() routine requests delivery of a pending cancel
 to the current thread.  The cancel is delivered only if a cancel is
 pending for the current thread and general cancel delivery is not
 currently disabled. (A thread disables delivery of cancels to itself by
 calling the pthread_setcancel() routine.)

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

 RETURN VALUES

 No value is returned.

 RELATED INFORMATION

     FUNCTIONS:  pthread_cancel
                 pthread_setasynccancel
                 pthread_setcancel