Linux Audio

Check our new training course

Linux kernel drivers training

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