pthread_testcancel.3t (2010 09)

p
pthread_testcancel(3T) pthread_testcancel(3T)
(Pthread Library)
NAME
pthread_testcancel() - process any pending cancellation requests
SYNOPSIS
#include <pthread.h>
void pthread_testcancel(void);
PARAMETERS
None.
DESCRIPTION
The
pthread_testcancel()
function checks for any pending cancellation requests against the cal-
ling thread. If a cancellation request is pending and the calling thread has its cancelability state enabled,
the cancellation request will be acted upon. If the cancelability state of the calling thread is disabled, this
function will have no effect.
RETURN VALUE
None. The
pthread_testcancel()
function does not return a value.
If the calling thread acts upon a cancellation request, this function will not return; the calling thread will
be terminated.
ERRORS
None.
AUTHOR
pthread_testcancel()
was derived from the IEEE POSIX P1003.1c standard.
SEE ALSO
pthread_exit(3T), pthread_join(3T), pthread_setcancelstate(3T), pthread_setcanceltype(3T),
pthread_cleanup_push(3T), pthread_cleanup_pop(3T), pthread_cond_wait(3T),
pthread_cond_timedwait(3T).
STANDARDS CONFORMANCE
pthread_testcancel()
: POSIX 1003.1c.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1