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 Yamadakernelsymfile := $(objtree)/Module.symvers 47a721588dSMasahiro Yamadamodulesymfile := $(firstword $(KBUILD_EXTMOD))/Module.symvers 48a721588dSMasahiro Yamada 49a721588dSMasahiro YamadaMODPOST = scripts/mod/modpost \ 50a721588dSMasahiro Yamada $(if $(CONFIG_MODVERSIONS),-m) \ 51a721588dSMasahiro Yamada $(if $(CONFIG_MODULE_SRCVERSION_ALL),-a) \ 52a721588dSMasahiro Yamada $(if $(KBUILD_EXTMOD),-i,-o) $(kernelsymfile) \ 53a721588dSMasahiro Yamada $(if $(KBUILD_EXTMOD),-I $(modulesymfile)) \ 54a721588dSMasahiro Yamada $(if $(KBUILD_EXTMOD),$(addprefix -e ,$(KBUILD_EXTRA_SYMBOLS))) \ 55a721588dSMasahiro Yamada $(if $(KBUILD_EXTMOD),-o $(modulesymfile)) \ 56a721588dSMasahiro Yamada $(if $(CONFIG_SECTION_MISMATCH_WARN_ONLY),,-E) \ 57a721588dSMasahiro Yamada $(if $(KBUILD_MODPOST_WARN),-w) 58a721588dSMasahiro Yamada 59a721588dSMasahiro Yamadaifdef MODPOST_VMLINUX 60a721588dSMasahiro Yamada 619b9a3f20SMasahiro Yamadaquiet_cmd_modpost = MODPOST vmlinux.o 629b9a3f20SMasahiro Yamada cmd_modpost = $(MODPOST) vmlinux.o 63a721588dSMasahiro Yamada 649b9a3f20SMasahiro Yamada__modpost: 65a721588dSMasahiro Yamada $(call cmd,modpost) 66a721588dSMasahiro Yamada 67a721588dSMasahiro Yamadaelse 68a721588dSMasahiro Yamada 6925985edcSLucas De Marchi# When building external modules load the Kbuild file to retrieve EXTRA_SYMBOLS info 700d96fb20SRichard Hackerifneq ($(KBUILD_EXTMOD),) 7196d97f26SSam Ravnborg 7296d97f26SSam Ravnborg# set src + obj - they may be used when building the .mod.c file 7396d97f26SSam Ravnborgobj := $(KBUILD_EXTMOD) 7496d97f26SSam Ravnborgsrc := $(obj) 7596d97f26SSam Ravnborg 760d96fb20SRichard Hacker# Include the module's Makefile to find KBUILD_EXTRA_SYMBOLS 770d96fb20SRichard Hackerinclude $(if $(wildcard $(KBUILD_EXTMOD)/Kbuild), \ 780d96fb20SRichard Hacker $(KBUILD_EXTMOD)/Kbuild, $(KBUILD_EXTMOD)/Makefile) 790d96fb20SRichard Hackerendif 800d96fb20SRichard Hacker 819b9a3f20SMasahiro YamadaMODPOST += $(subst -i,-n,$(filter -i,$(MAKEFLAGS))) -s -T - $(wildcard vmlinux) 821da177e4SLinus Torvalds 83a721588dSMasahiro Yamada# find all modules listed in modules.order 8447801c97SMasahiro Yamadamodules := $(sort $(shell cat $(MODORDER))) 851da177e4SLinus Torvalds 869b9a3f20SMasahiro Yamada# Read out modules.order instead of expanding $(modules) to pass in modpost. 879b9a3f20SMasahiro Yamada# Otherwise, allmodconfig would fail with "Argument list too long". 88acf2a139SMasahiro Yamadaquiet_cmd_modpost = MODPOST $(words $(modules)) modules 8947801c97SMasahiro Yamada cmd_modpost = sed 's/ko$$/o/' $(MODORDER) | $(MODPOST) 908d8d8289SSam Ravnborg 919b9a3f20SMasahiro Yamada__modpost: 929b9a3f20SMasahiro Yamada @$(kecho) ' Building modules, stage 2.' 93a721588dSMasahiro Yamada $(call cmd,modpost) 949b9a3f20SMasahiro Yamadaifneq ($(KBUILD_MODPOST_NOFINAL),1) 959b9a3f20SMasahiro Yamada $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modfinal 969b9a3f20SMasahiro Yamadaendif 974f193362SPaul Smith 98a721588dSMasahiro Yamadaendif 99a721588dSMasahiro Yamada 1004f193362SPaul Smith.PHONY: $(PHONY) 101