CODEWITHSUNDEEP
c++gccpthreadslibstdc++
R.M.
R.M.

Reputation: 3652

Which C++ standard library headers invoke a requirement for the -pthread option with GCC?

If you use C++ threads with the GCC compiler (or perhaps more accurately, with the libstdc++ C++ standard library which ships with GCC) on Linux, you may need to include the -pthread option in your build process to get things to compile and link properly.

What I'm curious about is which library headers invoke that requirement? #include <thread> is an obvious one, but are there other standard library headers which implicitly have a pthread dependency for libstdc++?

Upvotes: 2

Views: 835

Answers (3)

Jonathan Wakely
Jonathan Wakely

Reputation: 171253

<thread> <mutex> <condition_variable> <future> <shared_mutex> <stop_token> all use Pthreads types and functions.

The Networking TS headers such as <experimental/net> and <experimental/executor> use <mutex> and <future> so they also depend on Pthreads.

We'll soon be adding more concurrency headers such as <latch> <barrier> <semaphore>.

Basically anything related to concurrency and synchronization, except <atomic> which notably does not depend on anything from Pthreads.

Upvotes: 2

Maxim Egorushkin
Maxim Egorushkin

Reputation: 136208

On Solaris prior to version 10, errno was a global variable in a single-threaded build, but a macro expanding into a function call in a multi-threaded build. That was a source of problems when people linked multi-threaded apps with single-threaded libraries unwittingly. See Compiling Multithreaded Code for more details.

On Linux, errno is always a macro expanding into a function call that reads a thread-specific errno regardless whether -pthread is specified.

Compiling with -pthread defines macro _REENTRANT, but none of the GNU C and C++ standard library headers use that macro. Boost library does use it.

Upvotes: 1

Florian Weimer
Florian Weimer

Reputation: 33694

It's not so much header files, but specific functionality. Anything that creates threads under the hood will need or greatly benefit from linking with -lpthread, such as std::async from <future>.

Upvotes: 2

Related Questions