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 167c801446SRamji Jiyani# 3) create one <module>.mod.c file per 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 35a721588dSMasahiro YamadaPHONY := __modpost 36a721588dSMasahiro Yamada__modpost: 371da177e4SLinus Torvalds 38c955ccafSRoman Zippelinclude include/config/auto.conf 393204a7fbSMasahiro Yamadainclude $(srctree)/scripts/Kbuild.include 400d96fb20SRichard Hacker 413d57e1b7SMasahiro YamadaMODPOST = scripts/mod/modpost 423d57e1b7SMasahiro Yamada 4342593738SMasahiro Yamadamodpost-args = \ 44*481461f5SMasahiro Yamada $(if $(CONFIG_MODULES),-M) \ 45a721588dSMasahiro Yamada $(if $(CONFIG_MODVERSIONS),-m) \ 46a721588dSMasahiro Yamada $(if $(CONFIG_MODULE_SRCVERSION_ALL),-a) \ 47a721588dSMasahiro Yamada $(if $(CONFIG_SECTION_MISMATCH_WARN_ONLY),,-E) \ 48735aec59SMasahiro Yamada $(if $(KBUILD_MODPOST_WARN),-w) \ 49f73edc89SMasahiro Yamada $(if $(KBUILD_NSDEPS),-d $(MODULES_NSDEPS)) \ 50f73edc89SMasahiro Yamada $(if $(CONFIG_MODULE_ALLOW_MISSING_NAMESPACE_IMPORTS)$(KBUILD_NSDEPS),-N) \ 5120ff3685SMasahiro Yamada $(if $(findstring 1, $(KBUILD_EXTRA_WARN)),-W) \ 52bcfedae7SMasahiro Yamada -o $@ 53a721588dSMasahiro Yamada 543d57e1b7SMasahiro Yamadamodpost-deps := $(MODPOST) 553d57e1b7SMasahiro Yamada 56f73edc89SMasahiro Yamada# 'make -i -k' ignores compile errors, and builds as many modules as possible. 57f73edc89SMasahiro Yamadaifneq ($(findstring i,$(filter-out --%,$(MAKEFLAGS))),) 5842593738SMasahiro Yamadamodpost-args += -n 59f73edc89SMasahiro Yamadaendif 60a721588dSMasahiro Yamada 6163ffe00dSSamuel Holland# Read out modules.order to pass in modpost. 6263ffe00dSSamuel Holland# Otherwise, allmodconfig would fail with "Argument list too long". 6363ffe00dSSamuel Hollandifdef KBUILD_MODULES 6463ffe00dSSamuel Hollandmodpost-args += -T $(MODORDER) 6563ffe00dSSamuel Hollandmodpost-deps += $(MODORDER) 6663ffe00dSSamuel Hollandendif 6763ffe00dSSamuel Holland 68f73edc89SMasahiro Yamadaifeq ($(KBUILD_EXTMOD),) 69bcfedae7SMasahiro Yamada 7026ef40deSMasahiro Yamada# Generate the list of in-tree objects in vmlinux 7126ef40deSMasahiro Yamada# --------------------------------------------------------------------------- 7226ef40deSMasahiro Yamada 7326ef40deSMasahiro Yamada# This is used to retrieve symbol versions generated by genksyms. 7426ef40deSMasahiro Yamadaifdef CONFIG_MODVERSIONS 75f73edc89SMasahiro Yamadavmlinux.symvers Module.symvers: .vmlinux.objs 7626ef40deSMasahiro Yamadaendif 7726ef40deSMasahiro Yamada 7826ef40deSMasahiro Yamada# Ignore libgcc.a 7926ef40deSMasahiro Yamada# Some architectures do '$(CC) --print-libgcc-file-name' to borrow libgcc.a 8026ef40deSMasahiro Yamada# from the toolchain, but there is no EXPORT_SYMBOL in it. 8126ef40deSMasahiro Yamada 8226ef40deSMasahiro Yamadaquiet_cmd_vmlinux_objs = GEN $@ 8326ef40deSMasahiro Yamada cmd_vmlinux_objs = \ 8426ef40deSMasahiro Yamada for f in $(real-prereqs); do \ 8526ef40deSMasahiro Yamada case $${f} in \ 8626ef40deSMasahiro Yamada *libgcc.a) ;; \ 8732164845SMasahiro Yamada *) $(AR) t $${f} ;; \ 8826ef40deSMasahiro Yamada esac \ 8926ef40deSMasahiro Yamada done > $@ 9026ef40deSMasahiro Yamada 9126ef40deSMasahiro Yamadatargets += .vmlinux.objs 9232164845SMasahiro Yamada.vmlinux.objs: vmlinux.a $(KBUILD_VMLINUX_LIBS) FORCE 9326ef40deSMasahiro Yamada $(call if_changed,vmlinux_objs) 9426ef40deSMasahiro Yamada 955e9e95ccSMasahiro Yamadaifdef CONFIG_TRIM_UNUSED_KSYMS 965e9e95ccSMasahiro Yamadaksym-wl := $(CONFIG_UNUSED_KSYMS_WHITELIST) 975e9e95ccSMasahiro Yamadaksym-wl := $(if $(filter-out /%, $(ksym-wl)),$(srctree)/)$(ksym-wl) 985e9e95ccSMasahiro Yamadamodpost-args += -t $(addprefix -u , $(ksym-wl)) 995e9e95ccSMasahiro Yamadamodpost-deps += $(ksym-wl) 1005e9e95ccSMasahiro Yamadaendif 1015e9e95ccSMasahiro Yamada 1023d57e1b7SMasahiro Yamadaifeq ($(wildcard vmlinux.o),) 1033d57e1b7SMasahiro Yamadamissing-input := vmlinux.o 1043d57e1b7SMasahiro Yamadaoutput-symdump := modules-only.symvers 1053d57e1b7SMasahiro Yamadaelse 1063d57e1b7SMasahiro Yamadamodpost-args += vmlinux.o 1073d57e1b7SMasahiro Yamadamodpost-deps += vmlinux.o 1083d57e1b7SMasahiro Yamadaoutput-symdump := $(if $(KBUILD_MODULES), Module.symvers, vmlinux.symvers) 10969bc8d38SMasahiro Yamadaendif 110bcfedae7SMasahiro Yamada 1111747269aSMasahiro Yamadaelse 11296d97f26SSam Ravnborg 113fab546e6SMasahiro Yamada# set src + obj - they may be used in the modules's Makefile 11496d97f26SSam Ravnborgobj := $(KBUILD_EXTMOD) 11596d97f26SSam Ravnborgsrc := $(obj) 11696d97f26SSam Ravnborg 1170d96fb20SRichard Hacker# Include the module's Makefile to find KBUILD_EXTRA_SYMBOLS 118a2430b25SMasahiro Yamadainclude $(kbuild-file) 119e3fb4df7SMasahiro Yamada 120bcfedae7SMasahiro Yamadaoutput-symdump := $(KBUILD_EXTMOD)/Module.symvers 121bcfedae7SMasahiro Yamada 1223d57e1b7SMasahiro Yamadaifeq ($(wildcard Module.symvers),) 1233d57e1b7SMasahiro Yamadamissing-input := Module.symvers 1243d57e1b7SMasahiro Yamadaelse 1253d57e1b7SMasahiro Yamadamodpost-args += -i Module.symvers 1263d57e1b7SMasahiro Yamadamodpost-deps += Module.symvers 1273d57e1b7SMasahiro Yamadaendif 1283d57e1b7SMasahiro Yamada 1293d57e1b7SMasahiro Yamadamodpost-args += -e $(addprefix -i , $(KBUILD_EXTRA_SYMBOLS)) 1300d96fb20SRichard Hacker 131f73edc89SMasahiro Yamadaendif # ($(KBUILD_EXTMOD),) 1324475dff5SMasahiro Yamada 133bcfedae7SMasahiro Yamadaquiet_cmd_modpost = MODPOST $@ 134f73edc89SMasahiro Yamada cmd_modpost = \ 135f73edc89SMasahiro Yamada $(if $(missing-input), \ 136f73edc89SMasahiro Yamada echo >&2 "WARNING: $(missing-input) is missing."; \ 137f73edc89SMasahiro Yamada echo >&2 " Modules may not have dependencies or modversions."; \ 1385573b4daSMasahiro Yamada echo >&2 " You may get many unresolved symbol errors."; \ 1395573b4daSMasahiro Yamada echo >&2 " You can set KBUILD_MODPOST_WARN=1 to turn errors into warning"; \ 1405573b4daSMasahiro Yamada echo >&2 " if you want to proceed at your own risk.";) \ 1413d57e1b7SMasahiro Yamada $(MODPOST) $(modpost-args) 142436b2ac6SMasahiro Yamada 143436b2ac6SMasahiro Yamadatargets += $(output-symdump) 1443d57e1b7SMasahiro Yamada$(output-symdump): $(modpost-deps) FORCE 145f73edc89SMasahiro Yamada $(call if_changed,modpost) 146bcfedae7SMasahiro Yamada 147bcfedae7SMasahiro Yamada__modpost: $(output-symdump) 148bcfedae7SMasahiro YamadaPHONY += FORCE 149bcfedae7SMasahiro YamadaFORCE: 150bcfedae7SMasahiro Yamada 151436b2ac6SMasahiro Yamadaexisting-targets := $(wildcard $(sort $(targets))) 152436b2ac6SMasahiro Yamada 153436b2ac6SMasahiro Yamada-include $(foreach f,$(existing-targets),$(dir $(f)).$(notdir $(f)).cmd) 154436b2ac6SMasahiro Yamada 1554f193362SPaul Smith.PHONY: $(PHONY) 156