osf1 man page for pthread_testcancel

pthread_testcancel(3)					     Library Functions Manual					     pthread_testcancel(3)

NAME
       pthread_testcancel - Requests delivery of a pending cancelation request to the calling thread.

LIBRARY
       DECthreads POSIX 1003.1c Library (libpthread.so)

SYNOPSIS
       #include <pthread.h>

       void   pthread_testcancel(void);

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 cancelation request to the calling thread.  Thus, calling this routine creates a cancelation
       point within the calling thread.

       The cancelation 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 cancelation requests to itself by calling pthread_setcancelstate(3).)

       When  called within very long loops, this routine ensures that a pending cancelation request is noticed by the calling thread within a rea-
       sonable amount of time.

RETURN VALUES
       None

RELATED INFORMATION
       Functions: pthread_setcancelstate(3)

       Manuals: Guide to DECthreads and Programmer's Guide

       delim off

															     pthread_testcancel(3)