Prerequisites¶

Supported platforms¶

At this time, HPX supports the following platforms. Other platforms may work, but we do not test HPX with other platforms, so please be warned.

Table 1 Supported Platforms for *HPX*¶
Name	Minimum Version	Architectures
Linux	2.6	x86-32, x86-64, k1om
BlueGeneQ	V1R2M0	PowerPC A2
Windows	Any Windows system	x86-32, x86-64
Mac OSX	Any OSX system	x86-64

Supported compilers¶

The table below shows the supported compilers for HPX.

Table 2 Supported Compilers for *HPX*¶
Name	Minimum Version
GNU Compiler Collection (g++)	8.0
clang: a C language family frontend for LLVM	8.0
Visual C++ (x64)	2015

Software and libraries¶

The table below presents all the necessary prerequisites for building HPX.

Table 3 Software prerequisites for *HPX*¶
	Name	Minimum Version
Build System	CMake	3.18
Required Libraries	Boost	1.71.0
	Portable Hardware Locality (HWLOC)	1.5
	Asio	1.12.0

The most important dependencies are Boost and Portable Hardware Locality (HWLOC). The installation of Boost is described in detail in Boost’s Getting Started document. A recent version of hwloc is required in order to support thread pinning and NUMA awareness and can be found in Hwloc Downloads.

HPX is written in 99.99% Standard C++ (the remaining 0.01% is platform specific assembly code). As such, HPX is compilable with almost any standards compliant C++ compiler. The code base takes advantage of C++ language and standard library features when available.

Note

When building Boost using gcc, please note that it is required to specify a cxxflags=-std=c++17 command line argument to b2 (bjam).

Note

In most configurations, HPX depends only on header-only Boost. Boost.Filesystem is required if the standard library does not support filesystem. The following are not needed by default, but are required in certain configurations: Boost.Chrono, Boost.DateTime, Boost.Log, Boost.LogSetup, Boost.Regex, and Boost.Thread.

Depending on the options you chose while building and installing HPX, you will find that HPX may depend on several other libraries such as those listed below.

Note

In order to use a high speed parcelport, we currently recommend configuring HPX to use MPI so that MPI can be used for communication between different localities. Please set the CMake variable MPI_CXX_COMPILER to your MPI C++ compiler wrapper if not detected automatically.

Table 4 Optional software prerequisites for *HPX*¶
Name	Minimum version
google-perftools	1.7.1
jemalloc	2.1.0
mi-malloc	1.0.0
Performance Application Programming Interface (PAPI)