|Non-Confidential||PDF version||ARM 100073_0608_00_en|
|Home > The ARM C and C++ Libraries > Multithreaded support in ARM C++ libraries [ALPHA] > ARM C++ libraries and multithreading [ALPHA]|
The C++ Thread Porting Application Programming Interface (API) is an [ALPHA]-supported API that enables the use of C++11 concurrency constructs with ARM® Compiler 6. Operating system or library vendors must provide an implementation of this API to enable the seamless use of C++11 concurrency constructs within user applications.
The C++11 standard offers several high-level concurrency constructs intended to simplify parallel programming and make multithreaded programs portable across platforms. Future versions of the C++ standard are set to introduce additional high-level concurrency constructs. For more information, see https://isocpp.org/std/status.
Most standard library implementations expect an underlying operating system or library platform to provide a comprehensive set of primitive concurrency constructs on top of which these higher level constructs can be built.
The default standard C++ library supplied with ARM Compiler 6 has been built without concurrency support to avoid passing these dependencies to target bare-metal systems.
ARM Compiler 6 includes
a special variant of the standard C++ library that enables support for C++11
concurrency constructs. This library variant requires platform vendors to provide an
implementation of the threading API described in this document. On certain
architectures, for example ARMv6M, this threaded library variant might contain
library calls to various
__atomic_* functions. On
these architectures, platform vendors must also provide an implementation of an
atomics library as discussed in LLVM Atomic Instructions and Concurrency Guide.
To select the threaded standard C++ library variant instead of the default
variant use the compiler options
-D_ARM_LIBCPP_EXTERNAL_THREADS together with linker option
Platform vendors can selectively implement subsets of the porting API based on the dependencies between the high-level C++11 concurrency constructs and the underlying platform concurrency primitives.
ARM Compiler 6 provides C++ libraries that are based on open source LLVM technology. The libraries for multithreaded applications are:
The C++ Thread Porting API enables these libraries to correctly operate in different multithreaded environments.
<arm-tpl.h>header file of the ARM Compiler 6 distribution.
The C++ Thread Porting API functional areas include: