1# SPDX-License-Identifier: GPL-2.0
  2# ==========================================================================
  3# Installing modules
  4# ==========================================================================
  5
  6PHONY := __modinst
  7__modinst:
  8
  9include $(objtree)/include/config/auto.conf
 10include $(srctree)/scripts/Kbuild.include
 11
 12install-y :=
 13
 14ifeq ($(KBUILD_EXTMOD)$(sign-only),)
 15
 16# remove the old directory and symlink
 17$(shell rm -fr $(MODLIB)/kernel $(MODLIB)/build)
 18
 19install-$(CONFIG_MODULES) += $(addprefix $(MODLIB)/, build modules.order)
 20
 21$(MODLIB)/build: FORCE
 22	$(call cmd,symlink)
 23
 24quiet_cmd_symlink = SYMLINK $@
 25      cmd_symlink = ln -s $(CURDIR) $@
 26
 27$(MODLIB)/modules.order: modules.order FORCE
 28	$(call cmd,install_modorder)
 29
 30quiet_cmd_install_modorder = INSTALL $@
 31      cmd_install_modorder = sed 's:^\(.*\)\.o$$:kernel/\1.ko:' $< > $@
 32
 33# Install modules.builtin(.modinfo,.ranges) even when CONFIG_MODULES is disabled.
 34install-y += $(addprefix $(MODLIB)/, modules.builtin modules.builtin.modinfo)
 35
 36install-$(CONFIG_BUILTIN_MODULE_RANGES) += $(MODLIB)/modules.builtin.ranges
 37
 38$(addprefix $(MODLIB)/, modules.builtin modules.builtin.modinfo modules.builtin.ranges): $(MODLIB)/%: % FORCE
 39	$(call cmd,install)
 40
 41endif
 42
 43modules := $(call read-file, modules.order)
 44
 45ifeq ($(KBUILD_EXTMOD),)
 46dst := $(MODLIB)/kernel
 47else
 48INSTALL_MOD_DIR ?= updates
 49dst := $(MODLIB)/$(INSTALL_MOD_DIR)
 50endif
 51
 52$(foreach x, % :, $(if $(findstring $x, $(dst)), \
 53	$(error module installation path cannot contain '$x')))
 54
 55suffix-y				:=
 56ifdef CONFIG_MODULE_COMPRESS_ALL
 57suffix-$(CONFIG_MODULE_COMPRESS_GZIP)	:= .gz
 58suffix-$(CONFIG_MODULE_COMPRESS_XZ)	:= .xz
 59suffix-$(CONFIG_MODULE_COMPRESS_ZSTD)	:= .zst
 60endif
 61
 62modules := $(patsubst %.o, $(dst)/%.ko$(suffix-y), $(modules))
 63install-$(CONFIG_MODULES) += $(modules)
 64
 65__modinst: $(install-y)
 66	@:
 67
 68#
 69# Installation
 70#
 71quiet_cmd_install = INSTALL $@
 72      cmd_install = cp $< $@
 73
 74# Strip
 75#
 76# INSTALL_MOD_STRIP, if defined, will cause modules to be stripped after they
 77# are installed. If INSTALL_MOD_STRIP is '1', then the default option
 78# --strip-debug will be used. Otherwise, INSTALL_MOD_STRIP value will be used
 79# as the options to the strip command.
 80ifdef INSTALL_MOD_STRIP
 81
 82ifeq ($(INSTALL_MOD_STRIP),1)
 83strip-option := --strip-debug
 84else
 85strip-option := $(INSTALL_MOD_STRIP)
 86endif
 87
 88quiet_cmd_strip = STRIP   $@
 89      cmd_strip = $(STRIP) $(strip-option) $@
 90
 91else
 92
 93quiet_cmd_strip =
 94      cmd_strip = :
 95
 96endif
 
 97
 98#
 99# Signing
