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 4142593738SMasahiro Yamadamodpost-args = \ 42a721588dSMasahiro Yamada $(if $(CONFIG_MODVERSIONS),-m) \ 43a721588dSMasahiro Yamada $(if $(CONFIG_MODULE_SRCVERSION_ALL),-a) \ 44a721588dSMasahiro Yamada $(if $(CONFIG_SECTION_MISMATCH_WARN_ONLY),,-E) \ 45f73edc89SMasahiro Yamada $(if $(KBUILD_NSDEPS),-d $(MODULES_NSDEPS)) \ 46f73edc89SMasahiro Yamada $(if $(CONFIG_MODULE_ALLOW_MISSING_NAMESPACE_IMPORTS)$(KBUILD_NSDEPS),-N) \ 47bcfedae7SMasahiro Yamada -o $@ 48a721588dSMasahiro Yamada 49f73edc89SMasahiro Yamada# 'make -i -k' ignores compile errors, and builds as many modules as possible. 50f73edc89SMasahiro Yamadaifneq ($(findstring i,$(filter-out --%,$(MAKEFLAGS))),) 5142593738SMasahiro Yamadamodpost-args += -n 52f73edc89SMasahiro Yamadaendif 53a721588dSMasahiro Yamada 54f73edc89SMasahiro Yamadaifeq ($(KBUILD_EXTMOD),) 55bcfedae7SMasahiro Yamada 5626ef40deSMasahiro Yamada# Generate the list of in-tree objects in vmlinux 5726ef40deSMasahiro Yamada# --------------------------------------------------------------------------- 5826ef40deSMasahiro Yamada 5926ef40deSMasahiro Yamada# This is used to retrieve symbol versions generated by genksyms. 6026ef40deSMasahiro Yamadaifdef CONFIG_MODVERSIONS 61f73edc89SMasahiro Yamadavmlinux.symvers Module.symvers: .vmlinux.objs 6226ef40deSMasahiro Yamadaendif 6326ef40deSMasahiro Yamada 6426ef40deSMasahiro Yamada# Ignore libgcc.a 6526ef40deSMasahiro Yamada# Some architectures do '$(CC) --print-libgcc-file-name' to borrow libgcc.a 6626ef40deSMasahiro Yamada# from the toolchain, but there is no EXPORT_SYMBOL in it. 6726ef40deSMasahiro Yamada 6826ef40deSMasahiro Yamadaquiet_cmd_vmlinux_objs = GEN $@ 6926ef40deSMasahiro Yamada cmd_vmlinux_objs = \ 7026ef40deSMasahiro Yamada for f in $(real-prereqs); do \ 7126ef40deSMasahiro Yamada case $${f} in \ 7226ef40deSMasahiro Yamada *libgcc.a) ;; \ 73*32164845SMasahiro Yamada *) $(AR) t $${f} ;; \ 7426ef40deSMasahiro Yamada esac \ 7526ef40deSMasahiro Yamada done > $@ 7626ef40deSMasahiro Yamada 7726ef40deSMasahiro Yamadatargets += .vmlinux.objs 78*32164845SMasahiro Yamada.vmlinux.objs: vmlinux.a $(KBUILD_VMLINUX_LIBS) FORCE 7926ef40deSMasahiro Yamada $(call if_changed,vmlinux_objs) 8026ef40deSMasahiro Yamada 81f73edc89SMasahiro Yamadavmlinux.o-if-present := $(wildcard vmlinux.o) 82f73edc89SMasahiro Yamadaoutput-symdump := vmlinux.symvers 83a721588dSMasahiro Yamada 84f73edc89SMasahiro Yamadaifdef KBUILD_MODULES 85f73edc89SMasahiro Yamadaoutput-symdump := $(if $(vmlinux.o-if-present), Module.symvers, modules-only.symvers) 86f73edc89SMasahiro Yamadamissing-input := $(filter-out $(vmlinux.o-if-present),vmlinux.o) 8769bc8d38SMasahiro Yamadaendif 88bcfedae7SMasahiro Yamada 891747269aSMasahiro Yamadaelse 9096d97f26SSam Ravnborg 91fab546e6SMasahiro Yamada# set src + obj - they may be used in the modules's Makefile 9296d97f26SSam Ravnborgobj := $(KBUILD_EXTMOD) 9396d97f26SSam Ravnborgsrc := $(obj) 9496d97f26SSam Ravnborg 950d96fb20SRichard Hacker# Include the module's Makefile to find KBUILD_EXTRA_SYMBOLS 96c9db1884SMasahiro Yamadainclude $(or $(wildcard $(src)/Kbuild), $(src)/Makefile) 97e3fb4df7SMasahiro Yamada 98f73edc89SMasahiro Yamadamodule.symvers-if-present := $(wildcard Module.symvers) 99bcfedae7SMasahiro Yamadaoutput-symdump := $(KBUILD_EXTMOD)/Module.symvers 100f73edc89SMasahiro Yamadamissing-input := $(filter-out $(module.symvers-if-present), Module.symvers) 101bcfedae7SMasahiro Yamada 10242593738SMasahiro Yamadamodpost-args += -e $(addprefix -i ,$(module.symvers-if-present) $(KBUILD_EXTRA_SYMBOLS)) 1030d96fb20SRichard Hacker 104f73edc89SMasahiro Yamadaendif # ($(KBUILD_EXTMOD),) 1054475dff5SMasahiro Yamada 106f73edc89SMasahiro Yamadaifneq ($(KBUILD_MODPOST_WARN)$(missing-input),) 10742593738SMasahiro Yamadamodpost-args += -w 1085ab70ff4SMasahiro Yamadaendif 1095ab70ff4SMasahiro Yamada 110f73edc89SMasahiro Yamadamodorder-if-needed := $(if $(KBUILD_MODULES), $(MODORDER)) 111f73edc89SMasahiro Yamada 11242593738SMasahiro YamadaMODPOST = scripts/mod/modpost 11342593738SMasahiro Yamada 114bcfedae7SMasahiro Yamada# Read out modules.order to pass in modpost. 1159b9a3f20SMasahiro Yamada# Otherwise, allmodconfig would fail with "Argument list too long". 116bcfedae7SMasahiro Yamadaquiet_cmd_modpost = MODPOST $@ 117f73edc89SMasahiro Yamada cmd_modpost = \ 118f73edc89SMasahiro Yamada $(if $(missing-input), \ 119f73edc89SMasahiro Yamada echo >&2 "WARNING: $(missing-input) is missing."; \ 120f73edc89SMasahiro Yamada echo >&2 " Modules may not have dependencies or modversions."; \ 121f73edc89SMasahiro Yamada echo >&2 " You may get many unresolved symbol warnings.";) \ 12242593738SMasahiro Yamada sed 's/ko$$/o/' $(or $(modorder-if-needed), /dev/null) | $(MODPOST) $(modpost-args) $(vmlinux.o-if-present) -T - 123436b2ac6SMasahiro Yamada 124436b2ac6SMasahiro Yamadatargets += $(output-symdump) 12542593738SMasahiro Yamada$(output-symdump): $(modorder-if-needed) $(vmlinux.o-if-present) $(moudle.symvers-if-present) $(MODPOST) FORCE 126f73edc89SMasahiro Yamada $(call if_changed,modpost) 127bcfedae7SMasahiro Yamada 128bcfedae7SMasahiro Yamada__modpost: $(output-symdump) 129bcfedae7SMasahiro YamadaPHONY += FORCE 130bcfedae7SMasahiro YamadaFORCE: 131bcfedae7SMasahiro Yamada 132436b2ac6SMasahiro Yamadaexisting-targets := $(wildcard $(sort $(targets))) 133436b2ac6SMasahiro Yamada 134436b2ac6SMasahiro Yamada-include $(foreach f,$(existing-targets),$(dir $(f)).$(notdir $(f)).cmd) 135436b2ac6SMasahiro Yamada 1364f193362SPaul Smith.PHONY: $(PHONY) 137