Skip to main content

Platform Specific Build Instructions

Building with GCC​

When the library is built using GCC it is necessary to link with the pthread library due to how GCC implements std::thread. Failing to link to pthread will lead to runtime exceptions (unless you're using libc++), not linker errors. See issue #67 for more details. You can link to pthread by adding -pthread to your linker command. Note, you can also use -lpthread, but there are potential issues with ordering of command line parameters if you use that.

On QNX, the pthread library is part of libc and usually included automatically (see pthread_create()). There's no separate pthread library to link.

Building with Visual Studio 2015, 2017 or 2022​

The shlwapi library (-lshlwapi) is required to support a call to CPUInfo which reads the registry. Either add shlwapi.lib under [ Configuration Properties > Linker > Input ], or use the following:

// Alternatively, can add libraries using linker options.

// First, Add the path to the generated library files (directory containing the `benchmark.lib`) in `[Configuration Properties > Linker > General > Additional Library Directories]`. Then do the following:
#ifdef _WIN32
#pragma comment ( lib, "Shlwapi.lib" )
#ifdef _DEBUG
#pragma comment ( lib, "benchmark.lib" )
#else
#pragma comment ( lib, "benchmark.lib" )
#endif
#endif

When using the static library, make sure to add BENCHMARK_STATIC_DEFINE under [Configuration Properties > C/C++ > Preprocessor > Preprocessor Definitions]

Can also use the graphical version of CMake:

  • Open CMake GUI.
  • Under Where to build the binaries, same path as source plus build.
  • Under CMAKE_INSTALL_PREFIX, same path as source plus install.
  • Click Configure, Generate, Open Project.
  • If build fails, try deleting entire directory and starting again, or unticking options to build less.

Building with Intel 2015 Update 1 or Intel System Studio Update 4​

See instructions for building with Visual Studio. Once built, right click on the solution and change the build to Intel.

Building on Solaris​

If you're running benchmarks on solaris, you'll want the kstat library linked in too (-lkstat).