100# Don't stop modules_install even if we can't sign external modules.
101#
102ifeq ($(filter pkcs11:%, $(CONFIG_MODULE_SIG_KEY)),)
103sig-key := $(if $(wildcard $(CONFIG_MODULE_SIG_KEY)),,$(srctree)/)$(CONFIG_MODULE_SIG_KEY)
104else
105sig-key := $(CONFIG_MODULE_SIG_KEY)
106endif
107quiet_cmd_sign = SIGN    $@
108      cmd_sign = $(objtree)/scripts/sign-file $(CONFIG_MODULE_SIG_HASH) "$(sig-key)" $(objtree)/certs/signing_key.x509 $@ \
109                 $(if $(KBUILD_EXTMOD),|| true)
110
111ifeq ($(sign-only),)
112
113# During modules_install, modules are signed only when CONFIG_MODULE_SIG_ALL=y.
114ifndef CONFIG_MODULE_SIG_ALL
115quiet_cmd_sign :=
116      cmd_sign := :
117endif
118
119# Create necessary directories
120$(foreach dir, $(sort $(dir $(install-y))), $(shell mkdir -p $(dir)))
121
122$(dst)/%.ko: %.ko FORCE
123	$(call cmd,install)
124	$(call cmd,strip)
125	$(call cmd,sign)
126
127ifdef CONFIG_MODULES
128__modinst: depmod
129
130PHONY += depmod
131depmod: $(install-y)
132	$(call cmd,depmod)
133
134quiet_cmd_depmod = DEPMOD  $(MODLIB)
135      cmd_depmod = $(srctree)/scripts/depmod.sh $(KERNELRELEASE)
136endif
137
138else
139
140$(dst)/%.ko: FORCE
141	$(call cmd,sign)
142
143endif
 
 
 
 
 
 
 
 
 
 
 
144
145#
146# Compression
147#
148quiet_cmd_gzip = GZIP    $@
149      cmd_gzip = $(KGZIP) -n -f $<
150quiet_cmd_xz = XZ      $@
151      cmd_xz = $(XZ) --check=crc32 --lzma2=dict=1MiB -f $<
152quiet_cmd_zstd = ZSTD    $@
153      cmd_zstd = $(ZSTD) --rm -f -q $<
154
155$(dst)/%.ko.gz: $(dst)/%.ko FORCE
156	$(call cmd,gzip)
157
158$(dst)/%.ko.xz: $(dst)/%.ko FORCE
159	$(call cmd,xz)
160
161$(dst)/%.ko.zst: $(dst)/%.ko FORCE
162	$(call cmd,zstd)
163
164PHONY += FORCE
165FORCE:
166
167.PHONY: $(PHONY)

 
 1# ==========================================================================
 2# Installing modules
 3# ==========================================================================
 4
 5PHONY := __modinst
 6__modinst:
 7
 8include scripts/Kbuild.include
 
 9
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
10#
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
11
12__modules := $(sort $(shell grep -h '\.ko$$' /dev/null $(wildcard $(MODVERDIR)/*.mod)))
13modules := $(patsubst %.o,%.ko,$(wildcard $(__modules:.ko=.o)))
14
15PHONY += $(modules)
16__modinst: $(modules)
17	@:
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
18
19# Don't stop modules_install if we can't sign external modules.
20quiet_cmd_modules_install = INSTALL $@
21      cmd_modules_install = \
22    mkdir -p $(2) ; \
23    cp $@ $(2) ; \
24    $(mod_strip_cmd) $(2)/$(notdir $@) ; \
25    $(mod_sign_cmd) $(2)/$(notdir $@) $(patsubst %,|| true,$(KBUILD_EXTMOD)) && \
26    $(mod_compress_cmd) $(2)/$(notdir $@)
27
28# Modules built outside the kernel source tree go into extra by default
29INSTALL_MOD_DIR ?= extra
30ext-mod-dir = $(INSTALL_MOD_DIR)$(subst $(patsubst %/,%,$(KBUILD_EXTMOD)),,$(@D))
31
32modinst_dir = $(if $(KBUILD_EXTMOD),$(ext-mod-dir),kernel/$(@D))
 
 
 
 
 
 
 
 
 
 
 
33
34$(modules):
35	$(call cmd,modules_install,$(MODLIB)/$(modinst_dir))
36
 
 
37
38# Declare the contents of the .PHONY variable as phony.  We keep that
39# information in a variable so we can use it in if_changed and friends.
40
41.PHONY: $(PHONY)