Click this button to go to the index for this section.

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 reasonable
  amount of time.

RETURN VALUES
  None

RELATED INFORMATION
  Functions: pthread_setcancelstate(3)

  Manuals: Guide to DECthreads and Programmer's Guide