pthread_testcancel(3T)pthread_testcancel(3T)NAME
pthread_testcancel() - process any pending cancellation requests
SYNOPSIS PARAMETERS
None.
DESCRIPTION
The function checks for any pending cancellation requests against the calling 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 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
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 Library pthread_testcancel(3T)
Check Out this Related Man Page
pthread_setcancelstate(3T)pthread_setcancelstate(3T)NAME
pthread_setcancelstate(), pthread_setcanceltype() - set and retrieve current thread's cancelability state or type.
SYNOPSIS PARAMETERS
state Value to which the cancelability state of the calling thread is to be set.
oldstate Pointer to the location where the old cancelability state of the calling thread will be returned.
type Value to which the cancelability type of the calling thread is to be set.
oldtype Pointer to the location where the old cancelability type of the calling thread will be returned.
DESCRIPTION
atomically sets the calling thread's cancelability state to the value in state and returns the previous cancelability state in oldstate.
The legal values for state are:
Disable cancelability for the calling thread.
Cancellation requests against the calling thread are held pending.
Enable cancelability for the calling thread.
Cancellation requests against the calling thread may be acted upon. When a pending cancellation request will be acted upon
depends on the thread's cancelability type.
By default, a thread's cancelability state is set to when it is created.
atomically sets the calling thread's cancelability type to the value in type and returns the previous cancelability type in oldtype. The
legal values for type are:
New or pending cancellation requests against the calling thread may be acted
upon at any time (if cancellation is enabled for the calling thread).
Cancellation requests for the calling thread are held pending until a
cancellation point is reached.
A thread's cancelability type is set to when it is created.
If a thread's cancelability state is disabled, the setting of the thread's cancelability type has no immediate effect. All cancellation
requests are held pending. However, once cancelability is enabled again, the new type will be in effect.
RETURN VALUE
Upon successful completion, and return zero. Otherwise, an error number is returned to indicate the error (the variable is not set).
ERRORS
For each of the following conditions, if the condition is detected, the and functions return the corresponding error number:
[EINVAL] state contains an invalid value.
[EINVAL] type contains an invalid value.
NOTES
Only functions that are async-cancel safe should be called from a thread that is asynchronously cancelable.
AUTHOR
and were derived from the IEEE POSIX P1003.1c standard.
SEE ALSO pthread_exit(3T), pthread_join(3T), pthread_cancel(3T), pthread_cond_wait(3T), pthread_cond_timedwait(3T).
STANDARDS CONFORMANCE
Pthread Library pthread_setcancelstate(3T)