| # |
| # CMake build system design considerations: |
| # |
| # - Include directories: |
| # + Do not define include directories globally using the include_directories |
| # command but rather at the target level using the |
| # target_include_directories command. That way, it is easier to guarantee |
| # that targets are built using the proper list of include directories. |
| # + Use the PUBLIC and PRIVATE keywords to specifiy the scope of include |
| # directories. That way, a target linking to a library (using the |
| # target_link_librairies command) inherits from the library PUBLIC include |
| # directories and not from the PRIVATE ones. |
| # + Note: there is currently one remaining include_directories command in the |
| # CMake files. It is related to ZLIB support which is planned to be removed. |
| # When the support is removed, the associated include_directories command |
| # will be removed as well as this note. |
| # - MBEDTLS_TARGET_PREFIX: CMake targets are designed to be alterable by calling |
| # CMake in order to avoid target name clashes, via the use of |
| # MBEDTLS_TARGET_PREFIX. The value of this variable is prefixed to the |
| # mbedtls, mbedx509, mbedcrypto and apidoc targets. |
| # |
| |
| cmake_minimum_required(VERSION 2.8.12) |
| |
| # https://cmake.org/cmake/help/latest/policy/CMP0011.html |
| # Setting this policy is required in CMake >= 3.18.0, otherwise a warning is generated. The OLD |
| # policy setting is deprecated, and will be removed in future versions. |
| cmake_policy(SET CMP0011 NEW) |
| # https://cmake.org/cmake/help/latest/policy/CMP0012.html |
| # Setting the CMP0012 policy to NEW is required for FindPython3 to work with CMake 3.18.2 |
| # (there is a bug in this particular version), otherwise, setting the CMP0012 policy is required |
| # for CMake versions >= 3.18.3 otherwise a deprecated warning is generated. The OLD policy setting |
| # is deprecated and will be removed in future versions. |
| cmake_policy(SET CMP0012 NEW) |
| |
| if(TEST_CPP) |
| project("mbed TLS" C CXX) |
| else() |
| project("mbed TLS" C) |
| endif() |
| |
| # Set the project root directory. |
| set(MBEDTLS_DIR ${CMAKE_CURRENT_SOURCE_DIR}) |
| |
| option(USE_PKCS11_HELPER_LIBRARY "Build mbed TLS with the pkcs11-helper library." OFF) |
| option(ENABLE_ZLIB_SUPPORT "Build mbed TLS with zlib library." OFF) |
| |
| option(ENABLE_PROGRAMS "Build mbed TLS programs." ON) |
| |
| option(UNSAFE_BUILD "Allow unsafe builds. These builds ARE NOT SECURE." OFF) |
| option(MBEDTLS_FATAL_WARNINGS "Compiler warnings treated as errors" ON) |
| |
| string(REGEX MATCH "Clang" CMAKE_COMPILER_IS_CLANG "${CMAKE_C_COMPILER_ID}") |
| string(REGEX MATCH "GNU" CMAKE_COMPILER_IS_GNU "${CMAKE_C_COMPILER_ID}") |
| string(REGEX MATCH "IAR" CMAKE_COMPILER_IS_IAR "${CMAKE_C_COMPILER_ID}") |
| string(REGEX MATCH "MSVC" CMAKE_COMPILER_IS_MSVC "${CMAKE_C_COMPILER_ID}") |
| |
| # the test suites currently have compile errors with MSVC |
| if(CMAKE_COMPILER_IS_MSVC) |
| option(ENABLE_TESTING "Build mbed TLS tests." OFF) |
| else() |
| option(ENABLE_TESTING "Build mbed TLS tests." ON) |
| endif() |
| |
| # Warning string - created as a list for compatibility with CMake 2.8 |
| set(WARNING_BORDER "*******************************************************\n") |
| set(NULL_ENTROPY_WARN_L1 "**** WARNING! MBEDTLS_TEST_NULL_ENTROPY defined!\n") |
| set(NULL_ENTROPY_WARN_L2 "**** THIS BUILD HAS NO DEFINED ENTROPY SOURCES\n") |
| set(NULL_ENTROPY_WARN_L3 "**** AND IS *NOT* SUITABLE FOR PRODUCTION USE\n") |
| |
| set(NULL_ENTROPY_WARNING "${WARNING_BORDER}" |
| "${NULL_ENTROPY_WARN_L1}" |
| "${NULL_ENTROPY_WARN_L2}" |
| "${NULL_ENTROPY_WARN_L3}" |
| "${WARNING_BORDER}") |
| |
| set(CTR_DRBG_128_BIT_KEY_WARN_L1 "**** WARNING! MBEDTLS_CTR_DRBG_USE_128_BIT_KEY defined!\n") |
| set(CTR_DRBG_128_BIT_KEY_WARN_L2 "**** Using 128-bit keys for CTR_DRBG limits the security of generated\n") |
| set(CTR_DRBG_128_BIT_KEY_WARN_L3 "**** keys and operations that use random values generated to 128-bit security\n") |
| |
| set(CTR_DRBG_128_BIT_KEY_WARNING "${WARNING_BORDER}" |
| "${CTR_DRBG_128_BIT_KEY_WARN_L1}" |
| "${CTR_DRBG_128_BIT_KEY_WARN_L2}" |
| "${CTR_DRBG_128_BIT_KEY_WARN_L3}" |
| "${WARNING_BORDER}") |
| |
| # Python 3 is only needed here to check for configuration warnings. |
| if(NOT CMAKE_VERSION VERSION_LESS 3.15.0) |
| set(Python3_FIND_STRATEGY LOCATION) |
| find_package(Python3 COMPONENTS Interpreter) |
| if(Python3_Interpreter_FOUND) |
| set(MBEDTLS_PYTHON_EXECUTABLE ${Python3_EXECUTABLE}) |
| endif() |
| else() |
| find_package(PythonInterp 3) |
| if(PYTHONINTERP_FOUND) |
| set(MBEDTLS_PYTHON_EXECUTABLE ${PYTHON_EXECUTABLE}) |
| endif() |
| endif() |
| if(MBEDTLS_PYTHON_EXECUTABLE) |
| |
| # If 128-bit keys are configured for CTR_DRBG, display an appropriate warning |
| execute_process(COMMAND ${MBEDTLS_PYTHON_EXECUTABLE} ${CMAKE_CURRENT_SOURCE_DIR}/scripts/config.py -f ${CMAKE_CURRENT_SOURCE_DIR}/include/mbedtls/config.h get MBEDTLS_CTR_DRBG_USE_128_BIT_KEY |
| RESULT_VARIABLE result) |
| if(${result} EQUAL 0) |
| message(WARNING ${CTR_DRBG_128_BIT_KEY_WARNING}) |
| endif() |
| |
| # If NULL Entropy is configured, display an appropriate warning |
| execute_process(COMMAND ${MBEDTLS_PYTHON_EXECUTABLE} ${CMAKE_CURRENT_SOURCE_DIR}/scripts/config.py -f ${CMAKE_CURRENT_SOURCE_DIR}/include/mbedtls/config.h get MBEDTLS_TEST_NULL_ENTROPY |
| RESULT_VARIABLE result) |
| if(${result} EQUAL 0) |
| message(WARNING ${NULL_ENTROPY_WARNING}) |
| |
| if(NOT UNSAFE_BUILD) |
| message(FATAL_ERROR "\ |
| \n\ |
| Warning! You have enabled MBEDTLS_TEST_NULL_ENTROPY. \ |
| This option is not safe for production use and negates all security \ |
| It is intended for development use only. \ |
| \n\ |
| To confirm you want to build with this option, re-run cmake with the \ |
| option: \n\ |
| cmake -DUNSAFE_BUILD=ON ") |
| |
| return() |
| endif() |
| endif() |
| endif() |
| |
| # If this is the root project add longer list of available CMAKE_BUILD_TYPE values |
| if(CMAKE_SOURCE_DIR STREQUAL CMAKE_CURRENT_SOURCE_DIR) |
| set(CMAKE_BUILD_TYPE ${CMAKE_BUILD_TYPE} |
| CACHE STRING "Choose the type of build: None Debug Release Coverage ASan ASanDbg MemSan MemSanDbg Check CheckFull" |
| FORCE) |
| endif() |
| |
| # Create a symbolic link from ${base_name} in the binary directory |
| # to the corresponding path in the source directory. |
| function(link_to_source base_name) |
| # Get OS dependent path to use in `execute_process` |
| if (CMAKE_HOST_WIN32) |
| #mklink is an internal command of cmd.exe it can only work with \ |
| string(REPLACE "/" "\\" link "${CMAKE_CURRENT_BINARY_DIR}/${base_name}") |
| string(REPLACE "/" "\\" target "${CMAKE_CURRENT_SOURCE_DIR}/${base_name}") |
| else() |
| set(link "${CMAKE_CURRENT_BINARY_DIR}/${base_name}") |
| set(target "${CMAKE_CURRENT_SOURCE_DIR}/${base_name}") |
| endif() |
| |
| if (NOT EXISTS ${link}) |
| if (CMAKE_HOST_UNIX) |
| set(command ln -s ${target} ${link}) |
| else() |
| if (IS_DIRECTORY ${target}) |
| set(command cmd.exe /c mklink /j ${link} ${target}) |
| else() |
| set(command cmd.exe /c mklink /h ${link} ${target}) |
| endif() |
| endif() |
| |
| execute_process(COMMAND ${command} |
| RESULT_VARIABLE result |
| ERROR_VARIABLE output) |
| |
| if (NOT ${result} EQUAL 0) |
| message(FATAL_ERROR "Could not create symbolic link for: ${target} --> ${output}") |
| endif() |
| endif() |
| endfunction(link_to_source) |
| |
| string(REGEX MATCH "Clang" CMAKE_COMPILER_IS_CLANG "${CMAKE_C_COMPILER_ID}") |
| |
| include(CheckCCompilerFlag) |
| |
| if(CMAKE_COMPILER_IS_GNU) |
| # some warnings we want are not available with old GCC versions |
| # note: starting with CMake 2.8 we could use CMAKE_C_COMPILER_VERSION |
| execute_process(COMMAND ${CMAKE_C_COMPILER} -dumpversion |
| OUTPUT_VARIABLE GCC_VERSION) |
| set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wall -Wextra -Wwrite-strings") |
| if (GCC_VERSION VERSION_GREATER 3.0 OR GCC_VERSION VERSION_EQUAL 3.0) |
| set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wformat=2 -Wno-format-nonliteral") |
| endif() |
| if (GCC_VERSION VERSION_GREATER 4.3 OR GCC_VERSION VERSION_EQUAL 4.3) |
| set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wvla") |
| endif() |
| if (GCC_VERSION VERSION_GREATER 4.5 OR GCC_VERSION VERSION_EQUAL 4.5) |
| set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wlogical-op") |
| endif() |
| if (GCC_VERSION VERSION_GREATER 4.8 OR GCC_VERSION VERSION_EQUAL 4.8) |
| set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wshadow") |
| endif() |
| if (GCC_VERSION VERSION_GREATER 5.0) |
| CHECK_C_COMPILER_FLAG("-Wformat-signedness" C_COMPILER_SUPPORTS_WFORMAT_SIGNEDNESS) |
| if(C_COMPILER_SUPPORTS_WFORMAT_SIGNEDNESS) |
| set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wformat-signedness") |
| endif() |
| endif() |
| if (GCC_VERSION VERSION_GREATER 7.0 OR GCC_VERSION VERSION_EQUAL 7.0) |
| set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wformat-overflow=2 -Wformat-truncation") |
| endif() |
| set(CMAKE_C_FLAGS_RELEASE "-O2") |
| set(CMAKE_C_FLAGS_DEBUG "-O0 -g3") |
| set(CMAKE_C_FLAGS_COVERAGE "-O0 -g3 --coverage") |
| set(CMAKE_C_FLAGS_ASAN "-fsanitize=address -fno-common -fsanitize=undefined -fno-sanitize-recover=all -O3") |
| set(CMAKE_C_FLAGS_ASANDBG "-fsanitize=address -fno-common -fsanitize=undefined -fno-sanitize-recover=all -O1 -g3 -fno-omit-frame-pointer -fno-optimize-sibling-calls") |
| set(CMAKE_C_FLAGS_CHECK "-Os") |
| set(CMAKE_C_FLAGS_CHECKFULL "${CMAKE_C_FLAGS_CHECK} -Wcast-qual") |
| endif(CMAKE_COMPILER_IS_GNU) |
| |
| if(CMAKE_COMPILER_IS_CLANG) |
| set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wall -Wextra -Wwrite-strings -Wpointer-arith -Wimplicit-fallthrough -Wshadow -Wvla -Wformat=2 -Wno-format-nonliteral") |
| set(CMAKE_C_FLAGS_RELEASE "-O2") |
| set(CMAKE_C_FLAGS_DEBUG "-O0 -g3") |
| set(CMAKE_C_FLAGS_COVERAGE "-O0 -g3 --coverage") |
| set(CMAKE_C_FLAGS_ASAN "-fsanitize=address -fno-common -fsanitize=undefined -fno-sanitize-recover=all -O3") |
| set(CMAKE_C_FLAGS_ASANDBG "-fsanitize=address -fno-common -fsanitize=undefined -fno-sanitize-recover=all -O1 -g3 -fno-omit-frame-pointer -fno-optimize-sibling-calls") |
| set(CMAKE_C_FLAGS_MEMSAN "-fsanitize=memory -O3") |
| set(CMAKE_C_FLAGS_MEMSANDBG "-fsanitize=memory -O1 -g3 -fno-omit-frame-pointer -fno-optimize-sibling-calls -fsanitize-memory-track-origins=2") |
| set(CMAKE_C_FLAGS_CHECK "-Os") |
| endif(CMAKE_COMPILER_IS_CLANG) |
| |
| if(CMAKE_COMPILER_IS_IAR) |
| set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} --warn_about_c_style_casts --warnings_are_errors -Ohz") |
| endif(CMAKE_COMPILER_IS_IAR) |
| |
| if(CMAKE_COMPILER_IS_MSVC) |
| # Strictest warnings |
| set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} /W3") |
| endif(CMAKE_COMPILER_IS_MSVC) |
| |
| if(MBEDTLS_FATAL_WARNINGS) |
| if(CMAKE_COMPILER_IS_MSVC) |
| set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} /WX") |
| endif(CMAKE_COMPILER_IS_MSVC) |
| |
| if(CMAKE_COMPILER_IS_CLANG OR CMAKE_COMPILER_IS_GNU) |
| set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Werror") |
| if(UNSAFE_BUILD) |
| set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wno-error=cpp") |
| set(CMAKE_C_FLAGS_ASAN "${CMAKE_C_FLAGS_ASAN} -Wno-error=cpp") |
| set(CMAKE_C_FLAGS_ASANDBG "${CMAKE_C_FLAGS_ASANDBG} -Wno-error=cpp") |
| endif(UNSAFE_BUILD) |
| endif(CMAKE_COMPILER_IS_CLANG OR CMAKE_COMPILER_IS_GNU) |
| endif(MBEDTLS_FATAL_WARNINGS) |
| |
| if(CMAKE_BUILD_TYPE STREQUAL "Coverage") |
| if(CMAKE_COMPILER_IS_GNU OR CMAKE_COMPILER_IS_CLANG) |
| set(CMAKE_SHARED_LINKER_FLAGS "--coverage") |
| endif(CMAKE_COMPILER_IS_GNU OR CMAKE_COMPILER_IS_CLANG) |
| endif(CMAKE_BUILD_TYPE STREQUAL "Coverage") |
| |
| if(LIB_INSTALL_DIR) |
| else() |
| set(LIB_INSTALL_DIR lib) |
| endif() |
| |
| if(ENABLE_ZLIB_SUPPORT) |
| find_package(ZLIB) |
| |
| if(ZLIB_FOUND) |
| include_directories(${ZLIB_INCLUDE_DIR}) |
| endif(ZLIB_FOUND) |
| endif(ENABLE_ZLIB_SUPPORT) |
| |
| add_subdirectory(include) |
| |
| add_subdirectory(3rdparty) |
| list(APPEND libs ${thirdparty_lib}) |
| |
| add_subdirectory(library) |
| |
| # |
| # The C files in tests/src directory contain test code shared among test suites |
| # and programs. This shared test code is compiled and linked to test suites and |
| # programs objects as a set of compiled objects. The compiled objects are NOT |
| # built into a library that the test suite and program objects would link |
| # against as they link against the mbedcrypto, mbedx509 and mbedtls libraries. |
| # The reason is that such library is expected to have mutual dependencies with |
| # the aforementioned libraries and that there is as of today no portable way of |
| # handling such dependencies (only toolchain specific solutions). |
| # |
| # Thus the below definition of the `mbedtls_test` CMake library of objects |
| # target. This library of objects is used by tests and programs CMake files |
| # to define the test executables. |
| # |
| if(ENABLE_TESTING OR ENABLE_PROGRAMS) |
| file(GLOB MBEDTLS_TEST_FILES ${CMAKE_CURRENT_SOURCE_DIR}/tests/src/*.c ${CMAKE_CURRENT_SOURCE_DIR}/tests/src/drivers/*.c) |
| add_library(mbedtls_test OBJECT ${MBEDTLS_TEST_FILES}) |
| target_include_directories(mbedtls_test |
| PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/tests/include |
| PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/include |
| PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/library) |
| endif() |
| |
| if(ENABLE_PROGRAMS) |
| add_subdirectory(programs) |
| endif() |
| |
| ADD_CUSTOM_TARGET(${MBEDTLS_TARGET_PREFIX}apidoc |
| COMMAND doxygen mbedtls.doxyfile |
| WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/doxygen) |
| |
| if(ENABLE_TESTING) |
| enable_testing() |
| |
| add_subdirectory(tests) |
| |
| # additional convenience targets for Unix only |
| if(UNIX) |
| |
| ADD_CUSTOM_TARGET(covtest |
| COMMAND make test |
| COMMAND programs/test/selftest |
| COMMAND tests/compat.sh |
| COMMAND tests/ssl-opt.sh |
| ) |
| |
| ADD_CUSTOM_TARGET(lcov |
| COMMAND rm -rf Coverage |
| COMMAND lcov --capture --initial --directory library/CMakeFiles/mbedtls.dir -o files.info |
| COMMAND lcov --capture --directory library/CMakeFiles/mbedtls.dir -o tests.info |
| COMMAND lcov --add-tracefile files.info --add-tracefile tests.info -o all.info |
| COMMAND lcov --remove all.info -o final.info '*.h' |
| COMMAND gendesc tests/Descriptions.txt -o descriptions |
| COMMAND genhtml --title "mbed TLS" --description-file descriptions --keep-descriptions --legend --no-branch-coverage -o Coverage final.info |
| COMMAND rm -f files.info tests.info all.info final.info descriptions |
| ) |
| |
| ADD_CUSTOM_TARGET(memcheck |
| COMMAND sed -i.bak s+/usr/bin/valgrind+`which valgrind`+ DartConfiguration.tcl |
| COMMAND ctest -O memcheck.log -D ExperimentalMemCheck |
| COMMAND tail -n1 memcheck.log | grep 'Memory checking results:' > /dev/null |
| COMMAND rm -f memcheck.log |
| COMMAND mv DartConfiguration.tcl.bak DartConfiguration.tcl |
| ) |
| endif(UNIX) |
| |
| # Make scripts needed for testing available in an out-of-source build. |
| if (NOT ${CMAKE_CURRENT_BINARY_DIR} STREQUAL ${CMAKE_CURRENT_SOURCE_DIR}) |
| link_to_source(scripts) |
| # Copy (don't link) DartConfiguration.tcl, needed for memcheck, to |
| # keep things simple with the sed commands in the memcheck target. |
| configure_file(${CMAKE_CURRENT_SOURCE_DIR}/DartConfiguration.tcl |
| ${CMAKE_CURRENT_BINARY_DIR}/DartConfiguration.tcl COPYONLY) |
| endif() |
| endif() |