Digital

NAME

pthread_cancel − Allows a thread to request that it or another thread terminate execution. 

SYNOPSIS

#include <pthread.h>
int pthread_cancel(

pthread_t thread );

PARAMETERS

threadThread that receives a cancel request. 

DESCRIPTION

This routine sends a cancel to the specified thread. A cancel is a mechanism by which a calling thread informs either itself or the called thread to terminate as quickly as possible. Issuing a cancel does not guarantee that the cancelled thread receives or handles the cancel. The cancelled thread can delay processing the cancel after receiving it. For instance, if a cancel arrives during an important operation, the cancelled thread can continue if what it is doing cannot be interrupted at the point where the cancel is requested. 

Because of communication delays, the calling thread can only rely on the fact that a cancel eventually becomes pending in the designated thread (provided that the thread does not terminate beforehand). Furthermore, the calling thread has no guarantee that a pending cancel is be delivered because delivery is controlled by the designated thread. 

Termination processing when a cancel is delivered to a thread is similar to pthread_exit. Outstanding cleanup routines are executed in the context of the target thread, and a status of −1 is made available to any threads joining with the target thread. 

This routine is preferred in implementing Ada’s abort statement and any other language (or software-defined construct) for requesting thread cancellation. 

The results of this routine are unpredictable if the value specified in thread refers to a thread that does not currently exist. 

RETURN VALUES

If an error condition occurs, this routine returns −1 and sets errno to the corresponding error value. Possible return values are as follows:

RELATED INFORMATION

pthread_exit(3), pthread_join(3), pthread_setasynccancel(3), pthread_setcancel(3), pthread_testcancel(3)