genode/repos/base/lib/mk/ld.mk

#
# Generic ld.lib.so ABI stub library
#
# This library is used to build kernel-independent dynamically linked
# executables. It does not contain any code or data but only the symbol
# information of the binary interface of the Genode API.
#
# Note that this library is not used as runtime at all. At system-integration
# time, it is transparently replaced by the variant of the dynamic linker that
# matches the used kernel.
#

SHARED_LIB := yes

LD_OPT += -T$(BASE_DIR)/src/lib/ldso/linker.ld

LIBS += $(addprefix ld-,$(KERNEL))
Genode application binary interface (ABI) This patch decouples the kernel-specific implementation of the dynamic linker from its kernel-agnostic binary interface. The name of the kernel-specific dynamic linker binary now corresponds to the kernel, e.g., 'ld-linux.lib.so' or 'ld-nova.lib.so'. Applications are no longer linked directly against a concrete instance of the dynamic linker but against a shallow stub called 'ld.lib.so'. This stub contains nothing but the symbols provided by the dynamic linker. It thereby represents the Genode ABI. At system-integration time, the kernel-specific run/boot_dir back ends integrate the matching the kernel-specific variant of the dynamic linker as 'ld.lib.so' into the boot image. The ABI symbol file for the dynamic linker is located at 'base/lib/symbols/ld'. It contains the joint ABI of all supported architectures. The new utility 'tool/abi_symbols' eases the creation of such an ABI symbol file for a given shared library. Its result should be manually inspected and edited as needed. The patch removes the 'syscall' library from 'base_libs.mk' to avoid polluting the kernel-agnostic ABI with kernel-specific interfaces. Issue #2190 Issue #2195 2016-12-09 22:09:17 +00:00			`#`
Generalize ABI mechanism to shared objects This patch make the ABI mechanism available to shared libraries other than Genode's dynamic linker. It thereby allows us to introduce intermediate ABIs at the granularity of shared libraries. This is useful for slow-moving ABIs such as the libc's interface but it will also become handy for the package management. To implement the feature, the build system had to be streamlined a bit. In particular, archive dependencies and shared-lib dependencies are now handled separately, and the global list of 'SHARED_LIBS' is no more. Now, the variable with the same name holds the per-target list of shared libraries used by the target. 2016-12-29 17:27:45 +00:00			`# Generic ld.lib.so ABI stub library`
Genode application binary interface (ABI) This patch decouples the kernel-specific implementation of the dynamic linker from its kernel-agnostic binary interface. The name of the kernel-specific dynamic linker binary now corresponds to the kernel, e.g., 'ld-linux.lib.so' or 'ld-nova.lib.so'. Applications are no longer linked directly against a concrete instance of the dynamic linker but against a shallow stub called 'ld.lib.so'. This stub contains nothing but the symbols provided by the dynamic linker. It thereby represents the Genode ABI. At system-integration time, the kernel-specific run/boot_dir back ends integrate the matching the kernel-specific variant of the dynamic linker as 'ld.lib.so' into the boot image. The ABI symbol file for the dynamic linker is located at 'base/lib/symbols/ld'. It contains the joint ABI of all supported architectures. The new utility 'tool/abi_symbols' eases the creation of such an ABI symbol file for a given shared library. Its result should be manually inspected and edited as needed. The patch removes the 'syscall' library from 'base_libs.mk' to avoid polluting the kernel-agnostic ABI with kernel-specific interfaces. Issue #2190 Issue #2195 2016-12-09 22:09:17 +00:00			`#`
			`# This library is used to build kernel-independent dynamically linked`
			`# executables. It does not contain any code or data but only the symbol`
			`# information of the binary interface of the Genode API.`
			`#`
			`# Note that this library is not used as runtime at all. At system-integration`
			`# time, it is transparently replaced by the variant of the dynamic linker that`
			`# matches the used kernel.`
			`#`

			`SHARED_LIB := yes`

			`LD_OPT += -T$(BASE_DIR)/src/lib/ldso/linker.ld`
mk/ld.mk: trigger kernel-dependent ld.lib.so build When 'KERNEL' is specified, let the generic (pseudo) target of lib/mk/ld.mk trigger the build of the actual dynamic linker named after the used kernel. This way, we become able to remove the magic linker-build step from the boot-image stage of the run tool. Issue #4320 2022-02-08 15:26:05 +00:00
			`LIBS += $(addprefix ld-,$(KERNEL))`