blob: aef67471f3d6ff6729abde39728e0c2c5976d9c7 [file] [log] [blame]
Ronald Cronb1790af2020-05-20 15:34:47 +02001#
2# CMake build system design considerations:
3#
4# - Include directories:
5# + Do not define include directories globally using the include_directories
6# command but rather at the target level using the
7# target_include_directories command. That way, it is easier to guarantee
8# that targets are built using the proper list of include directories.
Shaun Case8b0ecbc2021-12-20 21:14:10 -08009# + Use the PUBLIC and PRIVATE keywords to specify the scope of include
Ronald Cronb1790af2020-05-20 15:34:47 +020010# directories. That way, a target linking to a library (using the
bootstrap-prime6dbbf442022-05-17 19:30:44 -040011# target_link_libraries command) inherits from the library PUBLIC include
Ronald Cronb1790af2020-05-20 15:34:47 +020012# directories and not from the PRIVATE ones.
Raef Coles995c66f2020-10-13 16:30:41 +010013# - MBEDTLS_TARGET_PREFIX: CMake targets are designed to be alterable by calling
14# CMake in order to avoid target name clashes, via the use of
15# MBEDTLS_TARGET_PREFIX. The value of this variable is prefixed to the
16# mbedtls, mbedx509, mbedcrypto and apidoc targets.
Ronald Cronb1790af2020-05-20 15:34:47 +020017#
18
Dave Rodgmanbe4af042021-06-04 17:04:20 +010019# We specify a minimum requirement of 3.10.2, but for now use 3.5.1 here
20# until our infrastructure catches up.
21cmake_minimum_required(VERSION 3.5.1)
Paul Elliottb250ac92020-09-18 18:15:07 +010022
Chris Kayd259e342021-03-25 16:03:25 +000023include(CMakePackageConfigHelpers)
24
Ronald Cron7af1bea2024-07-11 08:47:53 +020025# Include convenience functions for printing properties and variables, like
26# cmake_print_properties(), cmake_print_variables().
27include(CMakePrintHelpers)
28
Paul Elliottb250ac92020-09-18 18:15:07 +010029# https://cmake.org/cmake/help/latest/policy/CMP0011.html
30# Setting this policy is required in CMake >= 3.18.0, otherwise a warning is generated. The OLD
31# policy setting is deprecated, and will be removed in future versions.
32cmake_policy(SET CMP0011 NEW)
33# https://cmake.org/cmake/help/latest/policy/CMP0012.html
34# Setting the CMP0012 policy to NEW is required for FindPython3 to work with CMake 3.18.2
35# (there is a bug in this particular version), otherwise, setting the CMP0012 policy is required
36# for CMake versions >= 3.18.3 otherwise a deprecated warning is generated. The OLD policy setting
37# is deprecated and will be removed in future versions.
38cmake_policy(SET CMP0012 NEW)
39
Andrzej Kurek0211c322018-03-15 05:16:24 -040040if(TEST_CPP)
Bill Robertsaab7f7f2024-02-20 08:16:57 -060041 project("Mbed TLS"
42 LANGUAGES C CXX
David Horstmann7ba04a22024-09-03 17:36:30 +010043 VERSION 4.0.0
Bill Robertsaab7f7f2024-02-20 08:16:57 -060044 )
Andrzej Kurek0211c322018-03-15 05:16:24 -040045else()
Bill Robertsaab7f7f2024-02-20 08:16:57 -060046 project("Mbed TLS"
47 LANGUAGES C
David Horstmann7ba04a22024-09-03 17:36:30 +010048 VERSION 4.0.0
Bill Robertsaab7f7f2024-02-20 08:16:57 -060049 )
Andrzej Kurek0211c322018-03-15 05:16:24 -040050endif()
Paul Bakker367dae42009-06-28 21:50:27 +000051
Biswapriyo Nath0f2e87b2022-04-22 20:56:21 +053052include(GNUInstallDirs)
53
Gilles Peskinee820c0a2023-08-03 17:45:20 +020054# Determine if Mbed TLS is being built as a subproject using add_subdirectory()
Antonio de Angelis2869c672021-12-07 20:45:55 +000055if(NOT DEFINED MBEDTLS_AS_SUBPROJECT)
56 set(MBEDTLS_AS_SUBPROJECT ON)
57 if(CMAKE_CURRENT_SOURCE_DIR STREQUAL CMAKE_SOURCE_DIR)
58 set(MBEDTLS_AS_SUBPROJECT OFF)
59 endif()
60endif()
61
Ronald Cronb6254f52024-07-25 14:52:19 +020062# Set the project and framework root directory.
Ashley Duncand85a7e92019-04-29 20:35:06 +120063set(MBEDTLS_DIR ${CMAKE_CURRENT_SOURCE_DIR})
Ronald Cronb6254f52024-07-25 14:52:19 +020064set(MBEDTLS_FRAMEWORK_DIR ${CMAKE_CURRENT_SOURCE_DIR}/framework)
Ashley Duncand85a7e92019-04-29 20:35:06 +120065
Gilles Peskinee820c0a2023-08-03 17:45:20 +020066option(ENABLE_PROGRAMS "Build Mbed TLS programs." ON)
Manuel Pégourié-Gonnard58719102015-07-09 09:19:47 +010067
Carlos Gomes Martinhoa5f0bd32020-04-03 09:42:37 +020068option(MBEDTLS_FATAL_WARNINGS "Compiler warnings treated as errors" ON)
Anton Komlevca947a42022-04-14 15:22:11 +010069if(CMAKE_HOST_WIN32)
Gilles Peskineecc99612023-09-09 22:54:26 +020070 # N.B. The comment on the next line is significant! If you change it,
71 # edit the sed command in prepare_release.sh that modifies
72 # CMakeLists.txt.
Gilles Peskineeeed74e2023-09-09 21:00:30 +020073 option(GEN_FILES "Generate the auto-generated files as needed" OFF) # off in development
David Horstmann77496512021-10-21 19:45:52 +010074else()
Minos Galanakis98600562024-03-27 13:51:15 +000075 option(GEN_FILES "Generate the auto-generated files as needed" ON)
David Horstmann77496512021-10-21 19:45:52 +010076endif()
Manuel Pégourié-Gonnard58719102015-07-09 09:19:47 +010077
Antonio de Angelis2869c672021-12-07 20:45:55 +000078option(DISABLE_PACKAGE_CONFIG_AND_INSTALL "Disable package configuration, target export and installation" ${MBEDTLS_AS_SUBPROJECT})
79
Daan Timmer3766a322023-10-18 16:15:58 +020080if (CMAKE_C_SIMULATE_ID)
81 set(COMPILER_ID ${CMAKE_C_SIMULATE_ID})
82else()
83 set(COMPILER_ID ${CMAKE_C_COMPILER_ID})
84endif(CMAKE_C_SIMULATE_ID)
85
86string(REGEX MATCH "Clang" CMAKE_COMPILER_IS_CLANG "${COMPILER_ID}")
87string(REGEX MATCH "GNU" CMAKE_COMPILER_IS_GNU "${COMPILER_ID}")
88string(REGEX MATCH "IAR" CMAKE_COMPILER_IS_IAR "${COMPILER_ID}")
89string(REGEX MATCH "MSVC" CMAKE_COMPILER_IS_MSVC "${COMPILER_ID}")
Azim Khan45b79cf2018-05-23 16:55:16 +010090
Manuel Pégourié-Gonnard58719102015-07-09 09:19:47 +010091# the test suites currently have compile errors with MSVC
Azim Khan45b79cf2018-05-23 16:55:16 +010092if(CMAKE_COMPILER_IS_MSVC)
Gilles Peskinee820c0a2023-08-03 17:45:20 +020093 option(ENABLE_TESTING "Build Mbed TLS tests." OFF)
Manuel Pégourié-Gonnard58719102015-07-09 09:19:47 +010094else()
Gilles Peskinee820c0a2023-08-03 17:45:20 +020095 option(ENABLE_TESTING "Build Mbed TLS tests." ON)
Manuel Pégourié-Gonnard58719102015-07-09 09:19:47 +010096endif()
Manuel Pégourié-Gonnard0b4e2ac2015-07-08 22:10:38 +010097
Ronald Cronf8a3f282024-07-24 08:42:32 +020098option(USE_STATIC_MBEDTLS_LIBRARY "Build Mbed TLS static library." ON)
99option(USE_SHARED_MBEDTLS_LIBRARY "Build Mbed TLS shared library." OFF)
100option(LINK_WITH_PTHREAD "Explicitly link Mbed TLS library to pthread." OFF)
101option(LINK_WITH_TRUSTED_STORAGE "Explicitly link Mbed TLS library to trusted_storage." OFF)
102
103set(mbedcrypto_target "${MBEDTLS_TARGET_PREFIX}mbedcrypto")
104if (USE_STATIC_MBEDTLS_LIBRARY)
105 set(mbedcrypto_static_target ${mbedcrypto_target})
106endif()
107if(USE_STATIC_MBEDTLS_LIBRARY AND USE_SHARED_MBEDTLS_LIBRARY)
108 string(APPEND mbedcrypto_static_target "_static")
109endif()
110
Simon Butcher45103f32016-06-21 14:47:11 +0100111# Warning string - created as a list for compatibility with CMake 2.8
Nir Sonnenscheinb7ebbca2018-08-29 10:20:12 +0300112set(CTR_DRBG_128_BIT_KEY_WARN_L1 "**** WARNING! MBEDTLS_CTR_DRBG_USE_128_BIT_KEY defined!\n")
113set(CTR_DRBG_128_BIT_KEY_WARN_L2 "**** Using 128-bit keys for CTR_DRBG limits the security of generated\n")
114set(CTR_DRBG_128_BIT_KEY_WARN_L3 "**** keys and operations that use random values generated to 128-bit security\n")
115
116set(CTR_DRBG_128_BIT_KEY_WARNING "${WARNING_BORDER}"
117 "${CTR_DRBG_128_BIT_KEY_WARN_L1}"
118 "${CTR_DRBG_128_BIT_KEY_WARN_L2}"
119 "${CTR_DRBG_128_BIT_KEY_WARN_L3}"
120 "${WARNING_BORDER}")
121
Gilles Peskine97409292019-09-04 22:10:34 +0200122# Python 3 is only needed here to check for configuration warnings.
okhowang(王沛文)3c1b0902020-03-25 19:55:32 +0800123if(NOT CMAKE_VERSION VERSION_LESS 3.15.0)
124 set(Python3_FIND_STRATEGY LOCATION)
125 find_package(Python3 COMPONENTS Interpreter)
126 if(Python3_Interpreter_FOUND)
127 set(MBEDTLS_PYTHON_EXECUTABLE ${Python3_EXECUTABLE})
128 endif()
129else()
130 find_package(PythonInterp 3)
131 if(PYTHONINTERP_FOUND)
132 set(MBEDTLS_PYTHON_EXECUTABLE ${PYTHON_EXECUTABLE})
133 endif()
134endif()
135if(MBEDTLS_PYTHON_EXECUTABLE)
Simon Butcher1ceab6e2016-06-21 10:14:00 +0100136
Nir Sonnenscheinb7ebbca2018-08-29 10:20:12 +0300137 # If 128-bit keys are configured for CTR_DRBG, display an appropriate warning
Bence Szépkútibb0cfeb2021-05-28 09:42:25 +0200138 execute_process(COMMAND ${MBEDTLS_PYTHON_EXECUTABLE} ${CMAKE_CURRENT_SOURCE_DIR}/scripts/config.py -f ${CMAKE_CURRENT_SOURCE_DIR}/include/mbedtls/mbedtls_config.h get MBEDTLS_CTR_DRBG_USE_128_BIT_KEY
Nir Sonnenscheinb7ebbca2018-08-29 10:20:12 +0300139 RESULT_VARIABLE result)
140 if(${result} EQUAL 0)
141 message(WARNING ${CTR_DRBG_128_BIT_KEY_WARNING})
142 endif()
143
Simon Butcher1ceab6e2016-06-21 10:14:00 +0100144endif()
145
Paul Elliott7fd162e2024-01-24 18:05:53 +0000146# We now potentially need to link all executables against PThreads, if available
147set(CMAKE_THREAD_PREFER_PTHREAD TRUE)
148set(THREADS_PREFER_PTHREAD_FLAG TRUE)
149find_package(Threads)
150
Peter Toftfdf33792020-10-14 17:19:02 +0200151# If this is the root project add longer list of available CMAKE_BUILD_TYPE values
Ronald Cronf584e972024-10-07 11:38:17 +0200152if(NOT MBEDTLS_AS_SUBPROJECT)
Peter Toftfdf33792020-10-14 17:19:02 +0200153 set(CMAKE_BUILD_TYPE ${CMAKE_BUILD_TYPE}
Paul Elliottbbdfc8a2023-11-23 14:07:43 +0000154 CACHE STRING "Choose the type of build: None Debug Release Coverage ASan ASanDbg MemSan MemSanDbg Check CheckFull TSan TSanDbg"
Peter Toftfdf33792020-10-14 17:19:02 +0200155 FORCE)
156endif()
Manuel Pégourié-Gonnard0b4e2ac2015-07-08 22:10:38 +0100157
David Horstmann0f1dd572023-02-15 14:44:25 +0000158# Make MBEDTLS_CONFIG_FILE and MBEDTLS_USER_CONFIG_FILE into PATHs
159set(MBEDTLS_CONFIG_FILE "" CACHE FILEPATH "Mbed TLS config file (overrides default).")
160set(MBEDTLS_USER_CONFIG_FILE "" CACHE FILEPATH "Mbed TLS user config file (appended to default).")
David Horstmannae33ab82023-01-12 13:59:34 +0000161
Gilles Peskine84052572018-03-21 12:12:47 +0100162# Create a symbolic link from ${base_name} in the binary directory
163# to the corresponding path in the source directory.
Dominik Gschwindc6d16362022-08-10 16:27:14 +0200164# Note: Copies the file(s) on Windows.
Gilles Peskine84052572018-03-21 12:12:47 +0100165function(link_to_source base_name)
Dominik Gschwindc6d16362022-08-10 16:27:14 +0200166 set(link "${CMAKE_CURRENT_BINARY_DIR}/${base_name}")
167 set(target "${CMAKE_CURRENT_SOURCE_DIR}/${base_name}")
Gilles Peskine84052572018-03-21 12:12:47 +0100168
Dave Rodgmana14f5d92022-07-20 11:09:17 +0100169 # Linking to non-existent file is not desirable. At best you will have a
Paul Elliott582f72b2022-07-12 14:55:01 +0100170 # dangling link, but when building in tree, this can create a symbolic link
171 # to itself.
172 if (EXISTS ${target} AND NOT EXISTS ${link})
Gilles Peskine84052572018-03-21 12:12:47 +0100173 if (CMAKE_HOST_UNIX)
Dominik Gschwindc6d16362022-08-10 16:27:14 +0200174 execute_process(COMMAND ln -s ${target} ${link}
175 RESULT_VARIABLE result
176 ERROR_VARIABLE output)
177
178 if (NOT ${result} EQUAL 0)
179 message(FATAL_ERROR "Could not create symbolic link for: ${target} --> ${output}")
180 endif()
Gilles Peskine84052572018-03-21 12:12:47 +0100181 else()
Darryl Greend75ee642018-06-07 11:55:50 +0100182 if (IS_DIRECTORY ${target})
Dominik Gschwindc6d16362022-08-10 16:27:14 +0200183 file(GLOB_RECURSE files FOLLOW_SYMLINKS LIST_DIRECTORIES false RELATIVE ${target} "${target}/*")
184 foreach(file IN LISTS files)
185 configure_file("${target}/${file}" "${link}/${file}" COPYONLY)
186 endforeach(file)
Darryl Greend75ee642018-06-07 11:55:50 +0100187 else()
Dominik Gschwindc6d16362022-08-10 16:27:14 +0200188 configure_file(${target} ${link} COPYONLY)
Darryl Greend75ee642018-06-07 11:55:50 +0100189 endif()
Gilles Peskine84052572018-03-21 12:12:47 +0100190 endif()
Gilles Peskine84052572018-03-21 12:12:47 +0100191 endif()
192endfunction(link_to_source)
193
David Horstmannb3a54242021-10-19 18:37:04 +0100194# Get the filename without the final extension (i.e. convert "a.b.c" to "a.b")
195function(get_name_without_last_ext dest_var full_name)
196 # Split into a list on '.' (but a cmake list is just a ';'-separated string)
197 string(REPLACE "." ";" ext_parts "${full_name}")
198 # Remove the last item if there are more than one
199 list(LENGTH ext_parts ext_parts_len)
200 if (${ext_parts_len} GREATER "1")
201 math(EXPR ext_parts_last_item "${ext_parts_len} - 1")
202 list(REMOVE_AT ext_parts ${ext_parts_last_item})
203 endif()
204 # Convert back to a string by replacing separators with '.'
205 string(REPLACE ";" "." no_ext_name "${ext_parts}")
206 # Copy into the desired variable
207 set(${dest_var} ${no_ext_name} PARENT_SCOPE)
208endfunction(get_name_without_last_ext)
209
makise-homuraac2fd652020-08-18 21:59:46 +0300210include(CheckCCompilerFlag)
211
Dave Rodgmanf5f1cfc2022-05-10 17:26:47 +0100212set(CMAKE_C_EXTENSIONS OFF)
okhowang(王沛文)df865c32020-09-03 16:21:30 +0800213set(CMAKE_C_STANDARD 99)
214
Ronald Cronb2478982024-10-07 16:17:07 +0200215function(set_base_compile_options target)
216 if(CMAKE_COMPILER_IS_GNU)
217 set_gnu_base_compile_options(${target})
Ronald Crond9e11092024-10-09 10:01:46 +0200218 elseif(CMAKE_COMPILER_IS_CLANG)
219 set_clang_base_compile_options(${target})
Ronald Cron6f9d5082024-10-09 14:54:43 +0200220 elseif(CMAKE_COMPILER_IS_IAR)
221 set_iar_base_compile_options(${target})
222 elseif(CMAKE_COMPILER_IS_MSVC)
223 set_msvc_base_compile_options(${target})
Ronald Cronb2478982024-10-07 16:17:07 +0200224 endif()
225endfunction(set_base_compile_options)
226
227function(set_gnu_base_compile_options target)
Manuel Pégourié-Gonnardbcb04602015-07-19 16:00:04 +0200228 # some warnings we want are not available with old GCC versions
229 # note: starting with CMake 2.8 we could use CMAKE_C_COMPILER_VERSION
230 execute_process(COMMAND ${CMAKE_C_COMPILER} -dumpversion
231 OUTPUT_VARIABLE GCC_VERSION)
Ronald Cronb2478982024-10-07 16:17:07 +0200232 target_compile_options(${target} PRIVATE -Wall -Wextra -Wwrite-strings -Wmissing-prototypes)
Paul Elliottea32d552020-12-09 14:34:47 +0000233 if (GCC_VERSION VERSION_GREATER 3.0 OR GCC_VERSION VERSION_EQUAL 3.0)
Ronald Cronb2478982024-10-07 16:17:07 +0200234 target_compile_options(${target} PRIVATE -Wformat=2 -Wno-format-nonliteral)
Paul Elliottea32d552020-12-09 14:34:47 +0000235 endif()
Gilles Peskinebe517162019-07-02 20:22:11 +0200236 if (GCC_VERSION VERSION_GREATER 4.3 OR GCC_VERSION VERSION_EQUAL 4.3)
Ronald Cronb2478982024-10-07 16:17:07 +0200237 target_compile_options(${target} PRIVATE -Wvla)
Gilles Peskinebe517162019-07-02 20:22:11 +0200238 endif()
Manuel Pégourié-Gonnardbcb04602015-07-19 16:00:04 +0200239 if (GCC_VERSION VERSION_GREATER 4.5 OR GCC_VERSION VERSION_EQUAL 4.5)
Ronald Cronb2478982024-10-07 16:17:07 +0200240 target_compile_options(${target} PRIVATE -Wlogical-op)
Manuel Pégourié-Gonnardbcb04602015-07-19 16:00:04 +0200241 endif()
Manuel Pégourié-Gonnard824ba722015-08-27 23:00:49 +0200242 if (GCC_VERSION VERSION_GREATER 4.8 OR GCC_VERSION VERSION_EQUAL 4.8)
Ronald Cronb2478982024-10-07 16:17:07 +0200243 target_compile_options(${target} PRIVATE -Wshadow)
okhowang(王沛文)0cd8e0f2020-07-03 11:41:38 +0800244 endif()
245 if (GCC_VERSION VERSION_GREATER 5.0)
makise-homuraac2fd652020-08-18 21:59:46 +0300246 CHECK_C_COMPILER_FLAG("-Wformat-signedness" C_COMPILER_SUPPORTS_WFORMAT_SIGNEDNESS)
247 if(C_COMPILER_SUPPORTS_WFORMAT_SIGNEDNESS)
Ronald Cronb2478982024-10-07 16:17:07 +0200248 target_compile_options(${target} PRIVATE -Wformat-signedness)
makise-homuraac2fd652020-08-18 21:59:46 +0300249 endif()
250 endif()
Paul Elliottea32d552020-12-09 14:34:47 +0000251 if (GCC_VERSION VERSION_GREATER 7.0 OR GCC_VERSION VERSION_EQUAL 7.0)
Ronald Cronb2478982024-10-07 16:17:07 +0200252 target_compile_options(${target} PRIVATE -Wformat-overflow=2 -Wformat-truncation)
Paul Elliottea32d552020-12-09 14:34:47 +0000253 endif()
Ronald Cronb2478982024-10-07 16:17:07 +0200254 target_compile_options(${target} PRIVATE $<$<CONFIG:Release>:-O2>)
255 target_compile_options(${target} PRIVATE $<$<CONFIG:Debug>:-O0 -g3>)
256 target_compile_options(${target} PRIVATE $<$<CONFIG:Coverage>:-O0 -g3 --coverage>)
Ronald Cron4ae24f42024-10-08 17:53:13 +0200257 set_target_properties(${target} PROPERTIES LINK_FLAGS_COVERAGE "--coverage")
Gilles Peskinec76f82d2024-10-15 12:03:26 +0200258 # Old GCC versions hit a performance problem with test_suite_pkwrite
259 # "Private keey write check EC" tests when building with Asan+UBSan
260 # and -O3: those tests take more than 100x time than normal, with
261 # test_suite_pkwrite taking >3h on the CI. Observed with GCC 5.4 on
262 # Ubuntu 16.04 x86_64 and GCC 6.5 on Ubuntu 18.04 x86_64.
263 # GCC 7.5 and above on Ubuntu 18.04 appear fine.
Valerio Setti8b675b82024-10-16 13:28:44 +0200264 # To avoid the performance problem, we use -O2 when GCC version is lower than 7.0.
265 # It doesn't slow down much even with modern compiler versions.
Ronald Cronb2478982024-10-07 16:17:07 +0200266 target_compile_options(${target} PRIVATE $<$<CONFIG:ASan>:-fsanitize=address -fno-common -fsanitize=undefined -fno-sanitize-recover=all>)
Valerio Setti8b675b82024-10-16 13:28:44 +0200267 if (GCC_VERSION VERSION_LESS 7.0)
Ronald Cronb2478982024-10-07 16:17:07 +0200268 target_compile_options(${target} PRIVATE $<$<CONFIG:ASan>:-O2>)
Valerio Setti8b675b82024-10-16 13:28:44 +0200269 else()
Ronald Cronb2478982024-10-07 16:17:07 +0200270 target_compile_options(${target} PRIVATE $<$<CONFIG:ASan>:-O3>)
Valerio Setti8b675b82024-10-16 13:28:44 +0200271 endif()
Ronald Cron4ae24f42024-10-08 17:53:13 +0200272 set_target_properties(${target} PROPERTIES LINK_FLAGS_ASAN "-fsanitize=address -fsanitize=undefined")
Ronald Cronb2478982024-10-07 16:17:07 +0200273 target_compile_options(${target} PRIVATE $<$<CONFIG:ASanDbg>:-fsanitize=address -fno-common -fsanitize=undefined -fno-sanitize-recover=all -O1 -g3 -fno-omit-frame-pointer -fno-optimize-sibling-calls>)
Ronald Cron4ae24f42024-10-08 17:53:13 +0200274 set_target_properties(${target} PROPERTIES LINK_FLAGS_ASANDBG "-fsanitize=address -fsanitize=undefined")
Ronald Cronb2478982024-10-07 16:17:07 +0200275 target_compile_options(${target} PRIVATE $<$<CONFIG:TSan>:-fsanitize=thread -O3>)
Ronald Cron4ae24f42024-10-08 17:53:13 +0200276 set_target_properties(${target} PROPERTIES LINK_FLAGS_TSAN "-fsanitize=thread")
Ronald Cronb2478982024-10-07 16:17:07 +0200277 target_compile_options(${target} PRIVATE $<$<CONFIG:TSanDbg>:-fsanitize=thread -O1 -g3 -fno-omit-frame-pointer -fno-optimize-sibling-calls>)
Ronald Cron4ae24f42024-10-08 17:53:13 +0200278 set_target_properties(${target} PROPERTIES LINK_FLAGS_TSANDBG "-fsanitize=thread")
Ronald Cronb2478982024-10-07 16:17:07 +0200279 target_compile_options(${target} PRIVATE $<$<CONFIG:Check>:-Os>)
280 target_compile_options(${target} PRIVATE $<$<CONFIG:CheckFull>:-Os -Wcast-qual>)
Ronald Crond77fad22024-10-08 09:24:31 +0200281
282 if(MBEDTLS_FATAL_WARNINGS)
Ronald Cronb2478982024-10-07 16:17:07 +0200283 target_compile_options(${target} PRIVATE -Werror)
Ronald Crond77fad22024-10-08 09:24:31 +0200284 endif(MBEDTLS_FATAL_WARNINGS)
Ronald Cronb2478982024-10-07 16:17:07 +0200285endfunction(set_gnu_base_compile_options)
Paul Bakker76f03112013-11-28 17:20:04 +0100286
Ronald Crond9e11092024-10-09 10:01:46 +0200287function(set_clang_base_compile_options target)
288 target_compile_options(${target} PRIVATE -Wall -Wextra -Wwrite-strings -Wmissing-prototypes -Wpointer-arith -Wimplicit-fallthrough -Wshadow -Wvla -Wformat=2 -Wno-format-nonliteral)
289 target_compile_options(${target} PRIVATE $<$<CONFIG:Release>:-O2>)
290 target_compile_options(${target} PRIVATE $<$<CONFIG:Debug>:-O0 -g3>)
291 target_compile_options(${target} PRIVATE $<$<CONFIG:Coverage>:-O0 -g3 --coverage>)
292 set_target_properties(${target} PROPERTIES LINK_FLAGS_COVERAGE "--coverage")
293 target_compile_options(${target} PRIVATE $<$<CONFIG:ASan>:-fsanitize=address -fno-common -fsanitize=undefined -fno-sanitize-recover=all -O3>)
294 set_target_properties(${target} PROPERTIES LINK_FLAGS_ASAN "-fsanitize=address -fsanitize=undefined")
295 target_compile_options(${target} PRIVATE $<$<CONFIG:ASanDbg>:-fsanitize=address -fno-common -fsanitize=undefined -fno-sanitize-recover=all -O1 -g3 -fno-omit-frame-pointer -fno-optimize-sibling-calls>)
296 set_target_properties(${target} PROPERTIES LINK_FLAGS_ASANDBG "-fsanitize=address -fsanitize=undefined")
297 target_compile_options(${target} PRIVATE $<$<CONFIG:MemSan>:-fsanitize=memory>)
298 set_target_properties(${target} PROPERTIES LINK_FLAGS_MEMSAN "-fsanitize=memory")
299 target_compile_options(${target} PRIVATE $<$<CONFIG:MemSanDbg>:-fsanitize=memory -O1 -g3 -fno-omit-frame-pointer -fno-optimize-sibling-calls -fsanitize-memory-track-origins=2>)
300 set_target_properties(${target} PROPERTIES LINK_FLAGS_MEMSANDBG "-fsanitize=memory")
301 target_compile_options(${target} PRIVATE $<$<CONFIG:TSan>:-fsanitize=thread -O3>)
302 set_target_properties(${target} PROPERTIES LINK_FLAGS_TSAN "-fsanitize=thread")
303 target_compile_options(${target} PRIVATE $<$<CONFIG:TSanDbg>:-fsanitize=thread -O1 -g3 -fno-omit-frame-pointer -fno-optimize-sibling-calls>)
304 set_target_properties(${target} PROPERTIES LINK_FLAGS_TSANDBG "-fsanitize=thread")
305 target_compile_options(${target} PRIVATE $<$<CONFIG:Check>:-Os>)
306
Ronald Crond77fad22024-10-08 09:24:31 +0200307 if(MBEDTLS_FATAL_WARNINGS)
Ronald Crond9e11092024-10-09 10:01:46 +0200308 target_compile_options(${target} PRIVATE -Werror)
Ronald Crond77fad22024-10-08 09:24:31 +0200309 endif(MBEDTLS_FATAL_WARNINGS)
Ronald Crond9e11092024-10-09 10:01:46 +0200310endfunction(set_clang_base_compile_options)
Paul Bakker92bc8752013-12-30 17:56:23 +0100311
Ronald Cron6f9d5082024-10-09 14:54:43 +0200312function(set_iar_base_compile_options target)
313 target_compile_options(${target} PRIVATE --warn_about_c_style_casts)
314 target_compile_options(${target} PRIVATE $<$<CONFIG:Release>:-Ohz>)
315 target_compile_options(${target} PRIVATE $<$<CONFIG:Debug>:--debug -On>)
Ronald Crond77fad22024-10-08 09:24:31 +0200316
317 if(MBEDTLS_FATAL_WARNINGS)
Ronald Cron6f9d5082024-10-09 14:54:43 +0200318 target_compile_options(${target} PRIVATE --warnings_are_errors)
Ronald Crond77fad22024-10-08 09:24:31 +0200319 endif(MBEDTLS_FATAL_WARNINGS)
Ronald Cron6f9d5082024-10-09 14:54:43 +0200320endfunction(set_iar_base_compile_options)
Azim Khan45b79cf2018-05-23 16:55:16 +0100321
Ronald Cron6f9d5082024-10-09 14:54:43 +0200322function(set_msvc_base_compile_options target)
Andrea Pappacoda92029092021-12-27 22:41:21 +0100323 # Strictest warnings, UTF-8 source and execution charset
Ronald Cron6f9d5082024-10-09 14:54:43 +0200324 target_compile_options(${target} PRIVATE /W3 /utf-8)
Manuel Pégourié-Gonnard30830532015-07-01 17:06:28 +0200325
Ronald Crond77fad22024-10-08 09:24:31 +0200326 if(MBEDTLS_FATAL_WARNINGS)
Ronald Cron6f9d5082024-10-09 14:54:43 +0200327 target_compile_options(${target} PRIVATE /WX)
Ronald Crond77fad22024-10-08 09:24:31 +0200328 endif(MBEDTLS_FATAL_WARNINGS)
Ronald Cron6f9d5082024-10-09 14:54:43 +0200329endfunction(set_msvc_base_compile_options)
Carlos Gomes Martinhoa5f0bd32020-04-03 09:42:37 +0200330
Ronald Cron211bf6d2024-10-23 14:22:03 +0200331function(set_config_files_compile_definitions target)
332 # Pass-through MBEDTLS_CONFIG_FILE, MBEDTLS_USER_CONFIG_FILE,
333 # MBEDTLS_PSA_CRYPTO_CONFIG_FILE and MBEDTLS_PSA_CRYPTO_USER_CONFIG_FILE
334 if(MBEDTLS_CONFIG_FILE)
335 target_compile_definitions(${target}
336 PUBLIC MBEDTLS_CONFIG_FILE="${MBEDTLS_CONFIG_FILE}")
337 endif()
338 if(MBEDTLS_USER_CONFIG_FILE)
339 target_compile_definitions(${target}
340 PUBLIC MBEDTLS_USER_CONFIG_FILE="${MBEDTLS_USER_CONFIG_FILE}")
341 endif()
342 if(MBEDTLS_PSA_CRYPTO_CONFIG_FILE)
343 target_compile_definitions(${target}
344 PUBLIC MBEDTLS_PSA_CRYPTO_CONFIG_FILE="${MBEDTLS_PSA_CRYPTO_CONFIG_FILE}")
345 endif()
346 if(MBEDTLS_PSA_CRYPTO_USER_CONFIG_FILE)
347 target_compile_definitions(${target}
348 PUBLIC MBEDTLS_PSA_CRYPTO_USER_CONFIG_FILE="${MBEDTLS_PSA_CRYPTO_USER_CONFIG_FILE}")
349 endif()
350endfunction(set_config_files_compile_definitions)
351
Gilles Peskine62ee8fd2024-06-06 22:12:06 +0200352if(CMAKE_BUILD_TYPE STREQUAL "Check" AND TEST_CPP)
353 set(CMAKE_CXX_STANDARD 11)
354 set(CMAKE_CXX_STANDARD_REQUIRED ON)
355 set(CMAKE_CXX_EXTENSIONS OFF)
356 if(CMAKE_COMPILER_IS_CLANG OR CMAKE_COMPILER_IS_GNU)
357 set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -pedantic")
358 endif()
359endif()
360
Ronald Cronb6254f52024-07-25 14:52:19 +0200361if (NOT EXISTS "${MBEDTLS_FRAMEWORK_DIR}/CMakeLists.txt")
Harry Ramsey6d9c3892024-10-28 14:05:23 +0000362 if (EXISTS "${CMAKE_CURRENT_SOURCE_DIR}/.git/")
363 message(FATAL_ERROR "${MBEDTLS_FRAMEWORK_DIR}/CMakeLists.txt not found (and does appear to be a git checkout). Run `git submodule update --init` from the source tree to fetch the submodule contents.")
Harry Ramseye05cf2e2024-09-17 15:12:11 +0100364 else ()
Harry Ramsey6d9c3892024-10-28 14:05:23 +0000365 message(FATAL_ERROR "${MBEDTLS_FRAMEWORK_DIR}/CMakeLists.txt not found (and does not appear to be a git checkout). Please ensure you have downloaded the right archive from the release page on GitHub.")
Harry Ramseye05cf2e2024-09-17 15:12:11 +0100366 endif()
Gilles Peskinef9bbe0d2024-03-04 16:25:14 +0100367endif()
Gilles Peskine469f7812024-02-29 18:19:56 +0100368add_subdirectory(framework)
369
Christoph M. Wintersteiger7b747fc2019-04-08 17:00:34 +0100370add_subdirectory(include)
371
Ronald Cronaef8cf32024-07-01 18:33:24 +0200372add_subdirectory(tf-psa-crypto)
Christoph M. Wintersteiger6ea2dea12019-01-21 17:26:19 +0000373
Paul Bakker367dae42009-06-28 21:50:27 +0000374add_subdirectory(library)
Paul Bakker2015eac2011-07-27 16:52:28 +0000375
Bill Robertsa4d17b32024-01-09 13:10:05 -0600376add_subdirectory(pkgconfig)
377
Ronald Crondd6bdb52020-06-26 16:37:02 +0200378#
379# The C files in tests/src directory contain test code shared among test suites
380# and programs. This shared test code is compiled and linked to test suites and
381# programs objects as a set of compiled objects. The compiled objects are NOT
382# built into a library that the test suite and program objects would link
383# against as they link against the mbedcrypto, mbedx509 and mbedtls libraries.
384# The reason is that such library is expected to have mutual dependencies with
385# the aforementioned libraries and that there is as of today no portable way of
386# handling such dependencies (only toolchain specific solutions).
387#
388# Thus the below definition of the `mbedtls_test` CMake library of objects
389# target. This library of objects is used by tests and programs CMake files
390# to define the test executables.
391#
Ronald Cronddaf99c2020-06-19 11:27:26 +0200392if(ENABLE_TESTING OR ENABLE_PROGRAMS)
Yanray Wangb458b8c2022-10-28 11:49:33 +0800393 file(GLOB MBEDTLS_TEST_FILES
394 ${CMAKE_CURRENT_SOURCE_DIR}/tests/src/*.c
395 ${CMAKE_CURRENT_SOURCE_DIR}/tests/src/drivers/*.c)
Valerio Settifb418162024-04-15 09:11:28 +0200396 add_library(mbedtls_test OBJECT ${MBEDTLS_TEST_FILES})
Ronald Cronb2478982024-10-07 16:17:07 +0200397 set_base_compile_options(mbedtls_test)
Valerio Settifb418162024-04-15 09:11:28 +0200398 if(GEN_FILES)
David Horstmann1238b372024-05-10 14:23:16 +0100399 add_custom_command(
400 OUTPUT
401 ${CMAKE_CURRENT_SOURCE_DIR}/tests/src/test_keys.h
402 WORKING_DIRECTORY
403 ${CMAKE_CURRENT_SOURCE_DIR}/tests
404 COMMAND
405 "${MBEDTLS_PYTHON_EXECUTABLE}"
Ronald Cronb6254f52024-07-25 14:52:19 +0200406 "${MBEDTLS_FRAMEWORK_DIR}/scripts/generate_test_keys.py"
David Horstmann1238b372024-05-10 14:23:16 +0100407 "--output"
408 "${CMAKE_CURRENT_SOURCE_DIR}/tests/src/test_keys.h"
409 DEPENDS
Ronald Cronb6254f52024-07-25 14:52:19 +0200410 ${MBEDTLS_FRAMEWORK_DIR}/scripts/generate_test_keys.py
David Horstmann1238b372024-05-10 14:23:16 +0100411 )
412 add_custom_target(test_keys_header DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/tests/src/test_keys.h)
413 add_custom_command(
414 OUTPUT
415 ${CMAKE_CURRENT_SOURCE_DIR}/tests/src/test_certs.h
416 WORKING_DIRECTORY
417 ${CMAKE_CURRENT_SOURCE_DIR}/tests
418 COMMAND
419 "${MBEDTLS_PYTHON_EXECUTABLE}"
Ronald Cronb6254f52024-07-25 14:52:19 +0200420 "${MBEDTLS_FRAMEWORK_DIR}/scripts/generate_test_cert_macros.py"
David Horstmann1238b372024-05-10 14:23:16 +0100421 "--output"
422 "${CMAKE_CURRENT_SOURCE_DIR}/tests/src/test_certs.h"
423 DEPENDS
Ronald Cronb6254f52024-07-25 14:52:19 +0200424 ${MBEDTLS_FRAMEWORK_DIR}/scripts/generate_test_cert_macros.py
David Horstmann1238b372024-05-10 14:23:16 +0100425 )
426 add_custom_target(test_certs_header DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/tests/src/test_certs.h)
Valerio Settifb418162024-04-15 09:11:28 +0200427 add_dependencies(mbedtls_test test_keys_header test_certs_header)
428 endif()
Ronald Cronddaf99c2020-06-19 11:27:26 +0200429 target_include_directories(mbedtls_test
430 PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/tests/include
431 PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/include
Ronald Cronc7e9e362024-06-10 09:41:49 +0200432 PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/tf-psa-crypto/include
Ronald Cron3d817ad2024-06-14 08:43:28 +0200433 PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/tf-psa-crypto/drivers/builtin/include
Waleed Elmelegy4cef20d2024-08-22 15:26:05 +0100434 PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/tf-psa-crypto/drivers/everest/include
Ronald Cronc29afb62024-07-01 14:50:54 +0200435 PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/library
436 PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/tf-psa-crypto/core
437 PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/tf-psa-crypto/drivers/builtin/src)
David Horstmannc2ab3982024-01-17 12:25:19 +0000438 # Request C11, needed for memory poisoning tests
439 set_target_properties(mbedtls_test PROPERTIES C_STANDARD 11)
Yanray Wangb458b8c2022-10-28 11:49:33 +0800440
441 file(GLOB MBEDTLS_TEST_HELPER_FILES
442 ${CMAKE_CURRENT_SOURCE_DIR}/tests/src/test_helpers/*.c)
443 add_library(mbedtls_test_helpers OBJECT ${MBEDTLS_TEST_HELPER_FILES})
Ronald Cronb2478982024-10-07 16:17:07 +0200444 set_base_compile_options(mbedtls_test_helpers)
Yanray Wangb458b8c2022-10-28 11:49:33 +0800445 target_include_directories(mbedtls_test_helpers
446 PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/tests/include
447 PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/include
Ronald Cronc7e9e362024-06-10 09:41:49 +0200448 PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/tf-psa-crypto/include
Ronald Cron3d817ad2024-06-14 08:43:28 +0200449 PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/tf-psa-crypto/drivers/builtin/include
Yanray Wangb458b8c2022-10-28 11:49:33 +0800450 PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/library
Ronald Cronc29afb62024-07-01 14:50:54 +0200451 PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/tf-psa-crypto/core
452 PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/tf-psa-crypto/drivers/builtin/src
Ronald Cronaef8cf32024-07-01 18:33:24 +0200453 PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/tf-psa-crypto/drivers/everest/include)
David Horstmannae33ab82023-01-12 13:59:34 +0000454
Ronald Cron211bf6d2024-10-23 14:22:03 +0200455 set_config_files_compile_definitions(mbedtls_test)
456 set_config_files_compile_definitions(mbedtls_test_helpers)
Ronald Cronddaf99c2020-06-19 11:27:26 +0200457endif()
458
Paul Bakkerdf5024c2014-03-26 13:27:51 +0100459if(ENABLE_PROGRAMS)
Gilles Peskine63068d62024-09-24 19:09:57 +0200460 set(ssl_opt_target "${MBEDTLS_TARGET_PREFIX}ssl-opt")
461 add_custom_target(${ssl_opt_target})
462
Manuel Pégourié-Gonnard216a1832015-06-25 09:20:03 +0200463 add_subdirectory(programs)
Paul Bakkerdf5024c2014-03-26 13:27:51 +0100464endif()
Paul Bakkerccba9bc2011-01-05 15:30:32 +0000465
Raef Coles995c66f2020-10-13 16:30:41 +0100466ADD_CUSTOM_TARGET(${MBEDTLS_TARGET_PREFIX}apidoc
Krzysztof Stachowiaka0188d62018-01-19 16:21:11 +0100467 COMMAND doxygen mbedtls.doxyfile
468 WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/doxygen)
Manuel Pégourié-Gonnard7669f282013-09-07 16:52:42 +0200469
Paul Bakker27f1cae2014-04-30 16:31:54 +0200470if(ENABLE_TESTING)
Manuel Pégourié-Gonnard5fe51d72015-07-01 16:59:56 +0200471 enable_testing()
Manuel Pégourié-Gonnardc8293b22015-06-25 09:22:25 +0200472
Manuel Pégourié-Gonnard5fe51d72015-07-01 16:59:56 +0200473 add_subdirectory(tests)
Manuel Pégourié-Gonnard61137df2014-02-24 11:57:36 +0100474
Manuel Pégourié-Gonnard5fe51d72015-07-01 16:59:56 +0200475 # additional convenience targets for Unix only
Ronald Cron169393e2024-10-07 12:34:42 +0200476 if(UNIX AND (NOT MBEDTLS_AS_SUBPROJECT))
Gilles Peskine0ab6c8a2022-12-08 22:18:31 +0100477 # For coverage testing:
478 # 1. Build with:
479 # cmake -D CMAKE_BUILD_TYPE=Coverage /path/to/source && make
480 # 2. Run the relevant tests for the part of the code you're interested in.
481 # For the reference coverage measurement, see
482 # tests/scripts/basic-build-test.sh
483 # 3. Run scripts/lcov.sh to generate an HTML report.
Manuel Pégourié-Gonnard5fe51d72015-07-01 16:59:56 +0200484 ADD_CUSTOM_TARGET(lcov
Gilles Peskinecb330762022-11-30 17:52:01 +0100485 COMMAND scripts/lcov.sh
Manuel Pégourié-Gonnard5fe51d72015-07-01 16:59:56 +0200486 )
487
488 ADD_CUSTOM_TARGET(memcheck
489 COMMAND sed -i.bak s+/usr/bin/valgrind+`which valgrind`+ DartConfiguration.tcl
490 COMMAND ctest -O memcheck.log -D ExperimentalMemCheck
491 COMMAND tail -n1 memcheck.log | grep 'Memory checking results:' > /dev/null
492 COMMAND rm -f memcheck.log
493 COMMAND mv DartConfiguration.tcl.bak DartConfiguration.tcl
494 )
Ronald Cron169393e2024-10-07 12:34:42 +0200495 endif()
Gilles Peskine84052572018-03-21 12:12:47 +0100496
Renz Christian Bagaporod8a40b52019-04-28 13:51:37 +0800497 # Make scripts needed for testing available in an out-of-source build.
498 if (NOT ${CMAKE_CURRENT_BINARY_DIR} STREQUAL ${CMAKE_CURRENT_SOURCE_DIR})
499 link_to_source(scripts)
500 # Copy (don't link) DartConfiguration.tcl, needed for memcheck, to
501 # keep things simple with the sed commands in the memcheck target.
502 configure_file(${CMAKE_CURRENT_SOURCE_DIR}/DartConfiguration.tcl
503 ${CMAKE_CURRENT_BINARY_DIR}/DartConfiguration.tcl COPYONLY)
504 endif()
Gilles Peskine84052572018-03-21 12:12:47 +0100505endif()
Chris Kayd259e342021-03-25 16:03:25 +0000506
Antonio de Angelis2869c672021-12-07 20:45:55 +0000507if(NOT DISABLE_PACKAGE_CONFIG_AND_INSTALL)
508 configure_package_config_file(
509 "cmake/MbedTLSConfig.cmake.in"
510 "cmake/MbedTLSConfig.cmake"
511 INSTALL_DESTINATION "cmake")
Chris Kayd259e342021-03-25 16:03:25 +0000512
Antonio de Angelis2869c672021-12-07 20:45:55 +0000513 write_basic_package_version_file(
514 "cmake/MbedTLSConfigVersion.cmake"
515 COMPATIBILITY SameMajorVersion
David Horstmann7ba04a22024-09-03 17:36:30 +0100516 VERSION 4.0.0)
Chris Kayd259e342021-03-25 16:03:25 +0000517
Antonio de Angelis2869c672021-12-07 20:45:55 +0000518 install(
519 FILES "${CMAKE_CURRENT_BINARY_DIR}/cmake/MbedTLSConfig.cmake"
520 "${CMAKE_CURRENT_BINARY_DIR}/cmake/MbedTLSConfigVersion.cmake"
Issam E. Maghni760f3a02022-11-19 18:34:01 +0000521 DESTINATION "${CMAKE_INSTALL_LIBDIR}/cmake/MbedTLS")
Chris Kayd259e342021-03-25 16:03:25 +0000522
Antonio de Angelis2869c672021-12-07 20:45:55 +0000523 export(
524 EXPORT MbedTLSTargets
525 NAMESPACE MbedTLS::
526 FILE "cmake/MbedTLSTargets.cmake")
Chris Kayd259e342021-03-25 16:03:25 +0000527
Antonio de Angelis2869c672021-12-07 20:45:55 +0000528 install(
529 EXPORT MbedTLSTargets
530 NAMESPACE MbedTLS::
Issam E. Maghni760f3a02022-11-19 18:34:01 +0000531 DESTINATION "${CMAKE_INSTALL_LIBDIR}/cmake/MbedTLS"
Antonio de Angelis2869c672021-12-07 20:45:55 +0000532 FILE "MbedTLSTargets.cmake")
Chris Kayd259e342021-03-25 16:03:25 +0000533
Antonio de Angelis2869c672021-12-07 20:45:55 +0000534 if(CMAKE_VERSION VERSION_GREATER 3.15 OR CMAKE_VERSION VERSION_EQUAL 3.15)
535 # Do not export the package by default
536 cmake_policy(SET CMP0090 NEW)
Chris Kayd259e342021-03-25 16:03:25 +0000537
Antonio de Angelis2869c672021-12-07 20:45:55 +0000538 # Make this package visible to the system
539 export(PACKAGE MbedTLS)
540 endif()
Chris Kayd259e342021-03-25 16:03:25 +0000541endif()