Build with CMake
Table of contents
Introduction
CMake is an open-source and cross-platform building tool for software packages that provides easy managing of multiple build systems at a time. It works by allowing the developer to specify build parameters and rules in a simple text file that CMake then processes to generate project files for the actual native build tools (e.g. UNIX Makefiles, Microsoft Visual Studio, Apple XCode, etc). That means you can easily maintain multiple separate builds for one project and manage cross-platform hardware and software complexity.
If you are not already familiar with CMake, please refer to the official documentation or the CMake Wiki introduction (recommended).
Before using CMake you will need to install/build the binaries on your system. Most systems have CMake already installed or provided by the standard package manager. If that is not the case for you, please download and install now.
For building SLEEF, CMake 3.18 is the minimum required.
Quick start
- Make sure CMake is available. The following command line should display a version number greater than or equal to 3.18.
cmake --version
- Download the tar from sourceforge, GitHub releases, or checkout out the source code from the GitHub repository.
git clone https://github.com/shibatch/sleef
- Make separate directories to create out-of-source build and install. SLEEF does not allow for in-tree builds.
cd sleef
mkdir build
mkdir install
- Run CMake to configure your project and generate the system to build it.
cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo \
-DCMAKE_INSTALL_PREFIX=install/ \
-S . -B build/
By default, CMake will detect your system platform and configure the build using the default parameters. You can control and modify these parameters by setting variables when running CMake. See the list of options and variables for customizing your build.
In the above example:
-DCMAKE_BUILD_TYPE=RelWithDebInfo
configures an optimisedlibsleef
shared library build with basic debug info.-DCMAKE_INSTALL_PREFIX=install/
sets SLEEF to be installed ininstall/
.
- Run make to build the project
cmake --build build -j --clean-first
NOTE: On Windows, you need to use a specific generator like this:
cmake -G"Visual Studio 14 2015 Win64" ..
specifying the Visual Studio version and targeting specificallyWin64
(to support compilation of AVX/AVX2) Checkcmake -G
to get a full list of supported Visual Studio project generators. This generator will create a proper solutionSLEEF.sln
under the build directory. You can still usecmake --build build
to build without opening Visual Studio.
- Run ctest suite (CMake 3.20+)
ctest --test-dir build -j
or for older CMake versions
cd build/ && ctest -j
- Install at path provided earlier or at new path
<prefix>
cmake --install build/ [--prefix <prefix>]
Refer to our web page for detailed build instructions.
Build customization
Variables dictate how the build is generated; options are defined and undefined, respectively, on the CMake command line like this:
cmake -DVARIABLE=<value> <cmake-build-dir>
cmake -UVARIABLE <cmake-build-dir>
Build configurations allow a project to be built in different ways for debug, optimized, or any other special set of flags.
CMake Variables
CMAKE_BUILD_TYPE
: By default, CMake supports the following configuration:Debug
: basic debug flags turned onRelease
: basic optimizations turned onMinSizeRel
: builds the smallest (but not fastest) object codeRelWithDebInfo
: builds optimized code with debug information as well
-
CMAKE_INSTALL_PREFIX
: The prefix the use when runningmake install
. Defaults to /usr/local on GNU/Linux and macOS. Defaults to C:/Program Files on Windows. CMAKE_C_FLAGS_RELEASE
: The optimization options used by the compiler.
SLEEF Variables
Library
SLEEF_SHOW_CONFIG
: Show relevant CMake variables upon configuring a build-
SLEEF_SHOW_ERROR_LOG
: Show the content of CMakeError.log BUILD_SHARED_LIBS
: Static libs are built if set to FALSESLEEF_BUILD_SHARED_LIBS
: If set, override the value ofBUILD_SHARED_LIBS
when configuring SLEEF.SLEEF_BUILD_GNUABI_LIBS
: Avoid building libraries with GNU ABI if set to FALSE-
SLEEF_BUILD_INLINE_HEADERS
: Generate header files for inlining whole SLEEF functions SLEEF_DISABLE_OPENMP
: Disable support for OpenMP-
SLEEF_ENFORCE_OPENMP
: Build fails if OpenMP is not supported by the compiler SLEEF_ENABLE_LTO
: Enable support for LTO with gcc, or thinLTO with llvmSLEEF_LLVM_AR_COMMAND
: Specify LLVM AR command when you build the library with thinLTO support with clang.SLEEF_ENABLE_LLVM_BITCODE
: Generate LLVM bitcode
Tests
SLEEF_BUILD_TESTS
: Avoid building testing tools if set to FALSESLEEF_ENFORCE_TESTER3
: Build fails if tester3 cannot be built
Quad and DFT
SLEEF_BUILD_QUAD
: Build quad-precision libraries if set to TRUESLEEF_BUILD_DFT
: Build DFT libraries if set to TRUESLEEFDFT_MAXBUTWIDTH
: This variable specifies the maximum length of combined butterfly block used in the DFT. Setting this value to 7 makes DFT faster but compilation takes more time and the library size will be larger.SLEEF_DISABLE_FFTW
: Disable FFTW-based testing of the DFT library.
Vector extensions and instructions
SLEEF_ENABLE_ALTDIV
: Enable alternative division method (aarch64 only)SLEEF_ENABLE_ALTSQRT
: Enable alternative sqrt method (aarch64 only)SLEEF_DISABLE_LONG_DOUBLE
: Disable support for long double data typeSLEEF_ENFORCE_LONG_DOUBLE
: Build fails if long double data type is not supported by the compilerSLEEF_DISABLE_FLOAT128
: Disable support for float128 data typeSLEEF_ENFORCE_FLOAT128
: Build fails if float128 data type is not supported by the compilerSLEEF_DISABLE_SSE2
: Disable support for x86 SSE2SLEEF_ENFORCE_SSE2
: Build fails if SSE2 is not supported by the compilerSLEEF_DISABLE_SSE4
: Disable support for x86 SSE4SLEEF_ENFORCE_SSE4
: Build fails if SSE4 is not supported by the compilerSLEEF_DISABLE_AVX
: Disable support for x86 AVXSLEEF_ENFORCE_AVX
: Build fails if AVX is not supported by the compilerSLEEF_DISABLE_FMA4
: Disable support for x86 FMA4SLEEF_ENFORCE_FMA4
: Build fails if FMA4 is not supported by the compilerSLEEF_DISABLE_AVX2
: Disable support for x86 AVX2SLEEF_ENFORCE_AVX2
: Build fails if AVX2 is not supported by the compilerSLEEF_DISABLE_AVX512F
: Disable support for x86 AVX512FSLEEF_ENFORCE_AVX512F
: Build fails if AVX512F is not supported by the compilerSLEEF_DISABLE_SVE
: Disable support for AArch64 SVESLEEF_ENFORCE_SVE
: Build fails if SVE is not supported by the compilerSLEEF_DISABLE_VSX
: Disable support for PowerPC VSXSLEEF_ENFORCE_VSX
: Build fails if VSX is not supported by the compilerSLEEF_DISABLE_VSX3
: Disable support for PowerPC VSX-3SLEEF_ENFORCE_VSX3
: Build fails if VSX-3 is not supported by the compilerSLEEF_DISABLE_VXE
: Disable support for System/390 VXESLEEF_ENFORCE_VXE
: Build fails if System/390 VXE is not supported by the compilerSLEEF_DISABLE_VXE2
: Disable support for System/390 VXE2SLEEF_ENFORCE_VXE2
: Build fails if System/390 VXE2 is not supported by the compiler