1b2441318SGreg Kroah-Hartman# SPDX-License-Identifier: GPL-2.0 21da177e4SLinus Torvalds# =========================================================================== 31da177e4SLinus Torvalds# Module versions 41da177e4SLinus Torvalds# =========================================================================== 51da177e4SLinus Torvalds# 61da177e4SLinus Torvalds# Stage one of module building created the following: 71da177e4SLinus Torvalds# a) The individual .o files used for the module 8c30fe7f7SUwe Zeisberger# b) A <module>.o file which is the .o files above linked together 9b7dca6ddSMasahiro Yamada# c) A <module>.mod file, listing the name of the preliminary <module>.o file, 10b7dca6ddSMasahiro Yamada# plus all .o files 11ff9b45c5SMasahiro Yamada# d) modules.order, which lists all the modules 121da177e4SLinus Torvalds 131da177e4SLinus Torvalds# Stage 2 is handled by this file and does the following 14ff9b45c5SMasahiro Yamada# 1) Find all modules listed in modules.order 151da177e4SLinus Torvalds# 2) modpost is then used to 161da177e4SLinus Torvalds# 3) create one <module>.mod.c file pr. module 171da177e4SLinus Torvalds# 4) create one Module.symvers file with CRC for all exported symbols 181da177e4SLinus Torvalds 191da177e4SLinus Torvalds# Step 3 is used to place certain information in the module's ELF 201da177e4SLinus Torvalds# section, including information such as: 21163d3fe6SGeert Uytterhoeven# Version magic (see include/linux/vermagic.h for full details) 221da177e4SLinus Torvalds# - Kernel release 231da177e4SLinus Torvalds# - SMP is CONFIG_SMP 244b950bb9SThomas Gleixner# - PREEMPT is CONFIG_PREEMPT[_RT] 251da177e4SLinus Torvalds# - GCC Version 261da177e4SLinus Torvalds# Module info 271da177e4SLinus Torvalds# - Module version (MODULE_VERSION) 281da177e4SLinus Torvalds# - Module alias'es (MODULE_ALIAS) 291da177e4SLinus Torvalds# - Module license (MODULE_LICENSE) 301da177e4SLinus Torvalds# - See include/linux/module.h for more details 311da177e4SLinus Torvalds 321da177e4SLinus Torvalds# Step 4 is solely used to allow module versioning in external modules, 334696e295SUwe Kleine-König# where the CRC of each module is retrieved from the Module.symvers file. 341da177e4SLinus Torvalds 35ea837f1cSSam Ravnborg# KBUILD_MODPOST_NOFINAL can be set to skip the final link of modules. 3625985edcSLucas De Marchi# This is solely useful to speed up test compiles 37a721588dSMasahiro Yamada 38a721588dSMasahiro YamadaPHONY := __modpost 39a721588dSMasahiro Yamada__modpost: 401da177e4SLinus Torvalds 41c955ccafSRoman Zippelinclude include/config/auto.conf 423204a7fbSMasahiro Yamadainclude $(srctree)/scripts/Kbuild.include 430d96fb20SRichard Hacker 44dc5723b0SSami Tolvanen# for ld_flags 453204a7fbSMasahiro Yamadainclude $(srctree)/scripts/Makefile.lib 46dc5723b0SSami Tolvanen 47a721588dSMasahiro YamadaMODPOST = scripts/mod/modpost \ 48a721588dSMasahiro Yamada $(if $(CONFIG_MODVERSIONS),-m) \ 49a721588dSMasahiro Yamada $(if $(CONFIG_MODULE_SRCVERSION_ALL),-a) \ 50a721588dSMasahiro Yamada $(if $(CONFIG_SECTION_MISMATCH_WARN_ONLY),,-E) \ 51bcfedae7SMasahiro Yamada -o $@ 52a721588dSMasahiro Yamada 53a721588dSMasahiro Yamadaifdef MODPOST_VMLINUX 54a721588dSMasahiro Yamada 55bcfedae7SMasahiro Yamadaquiet_cmd_modpost = MODPOST $@ 56bcfedae7SMasahiro Yamada cmd_modpost = $(MODPOST) $< 57a721588dSMasahiro Yamada 58269a535cSMasahiro Yamadavmlinux.symvers: vmlinux.o 59a721588dSMasahiro Yamada $(call cmd,modpost) 60a721588dSMasahiro Yamada 61269a535cSMasahiro Yamada__modpost: vmlinux.symvers 62bcfedae7SMasahiro Yamada 63a721588dSMasahiro Yamadaelse 64a721588dSMasahiro Yamada 651747269aSMasahiro Yamadaifeq ($(KBUILD_EXTMOD),) 66269a535cSMasahiro Yamada 67269a535cSMasahiro Yamadainput-symdump := vmlinux.symvers 6869bc8d38SMasahiro Yamadaoutput-symdump := modules-only.symvers 6969bc8d38SMasahiro Yamada 7069bc8d38SMasahiro Yamadaquiet_cmd_cat = GEN $@ 7169bc8d38SMasahiro Yamada cmd_cat = cat $(real-prereqs) > $@ 7269bc8d38SMasahiro Yamada 7369bc8d38SMasahiro Yamadaifneq ($(wildcard vmlinux.symvers),) 7469bc8d38SMasahiro Yamada 7569bc8d38SMasahiro Yamada__modpost: Module.symvers 7669bc8d38SMasahiro YamadaModule.symvers: vmlinux.symvers modules-only.symvers FORCE 7769bc8d38SMasahiro Yamada $(call if_changed,cat) 7869bc8d38SMasahiro Yamada 7969bc8d38SMasahiro Yamadatargets += Module.symvers 8069bc8d38SMasahiro Yamada 8169bc8d38SMasahiro Yamadaendif 82bcfedae7SMasahiro Yamada 831747269aSMasahiro Yamadaelse 8496d97f26SSam Ravnborg 85fab546e6SMasahiro Yamada# set src + obj - they may be used in the modules's Makefile 8696d97f26SSam Ravnborgobj := $(KBUILD_EXTMOD) 8796d97f26SSam Ravnborgsrc := $(obj) 8896d97f26SSam Ravnborg 890d96fb20SRichard Hacker# Include the module's Makefile to find KBUILD_EXTRA_SYMBOLS 900d96fb20SRichard Hackerinclude $(if $(wildcard $(KBUILD_EXTMOD)/Kbuild), \ 910d96fb20SRichard Hacker $(KBUILD_EXTMOD)/Kbuild, $(KBUILD_EXTMOD)/Makefile) 92e3fb4df7SMasahiro Yamada 93e3fb4df7SMasahiro Yamada# modpost option for external modules 94e3fb4df7SMasahiro YamadaMODPOST += -e 95e3fb4df7SMasahiro Yamada 96f1005b30SMasahiro Yamadainput-symdump := Module.symvers $(KBUILD_EXTRA_SYMBOLS) 97bcfedae7SMasahiro Yamadaoutput-symdump := $(KBUILD_EXTMOD)/Module.symvers 98bcfedae7SMasahiro Yamada 990d96fb20SRichard Hackerendif 1000d96fb20SRichard Hacker 101*4475dff5SMasahiro Yamadaexisting-input-symdump := $(wildcard $(input-symdump)) 102*4475dff5SMasahiro Yamada 1034e5ab74cSMasahiro Yamada# modpost options for modules (both in-kernel and external) 1044e5ab74cSMasahiro YamadaMODPOST += \ 105*4475dff5SMasahiro Yamada $(addprefix -i ,$(existing-input-symdump)) \ 106859c926aSMasahiro Yamada $(if $(KBUILD_NSDEPS),-d $(MODULES_NSDEPS)) \ 1074e5ab74cSMasahiro Yamada $(if $(CONFIG_MODULE_ALLOW_MISSING_NAMESPACE_IMPORTS)$(KBUILD_NSDEPS),-N) 1084e5ab74cSMasahiro Yamada 10991e6ee58SMasahiro Yamada# 'make -i -k' ignores compile errors, and builds as many modules as possible. 11091e6ee58SMasahiro Yamadaifneq ($(findstring i,$(filter-out --%,$(MAKEFLAGS))),) 11191e6ee58SMasahiro YamadaMODPOST += -n 11291e6ee58SMasahiro Yamadaendif 11391e6ee58SMasahiro Yamada 11448a0f727SMasahiro Yamada# Clear VPATH to not search for *.symvers in $(srctree). Check only $(objtree). 11548a0f727SMasahiro YamadaVPATH := 116436b2ac6SMasahiro Yamada$(input-symdump): 11748a0f727SMasahiro Yamada @echo >&2 'WARNING: Symbol version dump "$@" is missing.' 11848a0f727SMasahiro Yamada @echo >&2 ' Modules may not have dependencies or modversions.' 119*4475dff5SMasahiro Yamada @echo >&2 ' You may get many unresolved symbol warnings.' 120436b2ac6SMasahiro Yamada 121dc5723b0SSami Tolvanenifdef CONFIG_LTO_CLANG 122dc5723b0SSami Tolvanen# With CONFIG_LTO_CLANG, .o files might be LLVM bitcode, so we need to run 123dc5723b0SSami Tolvanen# LTO to compile them into native code before running modpost 124dc5723b0SSami Tolvanenprelink-ext := .lto 125dc5723b0SSami Tolvanen 126dc5723b0SSami Tolvanenquiet_cmd_cc_lto_link_modules = LTO [M] $@ 12738e89184SSami Tolvanencmd_cc_lto_link_modules = \ 12838e89184SSami Tolvanen $(LD) $(ld_flags) -r -o $@ \ 12938e89184SSami Tolvanen $(shell [ -s $(@:.lto.o=.o.symversions) ] && \ 13038e89184SSami Tolvanen echo -T $(@:.lto.o=.o.symversions)) \ 13138e89184SSami Tolvanen --whole-archive $^ 132dc5723b0SSami Tolvanen 133dc5723b0SSami Tolvanen%.lto.o: %.o 134dc5723b0SSami Tolvanen $(call if_changed,cc_lto_link_modules) 135dc5723b0SSami Tolvanenendif 136dc5723b0SSami Tolvanen 137dc5723b0SSami Tolvanenmodules := $(sort $(shell cat $(MODORDER))) 138dc5723b0SSami Tolvanen 1395ab70ff4SMasahiro Yamada# KBUILD_MODPOST_WARN can be set to avoid error out in case of undefined symbols 140*4475dff5SMasahiro Yamadaifneq ($(KBUILD_MODPOST_WARN)$(filter-out $(existing-input-symdump), $(input-symdump)),) 1415ab70ff4SMasahiro YamadaMODPOST += -w 1425ab70ff4SMasahiro Yamadaendif 1435ab70ff4SMasahiro Yamada 144bcfedae7SMasahiro Yamada# Read out modules.order to pass in modpost. 1459b9a3f20SMasahiro Yamada# Otherwise, allmodconfig would fail with "Argument list too long". 146bcfedae7SMasahiro Yamadaquiet_cmd_modpost = MODPOST $@ 147dc5723b0SSami Tolvanen cmd_modpost = sed 's/\.ko$$/$(prelink-ext)\.o/' $< | $(MODPOST) -T - 1488d8d8289SSam Ravnborg 149dc5723b0SSami Tolvanen$(output-symdump): $(MODORDER) $(input-symdump) $(modules:.ko=$(prelink-ext).o) FORCE 150436b2ac6SMasahiro Yamada $(call if_changed,modpost) 151436b2ac6SMasahiro Yamada 152436b2ac6SMasahiro Yamadatargets += $(output-symdump) 153bcfedae7SMasahiro Yamada 154bcfedae7SMasahiro Yamada__modpost: $(output-symdump) 1559b9a3f20SMasahiro Yamadaifneq ($(KBUILD_MODPOST_NOFINAL),1) 1569b9a3f20SMasahiro Yamada $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modfinal 1579b9a3f20SMasahiro Yamadaendif 1584f193362SPaul Smith 159bcfedae7SMasahiro YamadaPHONY += FORCE 160bcfedae7SMasahiro YamadaFORCE: 161bcfedae7SMasahiro Yamada 162436b2ac6SMasahiro Yamadaexisting-targets := $(wildcard $(sort $(targets))) 163436b2ac6SMasahiro Yamada 164436b2ac6SMasahiro Yamada-include $(foreach f,$(existing-targets),$(dir $(f)).$(notdir $(f)).cmd) 165436b2ac6SMasahiro Yamada 166a721588dSMasahiro Yamadaendif 167a721588dSMasahiro Yamada 1684f193362SPaul Smith.PHONY: $(PHONY) 169