线程取消相关的函数的用法

线程执行到pthread_testcancel()函数时，并不一定会马上取消（退出）。

 

先描述一下取消一个线程的过程：

1) 其他线程通过调用pthread_cancel()函数，向目标线程发送取消请求（cancellation request）。

2) 取消请求发出后，根据目标线程的cancel state来决定取消请求是否会到达目标线程：

a. 如果目标线程的cancel state是PTHREAD_CANCEL_ENABLE（默认），取消请求会到达目标线程。

b. 如果目标线程的cancel state是PTHREAD_CANCEL_DISABLE，取消请求会被放入队列。直到目标线程的cancel state变为PTHREAD_CANCEL_ENABLE，取消请求才会从队列里取出，发到目标线程。

3) 取消请求到达目标线程后，根据目标线程的cancel type来决定线程何时取消：

a. 如果目标线程的cancel type是PTHREAD_CANCEL_DEFERRED（默认），目标线程并不会马上取消，而是在执行下一条cancellation point的时候才会取消。有很多系统函数都是cancellation point，详细的列表可以在Linux上用man 7 pthreads查看。除了列出来的cancellation point，pthread_testcancel()也是一个cancellation point。就是说目标线程执行到pthread_testcancel()函数的时候，如果该线程收到过取消请求，而且它的cancel type是PTHREAD_CANCEL_DEFERRED，那么这个线程就会在这个函数里取消（退出），这个函数就不再返回了，目标线程也没有了。

b. 如果目标线程的cancel type是PTHREAD_CANCEL_ASYNCHRONOUS，目标线程会立即取消（这里的“立即”只是说目标线程不用等执行到属于cancellation point的函数的时候才会取消，它会在获得调度之后立即取消，因为内核调度会有延时，所以并不能保证时间上的“立即”）

void thread_function(void *arg)

{

/**

* 线程准备执行一些关键工作，在这个过程中不希望被取消。

* 所以先通过pthread_setcancelstate()将本线程的cancel state

* 设为disabled。

*/

pthread_setcancelstate(PTHREAD_CANCEL_DISABLE, NULL);

/* 执行关键工作 */

...

/**

* 关键工作执行完成，可以被取消。

* 通过pthread_setcancelstate()将本线程的cancel state

* 设为enabled。

*/

pthread_setcancelstate(PTHREAD_CANCEL_ENABLE, NULL);

/**

* 调用pthread_testcancel()函数，检查一下在cancel state

* 为disabled状态的时候，是否有取消请求发送给本线程。

* 如果有的话就取消（退出）。

*/

pthread_testcancel();

/**

* pthread_testcancel()返回了，表明之前没有取消请求发送给本线程，

* 继续其余的工作。

* 这时候如果有取消请求发送给本线程，会在下一次执行到

* cancellation point的时候（例如sleep(), read(), write(), ...）时取消。

*/

...

/**

* 从这里开始，函数里不再包含cancellation point了。

* 如果收到取消请求，将无法取消。所以先把本线程的cancel type

* 设为asynchronous，收到取消请求将立即取消。

*/

pthread_setcanceltype(PTHREAD_CANCEL_ASYNCHRONOUS, NULL);

/* 不包含cancellation point的代码 */

...

}

pthread_cancel()的用法：

线程取消的方法是向目标线程发Cancel信号，但如何处理Cancel信号则由目标线程自己决定，或者忽略、或者立即终止、或者继续运行至Cancelation-point（取消点），由不同的Cancelation状态决定。   
线程接收到CANCEL信号的缺省处理（即pthread_create()创建线程的缺省状态）是继续运行至取消点，也就是说设置一个CANCELED状态，线程继续运行，只有运行至Cancelation-point的时候才会退出。   
（1）什么是线程取消点   
根据POSIX标准，pthread_join()、pthread_testcancel()、pthread_cond_wait()、pthread_cond_timedwait()、sem_wait()、sigwait()等函数以及read()、write()等会引起阻塞的系统调用都是Cancelation-point，而其他pthread函数都不会引起Cancelation动作。但是pthread_cancel的手册页声称，由于LinuxThread库与C库结合得不好，因而目前C库函数都不是Cancelation-point；但CANCEL信号会使线程从阻塞的系统调用中退出，并置EINTR错误码，因此可以在需要作为Cancelation-point的系统调用前后调用pthread_testcancel()，从而达到POSIX标准所要求的目标，即如下代码段：   
pthread_testcancel();   
retcode   =   read(fd,   buffer,   length);   
pthread_testcancel();   

（2）程序设计方面的考虑   
如果线程处于无限循环中，且循环体内没有执行至取消点的必然路径，则线程无法由外部其他线程的取消请求而终止。因此在这样的循环体的必经路径上应该加入pthread_testcancel()调用。   

（3）与线程取消相关的pthread函数   
int   pthread_cancel(pthread_t   thread)   
发送终止信号给thread线程，如果成功则返回0，否则为非0值。发送成功并不意味着thread会终止。   

int   pthread_setcancelstate(int   state,   int   *oldstate)   
设置本线程对Cancel信号的反应，state有两种值：PTHREAD_CANCEL_ENABLE（缺省）和PTHREAD_CANCEL_DISABLE，分别表示收到信号后设为CANCLED状态和忽略CANCEL信号继续运行；old_state如果不为NULL则存入原来的Cancel状态以便恢复。   

int   pthread_setcanceltype(int   type,   int   *oldtype)   
设置本线程取消动作的执行时机，type由两种取值：PTHREAD_CANCEL_DEFFERED和PTHREAD_CANCEL_ASYCHRONOUS，仅当Cancel状态为Enable时有效，分别表示收到信号后继续运行至下一个取消点再退出和立即执行取消动作（退出）；oldtype如果不为NULL则存入运来的取消动作类型值。   

void   pthread_testcancel(void)   
检查本线程是否处于Canceld状态，如果是，则进行取消动作，否则直接返回