Opened 7 years ago

Closed 6 years ago

#5013 closed Bugs (fixed)

documentation: boost::thread: pthreas_exit causes terminate()

Reported by: Slava <Viatcheslav.Sysoltsev@…> Owned by: viboes
Milestone: Boost 1.50.0 Component: thread
Version: Boost 1.36.0 Severity: Problem
Keywords: doc native threads Cc: viboes


boost::thread before svn revision 49969 causes the terminate() to be called if the child thread exits with pthread_exit() on linux.

See the proof test case (environment: Boost 1.36, gcc 4.3.2, openSUSE 11.1, x86_64 architecture.):

#include <boost/thread.hpp>

void tf()

int main()
    boost::thread t(tf);
    return  0;

> g++ -g -O0 test2.cpp -lboost_thread && gdb a.outGNU gdb (GDB) 7.2
Copyright (C) 2010 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.  Type "show copying"
and "show warranty" for details.
This GDB was configured as "x86_64-unknown-linux-gnu".
For bug reporting instructions, please see:
Reading symbols from /home/vsysolts/test/boost_thread/a.out...done.
(gdb) r
Starting program: /home/vsysolts/test/boost_thread/a.out 
[Thread debugging using libthread_db enabled]
[New Thread 0x7ffff6cd5950 (LWP 14284)]

Program received signal SIGSEGV, Segmentation fault.
[Switching to Thread 0x7ffff6cd5950 (LWP 14284)]
0x00007ffff798a565 in __gnu_cxx::__verbose_terminate_handler() () from /usr/lib64/
(gdb) bt
#0  0x00007ffff798a565 in __gnu_cxx::__verbose_terminate_handler() () from /usr/lib64/
#1  0x00007ffff7988a46 in ?? () from /usr/lib64/
#2  0x00007ffff7988a73 in std::terminate() () from /usr/lib64/
#3  0x00007ffff7bd898a in thread_proxy () from /usr/lib64/
#4  0x00007ffff6cdd070 in start_thread () from /lib64/
#5  0x00007ffff71ce11d in clone () from /lib64/
#6  0x0000000000000000 in ?? ()

pthread_exit implementation uses the special forced_unwind exception to unwind the stack, which is (wrongly) caught in boost:thread code and used as a reason to call terminate(). The misbehaviour is commented out since svn rev 49969. Due to the fact the pthread_exit is quite legal possibility to end the single thread, the fact of incompatibility with former boost:thread implementation should be mentionen in the documentation of the boost releases up to veriosn 1.37 (presumably). I would add the mention about pthread_exit in the files doc/html/thread/thread_management.html, chapter "Exceptions in thread functions".

Attachments (0)

Change History (4)

comment:1 Changed 7 years ago by Steven Watanabe

Component: Documentationthread
Owner: changed from Matias Capeletto to Anthony Williams

comment:2 Changed 6 years ago by viboes

Keywords: doc native threads added

comment:3 Changed 6 years ago by viboes

Cc: viboes added
Milestone: To Be DeterminedBoost 1.49.0
Owner: changed from Anthony Williams to viboes
Status: newassigned

For the time been I propose to add this section

pthread_exit POSIX limitation

pthread_exit in glibc/NPTL causes a "forced unwind" that is almost like a C++ exception, but not quite. On Mac OS X, for example, pthread_exit unwinds without calling C++ destructors.

This behavior is incompatible with the current Boost.Thread design, so the use of this function in a POSIX thread result in undefined behavior of any Boost.Thread function.

Committed in trunk at #75904.

comment:4 Changed 6 years ago by viboes

Milestone: Boost 1.49.0Boost 1.50.0
Resolution: fixed
Status: assignedclosed

Committed in release branch at [78543]

Modify Ticket

Change Properties
Set your email in Preferences
as closed The owner will remain viboes.
The resolution will be deleted.

Add Comment

E-mail address and name can be saved in the Preferences.

Note: See TracTickets for help on using tickets.