ExternalVendorCode/genode
1
0
Fork 0
mirror of https://github.com/genodelabs/genode.git synced 2024-12-26 00:41:08 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
85daf1b3b2
genode/repos/base/mk/dep_lib.mk

161 lines
5.3 KiB
Makefile
Raw Normal View History

Imported Genode release 11.11
2011-12-22 15:19:25 +00:00
#
# This file determines dependencies of a library from other libraries
#
# The following variables must be defined by the caller:
#
# VERBOSE - controls the make verboseness
# VERBOSE_DIR - verboseness of directory change messages
# VERBOSE_MK - verboseness of make calls
# REPOSITORIES - source code repositories to use
# BASE_DIR - base directory of build system repository
# TARGET_DIR - target build directory
# BUILD_BASE_DIR - build directory with build config
# LIB_CACHE_DIR - destination directory for object files
# LIB_PROGRESS_LOG - library build log file
# BUILD_LIBS - list of libraries to build (without .lib.a or .lib.so suffix)
# INSTALL_DIR - destination directory for installing shared libraries
mk: strip binaries at <build-dir>/bin/ The <build-dir>/bin/ directory used to contain symbolic links to the unstripped build results. However, since the upcoming depot tool extracts the content of binary archives from bin/, the resulting archives would contain overly large unstripped binaries, which is undesired. On the other hand, always stripping the build results is not a good option either because we rely of symbol information during debugging. This patch changes the installation of build results such that a new 'debug/' directory is populated besides the existing 'bin/' directory. The debug directory contains symbolic links to the unstripped build results whereas the bin directory contains stripped binaries that are palatable for packaging (depot tool) and for assembling boot images (run tool).
2017-04-05 14:51:47 +00:00
# DEBUG_DIR - destination directory for installing unstripped shared libraries
Imported Genode release 11.11
2011-12-22 15:19:25 +00:00
#
toolchain: report missing ports at once Previously, ports that were needed for a scenario and that were not prepared or outdated, triggered one assertion each during the second build stage. The commit slots a mechanism in ahead that gathers all these ports during the first build stage and reports them in form of a list before the second build stage is entered. This list can be used directly as argument for tool/ports/prepare_port to prepare respectively update the ports. If, however, this mechanism is not available, for example because a target is build without the first build stage, the old assertion still prevents the target from running into troubles with a missing port. Fixes #1872
2016-02-04 11:20:03 +00:00
ACCUMULATE_MISSING_PORTS = 1
Add 'select_from_repositories' in 'dep_lib.mk' Fixes #142.
2012-03-06 14:16:22 +00:00
#
Build-system support for ported 3rd-party code The new 'select_from_ports' function allows a target description file to query the path to an installed port. All ports are stored in a central location specified as CONTRIB_DIR. By default, CONTRIB_DIR is defined as '<genode-dir>/contrib'. Ports of 3rd-party source code are managed using the tools at '<genode-dir>/tool/ports/'. Issue #1082
2014-05-08 14:42:38 +00:00
# Include common utility functions
Add 'select_from_repositories' in 'dep_lib.mk' Fixes #142.
2012-03-06 14:16:22 +00:00
#
Build-system support for ported 3rd-party code The new 'select_from_ports' function allows a target description file to query the path to an installed port. All ports are stored in a central location specified as CONTRIB_DIR. By default, CONTRIB_DIR is defined as '<genode-dir>/contrib'. Ports of 3rd-party source code are managed using the tools at '<genode-dir>/tool/ports/'. Issue #1082
2014-05-08 14:42:38 +00:00
include $(BASE_DIR)/mk/util.inc
Add 'select_from_repositories' in 'dep_lib.mk' Fixes #142.
2012-03-06 14:16:22 +00:00
Imported Genode release 11.11
2011-12-22 15:19:25 +00:00
#
# Generate dependencies only for those libs that are
# not already contained in the library build log
#
include $(LIB_PROGRESS_LOG)
ifneq ($(filter $(LIB),$(LIBS_READY)),)
already_visited:
@true
else
all: append_lib_to_progress_log
endif
append_lib_to_progress_log:
@echo "LIBS_READY += $(LIB)" >> $(LIB_PROGRESS_LOG)
mk: record build artifacts in progress.log Issue #4368
2022-01-07 12:39:45 +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
LIB_MK_DIRS = $(foreach REP,$(REPOSITORIES),$(addprefix $(REP)/lib/mk/spec/, $(SPECS)) $(REP)/lib/mk)
SYMBOLS_DIRS = $(foreach REP,$(REPOSITORIES),$(addprefix $(REP)/lib/symbols/spec/,$(SPECS)) $(REP)/lib/symbols)
Imported Genode release 11.11
2011-12-22 15:19:25 +00:00
#
# Of all possible file locations, use the (first) one that actually exist.
#
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
LIB_MK = $(firstword $(wildcard $(addsuffix /$(LIB).mk,$(LIB_MK_DIRS))))
SYMBOLS = $(firstword $(wildcard $(addsuffix /$(LIB), $(SYMBOLS_DIRS))))
Imported Genode release 11.11
2011-12-22 15:19:25 +00:00
mk: omit the creation of .lib.so files for ABIs Furthermore, the patch alleviates the need for providing a library description file if the library is present in the form of an ABI-symbols file only.
2017-03-15 18:02:38 +00:00
ifneq ($(SYMBOLS),)
SHARED_LIB := yes
endif
Imported Genode release 11.11
2011-12-22 15:19:25 +00:00
#
mk: omit the creation of .lib.so files for ABIs Furthermore, the patch alleviates the need for providing a library description file if the library is present in the form of an ABI-symbols file only.
2017-03-15 18:02:38 +00:00
# Sanity check to detect missing library-description file
Imported Genode release 11.11
2011-12-22 15:19:25 +00:00
#
mk: omit the creation of .lib.so files for ABIs Furthermore, the patch alleviates the need for providing a library description file if the library is present in the form of an ABI-symbols file only.
2017-03-15 18:02:38 +00:00
ifeq ($(sort $(LIB_MK) $(SYMBOLS)),)
Imported Genode release 11.11
2011-12-22 15:19:25 +00:00
all: warn_missing_lib_mk
else
all: check_unsatisfied_requirements
endif
warn_missing_lib_mk: generate_lib_rule_for_defect_library
@$(ECHO) "Library-description file $(DARK_COL)$(LIB).mk$(DEFAULT_COL) is missing"
#
# Determine the repository base directory from the absolute pathname
# of the choosen libname.mk file. We need to specify the override
# command because REP_DIR was first set by prg.mk when building a
# program target. The repository of a library could be a different
# one.
#
# Finally, we strip the trailing slash from the path. The slash was
# used to match the whole directory in 'findstring'.
#
override REP_DIR := $(firstword $(foreach REP,$(REPOSITORIES),$(findstring $(REP)/,$(LIB_MK))))
override REP_DIR := $(REP_DIR:/=)
include $(BASE_DIR)/mk/base-libs.mk
base: Do not link base libs against shared libs Base libraries are already contained within ldso.lib.so. Remove unnecessary filtering from 'dep_lib.mk', make ldso depend on base libs. Issue #1017 Issue #989
2014-01-08 14:01:26 +00:00
include $(LIB_MK)
ifdef SHARED_LIB
Cleanup shared-object support mechanics The former ldso-startup static library (now called ldso_so_support) is used to spice each shared object/library with local support code for the dynamic linker (execution of static constructors and ARM-EABI). Therefore, the library must be statically linked to each dynamic library. As a result recipes for dynamic libraries must always depend on the "so" API, which makes ldso_so_support.mk and so_support.c available independent of "base". Additionally, ldso_so_support is also provided in the libc API to cut the dependency early for libc/posix libraries. Issue #3720
2020-04-02 06:19:34 +00:00
LIBS += ldso_so_support
mk: record build artifacts in progress.log Issue #4368
2022-01-07 12:39:45 +00:00
# record creation of shared library build artifact
append_artifact_to_progress_log:
@echo -e "\n# Build artifact $(LIB).lib.so\n" >> $(LIB_PROGRESS_LOG)
append_lib_to_progress_log: append_artifact_to_progress_log
Imported Genode release 11.11
2011-12-22 15:19:25 +00:00
endif
mk: record build artifacts in progress.log Issue #4368
2022-01-07 12:39:45 +00:00
base: Do not link base libs against shared libs Base libraries are already contained within ldso.lib.so. Remove unnecessary filtering from 'dep_lib.mk', make ldso depend on base libs. Issue #1017 Issue #989
2014-01-08 14:01:26 +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
# Hide archive dependencies of shared libraries from users of the shared
# library. Library users examine the 'DEP_A_<lib>' variable to determine
# transitive dependencies. For shared libraries, this variable remains
# undefined.
base: Do not link base libs against shared libs Base libraries are already contained within ldso.lib.so. Remove unnecessary filtering from 'dep_lib.mk', make ldso depend on base libs. Issue #1017 Issue #989
2014-01-08 14:01:26 +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
ifdef SHARED_LIB
mk: don't link transitive shared-lib dependencies This patch applies the existing "privatization" of transitive shared-library dependencies from static lib dependencies to shared lib dependencies. It thereby improves the consistency of binaries created in a regular build directory with binaries created in depot archives. Issue #4408
2022-02-08 15:14:27 +00:00
DEP_A_VAR_NAME := PRIVATE_DEP_A_$(LIB)
DEP_SO_VAR_NAME := PRIVATE_DEP_SO_$(LIB)
Imported Genode release 11.11
2011-12-22 15:19:25 +00:00
else
mk: don't link transitive shared-lib dependencies This patch applies the existing "privatization" of transitive shared-library dependencies from static lib dependencies to shared lib dependencies. It thereby improves the consistency of binaries created in a regular build directory with binaries created in depot archives. Issue #4408
2022-02-08 15:14:27 +00:00
DEP_A_VAR_NAME := DEP_A_$(LIB)
DEP_SO_VAR_NAME := DEP_SO_$(LIB)
Imported Genode release 11.11
2011-12-22 15:19:25 +00:00
endif
#
# Check if the requirements of the target are satisfied
#
UNSATISFIED_REQUIREMENTS = $(filter-out $(SPECS),$(REQUIRES))
ifneq ($(UNSATISFIED_REQUIREMENTS),)
check_unsatisfied_requirements: warn_unsatisfied_requirements
else
check_unsatisfied_requirements: generate_lib_rule
endif
warn_unsatisfied_requirements: generate_lib_rule_for_defect_library
@$(ECHO) "Skip library $(LIB) because it requires $(DARK_COL)$(UNSATISFIED_REQUIREMENTS)$(DEFAULT_COL)"
generate_lib_rule_for_defect_library:
@echo "INVALID_DEPS += $(LIB)" >> $(LIB_DEP_FILE)
@echo "" >> $(LIB_DEP_FILE)
LIBS_TO_VISIT = $(filter-out $(LIBS_READY),$(LIBS))
generate_lib_rule:
toolchain: report missing ports at once Previously, ports that were needed for a scenario and that were not prepared or outdated, triggered one assertion each during the second build stage. The commit slots a mechanism in ahead that gathers all these ports during the first build stage and reports them in form of a list before the second build stage is entered. This list can be used directly as argument for tool/ports/prepare_port to prepare respectively update the ports. If, however, this mechanism is not available, for example because a target is build without the first build stage, the old assertion still prevents the target from running into troubles with a missing port. Fixes #1872
2016-02-04 11:20:03 +00:00
ifneq ($(DEP_MISSING_PORTS),)
@(echo "MISSING_PORTS += $(DEP_MISSING_PORTS)"; \
echo "") >> $(LIB_DEP_FILE)
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
endif
@for i in $(LIBS_TO_VISIT); do \
$(MAKE) $(VERBOSE_DIR) -f $(BASE_DIR)/mk/dep_lib.mk REP_DIR=$(REP_DIR) LIB=$$i; done
ifneq ($(LIBS),)
mk: don't link transitive shared-lib dependencies This patch applies the existing "privatization" of transitive shared-library dependencies from static lib dependencies to shared lib dependencies. It thereby improves the consistency of binaries created in a regular build directory with binaries created in depot archives. Issue #4408
2022-02-08 15:14:27 +00:00
@(echo "$(DEP_A_VAR_NAME) = $(foreach l,$(LIBS),\$${ARCHIVE_NAME($l)} \$$(DEP_A_$l))"; \
echo "$(DEP_SO_VAR_NAME) = $(foreach l,$(LIBS),\$${SO_NAME($l)} \$$(DEP_SO_$l))"; \
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
echo "") >> $(LIB_DEP_FILE)
toolchain: report missing ports at once Previously, ports that were needed for a scenario and that were not prepared or outdated, triggered one assertion each during the second build stage. The commit slots a mechanism in ahead that gathers all these ports during the first build stage and reports them in form of a list before the second build stage is entered. This list can be used directly as argument for tool/ports/prepare_port to prepare respectively update the ports. If, however, this mechanism is not available, for example because a target is build without the first build stage, the old assertion still prevents the target from running into troubles with a missing port. Fixes #1872
2016-02-04 11:20:03 +00:00
endif
@(echo "$(LIB).lib: check_ports $(addsuffix .lib,$(LIBS))"; \
Imported Genode release 11.11
2011-12-22 15:19:25 +00:00
echo " @\$$(MKDIR) -p \$$(LIB_CACHE_DIR)/$(LIB)"; \
echo " \$$(VERBOSE_MK)\$$(MAKE) $(VERBOSE_DIR) -C \$$(LIB_CACHE_DIR)/$(LIB) -f \$$(BASE_DIR)/mk/lib.mk \\"; \
echo " REP_DIR=$(REP_DIR) \\"; \
echo " LIB_MK=$(LIB_MK) \\"; \
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
echo " SYMBOLS=$(SYMBOLS) \\"; \
Imported Genode release 11.11
2011-12-22 15:19:25 +00:00
echo " LIB=$(LIB) \\"; \
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
echo " ARCHIVES=\"\$$(sort \$$($(DEP_A_VAR_NAME)))\" \\"; \
mk: don't link transitive shared-lib dependencies This patch applies the existing "privatization" of transitive shared-library dependencies from static lib dependencies to shared lib dependencies. It thereby improves the consistency of binaries created in a regular build directory with binaries created in depot archives. Issue #4408
2022-02-08 15:14:27 +00:00
echo " SHARED_LIBS=\"\$$(sort \$$($(DEP_SO_VAR_NAME)))\" \\"; \
Imported Genode release 11.11
2011-12-22 15:19:25 +00:00
echo " BUILD_BASE_DIR=$(BUILD_BASE_DIR) \\"; \
echo " SHELL=$(SHELL) \\"; \
mk: strip binaries at <build-dir>/bin/ The <build-dir>/bin/ directory used to contain symbolic links to the unstripped build results. However, since the upcoming depot tool extracts the content of binary archives from bin/, the resulting archives would contain overly large unstripped binaries, which is undesired. On the other hand, always stripping the build results is not a good option either because we rely of symbol information during debugging. This patch changes the installation of build results such that a new 'debug/' directory is populated besides the existing 'bin/' directory. The debug directory contains symbolic links to the unstripped build results whereas the bin directory contains stripped binaries that are palatable for packaging (depot tool) and for assembling boot images (run tool).
2017-04-05 14:51:47 +00:00
echo " INSTALL_DIR=\$$(INSTALL_DIR) \\"; \
echo " DEBUG_DIR=\$$(DEBUG_DIR)"; \
Imported Genode release 11.11
2011-12-22 15:19:25 +00:00
echo "") >> $(LIB_DEP_FILE)
ifdef SHARED_LIB
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
@(echo "SO_NAME($(LIB)) := $(LIB).lib.so"; \
echo "") >> $(LIB_DEP_FILE)
else
@(echo "ARCHIVE_NAME($(LIB)) := $(LIB).lib.a"; \
Imported Genode release 11.11
2011-12-22 15:19:25 +00:00
echo "") >> $(LIB_DEP_FILE)
endif
Reference in New Issue Copy Permalink