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_WARN can be set to avoid error out in case of undefined 36ea837f1cSSam Ravnborg# symbols in the final module linking stage 37ea837f1cSSam Ravnborg# KBUILD_MODPOST_NOFINAL can be set to skip the final link of modules. 3825985edcSLucas De Marchi# This is solely useful to speed up test compiles 39a721588dSMasahiro Yamada 40a721588dSMasahiro YamadaPHONY := __modpost 41a721588dSMasahiro Yamada__modpost: 421da177e4SLinus Torvalds 43c955ccafSRoman Zippelinclude include/config/auto.conf 448ec4b4ffSSam Ravnborginclude scripts/Kbuild.include 450d96fb20SRichard Hacker 46a721588dSMasahiro YamadaMODPOST = scripts/mod/modpost \ 47a721588dSMasahiro Yamada $(if $(CONFIG_MODVERSIONS),-m) \ 48a721588dSMasahiro Yamada $(if $(CONFIG_MODULE_SRCVERSION_ALL),-a) \ 49a721588dSMasahiro Yamada $(if $(CONFIG_SECTION_MISMATCH_WARN_ONLY),,-E) \ 50bcfedae7SMasahiro Yamada $(if $(KBUILD_MODPOST_WARN),-w) \ 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 6589d61176SMasahiro YamadaMODPOST += -s \ 66bc35d4bdSMasahiro Yamada $(if $(KBUILD_NSDEPS),-d $(MODULES_NSDEPS)) 671747269aSMasahiro Yamada 681747269aSMasahiro Yamadaifeq ($(KBUILD_EXTMOD),) 69269a535cSMasahiro Yamada 70269a535cSMasahiro Yamadainput-symdump := vmlinux.symvers 71bcfedae7SMasahiro Yamadaoutput-symdump := Module.symvers 72bcfedae7SMasahiro Yamada 731747269aSMasahiro Yamadaelse 7496d97f26SSam Ravnborg 75fab546e6SMasahiro Yamada# set src + obj - they may be used in the modules's Makefile 7696d97f26SSam Ravnborgobj := $(KBUILD_EXTMOD) 7796d97f26SSam Ravnborgsrc := $(obj) 7896d97f26SSam Ravnborg 790d96fb20SRichard Hacker# Include the module's Makefile to find KBUILD_EXTRA_SYMBOLS 800d96fb20SRichard Hackerinclude $(if $(wildcard $(KBUILD_EXTMOD)/Kbuild), \ 810d96fb20SRichard Hacker $(KBUILD_EXTMOD)/Kbuild, $(KBUILD_EXTMOD)/Makefile) 82e3fb4df7SMasahiro Yamada 83e3fb4df7SMasahiro Yamada# modpost option for external modules 84e3fb4df7SMasahiro YamadaMODPOST += -e 85e3fb4df7SMasahiro Yamada 86f1005b30SMasahiro Yamadainput-symdump := Module.symvers $(KBUILD_EXTRA_SYMBOLS) 87bcfedae7SMasahiro Yamadaoutput-symdump := $(KBUILD_EXTMOD)/Module.symvers 88bcfedae7SMasahiro Yamada 890d96fb20SRichard Hackerendif 900d96fb20SRichard Hacker 914e5ab74cSMasahiro Yamada# modpost options for modules (both in-kernel and external) 924e5ab74cSMasahiro YamadaMODPOST += \ 93436b2ac6SMasahiro Yamada $(addprefix -i ,$(wildcard $(input-symdump))) \ 944e5ab74cSMasahiro Yamada $(if $(CONFIG_MODULE_ALLOW_MISSING_NAMESPACE_IMPORTS)$(KBUILD_NSDEPS),-N) 954e5ab74cSMasahiro Yamada 9691e6ee58SMasahiro Yamada# 'make -i -k' ignores compile errors, and builds as many modules as possible. 9791e6ee58SMasahiro Yamadaifneq ($(findstring i,$(filter-out --%,$(MAKEFLAGS))),) 9891e6ee58SMasahiro YamadaMODPOST += -n 9991e6ee58SMasahiro Yamadaendif 10091e6ee58SMasahiro Yamada 10148a0f727SMasahiro Yamada# Clear VPATH to not search for *.symvers in $(srctree). Check only $(objtree). 10248a0f727SMasahiro YamadaVPATH := 103436b2ac6SMasahiro Yamada$(input-symdump): 10448a0f727SMasahiro Yamada @echo >&2 'WARNING: Symbol version dump "$@" is missing.' 10548a0f727SMasahiro Yamada @echo >&2 ' Modules may not have dependencies or modversions.' 106436b2ac6SMasahiro Yamada 107bcfedae7SMasahiro Yamada# Read out modules.order to pass in modpost. 1089b9a3f20SMasahiro Yamada# Otherwise, allmodconfig would fail with "Argument list too long". 109bcfedae7SMasahiro Yamadaquiet_cmd_modpost = MODPOST $@ 110436b2ac6SMasahiro Yamada cmd_modpost = sed 's/ko$$/o/' $< | $(MODPOST) -T - 1118d8d8289SSam Ravnborg 112436b2ac6SMasahiro Yamada$(output-symdump): $(MODORDER) $(input-symdump) FORCE 113436b2ac6SMasahiro Yamada $(call if_changed,modpost) 114436b2ac6SMasahiro Yamada 115436b2ac6SMasahiro Yamadatargets += $(output-symdump) 116bcfedae7SMasahiro Yamada 117bcfedae7SMasahiro Yamada__modpost: $(output-symdump) 1189b9a3f20SMasahiro Yamadaifneq ($(KBUILD_MODPOST_NOFINAL),1) 1199b9a3f20SMasahiro Yamada $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modfinal 1209b9a3f20SMasahiro Yamadaendif 1214f193362SPaul Smith 122bcfedae7SMasahiro YamadaPHONY += FORCE 123bcfedae7SMasahiro YamadaFORCE: 124bcfedae7SMasahiro Yamada 125436b2ac6SMasahiro Yamadaexisting-targets := $(wildcard $(sort $(targets))) 126436b2ac6SMasahiro Yamada 127436b2ac6SMasahiro Yamada-include $(foreach f,$(existing-targets),$(dir $(f)).$(notdir $(f)).cmd) 128436b2ac6SMasahiro Yamada 129436b2ac6SMasahiro YamadaPHONY += FORCE 130436b2ac6SMasahiro YamadaFORCE: 131436b2ac6SMasahiro Yamada 132a721588dSMasahiro Yamadaendif 133a721588dSMasahiro Yamada 1344f193362SPaul Smith.PHONY: $(PHONY) 135