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 = \ 44a721588dSMasahiro Yamada $(if $(CONFIG_MODVERSIONS),-m) \ 45a721588dSMasahiro Yamada $(if $(CONFIG_MODULE_SRCVERSION_ALL),-a) \ 46a721588dSMasahiro Yamada $(if $(CONFIG_SECTION_MISMATCH_WARN_ONLY),,-E) \ 47*735aec59SMasahiro Yamada $(if $(KBUILD_MODPOST_WARN),-w) \ 48f73edc89SMasahiro Yamada $(if $(KBUILD_NSDEPS),-d $(MODULES_NSDEPS)) \ 49f73edc89SMasahiro Yamada $(if $(CONFIG_MODULE_ALLOW_MISSING_NAMESPACE_IMPORTS)$(KBUILD_NSDEPS),-N) \ 50bcfedae7SMasahiro Yamada -o $@ 51a721588dSMasahiro Yamada 523d57e1b7SMasahiro Yamadamodpost-deps := $(MODPOST) 533d57e1b7SMasahiro Yamada 54f73edc89SMasahiro Yamada# 'make -i -k' ignores compile errors, and builds as many modules as possible. 55f73edc89SMasahiro Yamadaifneq ($(findstring i,$(filter-out --%,$(MAKEFLAGS))),) 5642593738SMasahiro Yamadamodpost-args += -n 57f73edc89SMasahiro Yamadaendif 58a721588dSMasahiro Yamada 5963ffe00dSSamuel Holland# Read out modules.order to pass in modpost. 6063ffe00dSSamuel Holland# Otherwise, allmodconfig would fail with "Argument list too long". 6163ffe00dSSamuel Hollandifdef KBUILD_MODULES 6263ffe00dSSamuel Hollandmodpost-args += -T $(MODORDER) 6363ffe00dSSamuel Hollandmodpost-deps += $(MODORDER) 6463ffe00dSSamuel Hollandendif 6563ffe00dSSamuel Holland 66f73edc89SMasahiro Yamadaifeq ($(KBUILD_EXTMOD),) 67bcfedae7SMasahiro Yamada 6826ef40deSMasahiro Yamada# Generate the list of in-tree objects in vmlinux 6926ef40deSMasahiro Yamada# --------------------------------------------------------------------------- 7026ef40deSMasahiro Yamada 7126ef40deSMasahiro Yamada# This is used to retrieve symbol versions generated by genksyms. 7226ef40deSMasahiro Yamadaifdef CONFIG_MODVERSIONS 73f73edc89SMasahiro Yamadavmlinux.symvers Module.symvers: .vmlinux.objs 7426ef40deSMasahiro Yamadaendif 7526ef40deSMasahiro Yamada 7626ef40deSMasahiro Yamada# Ignore libgcc.a 7726ef40deSMasahiro Yamada# Some architectures do '$(CC) --print-libgcc-file-name' to borrow libgcc.a 7826ef40deSMasahiro Yamada# from the toolchain, but there is no EXPORT_SYMBOL in it. 7926ef40deSMasahiro Yamada 8026ef40deSMasahiro Yamadaquiet_cmd_vmlinux_objs = GEN $@ 8126ef40deSMasahiro Yamada cmd_vmlinux_objs = \ 8226ef40deSMasahiro Yamada for f in $(real-prereqs); do \ 8326ef40deSMasahiro Yamada case $${f} in \ 8426ef40deSMasahiro Yamada *libgcc.a) ;; \ 8532164845SMasahiro Yamada *) $(AR) t $${f} ;; \ 8626ef40deSMasahiro Yamada esac \ 8726ef40deSMasahiro Yamada done > $@ 8826ef40deSMasahiro Yamada 8926ef40deSMasahiro Yamadatargets += .vmlinux.objs 9032164845SMasahiro Yamada.vmlinux.objs: vmlinux.a $(KBUILD_VMLINUX_LIBS) FORCE 9126ef40deSMasahiro Yamada $(call if_changed,vmlinux_objs) 9226ef40deSMasahiro Yamada 933d57e1b7SMasahiro Yamadaifeq ($(wildcard vmlinux.o),) 943d57e1b7SMasahiro Yamadamissing-input := vmlinux.o 953d57e1b7SMasahiro Yamadaoutput-symdump := modules-only.symvers 963d57e1b7SMasahiro Yamadaelse 973d57e1b7SMasahiro Yamadamodpost-args += vmlinux.o 983d57e1b7SMasahiro Yamadamodpost-deps += vmlinux.o 993d57e1b7SMasahiro Yamadaoutput-symdump := $(if $(KBUILD_MODULES), Module.symvers, vmlinux.symvers) 10069bc8d38SMasahiro Yamadaendif 101bcfedae7SMasahiro Yamada 1021747269aSMasahiro Yamadaelse 10396d97f26SSam Ravnborg 104fab546e6SMasahiro Yamada# set src + obj - they may be used in the modules's Makefile 10596d97f26SSam Ravnborgobj := $(KBUILD_EXTMOD) 10696d97f26SSam Ravnborgsrc := $(obj) 10796d97f26SSam Ravnborg 1080d96fb20SRichard Hacker# Include the module's Makefile to find KBUILD_EXTRA_SYMBOLS 109a2430b25SMasahiro Yamadainclude $(kbuild-file) 110e3fb4df7SMasahiro Yamada 111bcfedae7SMasahiro Yamadaoutput-symdump := $(KBUILD_EXTMOD)/Module.symvers 112bcfedae7SMasahiro Yamada 1133d57e1b7SMasahiro Yamadaifeq ($(wildcard Module.symvers),) 1143d57e1b7SMasahiro Yamadamissing-input := Module.symvers 1153d57e1b7SMasahiro Yamadaelse 1163d57e1b7SMasahiro Yamadamodpost-args += -i Module.symvers 1173d57e1b7SMasahiro Yamadamodpost-deps += Module.symvers 1183d57e1b7SMasahiro Yamadaendif 1193d57e1b7SMasahiro Yamada 1203d57e1b7SMasahiro Yamadamodpost-args += -e $(addprefix -i , $(KBUILD_EXTRA_SYMBOLS)) 1210d96fb20SRichard Hacker 122f73edc89SMasahiro Yamadaendif # ($(KBUILD_EXTMOD),) 1234475dff5SMasahiro Yamada 124*735aec59SMasahiro Yamadaifneq ($(missing-input),) 125*735aec59SMasahiro Yamadamodpost-args += -w 126*735aec59SMasahiro Yamadaendif 127*735aec59SMasahiro Yamada 128bcfedae7SMasahiro Yamadaquiet_cmd_modpost = MODPOST $@ 129f73edc89SMasahiro Yamada cmd_modpost = \ 130f73edc89SMasahiro Yamada $(if $(missing-input), \ 131f73edc89SMasahiro Yamada echo >&2 "WARNING: $(missing-input) is missing."; \ 132f73edc89SMasahiro Yamada echo >&2 " Modules may not have dependencies or modversions."; \ 133f73edc89SMasahiro Yamada echo >&2 " You may get many unresolved symbol warnings.";) \ 1343d57e1b7SMasahiro Yamada $(MODPOST) $(modpost-args) 135436b2ac6SMasahiro Yamada 136436b2ac6SMasahiro Yamadatargets += $(output-symdump) 1373d57e1b7SMasahiro Yamada$(output-symdump): $(modpost-deps) FORCE 138f73edc89SMasahiro Yamada $(call if_changed,modpost) 139bcfedae7SMasahiro Yamada 140bcfedae7SMasahiro Yamada__modpost: $(output-symdump) 141bcfedae7SMasahiro YamadaPHONY += FORCE 142bcfedae7SMasahiro YamadaFORCE: 143bcfedae7SMasahiro Yamada 144436b2ac6SMasahiro Yamadaexisting-targets := $(wildcard $(sort $(targets))) 145436b2ac6SMasahiro Yamada 146436b2ac6SMasahiro Yamada-include $(foreach f,$(existing-targets),$(dir $(f)).$(notdir $(f)).cmd) 147436b2ac6SMasahiro Yamada 1484f193362SPaul Smith.PHONY: $(PHONY) 149