Linux pthread_exit及线程清理函数

pthread_exit

关于线程的终止

单个线程可以通过下列三种方式退出，在不终止整个进程的情况下停止它的控制流。

(1)线程只是从例程中返回，返回线程的退出码。

(2)线程可以被同一进程中的其他线程取消。

(3)线程调用pthread_exit。

头文件

#include <pthread.h>

函数原型

void pthread_exit(void *retval);

参数

retval是一个无类型指针，与传给启动例程的单个参数类似。同一进程中的其他线程可调用pthread_join函数访问这个指针。调用了pthread_join的线程会一直阻塞直到它指定的线程调用pthread_exit、从启动例程中返回或者被取消。如果线程从启动它的例程返回，retval将包含返回码。若线程被取消则retval指定的内存空间会被置为PTHREAD_CANCELED。

unix环境高级编程

#include <pthread.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <sys/types.h>

void *thr_fn1(void *arg)
{
	printf("thread 1 returning\n");
	return((void *)1);
}

void * thr_fn2(void *arg)
{
	printf("thread 2 exiting\n");
	pthread_exit((void *)2);
}

int main(void)
{
	int err;
	pthread_t tid1, tid2;
	void *tret;

	err = pthread_create(&tid1, NULL, thr_fn1, NULL);
	if(err != 0)
	{
		printf("can't create thread 1: %s\n", strerror(err));
	}
	err = pthread_create(&tid2, NULL, thr_fn2, NULL);
	if(err != 0)
	{
		printf("can't create thread 2: %s\n", strerror(err));
	}
	err = pthread_join(tid1, &tret);
	if(err != 0)
	{
		printf("can't join with thread 1: %s\n", strerror(err));
	}
	printf("thread 1 exit code %d\n", (int)tret);
	err = pthread_join(tid2, &tret);
	if(err != 0)
	{
		printf("can't join with thread 2: %s\n", strerror(err));
	}
	printf("thread 2 exit code %d\n", (int)tret);
	exit(0);
}

线程清理

头文件

#include <pthread.h>

函数原型

int pthread_cancel(pthread_t thread);
void pthread_cleanup_push(void (*routine)(void *),
                                 void *arg);
void pthread_cleanup_pop(int execute);

功能

线程可以调用pthread_cancel函数来请求取消同一进程中的其他线程。在默认情况下pthread_cancel函数会使由thread标识的线程的行为表现为如同调用了参数为PTHREAD_CANCELED的pthread_exit函数，必须特别注意的是，pthread_cancel并不等待线程的终止。它仅仅提出请求。后两个函数被称为线程清理处理函数，线程可以建立多个清理处理函数。处理程序记录在栈空间，所以它们的执行顺序与它们的注册时的顺序相反。

说明

当线程执行动作(1)调用pthread_exit时，(2)响应取消请求时，(3)用非零execute参数调用pthread_cleanup_pop时调用清理函数，调用参数arg,清理函数routine的调用顺序是由pthread_cleanup_push函数来安排的。

如果execute参数置为0，清理函数将不被调用。

unix环境高级编程的例子

#include <pthread.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <sys/types.h>

void cleanup(void *arg)
{
	printf("cleanup: %s\n", (char *)arg);
}

void *thr_fn1(void *arg)
{
	printf("thread 1 start\n");
	pthread_cleanup_push(cleanup, "thread 1 first handler");
	pthread_cleanup_push(cleanup, "thread 1 second handler");
	printf("thread 1 push complete\n");
	if(arg)
	{
		return((void *)1);
	}
	pthread_cleanup_pop(0);
	pthread_cleanup_pop(0);
	return((void *)1);
}

void *thr_fn2(void *arg)
{
	printf("thread 2 start\n");
	pthread_cleanup_push(cleanup, "thread 2 first handler");
	pthread_cleanup_push(cleanup, "thread 2 second handler");
	printf("thread 2 push complete\n");
	if(arg)
	{
		pthread_exit((void *)2);
	}
	pthread_cleanup_pop(0);
	pthread_cleanup_pop(0);
}

int main(void)
{
	int err;
	pthread_t tid1, tid2;
	void *tret;

	err = pthread_create(&tid1, NULL, thr_fn1, (void *)1);
	if(err != 0)
	{
		printf("can't create thread 1: %s\n", strerror(err));
	}

	err = pthread_create(&tid2, NULL, thr_fn2, (void *)1);
	if(err != 0)
	{
		printf("can't create thread 2: %s\n", strerror(err));
	}

	err = pthread_join(tid1, &tret);
	if(err != 0)
	{
		printf("can't join with thread 1: %s\n", strerror(err));
	}

	printf("thread 1 exit code %d\n", (int)tret);

	err = pthread_join(tid2, &tret);
	if(err != 0)
	{
		printf("can't join with thread 2: %s\n", strerror(err));
	}

	printf("thread 2 exit code %d\n", (int)tret);
	exit(0);
}