build: use SPDX license tags
[openwrt/openwrt.git] / include / kernel.mk
1 # SPDX-License-Identifier: GPL-2.0-only
2 #
3 # Copyright (C) 2006-2020 OpenWrt.org
4
5 ifneq ($(filter check,$(MAKECMDGOALS)),)
6 CHECK:=1
7 DUMP:=1
8 endif
9
10 ifneq ($(SOURCE_DATE_EPOCH),)
11 ifndef DUMP
12 KBUILD_BUILD_TIMESTAMP:=$(shell perl -e 'print scalar gmtime($(SOURCE_DATE_EPOCH))')
13 endif
14 endif
15
16 ifeq ($(__target_inc),)
17 ifndef CHECK
18 include $(INCLUDE_DIR)/target.mk
19 endif
20 endif
21
22 ifeq ($(DUMP),1)
23 KERNEL?=<KERNEL>
24 BOARD?=<BOARD>
25 LINUX_VERSION?=<LINUX_VERSION>
26 LINUX_VERMAGIC?=<LINUX_VERMAGIC>
27 else
28 ifeq ($(CONFIG_EXTERNAL_TOOLCHAIN),)
29 export GCC_HONOUR_COPTS=s
30 endif
31
32 LINUX_KMOD_SUFFIX=ko
33
34 ifneq (,$(findstring uml,$(BOARD)))
35 KERNEL_CC?=$(HOSTCC)
36 KERNEL_CROSS?=
37 else
38 KERNEL_CC?=$(TARGET_CC)
39 KERNEL_CROSS?=$(TARGET_CROSS)
40 endif
41
42 ifeq ($(TARGET_BUILD),1)
43 PATCH_DIR ?= $(CURDIR)/patches$(if $(wildcard ./patches-$(KERNEL_PATCHVER)),-$(KERNEL_PATCHVER))
44 FILES_DIR ?= $(foreach dir,$(wildcard $(CURDIR)/files $(CURDIR)/files-$(KERNEL_PATCHVER)),"$(dir)")
45 endif
46 KERNEL_BUILD_DIR ?= $(BUILD_DIR)/linux-$(BOARD)$(if $(SUBTARGET),_$(SUBTARGET))
47 LINUX_DIR ?= $(KERNEL_BUILD_DIR)/linux-$(LINUX_VERSION)
48 LINUX_UAPI_DIR=uapi/
49 LINUX_VERMAGIC:=$(strip $(shell cat $(LINUX_DIR)/.vermagic 2>/dev/null))
50 LINUX_VERMAGIC:=$(if $(LINUX_VERMAGIC),$(LINUX_VERMAGIC),unknown)
51
52 LINUX_UNAME_VERSION:=$(KERNEL_BASE)
53 ifneq ($(findstring -rc,$(LINUX_VERSION)),)
54 LINUX_UNAME_VERSION:=$(LINUX_UNAME_VERSION)-$(strip $(lastword $(subst -, ,$(LINUX_VERSION))))
55 endif
56
57 LINUX_KERNEL:=$(KERNEL_BUILD_DIR)/vmlinux
58
59 ifneq (,$(findstring -rc,$(LINUX_VERSION)))
60 LINUX_SOURCE:=linux-$(LINUX_VERSION).tar.gz
61 else
62 LINUX_SOURCE:=linux-$(LINUX_VERSION).tar.xz
63 endif
64
65 ifneq (,$(findstring -rc,$(LINUX_VERSION)))
66 LINUX_SITE:=https://git.kernel.org/torvalds/t
67 else ifeq ($(call qstrip,$(CONFIG_EXTERNAL_KERNEL_TREE))$(call qstrip,$(CONFIG_KERNEL_GIT_CLONE_URI)),)
68 LINUX_SITE:=@KERNEL/linux/kernel/v$(word 1,$(subst ., ,$(KERNEL_BASE))).x
69 else
70 LINUX_UNAME_VERSION:=$(strip $(shell cat $(LINUX_DIR)/include/config/kernel.release 2>/dev/null))
71 endif
72
73 MODULES_SUBDIR:=lib/modules/$(LINUX_UNAME_VERSION)
74 TARGET_MODULES_DIR:=$(LINUX_TARGET_DIR)/$(MODULES_SUBDIR)
75
76 ifneq ($(TARGET_BUILD),1)
77 PKG_BUILD_DIR ?= $(KERNEL_BUILD_DIR)/$(if $(BUILD_VARIANT),$(PKG_NAME)-$(BUILD_VARIANT)/)$(PKG_NAME)$(if $(PKG_VERSION),-$(PKG_VERSION))
78 endif
79 endif
80
81 ifneq (,$(findstring uml,$(BOARD)))
82 LINUX_KARCH=um
83 else ifneq (,$(findstring $(ARCH) , aarch64 aarch64_be ))
84 LINUX_KARCH := arm64
85 else ifneq (,$(findstring $(ARCH) , arceb ))
86 LINUX_KARCH := arc
87 else ifneq (,$(findstring $(ARCH) , armeb ))
88 LINUX_KARCH := arm
89 else ifneq (,$(findstring $(ARCH) , mipsel mips64 mips64el ))
90 LINUX_KARCH := mips
91 else ifneq (,$(findstring $(ARCH) , powerpc64 ))
92 LINUX_KARCH := powerpc
93 else ifneq (,$(findstring $(ARCH) , sh2 sh3 sh4 ))
94 LINUX_KARCH := sh
95 else ifneq (,$(findstring $(ARCH) , i386 x86_64 ))
96 LINUX_KARCH := x86
97 else
98 LINUX_KARCH := $(ARCH)
99 endif
100
101 KERNEL_MAKE = $(MAKE) $(KERNEL_MAKEOPTS)
102
103 KERNEL_MAKE_FLAGS = \
104 KCFLAGS="$(call iremap,$(BUILD_DIR),$(notdir $(BUILD_DIR)))" \
105 HOSTCFLAGS="$(HOST_CFLAGS) -Wall -Wmissing-prototypes -Wstrict-prototypes" \
106 CROSS_COMPILE="$(KERNEL_CROSS)" \
107 ARCH="$(LINUX_KARCH)" \
108 KBUILD_HAVE_NLS=no \
109 KBUILD_BUILD_USER="$(call qstrip,$(CONFIG_KERNEL_BUILD_USER))" \
110 KBUILD_BUILD_HOST="$(call qstrip,$(CONFIG_KERNEL_BUILD_DOMAIN))" \
111 KBUILD_BUILD_TIMESTAMP="$(KBUILD_BUILD_TIMESTAMP)" \
112 KBUILD_BUILD_VERSION="0" \
113 HOST_LOADLIBES="-L$(STAGING_DIR_HOST)/lib" \
114 KBUILD_HOSTLDLIBS="-L$(STAGING_DIR_HOST)/lib" \
115 CONFIG_SHELL="$(BASH)" \
116 $(if $(findstring c,$(OPENWRT_VERBOSE)),V=1,V='') \
117 $(if $(PKG_BUILD_ID),LDFLAGS_MODULE=--build-id=0x$(PKG_BUILD_ID)) \
118 cmd_syscalls= \
119 $(if $(__package_mk),KBUILD_EXTRA_SYMBOLS="$(wildcard $(PKG_SYMVERS_DIR)/*.symvers)")
120
121 ifeq ($(call qstrip,$(CONFIG_EXTERNAL_KERNEL_TREE))$(call qstrip,$(CONFIG_KERNEL_GIT_CLONE_URI)),)
122 KERNEL_MAKE_FLAGS += \
123 KERNELRELEASE=$(LINUX_VERSION)
124 endif
125
126 KERNEL_MAKEOPTS := -C $(LINUX_DIR) $(KERNEL_MAKE_FLAGS)
127
128 ifdef CONFIG_USE_SPARSE
129 KERNEL_MAKEOPTS += C=1 CHECK=$(STAGING_DIR_HOST)/bin/sparse
130 endif
131
132 ifneq ($(HOST_OS),Linux)
133 KERNEL_MAKEOPTS += CONFIG_STACK_VALIDATION=
134 export SKIP_STACK_VALIDATION:=1
135 endif
136
137 PKG_EXTMOD_SUBDIRS ?= .
138
139 PKG_SYMVERS_DIR = $(KERNEL_BUILD_DIR)/symvers
140
141 define collect_module_symvers
142 for subdir in $(PKG_EXTMOD_SUBDIRS); do \
143 realdir=$$$$(readlink -f $(PKG_BUILD_DIR)); \
144 grep -F $(PKG_BUILD_DIR) $(PKG_BUILD_DIR)/$$$$subdir/Module.symvers >> $(PKG_BUILD_DIR)/Module.symvers.tmp; \
145 [ "$(PKG_BUILD_DIR)" = "$$$$realdir" ] || \
146 grep -F $$$$realdir $(PKG_BUILD_DIR)/$$$$subdir/Module.symvers >> $(PKG_BUILD_DIR)/Module.symvers.tmp; \
147 done; \
148 sort -u $(PKG_BUILD_DIR)/Module.symvers.tmp > $(PKG_BUILD_DIR)/Module.symvers; \
149 mkdir -p $(PKG_SYMVERS_DIR); \
150 mv $(PKG_BUILD_DIR)/Module.symvers $(PKG_SYMVERS_DIR)/$(PKG_NAME).symvers
151 endef
152
153 define KernelPackage/hooks
154 ifneq ($(PKG_NAME),kernel)
155 Hooks/Compile/Post += collect_module_symvers
156 endif
157 define KernelPackage/hooks
158 endef
159 endef
160
161 define KernelPackage/Defaults
162 FILES:=
163 AUTOLOAD:=
164 MODPARAMS:=
165 PKGFLAGS+=nonshared
166 endef
167
168 # 1: name
169 # 2: install prefix
170 # 3: module priority prefix
171 # 4: required for boot
172 # 5: module list
173 define ModuleAutoLoad
174 $(if $(5), \
175 mkdir -p $(2)/etc/modules.d; \
176 ($(foreach mod,$(5), \
177 echo "$(mod)$(if $(MODPARAMS.$(mod)), $(MODPARAMS.$(mod)),$(if $(MODPARAMS), $(MODPARAMS)))"; )) > $(2)/etc/modules.d/$(3)$(1); \
178 $(if $(4), \
179 mkdir -p $(2)/etc/modules-boot.d; \
180 ln -sf ../modules.d/$(3)$(1) $(2)/etc/modules-boot.d/;))
181 endef
182
183 ifeq ($(DUMP)$(TARGET_BUILD),)
184 -include $(LINUX_DIR)/.config
185 endif
186
187 define KernelPackage/depends
188 $(STAMP_BUILT): $(LINUX_DIR)/.config
189 define KernelPackage/depends
190 endef
191 endef
192
193 define KernelPackage
194 NAME:=$(1)
195 $(eval $(call Package/Default))
196 $(eval $(call KernelPackage/Defaults))
197 $(eval $(call KernelPackage/$(1)))
198 $(eval $(call KernelPackage/$(1)/$(BOARD)))
199 $(eval $(call KernelPackage/$(1)/$(BOARD)/$(if $(SUBTARGET),$(SUBTARGET),generic)))
200
201 define Package/kmod-$(1)
202 TITLE:=$(TITLE)
203 SECTION:=kernel
204 CATEGORY:=Kernel modules
205 DESCRIPTION:=$(DESCRIPTION)
206 EXTRA_DEPENDS:=kernel (=$(LINUX_VERSION)-$(LINUX_RELEASE)-$(LINUX_VERMAGIC))
207 VERSION:=$(LINUX_VERSION)$(if $(PKG_VERSION),+$(PKG_VERSION))-$(if $(PKG_RELEASE),$(PKG_RELEASE),$(LINUX_RELEASE))
208 PKGFLAGS:=$(PKGFLAGS)
209 $(call KernelPackage/$(1))
210 $(call KernelPackage/$(1)/$(BOARD))
211 $(call KernelPackage/$(1)/$(BOARD)/$(if $(SUBTARGET),$(SUBTARGET),generic))
212 endef
213
214 ifdef KernelPackage/$(1)/conffiles
215 define Package/kmod-$(1)/conffiles
216 $(call KernelPackage/$(1)/conffiles)
217 endef
218 endif
219
220 ifdef KernelPackage/$(1)/description
221 define Package/kmod-$(1)/description
222 $(call KernelPackage/$(1)/description)
223 endef
224 endif
225
226 ifdef KernelPackage/$(1)/config
227 define Package/kmod-$(1)/config
228 $(call KernelPackage/$(1)/config)
229 endef
230 endif
231
232 $(call KernelPackage/depends)
233 $(call KernelPackage/hooks)
234
235 ifneq ($(if $(filter-out %=y %=n %=m,$(KCONFIG)),$(filter m y,$(foreach c,$(filter-out %=y %=n %=m,$(KCONFIG)),$($(c)))),.),)
236 define Package/kmod-$(1)/install
237 @for mod in $$(call version_filter,$$(FILES)); do \
238 if grep -q "$$$$$$$${mod##$(LINUX_DIR)/}" "$(LINUX_DIR)/modules.builtin"; then \
239 echo "NOTICE: module '$$$$$$$$mod' is built-in."; \
240 elif [ -e $$$$$$$$mod ]; then \
241 mkdir -p $$(1)/$(MODULES_SUBDIR) ; \
242 $(CP) -L $$$$$$$$mod $$(1)/$(MODULES_SUBDIR)/ ; \
243 else \
244 echo "ERROR: module '$$$$$$$$mod' is missing." >&2; \
245 exit 1; \
246 fi; \
247 done;
248 $(call ModuleAutoLoad,$(1),$$(1),$(filter-out 0-,$(word 1,$(AUTOLOAD))-),$(filter-out 0,$(word 2,$(AUTOLOAD))),$(sort $(wordlist 3,99,$(AUTOLOAD))))
249 $(call KernelPackage/$(1)/install,$$(1))
250 endef
251 $(if $(CONFIG_PACKAGE_kmod-$(1)),
252 else
253 compile: $(1)-disabled
254 $(1)-disabled:
255 @echo "WARNING: kmod-$(1) is not available in the kernel config - generating empty package" >&2
256
257 define Package/kmod-$(1)/install
258 true
259 endef
260 )
261 endif
262 $$(eval $$(call BuildPackage,kmod-$(1)))
263
264 $$(IPKG_kmod-$(1)): $$(wildcard $$(call version_filter,$$(FILES)))
265
266 endef
267
268 version_filter=$(if $(findstring @,$(1)),$(shell $(SCRIPT_DIR)/package-metadata.pl version_filter $(KERNEL_PATCHVER) $(1)),$(1))
269
270 # 1: priority (optional)
271 # 2: module list
272 # 3: boot flag
273 define AutoLoad
274 $(if $(1),$(1),0) $(if $(3),1,0) $(call version_filter,$(2))
275 endef
276
277 # 1: module list
278 # 2: boot flag
279 define AutoProbe
280 $(call AutoLoad,,$(1),$(2))
281 endef
282
283 version_field=$(if $(word $(1),$(2)),$(word $(1),$(2)),0)
284 kernel_version_merge=$$(( ($(call version_field,1,$(1)) << 24) + ($(call version_field,2,$(1)) << 16) + ($(call version_field,3,$(1)) << 8) + $(call version_field,4,$(1)) ))
285
286 ifdef DUMP
287 kernel_version_cmp=
288 else
289 kernel_version_cmp=$(shell [ $(call kernel_version_merge,$(call split_version,$(2))) $(1) $(call kernel_version_merge,$(call split_version,$(3))) ] && echo 1 )
290 endif
291
292 CompareKernelPatchVer=$(if $(call kernel_version_cmp,-$(2),$(1),$(3)),1,0)
293
294 kernel_patchver_gt=$(call kernel_version_cmp,-gt,$(KERNEL_PATCHVER),$(1))
295 kernel_patchver_ge=$(call kernel_version_cmp,-ge,$(KERNEL_PATCHVER),$(1))
296 kernel_patchver_eq=$(call kernel_version_cmp,-eq,$(KERNEL_PATCHVER),$(1))
297 kernel_patchver_le=$(call kernel_version_cmp,-le,$(KERNEL_PATCHVER),$(1))
298 kernel_patchver_lt=$(call kernel_version_cmp,-lt,$(KERNEL_PATCHVER),$(1))
299