pthread_exit手册

最新推荐文章于 2025-04-04 23:09:43 发布

转载最新推荐文章于 2025-04-04 23:09:43 发布 · 866 阅读

文章标签：

#Linux #pthread_exit

Linux多线程专栏收录该内容

8 篇文章

订阅专栏

本文详细介绍了 pthread_exit 函数的功能及使用方法。该函数用于终止调用线程，并可通过参数传递退出状态，供其他线程通过 pthread_join 获取。文章还讨论了函数执行过程中清理处理器的行为及线程终止后的资源释放情况。

原文地址：http://man7.org/linux/man-pages/man3/pthread_exit.3.html

PTHREAD_EXIT(3)           Linux Programmer's Manual          PTHREAD_EXIT(3)

NAME top

       pthread_exit - terminate calling thread

SYNOPSIS top

       #include <pthread.h>

       void pthread_exit(void *retval);

       Compile and link with -pthread.

DESCRIPTION top

       The pthread_exit() function terminates the calling thread and returns
       a value via retval that (if the thread is joinable) is available to
       another thread in the same process that calls pthread_join(3).

       Any clean-up handlers established by pthread_cleanup_push(3) that
       have not yet been popped, are popped (in the reverse of the order in
       which they were pushed) and executed.  If the thread has any thread-
       specific data, then, after the clean-up handlers have been executed,
       the corresponding destructor functions are called, in an unspecified
       order.

       When a thread terminates, process-shared resources (e.g., mutexes,
       condition variables, semaphores, and file descriptors) are not
       released, and functions registered using atexit(3) are not called.

       After the last thread in a process terminates, the process terminates
       as by calling exit(3) with an exit status of zero; thus, process-
       shared resources are released and functions registered using
       atexit(3) are called.

RETURN VALUE top

       This function does not return to the caller.

ERRORS top

       This function always succeeds.

CONFORMING TO top

       POSIX.1-2001.

NOTES top

       Performing a return from the start function of any thread other than
       the main thread results in an implicit call to pthread_exit(), using
       the function's return value as the thread's exit status.

       To allow other threads to continue execution, the main thread should
       terminate by calling pthread_exit() rather than exit(3).

       The value pointed to by retval should not be located on the calling
       thread's stack, since the contents of that stack are undefined after
       the thread terminates.

BUGS top

       Currently, there are limitations in the kernel implementation logic
       for wait(2)ing on a stopped thread group with a dead thread group
       leader.  This can manifest in problems such as a locked terminal if a
       stop signal is sent to a foreground process whose thread group leader
       has already called pthread_exit().

COLOPHON top

       This page is part of release 3.51 of the Linux man-pages project.  A
       description of the project, and information about reporting bugs, can
       be found at http://www.kernel.org/doc/man-pages/.

Linux                            2009-03-30                  PTHREAD_EXIT(3)