| |
| # modules |
| # |
| # args: |
| # MODULE : module name (required) |
| # MODULE_SRCS : list of source files, local path (required) |
| # MODULE_DEPS : other modules that this one depends on |
| # MODULE_DEFINES : #defines local to this module |
| # MODULE_OPTFLAGS : OPTFLAGS local to this module |
| # MODULE_COMPILEFLAGS : COMPILEFLAGS local to this module |
| # MODULE_CFLAGS : CFLAGS local to this module |
| # MODULE_CPPFLAGS : CPPFLAGS local to this module |
| # MODULE_ASMFLAGS : ASMFLAGS local to this module |
| # MODULE_RUSTFLAGS : RUSTFLAGS local to this module |
| # MODULE_RUSTDOCFLAGS : RUSTDOCFLAGS local to this module |
| # MODULE_RUSTDOC_OBJECT : marker file to use as target when building Rust docs |
| # MODULE_INCLUDES : include directories local to this module |
| # MODULE_SRCDEPS : extra dependencies that all of this module's files depend on |
| # MODULE_EXTRA_ARCHIVES : extra .a files that should be linked with the module |
| # MODULE_EXTRA_OBJS : extra .o files that should be linked with the module |
| # MODULE_DISABLE_LTO : disable LTO for this module |
| # MODULE_DISABLE_CFI : disable CFI for this module |
| # MODULE_DISABLE_STACK_PROTECTOR : disable stack protector for this module |
| # MODULE_DISABLE_SCS : disable shadow call stack for this module |
| # MODULE_SKIP_DOCS : skip generating docs for this module |
| |
| # MODULE_ARM_OVERRIDE_SRCS : list of source files, local path that should be force compiled with ARM (if applicable) |
| |
| # the minimum module rules.mk file is as follows: |
| # |
| # LOCAL_DIR := $(GET_LOCAL_DIR) |
| # MODULE := $(LOCAL_DIR) |
| # |
| # MODULE_SRCS := $(LOCAL_DIR)/at_least_one_source_file.c |
| # |
| # include make/module.mk |
| |
| # test for old style rules.mk |
| ifneq ($(MODULE_OBJS),) |
| $(warning MODULE_OBJS = $(MODULE_OBJS)) |
| $(error MODULE $(MODULE) is setting MODULE_OBJS, change to MODULE_SRCS) |
| endif |
| ifneq ($(OBJS),) |
| $(warning OBJS = $(OBJS)) |
| $(error MODULE $(MODULE) is probably setting OBJS, change to MODULE_SRCS) |
| endif |
| |
| ifeq ($(call TOBOOL,$(TRUSTY_NEW_MODULE_SYSTEM)),true) |
| $(error MODULE $(MODULE) was included through the new module system and therefore must include library.mk or trusted_app.mk) |
| endif |
| |
| MODULE_SRCDIR := $(MODULE) |
| MODULE_BUILDDIR := $(call TOBUILDDIR,$(MODULE_SRCDIR)) |
| |
| # add a local include dir to the global include path |
| GLOBAL_INCLUDES += $(MODULE_SRCDIR)/include |
| |
| # add the listed module deps to the global list |
| MODULES += $(MODULE_DEPS) |
| |
| #$(info module $(MODULE)) |
| #$(info MODULE_SRCDIR $(MODULE_SRCDIR)) |
| #$(info MODULE_BUILDDIR $(MODULE_BUILDDIR)) |
| #$(info MODULE_DEPS $(MODULE_DEPS)) |
| #$(info MODULE_SRCS $(MODULE_SRCS)) |
| |
| # Turn spaces into underscores and escape quotes for the module_config.h header |
| define clean_defines |
| $(subst $(SPACE),_,$(subst \",\\\\\",$(1))) |
| endef |
| |
| MODULE_DEFINES += MODULE_COMPILEFLAGS=\"$(call clean_defines,$(MODULE_COMPILEFLAGS))\" |
| MODULE_DEFINES += MODULE_CFLAGS=\"$(call clean_defines,$(MODULE_CFLAGS))\" |
| MODULE_DEFINES += MODULE_CPPFLAGS=\"$(call clean_defines,$(MODULE_CPPFLAGS))\" |
| MODULE_DEFINES += MODULE_ASMFLAGS=\"$(call clean_defines,$(MODULE_ASMFLAGS))\" |
| MODULE_DEFINES += MODULE_RUSTFLAGS=\"$(call clean_defines,$(MODULE_RUSTFLAGS))\" |
| MODULE_DEFINES += MODULE_RUSTDOCFLAGS=\"$(call clean_defines,$(MODULE_RUSTDOCFLAGS))\" |
| MODULE_DEFINES += MODULE_RUST_ENV=\"$(call clean_defines,$(MODULE_RUST_ENV))\" |
| MODULE_DEFINES += MODULE_LDFLAGS=\"$(call clean_defines,$(MODULE_LDFLAGS))\" |
| MODULE_DEFINES += MODULE_OPTFLAGS=\"$(call clean_defines,$(MODULE_OPTFLAGS))\" |
| MODULE_DEFINES += MODULE_INCLUDES=\"$(call clean_defines,$(MODULE_INCLUDES))\" |
| MODULE_DEFINES += MODULE_SRCDEPS=\"$(call clean_defines,$(MODULE_SRCDEPS))\" |
| MODULE_DEFINES += MODULE_DEPS=\"$(call clean_defines,$(MODULE_DEPS))\" |
| MODULE_DEFINES += MODULE_SRCS=\"$(call clean_defines,$(MODULE_SRCS))\" |
| |
| # Handle common kernel module flags. Common userspace flags are found in |
| # user/base/make/common_flags.mk |
| ifneq (true,$(call TOBOOL,$(USER_TASK_MODULE))) |
| |
| # LTO |
| ifneq (true,$(call TOBOOL,$(MODULE_DISABLE_LTO))) |
| ifeq (true,$(call TOBOOL,$(KERNEL_LTO_ENABLED))) |
| MODULE_COMPILEFLAGS += $(GLOBAL_LTO_COMPILEFLAGS) |
| |
| # CFI |
| MODULE_CFI_ENABLED := false |
| ifneq (true,$(call TOBOOL,$(MODULE_DISABLE_CFI))) |
| ifeq (true,$(call TOBOOL,$(CFI_ENABLED))) |
| MODULE_CFI_ENABLED := true |
| endif |
| |
| ifdef KERNEL_CFI_ENABLED |
| MODULE_CFI_ENABLED := $(call TOBOOL,$(KERNEL_CFI_ENABLED)) |
| endif |
| |
| endif |
| |
| ifeq (true,$(call TOBOOL,$(MODULE_CFI_ENABLED))) |
| MODULE_COMPILEFLAGS += \ |
| -fsanitize-blacklist=trusty/kernel/lib/ubsan/exemptlist \ |
| -fsanitize=cfi \ |
| -DCFI_ENABLED |
| |
| MODULES += trusty/kernel/lib/ubsan |
| |
| ifeq (true,$(call TOBOOL,$(CFI_DIAGNOSTICS))) |
| MODULE_COMPILEFLAGS += -fno-sanitize-trap=cfi |
| endif |
| endif |
| |
| endif |
| endif |
| |
| # Shadow call stack |
| ifeq (true,$(call TOBOOL,$(SCS_ENABLED))) |
| # set in arch/$(ARCH)/toolchain.mk iff shadow call stack is supported |
| ifeq (false,$(call TOBOOL,$(ARCH_$(ARCH)_SUPPORTS_SCS))) |
| $(error Error: Shadow call stack is not supported for $(ARCH)) |
| endif |
| |
| ifeq (false,$(call TOBOOL,$(MODULE_DISABLE_SCS))) |
| # architectures that support SCS should set the flag that reserves |
| # a register for the shadow call stack in their toolchain.mk file |
| MODULE_COMPILEFLAGS += \ |
| -fsanitize=shadow-call-stack \ |
| |
| endif |
| endif |
| |
| endif |
| |
| # Rebuild every module if the toolchain changes |
| MODULE_SRCDEPS += $(TOOLCHAIN_CONFIG) |
| |
| # generate a per-module config.h file |
| ifeq ($(call TOBOOL,$(MODULE_IS_RUST)),false) |
| MODULE_CONFIG := $(MODULE_BUILDDIR)/module_config.h |
| |
| $(MODULE_CONFIG): MODULE_DEFINES:=$(MODULE_DEFINES) |
| $(MODULE_CONFIG): configheader |
| @$(call MAKECONFIGHEADER,$@,MODULE_DEFINES) |
| |
| GENERATED += $(MODULE_CONFIG) |
| |
| MODULE_COMPILEFLAGS += --include $(MODULE_CONFIG) |
| |
| MODULE_SRCDEPS += $(MODULE_CONFIG) |
| endif |
| |
| MODULE_INCLUDES := $(addprefix -I,$(MODULE_INCLUDES)) |
| |
| # include the rules to compile the module's object files |
| include make/compile.mk |
| |
| # MODULE_OBJS is passed back from compile.mk |
| #$(info MODULE_OBJS = $(MODULE_OBJS)) |
| |
| ifeq ($(call TOBOOL,$(MODULE_IS_RUST)),true) |
| # Build Rust sources |
| $(addsuffix .d,$(MODULE_RSOBJS)): |
| |
| MODULE_RSSRC := $(filter %.rs,$(MODULE_SRCS)) |
| $(MODULE_RSOBJS): $(MODULE_RSSRC) $(MODULE_SRCDEPS) $(MODULE_EXTRA_OBJECTS) $(MODULE_LIBRARIES) $(addsuffix .d,$(MODULE_RSOBJS)) |
| @$(MKDIR) |
| @echo compiling rust module $< |
| $(NOECHO)$(MODULE_RUST_ENV) $(RUSTC) $(GLOBAL_RUSTFLAGS) $(ARCH_RUSTFLAGS) $(MODULE_RUSTFLAGS) $< --emit "dep-info=$@.d" -o $@ |
| |
| ifneq ($(call TOBOOL,$(MODULE_SKIP_DOCS)),true) |
| |
| # Pass rustdoc the same flags as rustc such that the generated documentation |
| # matches the code that gets compiled and run. Note: $(GLOBAL_RUSTFLAGS) adds |
| # $(TRUSTY_HOST_LIBRARY_BUILDDIR) to the library search path. This is necessary |
| # to pick up dependencies that are proc macros and thus built in the host dir. |
| $(MODULE_RUSTDOC_OBJECT): $(MODULE_RSSRC) | $(MODULE_RSOBJS) |
| @$(MKDIR) |
| @echo "generating documentation for $(MODULE_CRATE_NAME)" |
| $(NOECHO)$(MODULE_RUST_ENV) $(RUSTDOC) $(GLOBAL_RUSTFLAGS) $(ARCH_RUSTFLAGS) $(MODULE_RUSTDOCFLAGS) -L $(TRUSTY_LIBRARY_BUILDDIR) --out-dir $(MODULE_RUSTDOC_OUT_DIR) $< |
| touch $@ |
| |
| EXTRA_BUILDDEPS += $(MODULE_RUSTDOC_OBJECT) |
| |
| endif |
| |
| -include $(addsuffix .d,$(MODULE_RSOBJS)) |
| |
| MODULE_OBJECT := $(MODULE_RSOBJS) |
| |
| else |
| # Archive the module's object files into a static library. |
| MODULE_OBJECT := $(call TOBUILDDIR,$(MODULE_SRCDIR).mod.a) |
| $(MODULE_OBJECT): $(MODULE_OBJS) $(MODULE_EXTRA_OBJS) |
| @$(MKDIR) |
| @echo creating $@ |
| $(NOECHO)rm -f $@ |
| $(NOECHO)$(AR) rcs $@ $^ |
| |
| endif |
| |
| # track the module object for make clean |
| GENERATED += $(MODULE_OBJECT) |
| |
| # make the rest of the build depend on our output |
| ALLMODULE_OBJS := $(MODULE_INIT_OBJS) $(ALLMODULE_OBJS) $(MODULE_OBJECT) $(MODULE_EXTRA_ARCHIVES) |
| |
| # track all of the source files compiled |
| ALLSRCS += $(MODULE_SRCS_FIRST) $(MODULE_SRCS) |
| |
| # track all the objects built |
| ALLOBJS += $(MODULE_INIT_OBJS) $(MODULE_OBJS) |
| |
| # empty out any vars set here |
| MODULE := |
| MODULE_SRCDIR := |
| MODULE_BUILDDIR := |
| MODULE_DEPS := |
| MODULE_SRCS := |
| MODULE_OBJS := |
| MODULE_DEFINES := |
| MODULE_OPTFLAGS := |
| MODULE_COMPILEFLAGS := |
| MODULE_CFLAGS := |
| MODULE_CPPFLAGS := |
| MODULE_ASMFLAGS := |
| MODULE_RUSTFLAGS := |
| MODULE_RUSTDOCFLAGS := |
| MODULE_SRCDEPS := |
| MODULE_INCLUDES := |
| MODULE_EXTRA_ARCHIVES := |
| MODULE_EXTRA_OBJS := |
| MODULE_CONFIG := |
| MODULE_OBJECT := |
| MODULE_ARM_OVERRIDE_SRCS := |
| MODULE_SRCS_FIRST := |
| MODULE_INIT_OBJS := |
| MODULE_DISABLE_LTO := |
| MODULE_LTO_ENABLED := |
| MODULE_DISABLE_CFI := |
| MODULE_DISABLE_STACK_PROTECTOR := |
| MODULE_DISABLE_SCS := |
| MODULE_RSOBJS := |
| MODULE_RUSTDOC_OBJECT := |
| MODULE_SKIP_DOCS := |
