zephyr/cmake/linker/target_template.cmake

# SPDX-License-Identifier: Apache-2.0
#
# Copyright (c) 2024, Nordic Semiconductor ASA

# Template file for optional Zephyr linker macros.
#
# This file will define optional linker macros for toolchains that are not
# defining these macros themselves.

if(NOT COMMAND toolchain_linker_finalize)
  macro(toolchain_linker_finalize)
  endmacro()
endif()
cmake: improve Zephyr link phase Zephyr is a bare metal build where standard libs are disabled. This means that c and runtime libraries must manually be linked in. This has generally been handled by using CMake's link libraries handling but the issue with that is both de-duplication but also library link order. Standard libraries must be linked at last location to ensure symbols are always available, however this is not optimal with target_link_libraries() because this would ultimately require every library to know the c library to link with, which is not desired. Therefore, setup standard C and runtime library linking in linker CMake files for toolchains where this is required. This commit expands the principle introduced with toolchain abstraction, see PR#24851. This means that a toolchain implementation may specify standard C, runtime, C++, etc libraries, as well as their link order. Because a property approach is used, then Zephyr modules, such as the Picolibc module can adjust such properties. An optional `zephyr_linker_finalize()` macro is called at the end of Zephyr's CMakeList process and can be used by the toolchain implementation to define the final linker invocation. This aligns the linker handling flow to the principle introduced in PR#24851 and improves the flexibility and robustness of Zephyr build system. Signed-off-by: Torsten Rasmussen <Torsten.Rasmussen@nordicsemi.no> 2024-08-06 16:13:31 +08:00			`# SPDX-License-Identifier: Apache-2.0`
			`#`
			`# Copyright (c) 2024, Nordic Semiconductor ASA`

			`# Template file for optional Zephyr linker macros.`
			`#`
			`# This file will define optional linker macros for toolchains that are not`
			`# defining these macros themselves.`

			`if(NOT COMMAND toolchain_linker_finalize)`
			`macro(toolchain_linker_finalize)`
			`endmacro()`
			`endif()`