blob: 0a364e34f50b84c66caecc8e12f8ec5a828322f2 [file] [log] [blame]
Greg Kroah-Hartmanb2441312017-11-01 15:07:57 +01001# SPDX-License-Identifier: GPL-2.0
Linus Torvalds568035b2022-08-14 15:50:18 -07002VERSION = 6
Linus Torvalds84002912024-07-28 14:19:55 -07003PATCHLEVEL = 11
Linus Torvalds55922c92011-05-29 17:43:36 -07004SUBLEVEL = 0
Linus Torvalds7c626ce2024-08-11 14:27:14 -07005EXTRAVERSION = -rc3
Linus Torvalds1613e602024-05-26 15:20:12 -07006NAME = Baby Opossum Posse
Linus Torvalds1da177e2005-04-16 15:20:36 -07007
8# *DOCUMENTATION*
9# To see a list of typical targets execute "make help"
10# More info can be located in ./README
11# Comments in this file are targeted only to the developer, do not
12# expect to learn how to build the kernel reading this file.
13
Masahiro Yamada5f996652024-07-04 22:47:55 +090014ifeq ($(filter output-sync,$(.FEATURES)),)
15$(error GNU Make >= 4.0 is required. Your Make version is $(MAKE_VERSION))
Masahiro Yamada87d599f2022-12-13 20:24:20 +090016endif
17
Masahiro Yamada121c2a12020-05-11 12:50:13 +090018$(if $(filter __%, $(MAKECMDGOALS)), \
19 $(error targets prefixed with '__' are only for internal use))
20
Masahiro Yamadaba634ec2017-10-04 12:56:05 +090021# That's our default target when none is given on the command line
Masahiro Yamada121c2a12020-05-11 12:50:13 +090022PHONY := __all
23__all:
Masahiro Yamadaba634ec2017-10-04 12:56:05 +090024
Linus Torvalds1da177e2005-04-16 15:20:36 -070025# We are using a recursive build, so we need to do a little thinking
26# to get the ordering right.
27#
28# Most importantly: sub-Makefiles should only ever modify files in
29# their own directory. If in some directory we have a dependency on
30# a file in another dir (which doesn't happen often, but it's often
Nicholas Pigginf49821e2018-02-11 00:25:04 +100031# unavoidable when linking the built-in.a targets which finally
Linus Torvalds1da177e2005-04-16 15:20:36 -070032# turn into vmlinux), we will call a sub make in that other dir, and
33# after that we are sure that everything which is in that other dir
34# is now up to date.
35#
36# The only cases where we need to modify files which have global
37# effects are thus separated out and done before the recursive
38# descending is started. They are now explicitly listed as the
39# prepare rule.
40
Masahiro Yamada5fa94ce2023-06-27 08:30:12 +090041this-makefile := $(lastword $(MAKEFILE_LIST))
Masahiro Yamadae2bad142024-03-06 19:42:22 +090042abs_srctree := $(realpath $(dir $(this-makefile)))
43abs_objtree := $(CURDIR)
Masahiro Yamada5fa94ce2023-06-27 08:30:12 +090044
Masahiro Yamada221cc2d2019-03-26 13:02:19 +090045ifneq ($(sub_make_done),1)
Masahiro Yamada3812b8c2019-02-22 16:40:07 +090046
47# Do not use make's built-in rules and variables
48# (this increases performance and avoids hard-to-debug behaviour)
49MAKEFLAGS += -rR
50
51# Avoid funny character set dependencies
52unexport LC_ALL
53LC_COLLATE=C
54LC_NUMERIC=C
55export LC_COLLATE LC_NUMERIC
56
57# Avoid interference with shell env settings
58unexport GREP_OPTIONS
59
Michal Marek066b7ed2014-07-04 14:29:30 +020060# Beautify output
61# ---------------------------------------------------------------------------
62#
Masahiro Yamada8962b6b2022-12-23 01:25:32 +090063# Most of build commands in Kbuild start with "cmd_". You can optionally define
64# "quiet_cmd_*". If defined, the short log is printed. Otherwise, no log from
65# that command is printed by default.
Michal Marek066b7ed2014-07-04 14:29:30 +020066#
Masahiro Yamada8962b6b2022-12-23 01:25:32 +090067# e.g.)
68# quiet_cmd_depmod = DEPMOD $(MODLIB)
69# cmd_depmod = $(srctree)/scripts/depmod.sh $(DEPMOD) $(KERNELRELEASE)
Michal Marek066b7ed2014-07-04 14:29:30 +020070#
71# A simple variant is to prefix commands with $(Q) - that's useful
72# for commands that shall be hidden in non-verbose mode.
73#
Masahiro Yamada8962b6b2022-12-23 01:25:32 +090074# $(Q)$(MAKE) $(build)=scripts/basic
Michal Marek066b7ed2014-07-04 14:29:30 +020075#
Masahiro Yamada6ae4b982022-12-23 01:25:34 +090076# If KBUILD_VERBOSE contains 1, the whole command is echoed.
77# If KBUILD_VERBOSE contains 2, the reason for rebuilding is printed.
Michal Marek066b7ed2014-07-04 14:29:30 +020078#
Linus Torvalds1da177e2005-04-16 15:20:36 -070079# To put more focus on warnings, be less verbose as default
80# Use 'make V=1' to see the full commands
81
Cheng Renquanb8b06182009-05-26 16:03:07 +080082ifeq ("$(origin V)", "command line")
83 KBUILD_VERBOSE = $(V)
Linus Torvalds1da177e2005-04-16 15:20:36 -070084endif
Linus Torvalds1da177e2005-04-16 15:20:36 -070085
Masahiro Yamada6ae4b982022-12-23 01:25:34 +090086quiet = quiet_
87Q = @
88
89ifneq ($(findstring 1, $(KBUILD_VERBOSE)),)
Michal Marek066b7ed2014-07-04 14:29:30 +020090 quiet =
91 Q =
Michal Marek066b7ed2014-07-04 14:29:30 +020092endif
93
94# If the user is running make -s (silent mode), suppress echoing of
95# commands
Masahiro Yamada5f996652024-07-04 22:47:55 +090096ifneq ($(findstring s,$(firstword -$(MAKEFLAGS))),)
Dmitry Goncharov4bf73582022-12-05 16:48:19 -050097quiet=silent_
Masahiro Yamada83d98d72022-12-23 01:25:35 +090098override KBUILD_VERBOSE :=
Michal Marek066b7ed2014-07-04 14:29:30 +020099endif
Michal Marek066b7ed2014-07-04 14:29:30 +0200100
101export quiet Q KBUILD_VERBOSE
102
Masahiro Yamadabcf637f2021-02-22 01:53:06 +0900103# Call a source code checker (by default, "sparse") as part of the
104# C compilation.
105#
106# Use 'make C=1' to enable checking of only re-compiled files.
107# Use 'make C=2' to enable checking of *all* source files, regardless
108# of whether they are re-compiled or not.
109#
110# See the file "Documentation/dev-tools/sparse.rst" for more details,
111# including where to get the "sparse" utility.
112
113ifeq ("$(origin C)", "command line")
114 KBUILD_CHECKSRC = $(C)
115endif
116ifndef KBUILD_CHECKSRC
117 KBUILD_CHECKSRC = 0
118endif
119
120export KBUILD_CHECKSRC
121
Miguel Ojeda2f7ab122021-07-03 16:42:57 +0200122# Enable "clippy" (a linter) as part of the Rust compilation.
123#
124# Use 'make CLIPPY=1' to enable it.
125ifeq ("$(origin CLIPPY)", "command line")
126 KBUILD_CLIPPY := $(CLIPPY)
127endif
128
129export KBUILD_CLIPPY
130
Masahiro Yamadabcf637f2021-02-22 01:53:06 +0900131# Use make M=dir or set the environment variable KBUILD_EXTMOD to specify the
132# directory of external module to build. Setting M= takes precedence.
133ifeq ("$(origin M)", "command line")
134 KBUILD_EXTMOD := $(M)
135endif
136
137$(if $(word 2, $(KBUILD_EXTMOD)), \
138 $(error building multiple external modules is not supported))
139
Masahiro Yamada9a68fd72022-07-14 14:02:42 +0900140$(foreach x, % :, $(if $(findstring $x, $(KBUILD_EXTMOD)), \
141 $(error module directory path cannot contain '$x')))
142
Masahiro Yamada74ee5852021-06-02 23:02:13 +0900143# Remove trailing slashes
144ifneq ($(filter %/, $(KBUILD_EXTMOD)),)
145KBUILD_EXTMOD := $(shell dirname $(KBUILD_EXTMOD).)
146endif
147
Masahiro Yamadabcf637f2021-02-22 01:53:06 +0900148export KBUILD_EXTMOD
149
Masahiro Yamada92ef4322023-11-23 18:05:40 +0900150# backward compatibility
151KBUILD_EXTRA_WARN ?= $(KBUILD_ENABLE_EXTRA_GCC_CHECKS)
152
153ifeq ("$(origin W)", "command line")
154 KBUILD_EXTRA_WARN := $(W)
155endif
156
157export KBUILD_EXTRA_WARN
158
Masahiro Yamada25b146c52019-03-30 21:04:14 +0900159# Kbuild will save output files in the current working directory.
160# This does not need to match to the root of the kernel source tree.
161#
162# For example, you can do this:
163#
164# cd /dir/to/store/output/files; make -f /dir/to/kernel/source/Makefile
165#
166# If you want to save output files in a different location, there are
167# two syntaxes to specify it.
168#
Linus Torvalds1da177e2005-04-16 15:20:36 -0700169# 1) O=
170# Use "make O=dir/to/store/output/files/"
Sam Ravnborg070b98b2006-06-25 00:07:55 +0200171#
Linus Torvalds1da177e2005-04-16 15:20:36 -0700172# 2) Set KBUILD_OUTPUT
Masahiro Yamada25b146c52019-03-30 21:04:14 +0900173# Set the environment variable KBUILD_OUTPUT to point to the output directory.
174# export KBUILD_OUTPUT=dir/to/store/output/files/; make
Linus Torvalds1da177e2005-04-16 15:20:36 -0700175#
176# The O= assignment takes precedence over the KBUILD_OUTPUT environment
177# variable.
178
Masahiro Yamada25b146c52019-03-30 21:04:14 +0900179# Do we want to change the working directory?
Cheng Renquanb8b06182009-05-26 16:03:07 +0800180ifeq ("$(origin O)", "command line")
181 KBUILD_OUTPUT := $(O)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700182endif
183
Masahiro Yamada25b146c52019-03-30 21:04:14 +0900184ifneq ($(KBUILD_OUTPUT),)
Masahiro Yamada7beba042023-12-16 01:06:37 +0900185# $(realpath ...) gets empty if the path does not exist. Run 'mkdir -p' first.
186$(shell mkdir -p "$(KBUILD_OUTPUT)")
Masahiro Yamada25b146c52019-03-30 21:04:14 +0900187# $(realpath ...) resolves symlinks
Masahiro Yamada7beba042023-12-16 01:06:37 +0900188abs_objtree := $(realpath $(KBUILD_OUTPUT))
189$(if $(abs_objtree),,$(error failed to create output directory "$(KBUILD_OUTPUT)"))
Masahiro Yamada25b146c52019-03-30 21:04:14 +0900190endif # ifneq ($(KBUILD_OUTPUT),)
191
Masahiro Yamada25b146c52019-03-30 21:04:14 +0900192ifneq ($(words $(subst :, ,$(abs_srctree))), 1)
193$(error source directory cannot contain spaces or colons)
194endif
195
Masahiro Yamada221cc2d2019-03-26 13:02:19 +0900196export sub_make_done := 1
197
Masahiro Yamada5fc10e72023-06-27 08:30:13 +0900198endif # sub_make_done
199
200ifeq ($(abs_objtree),$(CURDIR))
201# Suppress "Entering directory ..." if we are at the final work directory.
202no-print-directory := --no-print-directory
203else
204# Recursion to show "Entering directory ..."
205need-sub-make := 1
206endif
207
208ifeq ($(filter --no-print-directory, $(MAKEFLAGS)),)
209# If --no-print-directory is unset, recurse once again to set it.
210# You may end up recursing into __sub-make twice. This is needed due to the
211# behavior change in GNU Make 4.4.1.
212need-sub-make := 1
213endif
214
Masahiro Yamada688931a2019-03-19 13:02:36 +0900215ifeq ($(need-sub-make),1)
216
Masahiro Yamada121c2a12020-05-11 12:50:13 +0900217PHONY += $(MAKECMDGOALS) __sub-make
Milton Miller0b357862007-09-21 18:09:02 -0500218
Masahiro Yamada121c2a12020-05-11 12:50:13 +0900219$(filter-out $(this-makefile), $(MAKECMDGOALS)) __all: __sub-make
Charles Keepax16f89092012-10-15 13:49:12 +0100220 @:
Milton Miller0b357862007-09-21 18:09:02 -0500221
Cao jinc4e6fff2017-06-30 10:45:43 +0800222# Invoke a second make in the output directory, passing relevant variables
Masahiro Yamada121c2a12020-05-11 12:50:13 +0900223__sub-make:
Masahiro Yamada5fc10e72023-06-27 08:30:13 +0900224 $(Q)$(MAKE) $(no-print-directory) -C $(abs_objtree) \
225 -f $(abs_srctree)/Makefile $(MAKECMDGOALS)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700226
Masahiro Yamada5fc10e72023-06-27 08:30:13 +0900227else # need-sub-make
Masahiro Yamada688931a2019-03-19 13:02:36 +0900228
Linus Torvalds1da177e2005-04-16 15:20:36 -0700229# We process the rest of the Makefile if this is the final invocation of make
Masahiro Yamada7ff52572014-09-09 20:02:22 +0900230
Masahiro Yamada25b146c52019-03-30 21:04:14 +0900231ifeq ($(abs_srctree),$(abs_objtree))
Michal Marek9da07632014-04-25 23:25:18 +0200232 # building in the source tree
233 srctree := .
Masahiro Yamada051f2782019-07-06 12:07:12 +0900234 building_out_of_srctree :=
Michal Marek9da07632014-04-25 23:25:18 +0200235else
Masahiro Yamada25b146c52019-03-30 21:04:14 +0900236 ifeq ($(abs_srctree)/,$(dir $(abs_objtree)))
Michal Marek9da07632014-04-25 23:25:18 +0200237 # building in a subdirectory of the source tree
238 srctree := ..
239 else
Masahiro Yamada25b146c52019-03-30 21:04:14 +0900240 srctree := $(abs_srctree)
Michal Marek9da07632014-04-25 23:25:18 +0200241 endif
Masahiro Yamada051f2782019-07-06 12:07:12 +0900242 building_out_of_srctree := 1
Michal Marek9da07632014-04-25 23:25:18 +0200243endif
Masahiro Yamada2c1f4f12017-10-04 12:56:06 +0900244
Masahiro Yamada95fd3f82019-07-06 12:07:13 +0900245ifneq ($(KBUILD_ABS_SRCTREE),)
246srctree := $(abs_srctree)
247endif
Masahiro Yamada2c1f4f12017-10-04 12:56:06 +0900248
Michal Marek7e1c0472014-04-25 17:29:45 +0200249objtree := .
Masahiro Yamadab1992c32024-04-27 23:55:02 +0900250
251VPATH :=
252
253ifeq ($(KBUILD_EXTMOD),)
254ifdef building_out_of_srctree
Masahiro Yamada6b12de62019-02-22 16:40:09 +0900255VPATH := $(srctree)
Masahiro Yamadab1992c32024-04-27 23:55:02 +0900256endif
257endif
Linus Torvalds1da177e2005-04-16 15:20:36 -0700258
Masahiro Yamada051f2782019-07-06 12:07:12 +0900259export building_out_of_srctree srctree objtree VPATH
Linus Torvalds1da177e2005-04-16 15:20:36 -0700260
Masahiro Yamada2c1f4f12017-10-04 12:56:06 +0900261# To make sure we do not include .config for any of the *config targets
262# catch them early, and hand them over to scripts/kconfig/Makefile
263# It is allowed to specify more targets when calling make, including
264# mixing *config targets and build targets.
265# For example 'make oldconfig all'.
266# Detect when mixed targets is specified, and make a second invocation
267# of make so .config is not included in this case either (for *config).
268
269version_h := include/generated/uapi/linux/version.h
Masahiro Yamada2c1f4f12017-10-04 12:56:06 +0900270
Masahiro Yamada22340a02018-02-11 17:40:29 +0900271clean-targets := %clean mrproper cleandocs
272no-dot-config-targets := $(clean-targets) \
Masahiro Yamada2c1f4f12017-10-04 12:56:06 +0900273 cscope gtags TAGS tags help% %docs check% coccicheck \
Masahiro Yamada59b2bd02019-06-04 19:14:02 +0900274 $(version_h) headers headers_% archheaders archscripts \
David Engraf46239802020-03-26 20:29:33 +0100275 %asm-generic kernelversion %src-pkg dt_binding_check \
Masahiro Yamada05e96e92023-03-16 00:50:18 +0900276 outputmakefile rustavailable rustfmt rustfmtcheck
Masahiro Yamadaeb931e12023-08-23 20:50:42 +0900277no-sync-config-targets := $(no-dot-config-targets) %install modules_sign kernelrelease \
Masahiro Yamada993bdde2021-02-28 15:10:25 +0900278 image_name
Masahiro Yamadaaa4847d2022-12-29 21:16:42 +0900279single-targets := %.a %.i %.ko %.lds %.ll %.lst %.mod %.o %.rsi %.s %.symtypes %/
Masahiro Yamada2c1f4f12017-10-04 12:56:06 +0900280
Masahiro Yamada2042b542019-08-11 00:53:03 +0900281config-build :=
282mixed-build :=
283need-config := 1
284may-sync-config := 1
Masahiro Yamada394053f2019-08-15 00:19:18 +0900285single-build :=
Masahiro Yamada2c1f4f12017-10-04 12:56:06 +0900286
287ifneq ($(filter $(no-dot-config-targets), $(MAKECMDGOALS)),)
Masahiro Yamada3b9ab242024-02-02 10:31:42 +0900288 ifeq ($(filter-out $(no-dot-config-targets), $(MAKECMDGOALS)),)
Masahiro Yamada50a33992024-03-01 20:21:07 +0900289 need-config :=
Masahiro Yamada3b9ab242024-02-02 10:31:42 +0900290 endif
Masahiro Yamada2c1f4f12017-10-04 12:56:06 +0900291endif
292
Masahiro Yamadad7942412018-07-20 16:46:34 +0900293ifneq ($(filter $(no-sync-config-targets), $(MAKECMDGOALS)),)
Masahiro Yamada3b9ab242024-02-02 10:31:42 +0900294 ifeq ($(filter-out $(no-sync-config-targets), $(MAKECMDGOALS)),)
Masahiro Yamada50a33992024-03-01 20:21:07 +0900295 may-sync-config :=
Masahiro Yamada3b9ab242024-02-02 10:31:42 +0900296 endif
Masahiro Yamadad7942412018-07-20 16:46:34 +0900297endif
298
Masahiro Yamada9d361172023-10-14 19:54:36 +0900299need-compiler := $(may-sync-config)
300
Masahiro Yamadad7942412018-07-20 16:46:34 +0900301ifneq ($(KBUILD_EXTMOD),)
Masahiro Yamada50a33992024-03-01 20:21:07 +0900302 may-sync-config :=
Masahiro Yamadad7942412018-07-20 16:46:34 +0900303endif
304
Masahiro Yamada2c1f4f12017-10-04 12:56:06 +0900305ifeq ($(KBUILD_EXTMOD),)
Masahiro Yamada50a33992024-03-01 20:21:07 +0900306 ifneq ($(filter %config,$(MAKECMDGOALS)),)
307 config-build := 1
308 ifneq ($(words $(MAKECMDGOALS)),1)
309 mixed-build := 1
Masahiro Yamada2c1f4f12017-10-04 12:56:06 +0900310 endif
Masahiro Yamada50a33992024-03-01 20:21:07 +0900311 endif
Masahiro Yamada2c1f4f12017-10-04 12:56:06 +0900312endif
Masahiro Yamada22340a02018-02-11 17:40:29 +0900313
Masahiro Yamada394053f2019-08-15 00:19:18 +0900314# We cannot build single targets and the others at the same time
315ifneq ($(filter $(single-targets), $(MAKECMDGOALS)),)
Masahiro Yamada50a33992024-03-01 20:21:07 +0900316 single-build := 1
Masahiro Yamada3b9ab242024-02-02 10:31:42 +0900317 ifneq ($(filter-out $(single-targets), $(MAKECMDGOALS)),)
Masahiro Yamada50a33992024-03-01 20:21:07 +0900318 mixed-build := 1
Masahiro Yamada3b9ab242024-02-02 10:31:42 +0900319 endif
Masahiro Yamada394053f2019-08-15 00:19:18 +0900320endif
321
Masahiro Yamada22340a02018-02-11 17:40:29 +0900322# For "make -j clean all", "make -j mrproper defconfig all", etc.
323ifneq ($(filter $(clean-targets),$(MAKECMDGOALS)),)
Masahiro Yamada50a33992024-03-01 20:21:07 +0900324 ifneq ($(filter-out $(clean-targets),$(MAKECMDGOALS)),)
325 mixed-build := 1
326 endif
Masahiro Yamada22340a02018-02-11 17:40:29 +0900327endif
328
Masahiro Yamada2c1f4f12017-10-04 12:56:06 +0900329# install and modules_install need also be processed one by one
330ifneq ($(filter install,$(MAKECMDGOALS)),)
Masahiro Yamada50a33992024-03-01 20:21:07 +0900331 ifneq ($(filter modules_install,$(MAKECMDGOALS)),)
332 mixed-build := 1
333 endif
Masahiro Yamada2c1f4f12017-10-04 12:56:06 +0900334endif
335
Masahiro Yamada2042b542019-08-11 00:53:03 +0900336ifdef mixed-build
Masahiro Yamada2c1f4f12017-10-04 12:56:06 +0900337# ===========================================================================
338# We're called with mixed targets (*config and build targets).
339# Handle them one by one.
340
341PHONY += $(MAKECMDGOALS) __build_one_by_one
342
Masahiro Yamada121c2a12020-05-11 12:50:13 +0900343$(MAKECMDGOALS): __build_one_by_one
Masahiro Yamada2c1f4f12017-10-04 12:56:06 +0900344 @:
345
346__build_one_by_one:
347 $(Q)set -e; \
348 for i in $(MAKECMDGOALS); do \
349 $(MAKE) -f $(srctree)/Makefile $$i; \
350 done
351
Masahiro Yamada2042b542019-08-11 00:53:03 +0900352else # !mixed-build
Masahiro Yamada2c1f4f12017-10-04 12:56:06 +0900353
Masahiro Yamada3204a7f2021-02-28 15:10:26 +0900354include $(srctree)/scripts/Kbuild.include
Masahiro Yamada2c1f4f12017-10-04 12:56:06 +0900355
356# Read KERNELRELEASE from include/config/kernel.release (if it exists)
Masahiro Yamada6768fa42022-12-11 11:54:47 +0900357KERNELRELEASE = $(call read-file, include/config/kernel.release)
Masahiro Yamada2c1f4f12017-10-04 12:56:06 +0900358KERNELVERSION = $(VERSION)$(if $(PATCHLEVEL),.$(PATCHLEVEL)$(if $(SUBLEVEL),.$(SUBLEVEL)))$(EXTRAVERSION)
359export VERSION PATCHLEVEL SUBLEVEL KERNELRELEASE KERNELVERSION
360
Masahiro Yamada3204a7f2021-02-28 15:10:26 +0900361include $(srctree)/scripts/subarch.include
Linus Torvalds1da177e2005-04-16 15:20:36 -0700362
363# Cross compiling and selecting different set of gcc/bin-utils
364# ---------------------------------------------------------------------------
365#
366# When performing cross compilation for other architectures ARCH shall be set
367# to the target architecture. (See arch/* for the possibilities).
368# ARCH can be set during invocation of make:
Ard Biesheuvel94483492023-01-13 18:32:57 +0100369# make ARCH=arm64
Linus Torvalds1da177e2005-04-16 15:20:36 -0700370# Another way is to have ARCH set in the environment.
371# The default ARCH is the host where make is executed.
372
373# CROSS_COMPILE specify the prefix used for all executables used
374# during compilation. Only gcc and related bin-utils executables
375# are prefixed with $(CROSS_COMPILE).
376# CROSS_COMPILE can be set on the command line
Ard Biesheuvel94483492023-01-13 18:32:57 +0100377# make CROSS_COMPILE=aarch64-linux-gnu-
Linus Torvalds1da177e2005-04-16 15:20:36 -0700378# Alternatively CROSS_COMPILE can be set in the environment.
379# Default value for CROSS_COMPILE is not to prefix executables
380# Note: Some architectures assign CROSS_COMPILE in their arch/*/Makefile
Sam Ravnborg2331d1a2009-10-11 23:22:58 +0200381ARCH ?= $(SUBARCH)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700382
383# Architecture as present in compile.h
Thomas Gleixner6752ed92007-10-11 11:11:36 +0200384UTS_MACHINE := $(ARCH)
385SRCARCH := $(ARCH)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700386
Sam Ravnborgd746d642007-11-12 20:14:19 +0100387# Additional ARCH settings for x86
388ifeq ($(ARCH),i386)
389 SRCARCH := x86
390endif
391ifeq ($(ARCH),x86_64)
392 SRCARCH := x86
393endif
Sam Ravnborg74b469f2007-10-25 19:42:04 +0200394
Sam Ravnborg5e538792008-12-02 23:17:12 -0800395# Additional ARCH settings for sparc
Namhyung Kime69f58c2010-10-25 05:48:23 +0000396ifeq ($(ARCH),sparc32)
397 SRCARCH := sparc
398endif
Sam Ravnborga439fe52008-07-27 23:00:59 +0200399ifeq ($(ARCH),sparc64)
Sam Ravnborg5e538792008-12-02 23:17:12 -0800400 SRCARCH := sparc
Sam Ravnborga439fe52008-07-27 23:00:59 +0200401endif
Sam Ravnborg2fb9b1b2008-06-21 00:24:17 +0200402
Masahiro Yamada5f6e0fe02021-06-10 11:03:31 +0900403# Additional ARCH settings for parisc
404ifeq ($(ARCH),parisc64)
405 SRCARCH := parisc
406endif
407
Masahiro Yamadaf02aa482021-04-10 23:31:58 +0900408export cross_compiling :=
409ifneq ($(SRCARCH),$(SUBARCH))
410cross_compiling := 1
411endif
412
Roman Zippel14cdd3c2006-06-08 22:12:51 -0700413KCONFIG_CONFIG ?= .config
Ben Gardiner41263fc2010-12-14 11:39:44 -0500414export KCONFIG_CONFIG
Roman Zippel14cdd3c2006-06-08 22:12:51 -0700415
Linus Torvalds1da177e2005-04-16 15:20:36 -0700416# SHELL used by kbuild
Masahiro Yamada858805b2019-08-25 22:28:37 +0900417CONFIG_SHELL := sh
Linus Torvalds1da177e2005-04-16 15:20:36 -0700418
Masahiro Yamada6d79a7b2018-07-12 19:38:36 +0900419HOST_LFS_CFLAGS := $(shell getconf LFS_CFLAGS 2>/dev/null)
420HOST_LFS_LDFLAGS := $(shell getconf LFS_LDFLAGS 2>/dev/null)
421HOST_LFS_LIBS := $(shell getconf LFS_LIBS 2>/dev/null)
Uwe Kleine-Königd7f14c62017-07-09 20:02:36 +0200422
Masahiro Yamadaa0d1c952020-04-08 10:36:23 +0900423ifneq ($(LLVM),)
Nathan Chancellore9c28192022-03-04 10:08:14 -0700424ifneq ($(filter %/,$(LLVM)),)
425LLVM_PREFIX := $(LLVM)
426else ifneq ($(filter -%,$(LLVM)),)
427LLVM_SUFFIX := $(LLVM)
428endif
429
430HOSTCC = $(LLVM_PREFIX)clang$(LLVM_SUFFIX)
431HOSTCXX = $(LLVM_PREFIX)clang++$(LLVM_SUFFIX)
Masahiro Yamadaa0d1c952020-04-08 10:36:23 +0900432else
433HOSTCC = gcc
434HOSTCXX = g++
435endif
Miguel Ojeda2f7ab122021-07-03 16:42:57 +0200436HOSTRUSTC = rustc
Chun-Tse Shaod5ea4fe2022-04-01 23:18:02 +0000437HOSTPKG_CONFIG = pkg-config
Masahiro Yamada7f3a59d2020-04-29 12:45:14 +0900438
Elliot Bermanf67695c92022-02-01 13:35:42 -0800439KBUILD_USERHOSTCFLAGS := -Wall -Wmissing-prototypes -Wstrict-prototypes \
Peter Zijlstrab5ec6fd2023-06-09 11:28:30 +0200440 -O2 -fomit-frame-pointer -std=gnu11
Elliot Bermanf67695c92022-02-01 13:35:42 -0800441KBUILD_USERCFLAGS := $(KBUILD_USERHOSTCFLAGS) $(USERCFLAGS)
442KBUILD_USERLDFLAGS := $(USERLDFLAGS)
Masahiro Yamada7f3a59d2020-04-29 12:45:14 +0900443
Miguel Ojeda2f7ab122021-07-03 16:42:57 +0200444# These flags apply to all Rust code in the tree, including the kernel and
445# host programs.
446export rust_common_flags := --edition=2021 \
447 -Zbinary_dep_depinfo=y \
Miguel Ojedaf8f88aa2024-07-09 18:05:59 +0200448 -Dunsafe_op_in_unsafe_fn \
449 -Dnon_ascii_idents \
450 -Wrust_2018_idioms \
451 -Wunreachable_pub \
Miguel Ojeda2f7ab122021-07-03 16:42:57 +0200452 -Wmissing_docs \
Miguel Ojedaf8f88aa2024-07-09 18:05:59 +0200453 -Wrustdoc::missing_crate_level_docs \
Miguel Ojedabb421b52024-07-09 18:06:00 +0200454 -Wclippy::all \
455 -Wclippy::mut_mut \
Miguel Ojedaf8f88aa2024-07-09 18:05:59 +0200456 -Wclippy::needless_bitwise_bool \
457 -Wclippy::needless_continue \
458 -Wclippy::no_mangle_with_rust_abi \
Miguel Ojeda2f7ab122021-07-03 16:42:57 +0200459 -Wclippy::dbg_macro
460
Masahiro Yamadafbaf2422024-07-20 16:27:38 +0900461KBUILD_HOSTCFLAGS := $(KBUILD_USERHOSTCFLAGS) $(HOST_LFS_CFLAGS) \
462 $(HOSTCFLAGS) -I $(srctree)/scripts/include
463KBUILD_HOSTCXXFLAGS := -Wall -O2 $(HOST_LFS_CFLAGS) $(HOSTCXXFLAGS) \
464 -I $(srctree)/scripts/include
Miguel Ojeda2f7ab122021-07-03 16:42:57 +0200465KBUILD_HOSTRUSTFLAGS := $(rust_common_flags) -O -Cstrip=debuginfo \
466 -Zallow-features= $(HOSTRUSTFLAGS)
Laura Abbottf92d19e2018-07-09 17:46:02 -0700467KBUILD_HOSTLDFLAGS := $(HOST_LFS_LDFLAGS) $(HOSTLDFLAGS)
468KBUILD_HOSTLDLIBS := $(HOST_LFS_LIBS) $(HOSTLDLIBS)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700469
Linus Torvalds1da177e2005-04-16 15:20:36 -0700470# Make variables (CC, etc...)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700471CPP = $(CC) -E
Masahiro Yamadaa0d1c952020-04-08 10:36:23 +0900472ifneq ($(LLVM),)
Nathan Chancellore9c28192022-03-04 10:08:14 -0700473CC = $(LLVM_PREFIX)clang$(LLVM_SUFFIX)
474LD = $(LLVM_PREFIX)ld.lld$(LLVM_SUFFIX)
475AR = $(LLVM_PREFIX)llvm-ar$(LLVM_SUFFIX)
476NM = $(LLVM_PREFIX)llvm-nm$(LLVM_SUFFIX)
477OBJCOPY = $(LLVM_PREFIX)llvm-objcopy$(LLVM_SUFFIX)
478OBJDUMP = $(LLVM_PREFIX)llvm-objdump$(LLVM_SUFFIX)
479READELF = $(LLVM_PREFIX)llvm-readelf$(LLVM_SUFFIX)
480STRIP = $(LLVM_PREFIX)llvm-strip$(LLVM_SUFFIX)
Masahiro Yamadaa0d1c952020-04-08 10:36:23 +0900481else
482CC = $(CROSS_COMPILE)gcc
483LD = $(CROSS_COMPILE)ld
Linus Torvalds1da177e2005-04-16 15:20:36 -0700484AR = $(CROSS_COMPILE)ar
485NM = $(CROSS_COMPILE)nm
Linus Torvalds1da177e2005-04-16 15:20:36 -0700486OBJCOPY = $(CROSS_COMPILE)objcopy
487OBJDUMP = $(CROSS_COMPILE)objdump
Dmitry Golovineefb8c12019-12-05 00:54:41 +0200488READELF = $(CROSS_COMPILE)readelf
Masahiro Yamadaa0d1c952020-04-08 10:36:23 +0900489STRIP = $(CROSS_COMPILE)strip
490endif
Miguel Ojeda2f7ab122021-07-03 16:42:57 +0200491RUSTC = rustc
492RUSTDOC = rustdoc
493RUSTFMT = rustfmt
494CLIPPY_DRIVER = clippy-driver
495BINDGEN = bindgen
Andrii Nakryikoe83b9f52019-04-02 09:49:50 -0700496PAHOLE = pahole
Jiri Olsac9a0f3b2020-07-11 23:53:24 +0200497RESOLVE_BTFIDS = $(objtree)/tools/bpf/resolve_btfids/resolve_btfids
Masahiro Yamada73a4f6d2017-12-10 01:02:28 +0900498LEX = flex
499YACC = bison
Linus Torvalds1da177e2005-04-16 15:20:36 -0700500AWK = awk
Sam Ravnborgcaa27b62009-07-20 21:37:11 +0200501INSTALLKERNEL := installkernel
Linus Torvalds1da177e2005-04-16 15:20:36 -0700502PERL = perl
Masahiro Yamadae9781b52018-03-13 18:12:02 +0900503PYTHON3 = python3
Linus Torvalds1da177e2005-04-16 15:20:36 -0700504CHECK = sparse
Masahiro Yamada858805b2019-08-25 22:28:37 +0900505BASH = bash
Denis Efremove4a42c82020-06-08 12:59:44 +0300506KGZIP = gzip
507KBZIP2 = bzip2
508KLZOP = lzop
Denis Efremov8dfb61d2020-06-05 10:39:55 +0300509LZMA = lzma
510LZ4 = lz4c
511XZ = xz
Nick Terrell48f7ddf2020-07-30 12:08:36 -0700512ZSTD = zstd
Denis Efremov8dfb61d2020-06-05 10:39:55 +0300513
Hannes Eder80a7d1d2008-12-27 22:38:44 +0100514CHECKFLAGS := -D__linux__ -Dlinux -D__STDC__ -Dunix -D__unix__ \
Luc Van Oostenryck6c49f352018-02-15 22:07:50 +0100515 -Wbitwise -Wno-return-void -Wno-unknown-attribute $(CF)
Douglas Anderson0c22be02019-03-14 16:41:59 -0700516NOSTDINC_FLAGS :=
Sam Ravnborg65881692010-07-28 17:33:09 +0200517CFLAGS_MODULE =
Miguel Ojeda2f7ab122021-07-03 16:42:57 +0200518RUSTFLAGS_MODULE =
Sam Ravnborg65881692010-07-28 17:33:09 +0200519AFLAGS_MODULE =
520LDFLAGS_MODULE =
Linus Torvalds1da177e2005-04-16 15:20:36 -0700521CFLAGS_KERNEL =
Miguel Ojeda2f7ab122021-07-03 16:42:57 +0200522RUSTFLAGS_KERNEL =
Linus Torvalds1da177e2005-04-16 15:20:36 -0700523AFLAGS_KERNEL =
Masahiro Yamada8debed32023-01-09 04:23:17 +0900524LDFLAGS_vmlinux =
Linus Torvalds1da177e2005-04-16 15:20:36 -0700525
David Howellsabbf1592012-10-02 18:01:26 +0100526# Use USERINCLUDE when you must reference the UAPI directories only.
527USERINCLUDE := \
Masahiro Yamada9d022c52017-10-04 12:56:04 +0900528 -I$(srctree)/arch/$(SRCARCH)/include/uapi \
529 -I$(objtree)/arch/$(SRCARCH)/include/generated/uapi \
David Howellsabbf1592012-10-02 18:01:26 +0100530 -I$(srctree)/include/uapi \
Arnd Bergmann3308b282016-06-15 17:45:45 +0200531 -I$(objtree)/include/generated/uapi \
Masahiro Yamadace6ed1c2021-03-04 20:37:08 +0900532 -include $(srctree)/include/linux/compiler-version.h \
David Howellsabbf1592012-10-02 18:01:26 +0100533 -include $(srctree)/include/linux/kconfig.h
534
Linus Torvalds1da177e2005-04-16 15:20:36 -0700535# Use LINUXINCLUDE when you must reference the include/ directory.
536# Needed to be compatible with the O= option
David Howellsabbf1592012-10-02 18:01:26 +0100537LINUXINCLUDE := \
Masahiro Yamada9d022c52017-10-04 12:56:04 +0900538 -I$(srctree)/arch/$(SRCARCH)/include \
539 -I$(objtree)/arch/$(SRCARCH)/include/generated \
Masahiro Yamada051f2782019-07-06 12:07:12 +0900540 $(if $(building_out_of_srctree),-I$(srctree)/include) \
Masahiro Yamadaf8224f72017-06-06 16:15:28 +0900541 -I$(objtree)/include \
542 $(USERINCLUDE)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700543
Masahiro Yamada42a92bc2018-12-14 17:05:37 +0900544KBUILD_AFLAGS := -D__ASSEMBLY__ -fno-PIE
Alexey Dobriyan0817d252023-07-13 21:52:28 +0300545
546KBUILD_CFLAGS :=
547KBUILD_CFLAGS += -std=gnu11
548KBUILD_CFLAGS += -fshort-wchar
549KBUILD_CFLAGS += -funsigned-char
550KBUILD_CFLAGS += -fno-common
551KBUILD_CFLAGS += -fno-PIE
552KBUILD_CFLAGS += -fno-strict-aliasing
Alexey Dobriyan0817d252023-07-13 21:52:28 +0300553
Masahiro Yamada433dc2e2017-10-12 18:22:25 +0900554KBUILD_CPPFLAGS := -D__KERNEL__
Miguel Ojeda2f7ab122021-07-03 16:42:57 +0200555KBUILD_RUSTFLAGS := $(rust_common_flags) \
Miguel Ojeda2f7ab122021-07-03 16:42:57 +0200556 -Cpanic=abort -Cembed-bitcode=n -Clto=n \
557 -Cforce-unwind-tables=n -Ccodegen-units=1 \
558 -Csymbol-mangling-version=v0 \
559 -Crelocation-model=static \
560 -Zfunction-sections=n \
Miguel Ojedaf8f88aa2024-07-09 18:05:59 +0200561 -Wclippy::float_arithmetic
Miguel Ojeda2f7ab122021-07-03 16:42:57 +0200562
Sam Ravnborg80c00ba2010-07-28 19:11:27 +0200563KBUILD_AFLAGS_KERNEL :=
564KBUILD_CFLAGS_KERNEL :=
Miguel Ojeda2f7ab122021-07-03 16:42:57 +0200565KBUILD_RUSTFLAGS_KERNEL :=
Sam Ravnborg65881692010-07-28 17:33:09 +0200566KBUILD_AFLAGS_MODULE := -DMODULE
567KBUILD_CFLAGS_MODULE := -DMODULE
Miguel Ojeda2f7ab122021-07-03 16:42:57 +0200568KBUILD_RUSTFLAGS_MODULE := --cfg MODULE
Masahiro Yamada10df0632019-08-15 01:06:22 +0900569KBUILD_LDFLAGS_MODULE :=
Masahiro Yamadad503ac52018-08-24 08:20:39 +0900570KBUILD_LDFLAGS :=
Masahiro Yamada5241ab4c2019-07-29 18:15:17 +0900571CLANG_FLAGS :=
Linus Torvalds1da177e2005-04-16 15:20:36 -0700572
Miguel Ojeda2f7ab122021-07-03 16:42:57 +0200573ifeq ($(KBUILD_CLIPPY),1)
574 RUSTC_OR_CLIPPY_QUIET := CLIPPY
575 RUSTC_OR_CLIPPY = $(CLIPPY_DRIVER)
576else
577 RUSTC_OR_CLIPPY_QUIET := RUSTC
578 RUSTC_OR_CLIPPY = $(RUSTC)
579endif
580
581ifdef RUST_LIB_SRC
582 export RUST_LIB_SRC
583endif
584
585# Allows the usage of unstable features in stable compilers.
586export RUSTC_BOOTSTRAP := 1
587
Chun-Tse Shaod5ea4fe2022-04-01 23:18:02 +0000588export ARCH SRCARCH CONFIG_SHELL BASH HOSTCC KBUILD_HOSTCFLAGS CROSS_COMPILE LD CC HOSTPKG_CONFIG
Miguel Ojeda9ffc80c2024-05-28 18:35:02 +0200589export RUSTC RUSTDOC RUSTFMT RUSTC_OR_CLIPPY_QUIET RUSTC_OR_CLIPPY BINDGEN
Miguel Ojeda2f7ab122021-07-03 16:42:57 +0200590export HOSTRUSTC KBUILD_HOSTRUSTFLAGS
Vasily Gorbikd9b56652020-10-23 13:57:32 +0200591export CPP AR NM STRIP OBJCOPY OBJDUMP READELF PAHOLE RESOLVE_BTFIDS LEX YACC AWK INSTALLKERNEL
Masahiro Yamadad8d2d382021-02-01 10:00:24 +0900592export PERL PYTHON3 CHECK CHECKFLAGS MAKE UTS_MACHINE HOSTCXX
Nick Terrell48f7ddf2020-07-30 12:08:36 -0700593export KGZIP KBZIP2 KLZOP LZMA LZ4 XZ ZSTD
Vasily Gorbik7bac9872019-01-21 13:54:39 +0100594export KBUILD_HOSTCXXFLAGS KBUILD_HOSTLDFLAGS KBUILD_HOSTLDLIBS LDFLAGS_MODULE
Elliot Bermanf67695c92022-02-01 13:35:42 -0800595export KBUILD_USERCFLAGS KBUILD_USERLDFLAGS
Linus Torvalds1da177e2005-04-16 15:20:36 -0700596
Masahiro Yamadad503ac52018-08-24 08:20:39 +0900597export KBUILD_CPPFLAGS NOSTDINC_FLAGS LINUXINCLUDE OBJCOPYFLAGS KBUILD_LDFLAGS
Andrey Konovalov0e410e12018-02-06 15:36:00 -0800598export KBUILD_CFLAGS CFLAGS_KERNEL CFLAGS_MODULE
Miguel Ojeda2f7ab122021-07-03 16:42:57 +0200599export KBUILD_RUSTFLAGS RUSTFLAGS_KERNEL RUSTFLAGS_MODULE
Sam Ravnborg222d3942007-10-15 21:59:31 +0200600export KBUILD_AFLAGS AFLAGS_KERNEL AFLAGS_MODULE
Miguel Ojeda2f7ab122021-07-03 16:42:57 +0200601export KBUILD_AFLAGS_MODULE KBUILD_CFLAGS_MODULE KBUILD_RUSTFLAGS_MODULE KBUILD_LDFLAGS_MODULE
602export KBUILD_AFLAGS_KERNEL KBUILD_CFLAGS_KERNEL KBUILD_RUSTFLAGS_KERNEL
Linus Torvalds1da177e2005-04-16 15:20:36 -0700603
Linus Torvalds1da177e2005-04-16 15:20:36 -0700604# Files to ignore in find ... statements
605
Prarit Bhargavaae63b2d2014-02-06 07:51:42 -0500606export RCS_FIND_IGNORE := \( -name SCCS -o -name BitKeeper -o -name .svn -o \
607 -name CVS -o -name .pc -o -name .hg -o -name .git \) \
608 -prune -o
Linus Torvalds1da177e2005-04-16 15:20:36 -0700609
610# ===========================================================================
611# Rules shared between *config targets and build targets
612
Cao jin312a3d02017-08-02 10:31:06 +0800613# Basic helpers built in scripts/basic/
Paul Smith4f193362006-03-05 17:14:10 -0500614PHONY += scripts_basic
Linus Torvalds1da177e2005-04-16 15:20:36 -0700615scripts_basic:
616 $(Q)$(MAKE) $(build)=scripts/basic
617
Paul Smith4f193362006-03-05 17:14:10 -0500618PHONY += outputmakefile
Masahiro Yamada2728fcf2021-05-17 16:03:11 +0900619ifdef building_out_of_srctree
Masahiro Yamadae8e83a22019-08-22 13:46:11 +0900620# Before starting out-of-tree build, make sure the source tree is clean.
Jan Beulichfd5f0cd2006-05-02 12:33:20 +0200621# outputmakefile generates a Makefile in the output directory, if using a
622# separate output directory. This allows convenient use of make in the
623# output directory.
Vladimir Kondratiev3a51ff32019-02-03 10:48:40 +0200624# At the same time when output Makefile generated, generate .gitignore to
625# ignore whole output directory
Masahiro Yamada2728fcf2021-05-17 16:03:11 +0900626
627quiet_cmd_makefile = GEN Makefile
628 cmd_makefile = { \
629 echo "\# Automatically generated by $(srctree)/Makefile: don't edit"; \
630 echo "include $(srctree)/Makefile"; \
631 } > Makefile
632
Linus Torvalds1da177e2005-04-16 15:20:36 -0700633outputmakefile:
Masahiro Yamada4b098652022-09-24 17:24:25 +0900634 @if [ -f $(srctree)/.config -o \
Masahiro Yamadae8e83a22019-08-22 13:46:11 +0900635 -d $(srctree)/include/config -o \
636 -d $(srctree)/arch/$(SRCARCH)/include/generated ]; then \
637 echo >&2 "***"; \
638 echo >&2 "*** The source tree is not clean, please run 'make$(if $(findstring command line, $(origin ARCH)), ARCH=$(ARCH)) mrproper'"; \
639 echo >&2 "*** in $(abs_srctree)";\
640 echo >&2 "***"; \
641 false; \
642 fi
Andi Kleen92979992009-01-10 04:56:13 +0100643 $(Q)ln -fsn $(srctree) source
Masahiro Yamada2728fcf2021-05-17 16:03:11 +0900644 $(call cmd,makefile)
Masahiro Yamada156e7cb2019-03-26 13:26:58 +0900645 $(Q)test -e .gitignore || \
646 { echo "# this is build directory, ignore it"; echo "*"; } > .gitignore
Jan Beulichfd5f0cd2006-05-02 12:33:20 +0200647endif
Linus Torvalds1da177e2005-04-16 15:20:36 -0700648
Nick Desaulniersdb075622021-02-05 14:01:25 -0800649# The expansion should be delayed until arch/$(SRCARCH)/Makefile is included.
650# Some architectures define CROSS_COMPILE in arch/$(SRCARCH)/Makefile.
651# CC_VERSION_TEXT is referenced from Kconfig (so it needs export),
652# and from include/config/auto.conf.cmd to detect the compiler upgrade.
Masahiro Yamada6072b2c2021-08-01 11:53:46 +0900653CC_VERSION_TEXT = $(subst $(pound),,$(shell LC_ALL=C $(CC) --version 2>/dev/null | head -n 1))
Nick Desaulniersdb075622021-02-05 14:01:25 -0800654
655ifneq ($(findstring clang,$(CC_VERSION_TEXT)),)
Nick Desaulniers6f5b41a2021-08-02 11:39:08 -0700656include $(srctree)/scripts/Makefile.clang
Chris Friesae6b2892017-11-07 11:46:13 -0800657endif
658
Masahiro Yamada57fd2512021-02-28 15:10:27 +0900659# Include this also for config targets because some architectures need
660# cc-cross-prefix to determine CROSS_COMPILE.
Masahiro Yamada805b2e12021-02-28 15:10:28 +0900661ifdef need-compiler
Masahiro Yamada57fd2512021-02-28 15:10:27 +0900662include $(srctree)/scripts/Makefile.compiler
Masahiro Yamada805b2e12021-02-28 15:10:28 +0900663endif
Masahiro Yamada57fd2512021-02-28 15:10:27 +0900664
Masahiro Yamada2042b542019-08-11 00:53:03 +0900665ifdef config-build
Linus Torvalds1da177e2005-04-16 15:20:36 -0700666# ===========================================================================
667# *config targets only - make sure prerequisites are updated, and descend
668# in scripts/kconfig to make the *config target
669
Simon Glass766b7002023-10-26 20:26:23 +1300670# Read arch-specific Makefile to set KBUILD_DEFCONFIG as needed.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700671# KBUILD_DEFCONFIG may point out an alternative default configuration
672# used for 'make defconfig'
Masahiro Yamada3204a7f2021-02-28 15:10:26 +0900673include $(srctree)/arch/$(SRCARCH)/Makefile
Masahiro Yamada315bab42018-06-08 09:21:43 +0900674export KBUILD_DEFCONFIG KBUILD_KCONFIG CC_VERSION_TEXT
Linus Torvalds1da177e2005-04-16 15:20:36 -0700675
Masahiro Yamada36de0772019-08-22 13:46:13 +0900676config: outputmakefile scripts_basic FORCE
Sam Ravnborg31110eb2008-12-13 23:00:45 +0100677 $(Q)$(MAKE) $(build)=scripts/kconfig $@
678
Masahiro Yamada36de0772019-08-22 13:46:13 +0900679%config: outputmakefile scripts_basic FORCE
Linus Torvalds1da177e2005-04-16 15:20:36 -0700680 $(Q)$(MAKE) $(build)=scripts/kconfig $@
681
Masahiro Yamada2042b542019-08-11 00:53:03 +0900682else #!config-build
Linus Torvalds1da177e2005-04-16 15:20:36 -0700683# ===========================================================================
Simon Glass766b7002023-10-26 20:26:23 +1300684# Build targets only - this includes vmlinux, arch-specific targets, clean
Linus Torvalds1da177e2005-04-16 15:20:36 -0700685# targets and others. In general all targets except *config targets.
686
Masahiro Yamada2c1f4f12017-10-04 12:56:06 +0900687# If building an external module we do not care about the all: rule
Masahiro Yamada121c2a12020-05-11 12:50:13 +0900688# but instead __all depend on modules
Masahiro Yamada2c1f4f12017-10-04 12:56:06 +0900689PHONY += all
690ifeq ($(KBUILD_EXTMOD),)
Masahiro Yamada121c2a12020-05-11 12:50:13 +0900691__all: all
Masahiro Yamada2c1f4f12017-10-04 12:56:06 +0900692else
Masahiro Yamada121c2a12020-05-11 12:50:13 +0900693__all: modules
Masahiro Yamada2c1f4f12017-10-04 12:56:06 +0900694endif
695
Masahiro Yamada32164842022-09-25 03:19:14 +0900696targets :=
697
Masahiro Yamada2c1f4f12017-10-04 12:56:06 +0900698# Decide whether to build built-in, modular, or both.
699# Normally, just do built-in.
700
701KBUILD_MODULES :=
702KBUILD_BUILTIN := 1
703
704# If we have only "make modules", don't compile built-in objects.
Masahiro Yamada2c1f4f12017-10-04 12:56:06 +0900705ifeq ($(MAKECMDGOALS),modules)
Masahiro Yamada4b50c8c2020-05-31 17:47:06 +0900706 KBUILD_BUILTIN :=
Masahiro Yamada2c1f4f12017-10-04 12:56:06 +0900707endif
708
709# If we have "make <whatever> modules", compile modules
710# in addition to whatever we do anyway.
711# Just "make" or "make all" shall build modules as well
712
Nathan Huckleberry6ad7cbc2020-08-22 23:56:18 +0900713ifneq ($(filter all modules nsdeps %compile_commands.json clang-%,$(MAKECMDGOALS)),)
Masahiro Yamada2c1f4f12017-10-04 12:56:06 +0900714 KBUILD_MODULES := 1
715endif
716
717ifeq ($(MAKECMDGOALS),)
718 KBUILD_MODULES := 1
719endif
720
721export KBUILD_MODULES KBUILD_BUILTIN
722
Masahiro Yamada2042b542019-08-11 00:53:03 +0900723ifdef need-config
Masahiro Yamadad93a18f2019-04-27 12:33:36 +0900724include include/config/auto.conf
725endif
726
Linus Torvalds1da177e2005-04-16 15:20:36 -0700727ifeq ($(KBUILD_EXTMOD),)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700728# Objects we will link into vmlinux / subdirs we need to visit
Masahiro Yamada57501212022-09-25 03:19:10 +0900729core-y :=
730drivers-y :=
Linus Torvalds1da177e2005-04-16 15:20:36 -0700731libs-y := lib/
Linus Torvalds1da177e2005-04-16 15:20:36 -0700732endif # KBUILD_EXTMOD
733
Masahiro Yamada315bab42018-06-08 09:21:43 +0900734# The all: target is the default when no target is given on the
735# command line.
736# This allow a user to issue only 'make' to build a kernel including modules
737# Defaults to vmlinux, but the arch makefile usually adds further targets
738all: vmlinux
739
Nick Desaulniers7d73c3e2021-08-16 13:25:01 -0700740CFLAGS_GCOV := -fprofile-arcs -ftest-coverage
741ifdef CONFIG_CC_IS_GCC
742CFLAGS_GCOV += -fno-tree-loop-im
743endif
Masahiro Yamada5aadfde2018-05-28 18:22:04 +0900744export CFLAGS_GCOV
Masahiro Yamada315bab42018-06-08 09:21:43 +0900745
Paulo Zanonib1f4ff72018-09-10 10:59:56 -0700746# The arch Makefiles can override CC_FLAGS_FTRACE. We may also append it later.
747ifdef CONFIG_FUNCTION_TRACER
748 CC_FLAGS_FTRACE := -pg
749endif
750
Masahiro Yamada3204a7f2021-02-28 15:10:26 +0900751include $(srctree)/arch/$(SRCARCH)/Makefile
Masahiro Yamada315bab42018-06-08 09:21:43 +0900752
Masahiro Yamada2042b542019-08-11 00:53:03 +0900753ifdef need-config
754ifdef may-sync-config
Masahiro Yamada315bab42018-06-08 09:21:43 +0900755# Read in dependencies to all Kconfig* files, make sure to run syncconfig if
756# changes are detected. This should be included after arch/$(SRCARCH)/Makefile
757# because some architectures define CROSS_COMPILE there.
Masahiro Yamadad2f8ae02019-05-12 11:13:48 +0900758include include/config/auto.conf.cmd
Linus Torvalds1da177e2005-04-16 15:20:36 -0700759
Masahiro Yamada05850712019-02-22 16:40:11 +0900760$(KCONFIG_CONFIG):
761 @echo >&2 '***'
762 @echo >&2 '*** Configuration file "$@" not found!'
763 @echo >&2 '***'
764 @echo >&2 '*** Please run some configurator (e.g. "make oldconfig" or'
765 @echo >&2 '*** "make menuconfig" or "make xconfig").'
766 @echo >&2 '***'
767 @/bin/false
Linus Torvalds1da177e2005-04-16 15:20:36 -0700768
Ulf Magnusson61277982018-02-13 08:58:20 +0100769# The actual configuration files used during the build are stored in
770# include/generated/ and include/config/. Update them if .config is newer than
771# include/config/auto.conf (which mirrors .config).
Masahiro Yamada9390dff2019-02-22 16:40:10 +0900772#
773# This exploits the 'multi-target pattern rule' trick.
774# The syncconfig should be executed only once to make all the targets.
Masahiro Yamadaf463c352020-03-25 12:16:30 +0900775# (Note: use the grouped target '&:' when we bump to GNU Make 4.3)
Masahiro Yamadad952cfa2021-07-14 13:23:49 +0900776#
777# Do not use $(call cmd,...) here. That would suppress prompts from syncconfig,
778# so you cannot notice that Kconfig is waiting for the user input.
Miguel Ojeda2f7ab122021-07-03 16:42:57 +0200779%/config/auto.conf %/config/auto.conf.cmd %/generated/autoconf.h %/generated/rustc_cfg: $(KCONFIG_CONFIG)
Masahiro Yamadad952cfa2021-07-14 13:23:49 +0900780 $(Q)$(kecho) " SYNC $@"
781 $(Q)$(MAKE) -f $(srctree)/Makefile syncconfig
Masahiro Yamada2042b542019-08-11 00:53:03 +0900782else # !may-sync-config
Masahiro Yamadad7942412018-07-20 16:46:34 +0900783# External modules and some install targets need include/generated/autoconf.h
784# and include/config/auto.conf but do not care if they are up-to-date.
785# Use auto.conf to trigger the test
Sam Ravnborg9ee4e332006-08-07 21:01:36 +0200786PHONY += include/config/auto.conf
787
788include/config/auto.conf:
Masahiro Yamada4b098652022-09-24 17:24:25 +0900789 @test -e include/generated/autoconf.h -a -e $@ || ( \
Michal Marek5369f552012-07-07 23:04:40 +0200790 echo >&2; \
791 echo >&2 " ERROR: Kernel configuration is invalid."; \
792 echo >&2 " include/generated/autoconf.h or $@ are missing.";\
793 echo >&2 " Run 'make oldconfig && make prepare' on kernel src to fix it."; \
794 echo >&2 ; \
Sam Ravnborg9ee4e332006-08-07 21:01:36 +0200795 /bin/false)
796
Masahiro Yamadad7942412018-07-20 16:46:34 +0900797endif # may-sync-config
Masahiro Yamada2042b542019-08-11 00:53:03 +0900798endif # need-config
Linus Torvalds1da177e2005-04-16 15:20:36 -0700799
Nick Desaulniers7d73c3e2021-08-16 13:25:01 -0700800KBUILD_CFLAGS += -fno-delete-null-pointer-checks
Geert Uytterhoevena1c48bb2014-05-27 09:54:12 +0200801
Masahiro Yamada15f5db62019-08-21 02:09:40 +0900802ifdef CONFIG_CC_OPTIMIZE_FOR_PERFORMANCE
803KBUILD_CFLAGS += -O2
Miguel Ojeda2f7ab122021-07-03 16:42:57 +0200804KBUILD_RUSTFLAGS += -Copt-level=2
Masahiro Yamada15f5db62019-08-21 02:09:40 +0900805else ifdef CONFIG_CC_OPTIMIZE_FOR_SIZE
806KBUILD_CFLAGS += -Os
Miguel Ojeda2f7ab122021-07-03 16:42:57 +0200807KBUILD_RUSTFLAGS += -Copt-level=s
Arnd Bergmann815eb712016-04-25 17:35:28 +0200808endif
Linus Torvalds1da177e2005-04-16 15:20:36 -0700809
Miguel Ojeda2f7ab122021-07-03 16:42:57 +0200810# Always set `debug-assertions` and `overflow-checks` because their default
811# depends on `opt-level` and `debug-assertions`, respectively.
812KBUILD_RUSTFLAGS += -Cdebug-assertions=$(if $(CONFIG_RUST_DEBUG_ASSERTIONS),y,n)
813KBUILD_RUSTFLAGS += -Coverflow-checks=$(if $(CONFIG_RUST_OVERFLOW_CHECKS),y,n)
814
Jiri Kosina69102312014-08-06 16:08:43 -0700815# Tell gcc to never replace conditional load with a non-conditional one
Nick Desaulniers7d73c3e2021-08-16 13:25:01 -0700816ifdef CONFIG_CC_IS_GCC
817# gcc-10 renamed --param=allow-store-data-races=0 to
818# -fno-allow-store-data-races.
Jiri Kosina69102312014-08-06 16:08:43 -0700819KBUILD_CFLAGS += $(call cc-option,--param=allow-store-data-races=0)
Sergei Trofimovichb1112132020-03-17 00:07:18 +0000820KBUILD_CFLAGS += $(call cc-option,-fno-allow-store-data-races)
Nick Desaulniers7d73c3e2021-08-16 13:25:01 -0700821endif
Jiri Kosina69102312014-08-06 16:08:43 -0700822
Andi Kleen1873e872012-03-28 11:51:18 -0700823ifdef CONFIG_READABLE_ASM
824# Disable optimizations that make assembler listings hard to read.
825# reorder blocks reorders the control in the function
826# ipa clone creates specialized cloned functions
827# partial inlining inlines only parts of functions
Nick Desaulniers7d73c3e2021-08-16 13:25:01 -0700828KBUILD_CFLAGS += -fno-reorder-blocks -fno-ipa-cp-clone -fno-partial-inlining
Andi Kleen1873e872012-03-28 11:51:18 -0700829endif
830
Masahiro Yamada893ab0042020-06-27 03:59:12 +0900831stackp-flags-y := -fno-stack-protector
Linus Torvalds050e9ba2018-06-14 12:21:18 +0900832stackp-flags-$(CONFIG_STACKPROTECTOR) := -fstack-protector
833stackp-flags-$(CONFIG_STACKPROTECTOR_STRONG) := -fstack-protector-strong
Masahiro Yamada2a61f472018-05-28 18:22:00 +0900834
835KBUILD_CFLAGS += $(stackp-flags-y)
Sam Ravnborge06b8b92008-02-13 22:43:28 +0100836
Miguel Ojeda2f7ab122021-07-03 16:42:57 +0200837KBUILD_RUSTFLAGS-$(CONFIG_WERROR) += -Dwarnings
838KBUILD_RUSTFLAGS += $(KBUILD_RUSTFLAGS-y)
839
Linus Torvalds1da177e2005-04-16 15:20:36 -0700840ifdef CONFIG_FRAME_POINTER
Sam Ravnborga0f97e02007-10-14 22:21:35 +0200841KBUILD_CFLAGS += -fno-omit-frame-pointer -fno-optimize-sibling-calls
Miguel Ojeda2f7ab122021-07-03 16:42:57 +0200842KBUILD_RUSTFLAGS += -Cforce-frame-pointers=y
Linus Torvalds1da177e2005-04-16 15:20:36 -0700843else
Rabin Vincent7e9501f2010-08-10 19:20:53 +0100844# Some targets (ARM with Thumb2, for example), can't be built with frame
845# pointers. For those, we don't have FUNCTION_TRACER automatically
846# select FRAME_POINTER. However, FUNCTION_TRACER adds -pg, and this is
847# incompatible with -fomit-frame-pointer with current GCC, so we don't use
848# -fomit-frame-pointer with FUNCTION_TRACER.
Miguel Ojeda2f7ab122021-07-03 16:42:57 +0200849# In the Rust target specification, "frame-pointer" is set explicitly
850# to "may-omit".
Rabin Vincent7e9501f2010-08-10 19:20:53 +0100851ifndef CONFIG_FUNCTION_TRACER
Sam Ravnborga0f97e02007-10-14 22:21:35 +0200852KBUILD_CFLAGS += -fomit-frame-pointer
Linus Torvalds1da177e2005-04-16 15:20:36 -0700853endif
Rabin Vincent7e9501f2010-08-10 19:20:53 +0100854endif
Linus Torvalds1da177e2005-04-16 15:20:36 -0700855
glider@google.comf0fe00d2020-06-16 10:34:35 +0200856# Initialize all stack variables with a 0xAA pattern.
857ifdef CONFIG_INIT_STACK_ALL_PATTERN
Kees Cook709a9722019-04-10 08:48:31 -0700858KBUILD_CFLAGS += -ftrivial-auto-var-init=pattern
859endif
860
glider@google.comf0fe00d2020-06-16 10:34:35 +0200861# Initialize all stack variables with a zero value.
862ifdef CONFIG_INIT_STACK_ALL_ZERO
glider@google.comf0fe00d2020-06-16 10:34:35 +0200863KBUILD_CFLAGS += -ftrivial-auto-var-init=zero
Kees Cook607e57c2022-09-29 22:57:43 -0700864ifdef CONFIG_CC_HAS_AUTO_VAR_INIT_ZERO_ENABLER
865# https://github.com/llvm/llvm-project/issues/44842
Nathan Chancellor4e3feaa2023-01-24 09:19:28 -0700866CC_AUTO_VAR_INIT_ZERO_ENABLER := -enable-trivial-auto-var-init-zero-knowing-it-will-be-removed-from-clang
867export CC_AUTO_VAR_INIT_ZERO_ENABLER
868KBUILD_CFLAGS += $(CC_AUTO_VAR_INIT_ZERO_ENABLER)
glider@google.comf0fe00d2020-06-16 10:34:35 +0200869endif
Kees Cookf02003c2021-09-14 12:49:03 -0700870endif
glider@google.comf0fe00d2020-06-16 10:34:35 +0200871
Kees Cook39218ff2021-04-01 16:23:44 -0700872# While VLAs have been removed, GCC produces unreachable stack probes
873# for the randomize_kstack_offset feature. Disable it for all compilers.
874KBUILD_CFLAGS += $(call cc-option, -fno-stack-clash-protection)
875
Kees Cooka82adfd2021-04-12 19:56:54 -0700876# Clear used registers at func exit (to reduce data lifetime and ROP gadgets).
877ifdef CONFIG_ZERO_CALL_USED_REGS
878KBUILD_CFLAGS += -fzero-call-used-regs=used-gpr
879endif
880
Steven Rostedt606576c2008-10-06 19:06:12 -0400881ifdef CONFIG_FUNCTION_TRACER
Sami Tolvanen3b15cdc12020-12-11 10:46:18 -0800882ifdef CONFIG_FTRACE_MCOUNT_USE_CC
883 CC_FLAGS_FTRACE += -mrecord-mcount
Vasily Gorbik2f4df002018-08-06 15:17:46 +0200884 ifdef CONFIG_HAVE_NOP_MCOUNT
885 ifeq ($(call cc-option-yn, -mnop-mcount),y)
886 CC_FLAGS_FTRACE += -mnop-mcount
887 CC_FLAGS_USING += -DCC_USING_NOP_MCOUNT
888 endif
889 endif
Steven Rostedta2546fa2011-02-09 13:15:59 -0500890endif
Sami Tolvanen22c85422020-09-25 16:43:53 -0700891ifdef CONFIG_FTRACE_MCOUNT_USE_OBJTOOL
Sathvika Vasireddy280981d2022-11-14 23:27:49 +0530892 ifdef CONFIG_HAVE_OBJTOOL_NOP_MCOUNT
893 CC_FLAGS_USING += -DCC_USING_NOP_MCOUNT
894 endif
Sami Tolvanen22c85422020-09-25 16:43:53 -0700895endif
Sami Tolvanen3b15cdc12020-12-11 10:46:18 -0800896ifdef CONFIG_FTRACE_MCOUNT_USE_RECORDMCOUNT
897 ifdef CONFIG_HAVE_C_RECORDMCOUNT
898 BUILD_C_RECORDMCOUNT := y
899 export BUILD_C_RECORDMCOUNT
900 endif
901endif
Steven Rostedta2546fa2011-02-09 13:15:59 -0500902ifdef CONFIG_HAVE_FENTRY
Nick Desaulniers7d73c3e2021-08-16 13:25:01 -0700903 # s390-linux-gnu-gcc did not support -mfentry until gcc-9.
Vasily Gorbikf28bc3c2018-08-06 15:17:42 +0200904 ifeq ($(call cc-option-yn, -mfentry),y)
905 CC_FLAGS_FTRACE += -mfentry
906 CC_FLAGS_USING += -DCC_USING_FENTRY
907 endif
Steven Rostedta2546fa2011-02-09 13:15:59 -0500908endif
Vasily Gorbikf28bc3c2018-08-06 15:17:42 +0200909export CC_FLAGS_FTRACE
910KBUILD_CFLAGS += $(CC_FLAGS_FTRACE) $(CC_FLAGS_USING)
911KBUILD_AFLAGS += $(CC_FLAGS_USING)
Arnaldo Carvalho de Melo16444a82008-05-12 21:20:42 +0200912endif
913
Sam Ravnborg91341d42008-01-21 21:31:44 +0100914# We trigger additional mismatches with less inlining
915ifdef CONFIG_DEBUG_SECTION_MISMATCH
Nick Desaulniers7d73c3e2021-08-16 13:25:01 -0700916KBUILD_CFLAGS += -fno-inline-functions-called-once
Sam Ravnborg91341d42008-01-21 21:31:44 +0100917endif
918
Miguel Ojeda2f7ab122021-07-03 16:42:57 +0200919# `rustc`'s `-Zfunction-sections` applies to data too (as of 1.59.0).
Masahiro Yamada90ad4052017-04-14 15:17:26 +0900920ifdef CONFIG_LD_DEAD_CODE_DATA_ELIMINATION
Masahiro Yamadae85d1d62018-08-22 22:51:09 +0900921KBUILD_CFLAGS_KERNEL += -ffunction-sections -fdata-sections
Miguel Ojeda2f7ab122021-07-03 16:42:57 +0200922KBUILD_RUSTFLAGS_KERNEL += -Zfunction-sections=y
Masahiro Yamadae85d1d62018-08-22 22:51:09 +0900923LDFLAGS_vmlinux += --gc-sections
Masahiro Yamada90ad4052017-04-14 15:17:26 +0900924endif
925
Sami Tolvanend08b9f02020-04-27 09:00:07 -0700926ifdef CONFIG_SHADOW_CALL_STACK
Ard Biesheuvel9beccca2022-10-27 17:59:07 +0200927ifndef CONFIG_DYNAMIC_SCS
Sami Tolvanend08b9f02020-04-27 09:00:07 -0700928CC_FLAGS_SCS := -fsanitize=shadow-call-stack
929KBUILD_CFLAGS += $(CC_FLAGS_SCS)
Ard Biesheuvel9beccca2022-10-27 17:59:07 +0200930endif
Sami Tolvanend08b9f02020-04-27 09:00:07 -0700931export CC_FLAGS_SCS
932endif
933
Sami Tolvanendc5723b2020-12-11 10:46:19 -0800934ifdef CONFIG_LTO_CLANG
935ifdef CONFIG_LTO_CLANG_THIN
Alexander Lobakin2b868952021-01-21 18:45:55 +0000936CC_FLAGS_LTO := -flto=thin -fsplit-lto-unit
Sami Tolvanendc5723b2020-12-11 10:46:19 -0800937else
Alexander Lobakin2b868952021-01-21 18:45:55 +0000938CC_FLAGS_LTO := -flto
Sami Tolvanendc5723b2020-12-11 10:46:19 -0800939endif
940CC_FLAGS_LTO += -fvisibility=hidden
Sami Tolvanen22d429e2020-12-11 10:46:21 -0800941
942# Limit inlining across translation units to reduce binary size
943KBUILD_LDFLAGS += -mllvm -import-instr-limit=5
Tor Vic02365262021-06-13 13:07:49 +0000944endif
Sami Tolvanendc5723b2020-12-11 10:46:19 -0800945
946ifdef CONFIG_LTO
Sami Tolvanen5e953252021-02-23 13:59:52 -0800947KBUILD_CFLAGS += -fno-lto $(CC_FLAGS_LTO)
948KBUILD_AFLAGS += -fno-lto
Sami Tolvanendc5723b2020-12-11 10:46:19 -0800949export CC_FLAGS_LTO
950endif
951
Sami Tolvanencf68fff2021-04-08 11:28:26 -0700952ifdef CONFIG_CFI_CLANG
Sami Tolvanen89245602022-09-08 14:54:47 -0700953CC_FLAGS_CFI := -fsanitize=kcfi
Sami Tolvanencf68fff2021-04-08 11:28:26 -0700954KBUILD_CFLAGS += $(CC_FLAGS_CFI)
955export CC_FLAGS_CFI
956endif
957
Samuel Holland6cbd1d62024-03-29 00:18:16 -0700958# Architectures can define flags to add/remove for floating-point support
959CC_FLAGS_FPU += -D_LINUX_FPU_COMPILATION_UNIT
960export CC_FLAGS_FPU
961export CC_FLAGS_NO_FPU
962
Peter Zijlstrad49a0622022-09-15 13:10:47 +0200963ifneq ($(CONFIG_FUNCTION_ALIGNMENT),0)
Petr Pavlu52703162024-02-22 14:35:00 +0100964# Set the minimal function alignment. Use the newer GCC option
965# -fmin-function-alignment if it is available, or fall back to -falign-funtions.
966# See also CONFIG_CC_HAS_SANE_FUNCTION_ALIGNMENT.
967ifdef CONFIG_CC_HAS_MIN_FUNCTION_ALIGNMENT
968KBUILD_CFLAGS += -fmin-function-alignment=$(CONFIG_FUNCTION_ALIGNMENT)
969else
Peter Zijlstrad49a0622022-09-15 13:10:47 +0200970KBUILD_CFLAGS += -falign-functions=$(CONFIG_FUNCTION_ALIGNMENT)
Feng Tang09c60542020-08-11 18:34:13 -0700971endif
Petr Pavlu52703162024-02-22 14:35:00 +0100972endif
Feng Tang09c60542020-08-11 18:34:13 -0700973
Sam Ravnborge8e69932005-04-30 16:51:42 -0700974# arch Makefile may override CC so keep this after arch Makefile is included
Alexey Dobriyan04e85bb2021-08-02 23:43:15 +0300975NOSTDINC_FLAGS += -nostdinc
Sam Ravnborge8e69932005-04-30 16:51:42 -0700976
Kees Cookdf8fc4e2023-05-17 16:18:11 -0700977# To gain proper coverage for CONFIG_UBSAN_BOUNDS and CONFIG_FORTIFY_SOURCE,
978# the kernel uses only C99 flexible arrays for dynamically sized trailing
979# arrays. Enforce this for everything that may examine structure sizes and
980# perform bounds checking.
981KBUILD_CFLAGS += $(call cc-option, -fstrict-flex-arrays=3)
982
Gustavo A. R. Silvaa5e0ace02023-11-30 14:29:34 -0600983#Currently, disable -Wstringop-overflow for GCC 11, globally.
984KBUILD_CFLAGS-$(CONFIG_CC_NO_STRINGOP_OVERFLOW) += $(call cc-option, -Wno-stringop-overflow)
985KBUILD_CFLAGS-$(CONFIG_CC_STRINGOP_OVERFLOW) += $(call cc-option, -Wstringop-overflow)
Gustavo A. R. Silva113a6182023-10-31 17:50:11 -0600986
Kirill Smelkovfe8d0a42009-04-09 15:34:34 +0400987# disable invalid "can't wrap" optimizations for signed / pointers
Masahiro Yamada8b42cf22020-09-10 22:51:17 +0900988KBUILD_CFLAGS += -fno-strict-overflow
Linus Torvaldsd0115552009-03-19 15:53:19 -0700989
Linus Torvalds3ce120b2017-12-29 17:34:43 -0800990# Make sure -fstack-check isn't enabled (like gentoo apparently did)
Masahiro Yamada7d4eb0d2020-09-10 22:51:19 +0900991KBUILD_CFLAGS += -fno-stack-check
Linus Torvalds3ce120b2017-12-29 17:34:43 -0800992
Andi Kleen8f7f5c92009-09-18 12:49:37 -0700993# conserve stack if available
Nick Desaulniers7d73c3e2021-08-16 13:25:01 -0700994ifdef CONFIG_CC_IS_GCC
995KBUILD_CFLAGS += -fconserve-stack
996endif
Andi Kleen8f7f5c92009-09-18 12:49:37 -0700997
Masahiro Yamadaa73619a2018-03-30 13:15:26 +0900998# change __FILE__ to the relative path from the srctree
Denys Zagoruia716bd72020-11-02 04:08:53 -0800999KBUILD_CPPFLAGS += $(call cc-option,-fmacro-prefix-map=$(srctree)/=)
Masahiro Yamadaa73619a2018-03-30 13:15:26 +09001000
Masahiro Yamadae0fe0bb2020-08-02 00:00:49 +09001001# include additional Makefiles when needed
1002include-y := scripts/Makefile.extrawarn
Masahiro Yamada6947fd92021-10-12 12:25:03 +09001003include-$(CONFIG_DEBUG_INFO) += scripts/Makefile.debug
Masahiro Yamada72d09182023-10-19 00:19:48 +09001004include-$(CONFIG_DEBUG_INFO_BTF)+= scripts/Makefile.btf
Masahiro Yamadae0fe0bb2020-08-02 00:00:49 +09001005include-$(CONFIG_KASAN) += scripts/Makefile.kasan
1006include-$(CONFIG_KCSAN) += scripts/Makefile.kcsan
Alexander Potapenkof80be452022-09-15 17:03:45 +02001007include-$(CONFIG_KMSAN) += scripts/Makefile.kmsan
Masahiro Yamadae0fe0bb2020-08-02 00:00:49 +09001008include-$(CONFIG_UBSAN) += scripts/Makefile.ubsan
1009include-$(CONFIG_KCOV) += scripts/Makefile.kcov
Kees Cook613f4b3e2022-05-03 13:55:01 -07001010include-$(CONFIG_RANDSTRUCT) += scripts/Makefile.randstruct
Masahiro Yamadae0fe0bb2020-08-02 00:00:49 +09001011include-$(CONFIG_GCC_PLUGINS) += scripts/Makefile.gcc-plugins
1012
1013include $(addprefix $(srctree)/, $(include-y))
Masahiro Yamadaa86fe352014-04-14 18:27:10 +09001014
Masahiro Yamada132305b2020-08-02 00:00:50 +09001015# scripts/Makefile.gcc-plugins is intentionally included last.
1016# Do not add $(call cc-option,...) below this line. When you build the kernel
1017# from the clean source tree, the GCC plugins do not exist at this point.
Jason Baronbf5438fc2010-09-17 11:09:00 -04001018
Miguel Ojeda2f7ab122021-07-03 16:42:57 +02001019# Add user supplied CPPFLAGS, AFLAGS, CFLAGS and RUSTFLAGS as the last assignments
Masahiro Yamada8cc7af72019-08-21 02:09:41 +09001020KBUILD_CPPFLAGS += $(KCPPFLAGS)
1021KBUILD_AFLAGS += $(KAFLAGS)
1022KBUILD_CFLAGS += $(KCFLAGS)
Miguel Ojeda2f7ab122021-07-03 16:42:57 +02001023KBUILD_RUSTFLAGS += $(KRUSTFLAGS)
Sam Ravnborg52bcc332007-10-15 22:03:58 +02001024
Bill Wendlinga9684332020-09-22 16:21:40 -07001025KBUILD_LDFLAGS_MODULE += --build-id=sha1
1026LDFLAGS_vmlinux += --build-id=sha1
Roland McGrath18991192007-07-19 01:48:40 -07001027
Nick Desaulniers0d362be2022-08-10 15:24:40 -07001028KBUILD_LDFLAGS += -z noexecstack
1029ifeq ($(CONFIG_LD_IS_BFD),y)
1030KBUILD_LDFLAGS += $(call ld-option,--no-warn-rwx-segments)
1031endif
1032
David Howells5d7d18f2009-03-04 11:59:07 -08001033ifeq ($(CONFIG_STRIP_ASM_SYMS),y)
Masahiro Yamada0f1fe9d2022-09-30 03:12:23 +09001034LDFLAGS_vmlinux += -X
David Howells5d7d18f2009-03-04 11:59:07 -08001035endif
1036
Peter Collingbourne5cf896fb62019-07-31 18:18:42 -07001037ifeq ($(CONFIG_RELR),y)
Fangrui Songccb2d172023-04-11 20:09:44 +00001038# ld.lld before 15 did not support -z pack-relative-relocs.
1039LDFLAGS_vmlinux += $(call ld-option,--pack-dyn-relocs=relr,-z pack-relative-relocs)
Peter Collingbourne5cf896fb62019-07-31 18:18:42 -07001040endif
1041
Nathan Chancellor59612b22020-11-19 13:46:56 -07001042# We never want expected sections to be placed heuristically by the
1043# linker. All sections should be explicitly named in the linker script.
1044ifdef CONFIG_LD_ORPHAN_WARN
Xin Lie1789d72022-10-25 00:30:23 -07001045LDFLAGS_vmlinux += --orphan-handling=$(CONFIG_LD_ORPHAN_WARN_LEVEL)
Nathan Chancellor59612b22020-11-19 13:46:56 -07001046endif
1047
Masahiro Yamada7f3a59d2020-04-29 12:45:14 +09001048# Align the bit size of userspace programs with the kernel
Masahiro Yamada7f58b482020-07-01 00:06:25 +09001049KBUILD_USERCFLAGS += $(filter -m32 -m64 --target=%, $(KBUILD_CFLAGS))
1050KBUILD_USERLDFLAGS += $(filter -m32 -m64 --target=%, $(KBUILD_CFLAGS))
Masahiro Yamada7f3a59d2020-04-29 12:45:14 +09001051
Luc Van Oostenryck80591e62019-11-09 13:12:16 +01001052# make the checker run with the right architecture
1053CHECKFLAGS += --arch=$(ARCH)
1054
Luc Van Oostenryck145167652018-05-28 20:27:35 +02001055# insure the checker run with the right endianness
1056CHECKFLAGS += $(if $(CONFIG_CPU_BIG_ENDIAN),-mbig-endian,-mlittle-endian)
1057
Luc Van Oostenryck1f2f01b2018-05-30 22:48:38 +02001058# the checker needs the correct machine size
1059CHECKFLAGS += $(if $(CONFIG_64BIT),-m64,-m32)
1060
Linus Torvalds1da177e2005-04-16 15:20:36 -07001061# Default kernel image to build when no specific target is given.
Sam Ravnborg070b98b2006-06-25 00:07:55 +02001062# KBUILD_IMAGE may be overruled on the command line or
Linus Torvalds1da177e2005-04-16 15:20:36 -07001063# set in the environment
1064# Also any assignments in arch/$(ARCH)/Makefile take precedence over
1065# this default value
1066export KBUILD_IMAGE ?= vmlinux
1067
1068#
1069# INSTALL_PATH specifies where to place the updated kernel and system map
1070# images. Default is /boot, but you can set it to other values
1071export INSTALL_PATH ?= /boot
1072
1073#
Jason Cooperf4d4ffc2013-12-01 23:56:28 +00001074# INSTALL_DTBS_PATH specifies a prefix for relocations required by build roots.
1075# Like INSTALL_MOD_PATH, it isn't defined in the Makefile, but can be passed as
1076# an argument if needed. Otherwise it defaults to the kernel install path
1077#
1078export INSTALL_DTBS_PATH ?= $(INSTALL_PATH)/dtbs/$(KERNELRELEASE)
1079
1080#
Linus Torvalds1da177e2005-04-16 15:20:36 -07001081# INSTALL_MOD_PATH specifies a prefix to MODLIB for module directory
1082# relocations required by build roots. This is not defined in the
Sam Ravnborg070b98b2006-06-25 00:07:55 +02001083# makefile but the argument can be passed to make if needed.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001084#
1085
Sam Ravnborgdf9df032006-01-16 12:46:07 +01001086MODLIB = $(INSTALL_MOD_PATH)/lib/modules/$(KERNELRELEASE)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001087export MODLIB
1088
Masahiro Yamadae00d8882019-01-15 16:19:00 +09001089PHONY += prepare0
Rusty Russelle2a666d2012-10-19 11:53:15 +10301090
Masahiro Yamadaccae4cf2021-03-31 22:38:07 +09001091export extmod_prefix = $(if $(KBUILD_EXTMOD),$(KBUILD_EXTMOD)/)
Masahiro Yamada7f691802021-03-31 22:38:06 +09001092export MODORDER := $(extmod_prefix)modules.order
1093export MODULES_NSDEPS := $(extmod_prefix)modules.nsdeps
Masahiro Yamada47801c92019-08-02 19:23:58 +09001094
Linus Torvalds1da177e2005-04-16 15:20:36 -07001095ifeq ($(KBUILD_EXTMOD),)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001096
Masahiro Yamada57501212022-09-25 03:19:10 +09001097build-dir := .
1098clean-dirs := $(sort . Documentation \
Masahiro Yamada23febe32020-06-01 14:56:57 +09001099 $(patsubst %/,%,$(filter %/, $(core-) \
Masahiro Yamada95fb6312020-06-01 14:56:58 +09001100 $(drivers-) $(libs-))))
Linus Torvalds1da177e2005-04-16 15:20:36 -07001101
Masahiro Yamada57501212022-09-25 03:19:10 +09001102export ARCH_CORE := $(core-y)
1103export ARCH_LIB := $(filter %/, $(libs-y))
1104export ARCH_DRIVERS := $(drivers-y) $(drivers-m)
Sam Ravnborg1f2bfbd2012-05-05 10:18:41 +02001105# Externally visible symbols (used by link-vmlinux.sh)
Masahiro Yamada57501212022-09-25 03:19:10 +09001106
Masahiro Yamada32164842022-09-25 03:19:14 +09001107KBUILD_VMLINUX_OBJS := ./built-in.a
Masahiro Yamadaf0d50ca2020-06-01 14:56:59 +09001108ifdef CONFIG_MODULES
1109KBUILD_VMLINUX_OBJS += $(patsubst %/, %/lib.a, $(filter %/, $(libs-y)))
1110KBUILD_VMLINUX_LIBS := $(filter-out %/, $(libs-y))
1111else
1112KBUILD_VMLINUX_LIBS := $(patsubst %/,%/lib.a, $(libs-y))
1113endif
Masahiro Yamadaf0d50ca2020-06-01 14:56:59 +09001114
Masahiro Yamada32164842022-09-25 03:19:14 +09001115export KBUILD_VMLINUX_LIBS
Sam Ravnborg95698572012-05-05 10:18:40 +02001116export KBUILD_LDS := arch/$(SRCARCH)/kernel/vmlinux.lds
Linus Torvalds1da177e2005-04-16 15:20:36 -07001117
Nicolas Pitre2441e782016-04-22 15:25:00 -04001118ifdef CONFIG_TRIM_UNUSED_KSYMS
Masahiro Yamada1f50b802018-03-16 16:37:13 +09001119# For the kernel to actually contain only the needed exported symbols,
1120# we have to build modules as well to determine what those symbols are.
Masahiro Yamadafb2d99b2020-05-31 19:11:39 +09001121KBUILD_MODULES := 1
Masahiro Yamada1f50b802018-03-16 16:37:13 +09001122endif
1123
Masahiro Yamada32164842022-09-25 03:19:14 +09001124# '$(AR) mPi' needs 'T' to workaround the bug of llvm-ar <= 14
1125quiet_cmd_ar_vmlinux.a = AR $@
1126 cmd_ar_vmlinux.a = \
1127 rm -f $@; \
1128 $(AR) cDPrST $@ $(KBUILD_VMLINUX_OBJS); \
Masahiro Yamadafb3041d2022-10-28 01:28:39 +09001129 $(AR) mPiT $$($(AR) t $@ | sed -n 1p) $@ $$($(AR) t $@ | grep -F -f $(srctree)/scripts/head-object-list.txt)
Nicholas Pigginfbe6e372016-08-24 22:29:21 +10001130
Masahiro Yamada32164842022-09-25 03:19:14 +09001131targets += vmlinux.a
Masahiro Yamada5e9e95cc92023-06-12 00:50:57 +09001132vmlinux.a: $(KBUILD_VMLINUX_OBJS) scripts/head-object-list.txt FORCE
Masahiro Yamada32164842022-09-25 03:19:14 +09001133 $(call if_changed,ar_vmlinux.a)
Nicolas Pitre2441e782016-04-22 15:25:00 -04001134
Masahiro Yamada7a342e62022-09-28 15:39:40 +09001135PHONY += vmlinux_o
1136vmlinux_o: vmlinux.a $(KBUILD_VMLINUX_LIBS)
Masahiro Yamada9c5a0ac2022-09-25 03:19:12 +09001137 $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.vmlinux_o
Sam Ravnborg741f98f2007-07-17 10:54:06 +02001138
Masahiro Yamada7a342e62022-09-28 15:39:40 +09001139vmlinux.o modules.builtin.modinfo modules.builtin: vmlinux_o
1140 @:
1141
Masahiro Yamada5d4aeff2022-09-28 15:39:41 +09001142PHONY += vmlinux
Masahiro Yamada8debed32023-01-09 04:23:17 +09001143# LDFLAGS_vmlinux in the top Makefile defines linker flags for the top vmlinux,
1144# not for decompressors. LDFLAGS_vmlinux in arch/*/boot/compressed/Makefile is
1145# unrelated; the decompressors just happen to have the same base name,
1146# arch/*/boot/compressed/vmlinux.
1147# Export LDFLAGS_vmlinux only to scripts/Makefile.vmlinux.
1148#
1149# _LDFLAGS_vmlinux is a workaround for the 'private export' bug:
1150# https://savannah.gnu.org/bugs/?61463
1151# For Make > 4.4, the following simple code will work:
1152# vmlinux: private export LDFLAGS_vmlinux := $(LDFLAGS_vmlinux)
1153vmlinux: private _LDFLAGS_vmlinux := $(LDFLAGS_vmlinux)
1154vmlinux: export LDFLAGS_vmlinux = $(_LDFLAGS_vmlinux)
Masahiro Yamada5d4aeff2022-09-28 15:39:41 +09001155vmlinux: vmlinux.o $(KBUILD_LDS) modpost
1156 $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.vmlinux
Masahiro Yamada392885e2018-11-30 10:05:22 +09001157
Masahiro Yamada38385f82014-04-28 16:26:18 +09001158# The actual objects are generated when descending,
Linus Torvalds1da177e2005-04-16 15:20:36 -07001159# make sure no implicit rule kicks in
Masahiro Yamada9c5a0ac2022-09-25 03:19:12 +09001160$(sort $(KBUILD_LDS) $(KBUILD_VMLINUX_OBJS) $(KBUILD_VMLINUX_LIBS)): . ;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001161
Masahiro Yamada1cb86b62023-01-28 01:19:42 +09001162ifeq ($(origin KERNELRELEASE),file)
Masahiro Yamadaec31f862023-01-22 23:14:25 +09001163filechk_kernel.release = $(srctree)/scripts/setlocalversion $(srctree)
Masahiro Yamada1cb86b62023-01-28 01:19:42 +09001164else
1165filechk_kernel.release = echo $(KERNELRELEASE)
1166endif
Michal Marek0d0e7712013-07-11 15:34:51 +02001167
Geert Uytterhoeven83a35e32013-06-28 11:27:31 +02001168# Store (new) KERNELRELEASE string in include/config/kernel.release
Masahiro Yamada24512792019-04-07 19:03:18 +09001169include/config/kernel.release: FORCE
Michal Marek0d0e7712013-07-11 15:34:51 +02001170 $(call filechk,kernel.release)
Sam Ravnborgcb584552006-01-09 21:20:34 +01001171
Masahiro Yamadad8821622018-03-16 16:37:11 +09001172# Additional helpers built in scripts/
1173# Carefully list dependencies so we do not try to build scripts twice
1174# in parallel
1175PHONY += scripts
Masahiro Yamada60df1ae2018-11-29 12:13:24 +09001176scripts: scripts_basic scripts_dtc
Masahiro Yamadad8821622018-03-16 16:37:11 +09001177 $(Q)$(MAKE) $(build)=$(@)
Sam Ravnborgcb584552006-01-09 21:20:34 +01001178
Linus Torvalds1da177e2005-04-16 15:20:36 -07001179# Things we need to do before we recursively start building the kernel
Sam Ravnborg5bb78262005-09-11 22:30:22 +02001180# or the modules are listed in "prepare".
1181# A multi level approach is used. prepareN is processed before prepareN-1.
1182# archprepare is used in arch Makefiles and when processed asm symlink,
1183# version.h and scripts_basic is processed / created.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001184
Masahiro Yamadaa5139fb2019-08-22 13:46:12 +09001185PHONY += prepare archprepare
Sam Ravnborg5bb78262005-09-11 22:30:22 +02001186
Masahiro Yamada36de0772019-08-22 13:46:13 +09001187archprepare: outputmakefile archheaders archscripts scripts include/config/kernel.release \
Masahiro Yamada5e9e95cc92023-06-12 00:50:57 +09001188 asm-generic $(version_h) include/generated/utsrelease.h \
Masahiro Yamadaa55f2832022-08-28 11:39:54 +09001189 include/generated/compile.h include/generated/autoconf.h remove-stale-files
Sam Ravnborg5bb78262005-09-11 22:30:22 +02001190
Masahiro Yamada65bba042018-11-29 11:58:50 +09001191prepare0: archprepare
Masahiro Yamada60df1ae2018-11-29 12:13:24 +09001192 $(Q)$(MAKE) $(build)=scripts/mod
Masahiro Yamadaed7ceac2022-08-20 18:15:28 +09001193 $(Q)$(MAKE) $(build)=. prepare
Sam Ravnborg86feeaa2005-09-09 19:28:28 +02001194
Linus Torvalds1da177e2005-04-16 15:20:36 -07001195# All the preparing..
Masahiro Yamada0d989ac2021-05-12 15:52:01 +09001196prepare: prepare0
Miguel Ojeda2f7ab122021-07-03 16:42:57 +02001197ifdef CONFIG_RUST
Miguel Ojedaecab4112024-02-17 01:26:37 +01001198 +$(Q)$(CONFIG_SHELL) $(srctree)/scripts/rust_is_available.sh
Miguel Ojeda2f7ab122021-07-03 16:42:57 +02001199 $(Q)$(MAKE) $(build)=rust
1200endif
Josh Poimboeufb9ab5eb2016-02-28 22:22:42 -06001201
Masahiro Yamada1476fee2021-04-25 16:07:12 +09001202PHONY += remove-stale-files
1203remove-stale-files:
1204 $(Q)$(srctree)/scripts/remove-stale-files
1205
Masahiro Yamada2c1f4f12017-10-04 12:56:06 +09001206# Support for using generic headers in asm-generic
Arnd Bergmannfbb5c062024-04-26 15:19:48 +02001207asm-generic := -f $(srctree)/scripts/Makefile.asm-headers obj
Masahiro Yamada7d0e5c22018-12-05 20:28:04 +09001208
Masahiro Yamada2c1f4f12017-10-04 12:56:06 +09001209PHONY += asm-generic uapi-asm-generic
1210asm-generic: uapi-asm-generic
Masahiro Yamada037fc332019-03-17 11:01:09 +09001211 $(Q)$(MAKE) $(asm-generic)=arch/$(SRCARCH)/include/generated/asm \
1212 generic=include/asm-generic
Masahiro Yamada2c1f4f12017-10-04 12:56:06 +09001213uapi-asm-generic:
Masahiro Yamada037fc332019-03-17 11:01:09 +09001214 $(Q)$(MAKE) $(asm-generic)=arch/$(SRCARCH)/include/generated/uapi/asm \
1215 generic=include/uapi/asm-generic
Masahiro Yamada2c1f4f12017-10-04 12:56:06 +09001216
Linus Torvalds1da177e2005-04-16 15:20:36 -07001217# Generate some files
1218# ---------------------------------------------------------------------------
1219
1220# KERNELRELEASE can change from a few different places, meaning version.h
1221# needs to be updated, so this check is forced on all builds
1222
1223uts_len := 64
Sam Ravnborg63104ee2006-07-03 23:30:54 +02001224define filechk_utsrelease.h
Linus Torvalds1da177e2005-04-16 15:20:36 -07001225 if [ `echo -n "$(KERNELRELEASE)" | wc -c ` -gt $(uts_len) ]; then \
Sam Ravnborg63104ee2006-07-03 23:30:54 +02001226 echo '"$(KERNELRELEASE)" exceeds $(uts_len) characters' >&2; \
1227 exit 1; \
1228 fi; \
Masahiro Yamadaad774082018-12-31 17:24:09 +09001229 echo \#define UTS_RELEASE \"$(KERNELRELEASE)\"
Linus Torvalds1da177e2005-04-16 15:20:36 -07001230endef
1231
Sam Ravnborg63104ee2006-07-03 23:30:54 +02001232define filechk_version.h
Sasha Levin9b82f132021-02-05 22:50:32 -05001233 if [ $(SUBLEVEL) -gt 255 ]; then \
1234 echo \#define LINUX_VERSION_CODE $(shell \
Masahiro Yamada207da4c2021-02-27 23:20:23 +09001235 expr $(VERSION) \* 65536 + $(PATCHLEVEL) \* 256 + 255); \
Sasha Levin9b82f132021-02-05 22:50:32 -05001236 else \
1237 echo \#define LINUX_VERSION_CODE $(shell \
Masahiro Yamada207da4c2021-02-27 23:20:23 +09001238 expr $(VERSION) \* 65536 + $(PATCHLEVEL) \* 256 + $(SUBLEVEL)); \
Sasha Levin9b82f132021-02-05 22:50:32 -05001239 fi; \
1240 echo '#define KERNEL_VERSION(a,b,c) (((a) << 16) + ((b) << 8) + \
Sasha Levin88a68672021-02-12 11:29:24 -05001241 ((c) > 255 ? 255 : (c)))'; \
1242 echo \#define LINUX_VERSION_MAJOR $(VERSION); \
1243 echo \#define LINUX_VERSION_PATCHLEVEL $(PATCHLEVEL); \
1244 echo \#define LINUX_VERSION_SUBLEVEL $(SUBLEVEL)
Sam Ravnborg63104ee2006-07-03 23:30:54 +02001245endef
1246
Masahiro Yamadad98dba82024-04-28 00:32:53 +09001247$(version_h): private PATCHLEVEL := $(or $(PATCHLEVEL), 0)
1248$(version_h): private SUBLEVEL := $(or $(SUBLEVEL), 0)
Masahiro Yamada43fee2b2018-07-25 14:16:11 +09001249$(version_h): FORCE
Linus Torvalds1da177e2005-04-16 15:20:36 -07001250 $(call filechk,version.h)
1251
Sam Ravnborg273b2812009-10-18 00:52:28 +02001252include/generated/utsrelease.h: include/config/kernel.release FORCE
Sam Ravnborg63104ee2006-07-03 23:30:54 +02001253 $(call filechk,utsrelease.h)
1254
Masahiro Yamadaa55f2832022-08-28 11:39:54 +09001255filechk_compile.h = $(srctree)/scripts/mkcompile_h \
1256 "$(UTS_MACHINE)" "$(CONFIG_CC_VERSION_TEXT)" "$(LD)"
1257
1258include/generated/compile.h: FORCE
1259 $(call filechk,compile.h)
1260
Vegard Nossum179efcb2008-12-16 12:33:43 +01001261PHONY += headerdep
1262headerdep:
Peter Foley9663d982011-04-26 17:17:11 -04001263 $(Q)find $(srctree)/include/ -name '*.h' | xargs --max-args 1 \
1264 $(srctree)/scripts/headerdep.pl -I$(srctree)/include
Vegard Nossum179efcb2008-12-16 12:33:43 +01001265
Linus Torvalds1da177e2005-04-16 15:20:36 -07001266# ---------------------------------------------------------------------------
David Woodhouse8d730cf2006-06-18 11:58:39 +01001267# Kernel headers
David Woodhouse8d730cf2006-06-18 11:58:39 +01001268
Sam Ravnborge6883b12008-06-05 16:43:46 +02001269#Default location for installed headers
1270export INSTALL_HDR_PATH = $(objtree)/usr
1271
Masahiro Yamada59b2bd02019-06-04 19:14:02 +09001272quiet_cmd_headers_install = INSTALL $(INSTALL_HDR_PATH)/include
1273 cmd_headers_install = \
1274 mkdir -p $(INSTALL_HDR_PATH); \
1275 rsync -mrl --include='*/' --include='*\.h' --exclude='*' \
1276 usr/include $(INSTALL_HDR_PATH)
David Woodhouse6d716272006-09-24 22:16:03 +01001277
David Woodhouse8d730cf2006-06-18 11:58:39 +01001278PHONY += headers_install
Masahiro Yamada59b2bd02019-06-04 19:14:02 +09001279headers_install: headers
1280 $(call cmd,headers_install)
Paul Smith4f193362006-03-05 17:14:10 -05001281
Linus Torvalds1da177e2005-04-16 15:20:36 -07001282PHONY += archheaders archscripts
1283
Masahiro Yamadaa5bae542019-06-04 19:14:04 +09001284hdr-inst := -f $(srctree)/scripts/Makefile.headersinst obj
Linus Torvalds1da177e2005-04-16 15:20:36 -07001285
Masahiro Yamada59b2bd02019-06-04 19:14:02 +09001286PHONY += headers
1287headers: $(version_h) scripts_unifdef uapi-asm-generic archheaders archscripts
Masahiro Yamada1b620d52022-09-01 10:12:52 +09001288 $(if $(filter um, $(SRCARCH)), $(error Headers not exportable for UML))
Masahiro Yamadad5470d12019-06-04 19:14:03 +09001289 $(Q)$(MAKE) $(hdr-inst)=include/uapi
1290 $(Q)$(MAKE) $(hdr-inst)=arch/$(SRCARCH)/include/uapi
Mike Frysinger1f857122007-02-14 00:33:02 -08001291
Masahiro Yamadae949f4c2019-06-04 19:13:59 +09001292ifdef CONFIG_HEADERS_INSTALL
Masahiro Yamada59b2bd02019-06-04 19:14:02 +09001293prepare: headers
Masahiro Yamadae949f4c2019-06-04 19:13:59 +09001294endif
David Woodhouse68475352006-06-18 12:02:10 +01001295
Masahiro Yamadabdd77142019-06-04 19:14:01 +09001296PHONY += scripts_unifdef
1297scripts_unifdef: scripts_basic
1298 $(Q)$(MAKE) $(build)=scripts scripts/unifdef
1299
David Woodhouse8d730cf2006-06-18 11:58:39 +01001300# ---------------------------------------------------------------------------
Masahiro Yamada14ccc632021-07-29 09:12:54 +09001301# Install
1302
1303# Many distributions have the custom install script, /sbin/installkernel.
Randy Dunlap75ef3122022-04-25 20:53:18 -07001304# If DKMS is installed, 'make install' will eventually recurse back
1305# to this Makefile to build and install external modules.
Masahiro Yamada14ccc632021-07-29 09:12:54 +09001306# Cancel sub_make_done so that options such as M=, V=, etc. are parsed.
1307
Masahiro Yamadaf774f5b2022-05-03 11:47:16 +09001308quiet_cmd_install = INSTALL $(INSTALL_PATH)
1309 cmd_install = unset sub_make_done; $(srctree)/scripts/install.sh
Masahiro Yamada14ccc632021-07-29 09:12:54 +09001310
1311# ---------------------------------------------------------------------------
Masahiro Yamada56769ba2023-10-14 19:54:35 +09001312# vDSO install
1313
1314PHONY += vdso_install
1315vdso_install: export INSTALL_FILES = $(vdso-install-y)
1316vdso_install:
1317 $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.vdsoinst
1318
1319# ---------------------------------------------------------------------------
Masahiro Yamada1bb0b182021-05-12 15:52:00 +09001320# Tools
1321
Josh Poimboeuf03f16cd2022-04-18 09:50:36 -07001322ifdef CONFIG_OBJTOOL
Masahiro Yamada0d989ac2021-05-12 15:52:01 +09001323prepare: tools/objtool
1324endif
1325
1326ifdef CONFIG_BPF
1327ifdef CONFIG_DEBUG_INFO_BTF
1328prepare: tools/bpf/resolve_btfids
1329endif
1330endif
1331
Masahiro Yamada6e6ef2d2024-07-18 03:28:19 +09001332# The tools build system is not a part of Kbuild and tends to introduce
1333# its own unique issues. If you need to integrate a new tool into Kbuild,
1334# please consider locating that tool outside the tools/ tree and using the
1335# standard Kbuild "hostprogs" syntax instead of adding a new tools/* entry
1336# here. See Documentation/kbuild/makefiles.rst for details.
1337
Masahiro Yamada0d989ac2021-05-12 15:52:01 +09001338PHONY += resolve_btfids_clean
1339
1340resolve_btfids_O = $(abspath $(objtree))/tools/bpf/resolve_btfids
1341
1342# tools/bpf/resolve_btfids directory might not exist
1343# in output directory, skip its clean in that case
1344resolve_btfids_clean:
1345ifneq ($(wildcard $(resolve_btfids_O)),)
1346 $(Q)$(MAKE) -sC $(srctree)/tools/bpf/resolve_btfids O=$(resolve_btfids_O) clean
1347endif
1348
Masahiro Yamada1bb0b182021-05-12 15:52:00 +09001349# Clear a bunch of variables before executing the submake
1350ifeq ($(quiet),silent_)
1351tools_silent=s
1352endif
1353
1354tools/: FORCE
1355 $(Q)mkdir -p $(objtree)/tools
1356 $(Q)$(MAKE) LDFLAGS= MAKEFLAGS="$(tools_silent) $(filter --j% -j,$(MAKEFLAGS))" O=$(abspath $(objtree)) subdir=tools -C $(srctree)/tools/
1357
1358tools/%: FORCE
1359 $(Q)mkdir -p $(objtree)/tools
1360 $(Q)$(MAKE) LDFLAGS= MAKEFLAGS="$(tools_silent) $(filter --j% -j,$(MAKEFLAGS))" O=$(abspath $(objtree)) subdir=tools -C $(srctree)/tools/ $*
1361
1362# ---------------------------------------------------------------------------
Shuah Khan5a5da782014-08-07 13:07:46 -06001363# Kernel selftest
1364
1365PHONY += kselftest
Guillaume Tucker4062eba2022-07-13 08:33:43 +02001366kselftest: headers
Shuah Khan2bc84522017-09-06 16:44:35 -06001367 $(Q)$(MAKE) -C $(srctree)/tools/testing/selftests run_tests
Shuah Khan5a5da782014-08-07 13:07:46 -06001368
Guillaume Tucker4062eba2022-07-13 08:33:43 +02001369kselftest-%: headers FORCE
Shuah Khan17eac6c2019-09-26 16:40:14 -06001370 $(Q)$(MAKE) -C $(srctree)/tools/testing/selftests $*
Wang Longdcb825a2015-10-08 02:41:18 +00001371
Bamvor Jian Zhang3d6dee72016-01-08 15:27:34 +08001372PHONY += kselftest-merge
1373kselftest-merge:
1374 $(if $(wildcard $(objtree)/.config),, $(error No .config exists, config your kernel first!))
Björn Töpel37013b52023-10-04 14:48:37 +02001375 $(Q)find $(srctree)/tools/testing/selftests -name config -o -name config.$(UTS_MACHINE) | \
Björn Töpel6d3d6382023-10-04 14:48:36 +02001376 xargs $(srctree)/scripts/kconfig/merge_config.sh -y -m $(objtree)/.config
Masahiro Yamada3e4c6942019-08-21 16:03:48 +09001377 $(Q)$(MAKE) -f $(srctree)/Makefile olddefconfig
Bamvor Jian Zhang3d6dee72016-01-08 15:27:34 +08001378
Shuah Khan5a5da782014-08-07 13:07:46 -06001379# ---------------------------------------------------------------------------
Rob Herring37c8a5f2018-01-10 15:19:37 -06001380# Devicetree files
1381
1382ifneq ($(wildcard $(srctree)/arch/$(SRCARCH)/boot/dts/),)
1383dtstree := arch/$(SRCARCH)/boot/dts
1384endif
1385
1386ifneq ($(dtstree),)
1387
Masahiro Yamadaee476202022-07-24 18:59:19 +09001388%.dtb: dtbs_prepare
Rob Herring75e89532021-12-08 15:39:16 -06001389 $(Q)$(MAKE) $(build)=$(dtstree) $(dtstree)/$@
Rob Herring37c8a5f2018-01-10 15:19:37 -06001390
Masahiro Yamadaee476202022-07-24 18:59:19 +09001391%.dtbo: dtbs_prepare
Rob Herring75e89532021-12-08 15:39:16 -06001392 $(Q)$(MAKE) $(build)=$(dtstree) $(dtstree)/$@
Viresh Kumarce88c9c2021-01-29 12:54:08 +05301393
Masahiro Yamadaee476202022-07-24 18:59:19 +09001394PHONY += dtbs dtbs_prepare dtbs_install dtbs_check
1395dtbs: dtbs_prepare
Masahiro Yamada24507872024-01-09 21:07:34 +09001396 $(Q)$(MAKE) $(build)=$(dtstree) need-dtbslist=1
Rob Herring37c8a5f2018-01-10 15:19:37 -06001397
Masahiro Yamadaee476202022-07-24 18:59:19 +09001398# include/config/kernel.release is actually needed when installing DTBs because
1399# INSTALL_DTBS_PATH contains $(KERNELRELEASE). However, we do not want to make
1400# dtbs_install depend on it as dtbs_install may run as root.
1401dtbs_prepare: include/config/kernel.release scripts_dtc
1402
Rob Herring75e89532021-12-08 15:39:16 -06001403ifneq ($(filter dtbs_check, $(MAKECMDGOALS)),)
Masahiro Yamadae10c4322020-03-04 12:20:37 +09001404export CHECK_DTBS=y
Rob Herringec201952022-12-19 19:32:33 -06001405endif
1406
1407ifneq ($(CHECK_DTBS),)
Rob Herring604a57b2024-04-05 17:56:03 -05001408dtbs_prepare: dt_binding_schemas
Masahiro Yamadab5154bf2020-03-04 12:20:36 +09001409endif
1410
Masahiro Yamadab5154bf2020-03-04 12:20:36 +09001411dtbs_check: dtbs
Rob Herring4f0e3a52018-09-06 13:26:07 -05001412
Rob Herring37c8a5f2018-01-10 15:19:37 -06001413dtbs_install:
Masahiro Yamada8f668642024-01-09 21:07:35 +09001414 $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.dtbinst obj=$(dtstree)
Rob Herring37c8a5f2018-01-10 15:19:37 -06001415
1416ifdef CONFIG_OF_EARLY_FLATTREE
1417all: dtbs
1418endif
1419
1420endif
1421
1422PHONY += scripts_dtc
1423scripts_dtc: scripts_basic
1424 $(Q)$(MAKE) $(build)=scripts/dtc
1425
Masahiro Yamadae10c4322020-03-04 12:20:37 +09001426ifneq ($(filter dt_binding_check, $(MAKECMDGOALS)),)
Rob Herring604a57b2024-04-05 17:56:03 -05001427export CHECK_DTBS=y
Masahiro Yamadae10c4322020-03-04 12:20:37 +09001428endif
1429
Rob Herring604a57b2024-04-05 17:56:03 -05001430PHONY += dt_binding_check dt_binding_schemas
1431dt_binding_check: dt_binding_schemas scripts_dtc
1432 $(Q)$(MAKE) $(build)=Documentation/devicetree/bindings $@
1433
1434dt_binding_schemas:
Rob Herring4f0e3a52018-09-06 13:26:07 -05001435 $(Q)$(MAKE) $(build)=Documentation/devicetree/bindings
1436
Rob Herringb6acf802022-06-30 15:37:22 -06001437PHONY += dt_compatible_check
Rob Herring604a57b2024-04-05 17:56:03 -05001438dt_compatible_check: dt_binding_schemas
Rob Herringb6acf802022-06-30 15:37:22 -06001439 $(Q)$(MAKE) $(build)=Documentation/devicetree/bindings $@
1440
Rob Herring37c8a5f2018-01-10 15:19:37 -06001441# ---------------------------------------------------------------------------
Linus Torvalds1da177e2005-04-16 15:20:36 -07001442# Modules
1443
1444ifdef CONFIG_MODULES
1445
Sam Ravnborg070b98b2006-06-25 00:07:55 +02001446# By default, build modules as well
Linus Torvalds1da177e2005-04-16 15:20:36 -07001447
Michal Marek73d13932010-03-10 12:28:58 +01001448all: modules
Linus Torvalds1da177e2005-04-16 15:20:36 -07001449
Masahiro Yamada4b50c8c2020-05-31 17:47:06 +09001450# When we're building modules with modversions, we need to consider
1451# the built-in objects during the descend as well, in order to
1452# make sure the checksums are up to date before we record them.
1453ifdef CONFIG_MODVERSIONS
1454 KBUILD_BUILTIN := 1
1455endif
1456
Masahiro Yamada3fbb43d2014-04-28 16:32:43 +09001457# Build modules
Tejun Heo551559e2007-12-07 21:04:30 +09001458#
Linus Torvalds1da177e2005-04-16 15:20:36 -07001459
Carlos Llamasfeb113a2023-01-25 18:30:47 +00001460# *.ko are usually independent of vmlinux, but CONFIG_DEBUG_INFO_BTF_MODULES
Masahiro Yamadaf73edc82022-09-25 03:19:13 +09001461# is an exception.
1462ifdef CONFIG_DEBUG_INFO_BTF_MODULES
Masahiro Yamada74d33202023-01-10 14:48:00 +09001463KBUILD_BUILTIN := 1
Masahiro Yamadaf73edc82022-09-25 03:19:13 +09001464modules: vmlinux
1465endif
Linus Torvalds1da177e2005-04-16 15:20:36 -07001466
Masahiro Yamadaf73edc82022-09-25 03:19:13 +09001467modules: modules_prepare
Michal Mareka6c36632010-03-08 10:07:12 +01001468
Linus Torvalds1da177e2005-04-16 15:20:36 -07001469# Target to prepare building external modules
Masahiro Yamada059bc9fc2018-11-29 12:56:30 +09001470modules_prepare: prepare
Masahiro Yamada596b0472020-09-08 13:27:08 +09001471 $(Q)$(MAKE) $(build)=scripts scripts/module.lds
Linus Torvalds1da177e2005-04-16 15:20:36 -07001472
Masahiro Yamada8ae071f2023-06-15 20:17:43 +09001473endif # CONFIG_MODULES
1474
Linus Torvalds1da177e2005-04-16 15:20:36 -07001475###
1476# Cleaning is done on three levels.
1477# make clean Delete most generated files
1478# Leave enough to build external modules
1479# make mrproper Delete the current configuration, and all generated files
1480# make distclean Remove editor backup files, patch leftover files and the like
1481
1482# Directories & files removed with 'make clean'
Masahiro Yamada1fdd7292023-08-19 20:43:01 +09001483CLEAN_FILES += vmlinux.symvers modules-only.symvers \
Masahiro Yamada3d322852020-08-22 23:56:16 +09001484 modules.builtin modules.builtin.modinfo modules.nsdeps \
Nathan Chancelloraba09152024-05-01 15:55:25 -07001485 compile_commands.json rust/test \
Maíra Canal7ea01d32023-02-03 14:37:04 -03001486 rust-project.json .vmlinux.objs .vmlinux.export.c
Linus Torvalds1da177e2005-04-16 15:20:36 -07001487
1488# Directories & files removed with 'make mrproper'
Masahiro Yamada0663c682020-05-04 17:08:07 +09001489MRPROPER_FILES += include/config include/generated \
Masahiro Yamadab0d62072022-05-29 00:47:02 +09001490 arch/$(SRCARCH)/include/generated .objdiff \
Thomas Weißschuhc8578532024-07-20 11:18:12 +02001491 debian snap tar-install PKGBUILD pacman \
Masahiro Yamada0663c682020-05-04 17:08:07 +09001492 .config .config.old .version \
Masahiro Yamada46457132019-07-15 23:01:49 +09001493 Module.symvers \
Masahiro Yamada5cca3602021-12-14 11:53:48 +09001494 certs/signing_key.pem \
Nayna Jainb31f2a42021-04-09 10:35:05 -04001495 certs/x509.genkey \
1496 vmlinux-gdb.py \
Masahiro Yamadaffa46bb2023-09-30 19:38:47 +09001497 rpmbuild \
Masahiro Yamadac83b16c2023-01-07 18:45:45 +09001498 rust/libmacros.so
Linus Torvalds1da177e2005-04-16 15:20:36 -07001499
1500# clean - Delete most, but leave enough to build external modules
1501#
Masahiro Yamadad98dba82024-04-28 00:32:53 +09001502clean: private rm-files := $(CLEAN_FILES)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001503
Masahiro Yamada76cd3062019-08-11 00:53:05 +09001504PHONY += archclean vmlinuxclean
Linus Torvalds1da177e2005-04-16 15:20:36 -07001505
Pawel Mollbd1ee802012-10-29 11:23:02 +00001506vmlinuxclean:
1507 $(Q)$(CONFIG_SHELL) $(srctree)/scripts/link-vmlinux.sh clean
Nicholas Pigginfbe6e372016-08-24 22:29:21 +10001508 $(Q)$(if $(ARCH_POSTLINK), $(MAKE) -f $(ARCH_POSTLINK) clean)
Pawel Mollbd1ee802012-10-29 11:23:02 +00001509
Jiri Olsa50d3a3f2021-02-05 13:40:20 +01001510clean: archclean vmlinuxclean resolve_btfids_clean
Linus Torvalds1da177e2005-04-16 15:20:36 -07001511
1512# mrproper - Delete all generated files, including .config
1513#
Masahiro Yamadad98dba82024-04-28 00:32:53 +09001514mrproper: private rm-files := $(MRPROPER_FILES)
Mauro Carvalho Chehabcb43fb52017-05-14 11:50:01 -03001515mrproper-dirs := $(addprefix _mrproper_,scripts)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001516
Masahiro Yamadab421b8a2019-01-14 17:29:29 +09001517PHONY += $(mrproper-dirs) mrproper
Linus Torvalds1da177e2005-04-16 15:20:36 -07001518$(mrproper-dirs):
1519 $(Q)$(MAKE) $(clean)=$(patsubst _mrproper_%,%,$@)
1520
Masahiro Yamadab421b8a2019-01-14 17:29:29 +09001521mrproper: clean $(mrproper-dirs)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001522 $(call cmd,rmfiles)
Miguel Ojeda2f7ab122021-07-03 16:42:57 +02001523 @find . $(RCS_FIND_IGNORE) \
1524 \( -name '*.rmeta' \) \
1525 -type f -print | xargs rm -f
Linus Torvalds1da177e2005-04-16 15:20:36 -07001526
1527# distclean
1528#
Paul Smith4f193362006-03-05 17:14:10 -05001529PHONY += distclean
Linus Torvalds1da177e2005-04-16 15:20:36 -07001530
1531distclean: mrproper
Masahiro Yamada19c8d9122021-05-04 19:10:56 +09001532 @find . $(RCS_FIND_IGNORE) \
Sam Ravnborg070b98b2006-06-25 00:07:55 +02001533 \( -name '*.orig' -o -name '*.rej' -o -name '*~' \
Masahiro Yamadaf78271d2017-01-22 23:02:32 +09001534 -o -name '*.bak' -o -name '#*#' -o -name '*%' \
Masahiro Yamada7a02cec2021-05-04 19:10:57 +09001535 -o -name 'core' -o -name tags -o -name TAGS -o -name 'cscope*' \
1536 -o -name GPATH -o -name GRTAGS -o -name GSYMS -o -name GTAGS \) \
Linus Torvalds1da177e2005-04-16 15:20:36 -07001537 -type f -print | xargs rm -f
1538
1539
1540# Packaging of the kernel to various formats
1541# ---------------------------------------------------------------------------
Linus Torvalds1da177e2005-04-16 15:20:36 -07001542
Arnaldo Carvalho de Melobafb6742010-06-07 07:44:25 -03001543%src-pkg: FORCE
Masahiro Yamada000ec952019-08-21 16:02:04 +09001544 $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.package $@
Zach Brown031ecc62006-06-08 22:12:37 -07001545%pkg: include/config/kernel.release FORCE
Masahiro Yamada000ec952019-08-21 16:02:04 +09001546 $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.package $@
Linus Torvalds1da177e2005-04-16 15:20:36 -07001547
1548# Brief documentation of the typical targets used
1549# ---------------------------------------------------------------------------
1550
Segher Boessenkool5dffbe82008-04-06 22:16:07 +02001551boards := $(wildcard $(srctree)/arch/$(SRCARCH)/configs/*_defconfig)
Konstantin Khlebnikova1e7b7b2014-10-28 17:18:20 +04001552boards := $(sort $(notdir $(boards)))
Segher Boessenkool5dffbe82008-04-06 22:16:07 +02001553board-dirs := $(dir $(wildcard $(srctree)/arch/$(SRCARCH)/configs/*/*_defconfig))
1554board-dirs := $(sort $(notdir $(board-dirs:/=)))
Linus Torvalds1da177e2005-04-16 15:20:36 -07001555
Masahiro Yamadafe69b422016-03-13 09:39:55 +09001556PHONY += help
Linus Torvalds1da177e2005-04-16 15:20:36 -07001557help:
1558 @echo 'Cleaning targets:'
Samuel Tardieu5ea084e2006-12-12 19:09:40 +01001559 @echo ' clean - Remove most generated files but keep the config and'
Jesper Juhl5cc8d242006-09-24 14:01:08 +02001560 @echo ' enough build support to build external modules'
Samuel Tardieu5ea084e2006-12-12 19:09:40 +01001561 @echo ' mrproper - Remove all generated files + config + various backup files'
Jesper Juhl5cc8d242006-09-24 14:01:08 +02001562 @echo ' distclean - mrproper + remove editor backup and patch files'
Linus Torvalds1da177e2005-04-16 15:20:36 -07001563 @echo ''
Linus Torvalds1da177e2005-04-16 15:20:36 -07001564 @$(MAKE) -f $(srctree)/scripts/kconfig/Makefile help
1565 @echo ''
1566 @echo 'Other generic targets:'
1567 @echo ' all - Build all targets marked with [*]'
1568 @echo '* vmlinux - Build the bare kernel'
1569 @echo '* modules - Build all modules'
Bodo Eggert9cc5d742005-11-23 20:11:34 +01001570 @echo ' modules_install - Install all modules to INSTALL_MOD_PATH (default: /)'
Masahiro Yamada56769ba2023-10-14 19:54:35 +09001571 @echo ' vdso_install - Install unstripped vdso to INSTALL_MOD_PATH (default: /)'
Linus Torvalds1da177e2005-04-16 15:20:36 -07001572 @echo ' dir/ - Build all files in dir and below'
Wang YanQing40ab87a42015-12-11 00:35:19 +08001573 @echo ' dir/file.[ois] - Build specified target only'
Vinícius Tinti433db3e2017-04-24 13:04:58 -07001574 @echo ' dir/file.ll - Build the LLVM assembly file'
1575 @echo ' (requires compiler support for LLVM assembly generation)'
Joe Perches62718972010-01-13 09:31:44 -08001576 @echo ' dir/file.lst - Build specified mixed source/assembly target only'
1577 @echo ' (requires a recent binutils and recent build (System.map))'
Sam Ravnborg155ad602005-07-07 17:56:08 -07001578 @echo ' dir/file.ko - Build module including final link'
Robert P. J. Dayc4d5ee62009-04-24 12:35:23 -04001579 @echo ' modules_prepare - Set up for building external modules'
Linus Torvalds1da177e2005-04-16 15:20:36 -07001580 @echo ' tags/TAGS - Generate tags file for editors'
1581 @echo ' cscope - Generate cscope index'
Jianbin Kangf4ed1002011-01-14 20:07:05 +08001582 @echo ' gtags - Generate GNU GLOBAL index'
Michal Marek3f1d9a62014-07-11 15:57:24 +02001583 @echo ' kernelrelease - Output the release version string (use with make -s)'
1584 @echo ' kernelversion - Output the version stored in Makefile (use with make -s)'
1585 @echo ' image_name - Output the image name (use with make -s)'
Sam Ravnborg2fb9b1b2008-06-21 00:24:17 +02001586 @echo ' headers_install - Install sanitised kernel headers to INSTALL_HDR_PATH'; \
Geert Uytterhoeven59df3232007-01-29 13:47:01 +01001587 echo ' (default: $(INSTALL_HDR_PATH))'; \
Sam Ravnborg2fb9b1b2008-06-21 00:24:17 +02001588 echo ''
Randy Dunlap31b8cc82017-05-08 15:55:08 -07001589 @echo 'Static analysers:'
Heiko Carstens66242cf2023-11-20 19:37:19 +01001590 @echo ' checkstack - Generate a list of stack hogs and consider all functions'
1591 @echo ' with a stack size larger than MINSTACKSIZE (default: 100)'
Sam Ravnborgaa025e72007-11-14 21:34:55 +01001592 @echo ' versioncheck - Sanity check on version.h usage'
Randy Dunlapec2d9872007-11-04 12:01:55 -08001593 @echo ' includecheck - Check for duplicate included header files'
Adrian Bunk295ac052007-08-24 23:04:56 +02001594 @echo ' export_report - List the usages of all exported symbols'
Nicolas Palix74425ee2010-06-06 17:15:01 +02001595 @echo ' headerdep - Detect inclusion cycles in headers'
Masahiro Yamada7f855fc82017-11-14 18:47:20 +09001596 @echo ' coccicheck - Check with Coccinelle'
Nathan Huckleberry6ad7cbc2020-08-22 23:56:18 +09001597 @echo ' clang-analyzer - Check with clang static analyzer'
1598 @echo ' clang-tidy - Check with clang-tidy'
Nicolas Palix74425ee2010-06-06 17:15:01 +02001599 @echo ''
Matthias Maennicheb8305a2019-09-06 11:32:32 +01001600 @echo 'Tools:'
1601 @echo ' nsdeps - Generate missing symbol namespace dependencies'
1602 @echo ''
Randy Dunlap31b8cc82017-05-08 15:55:08 -07001603 @echo 'Kernel selftest:'
Shuah Khane51d8da2020-03-30 12:07:11 -06001604 @echo ' kselftest - Build and run kernel selftest'
1605 @echo ' Build, install, and boot kernel before'
1606 @echo ' running kselftest on it'
1607 @echo ' Run as root for full coverage'
1608 @echo ' kselftest-all - Build kernel selftest'
1609 @echo ' kselftest-install - Build and install kernel selftest'
1610 @echo ' kselftest-clean - Remove all generated kselftest files'
1611 @echo ' kselftest-merge - Merge all the config dependencies of'
1612 @echo ' kselftest to existing .config.'
Shuah Khan5a5da782014-08-07 13:07:46 -06001613 @echo ''
Miguel Ojeda2f7ab122021-07-03 16:42:57 +02001614 @echo 'Rust targets:'
1615 @echo ' rustavailable - Checks whether the Rust toolchain is'
1616 @echo ' available and, if not, explains why.'
1617 @echo ' rustfmt - Reformat all the Rust code in the kernel'
1618 @echo ' rustfmtcheck - Checks if all the Rust code in the kernel'
1619 @echo ' is formatted, printing a diff otherwise.'
1620 @echo ' rustdoc - Generate Rust documentation'
1621 @echo ' (requires kernel .config)'
1622 @echo ' rusttest - Runs the Rust tests'
1623 @echo ' (requires kernel .config; downloads external repos)'
1624 @echo ' rust-analyzer - Generate rust-project.json rust-analyzer support file'
1625 @echo ' (requires kernel .config)'
1626 @echo ' dir/file.[os] - Build specified target only'
1627 @echo ' dir/file.rsi - Build macro expanded source, similar to C preprocessing.'
1628 @echo ' Run with RUSTFMT=n to skip reformatting if needed.'
1629 @echo ' The output is not intended to be compilable.'
1630 @echo ' dir/file.ll - Build the LLVM assembly file'
1631 @echo ''
Rob Herring37c8a5f2018-01-10 15:19:37 -06001632 @$(if $(dtstree), \
1633 echo 'Devicetree:'; \
Rob Herring604a57b2024-04-05 17:56:03 -05001634 echo '* dtbs - Build device tree blobs for enabled boards'; \
1635 echo ' dtbs_install - Install dtbs to $(INSTALL_DTBS_PATH)'; \
1636 echo ' dt_binding_check - Validate device tree binding documents and examples'; \
1637 echo ' dt_binding_schema - Build processed device tree binding schemas'; \
1638 echo ' dtbs_check - Validate device tree source files';\
Rob Herring37c8a5f2018-01-10 15:19:37 -06001639 echo '')
1640
Randy Dunlap31b8cc82017-05-08 15:55:08 -07001641 @echo 'Userspace tools targets:'
1642 @echo ' use "make tools/help"'
1643 @echo ' or "cd tools; make help"'
1644 @echo ''
Linus Torvalds1da177e2005-04-16 15:20:36 -07001645 @echo 'Kernel packaging:'
Masahiro Yamada000ec952019-08-21 16:02:04 +09001646 @$(MAKE) -f $(srctree)/scripts/Makefile.package help
Linus Torvalds1da177e2005-04-16 15:20:36 -07001647 @echo ''
1648 @echo 'Documentation targets:'
Mauro Carvalho Chehabcb43fb52017-05-14 11:50:01 -03001649 @$(MAKE) -f $(srctree)/Documentation/Makefile dochelp
Linus Torvalds1da177e2005-04-16 15:20:36 -07001650 @echo ''
Simon Glass766b7002023-10-26 20:26:23 +13001651 @echo 'Architecture-specific targets ($(SRCARCH)):'
Masahiro Yamada5c816642022-02-11 14:14:11 +09001652 @$(or $(archhelp),\
Simon Glass766b7002023-10-26 20:26:23 +13001653 echo ' No architecture-specific help defined for $(SRCARCH)')
Linus Torvalds1da177e2005-04-16 15:20:36 -07001654 @echo ''
1655 @$(if $(boards), \
1656 $(foreach b, $(boards), \
Geert Uytterhoeven42344482019-10-25 13:53:05 +02001657 printf " %-27s - Build for %s\\n" $(b) $(subst _defconfig,,$(b));) \
Linus Torvalds1da177e2005-04-16 15:20:36 -07001658 echo '')
Segher Boessenkool5dffbe82008-04-06 22:16:07 +02001659 @$(if $(board-dirs), \
1660 $(foreach b, $(board-dirs), \
1661 printf " %-16s - Show %s-specific targets\\n" help-$(b) $(b);) \
1662 printf " %-16s - Show all of the above\\n" help-boards; \
1663 echo '')
Linus Torvalds1da177e2005-04-16 15:20:36 -07001664
Masahiro Yamada83d98d72022-12-23 01:25:35 +09001665 @echo ' make V=n [targets] 1: verbose build'
Masahiro Yamada6ae4b982022-12-23 01:25:34 +09001666 @echo ' 2: give reason for rebuild of target'
1667 @echo ' V=1 and V=2 can be combined with V=12'
Linus Torvalds1da177e2005-04-16 15:20:36 -07001668 @echo ' make O=dir [targets] Locate all output files in "dir", including .config'
Geert Uytterhoevena64c0442019-10-25 13:52:32 +02001669 @echo ' make C=1 [targets] Check re-compiled c source with $$CHECK'
1670 @echo ' (sparse by default)'
Dustin Kirkland701842e2006-05-23 15:57:23 -05001671 @echo ' make C=2 [targets] Force check of all c source with $$CHECK'
Ingo Molnaraf07ce32011-06-16 13:26:23 +02001672 @echo ' make RECORDMCOUNT_WARN=1 [targets] Warn about ignored mcount sections'
Masahiro Yamada89876172024-01-20 17:32:55 +09001673 @echo ' make W=n [targets] Enable extra build checks, n=1,2,3,c,e where'
Sam Ravnborg28bc20d2011-04-27 22:15:27 +02001674 @echo ' 1: warnings which may be relevant and do not occur too often'
1675 @echo ' 2: warnings which occur quite often but may still be relevant'
1676 @echo ' 3: more obscure warnings, can most likely be ignored'
Masahiro Yamada92ef4322023-11-23 18:05:40 +09001677 @echo ' c: extra checks in the configuration stage (Kconfig)'
Yann Droneaudc77d06e2022-04-08 10:46:07 +02001678 @echo ' e: warnings are being treated as errors'
Michal Mareka6de5532011-04-29 14:45:31 +02001679 @echo ' Multiple levels can be combined with W=12 or W=123'
Rob Herringec201952022-12-19 19:32:33 -06001680 @$(if $(dtstree), \
1681 echo ' make CHECK_DTBS=1 [targets] Check all generated dtb files against schema'; \
1682 echo ' This can be applied both to "dtbs" and to individual "foo.dtb" targets' ; \
1683 )
Linus Torvalds1da177e2005-04-16 15:20:36 -07001684 @echo ''
1685 @echo 'Execute "make" or "make all" to build all targets marked with [*] '
1686 @echo 'For further info see the ./README file'
1687
1688
Segher Boessenkool5dffbe82008-04-06 22:16:07 +02001689help-board-dirs := $(addprefix help-,$(board-dirs))
1690
1691help-boards: $(help-board-dirs)
1692
Michal Marekfbae4d52014-11-28 13:31:43 +01001693boards-per-dir = $(sort $(notdir $(wildcard $(srctree)/arch/$(SRCARCH)/configs/$*/*_defconfig)))
Segher Boessenkool5dffbe82008-04-06 22:16:07 +02001694
1695$(help-board-dirs): help-%:
Simon Glass766b7002023-10-26 20:26:23 +13001696 @echo 'Architecture-specific targets ($(SRCARCH) $*):'
Segher Boessenkool5dffbe82008-04-06 22:16:07 +02001697 @$(if $(boards-per-dir), \
1698 $(foreach b, $(boards-per-dir), \
1699 printf " %-24s - Build for %s\\n" $*/$(b) $(subst _defconfig,,$(b));) \
1700 echo '')
1701
1702
Linus Torvalds1da177e2005-04-16 15:20:36 -07001703# Documentation targets
1704# ---------------------------------------------------------------------------
Jani Nikulae8939222017-10-09 18:26:15 +03001705DOC_TARGETS := xmldocs latexdocs pdfdocs htmldocs epubdocs cleandocs \
Maxim Cournoyer1f050e92022-11-16 14:02:09 -05001706 linkcheckdocs dochelp refcheckdocs texinfodocs infodocs
Jani Nikula22cba312016-05-19 15:14:05 +03001707PHONY += $(DOC_TARGETS)
Masahiro Yamadabc7b752a2019-08-22 02:33:21 +09001708$(DOC_TARGETS):
Mauro Carvalho Chehabcb43fb52017-05-14 11:50:01 -03001709 $(Q)$(MAKE) $(build)=Documentation $@
Linus Torvalds1da177e2005-04-16 15:20:36 -07001710
Miguel Ojeda2f7ab122021-07-03 16:42:57 +02001711
1712# Rust targets
1713# ---------------------------------------------------------------------------
1714
1715# "Is Rust available?" target
1716PHONY += rustavailable
1717rustavailable:
Miguel Ojedaecab4112024-02-17 01:26:37 +01001718 +$(Q)$(CONFIG_SHELL) $(srctree)/scripts/rust_is_available.sh && echo "Rust is available!"
Miguel Ojeda2f7ab122021-07-03 16:42:57 +02001719
1720# Documentation target
1721#
1722# Using the singular to avoid running afoul of `no-dot-config-targets`.
1723PHONY += rustdoc
1724rustdoc: prepare
1725 $(Q)$(MAKE) $(build)=rust $@
1726
1727# Testing target
1728PHONY += rusttest
1729rusttest: prepare
1730 $(Q)$(MAKE) $(build)=rust $@
1731
1732# Formatting targets
1733PHONY += rustfmt rustfmtcheck
1734
1735# We skip `rust/alloc` since we want to minimize the diff w.r.t. upstream.
1736#
1737# We match using absolute paths since `find` does not resolve them
1738# when matching, which is a problem when e.g. `srctree` is `..`.
1739# We `grep` afterwards in order to remove the directory entry itself.
1740rustfmt:
1741 $(Q)find $(abs_srctree) -type f -name '*.rs' \
1742 -o -path $(abs_srctree)/rust/alloc -prune \
1743 -o -path $(abs_objtree)/rust/test -prune \
1744 | grep -Fv $(abs_srctree)/rust/alloc \
1745 | grep -Fv $(abs_objtree)/rust/test \
1746 | grep -Fv generated \
1747 | xargs $(RUSTFMT) $(rustfmt_flags)
1748
1749rustfmtcheck: rustfmt_flags = --check
1750rustfmtcheck: rustfmt
1751
Masahiro Yamada67274c02019-02-19 18:33:02 +09001752# Misc
1753# ---------------------------------------------------------------------------
1754
Masahiro Yamada91ecf7f2022-12-29 16:43:10 +09001755PHONY += misc-check
1756misc-check:
1757 $(Q)$(srctree)/scripts/misc-check
1758
1759all: misc-check
1760
Masahiro Yamada67274c02019-02-19 18:33:02 +09001761PHONY += scripts_gdb
Masahiro Yamada7a739ce2019-06-04 19:13:57 +09001762scripts_gdb: prepare0
Masahiro Yamada1e5ff842019-02-19 18:33:04 +09001763 $(Q)$(MAKE) $(build)=scripts/gdb
Masahiro Yamada8d2e5202019-02-19 18:33:05 +09001764 $(Q)ln -fsn $(abspath $(srctree)/scripts/gdb/vmlinux-gdb.py)
Masahiro Yamada67274c02019-02-19 18:33:02 +09001765
1766ifdef CONFIG_GDB_SCRIPTS
1767all: scripts_gdb
1768endif
1769
Linus Torvalds1da177e2005-04-16 15:20:36 -07001770else # KBUILD_EXTMOD
1771
Tzafrir Cohenc753ccb2023-03-14 15:02:48 +02001772filechk_kernel.release = echo $(KERNELRELEASE)
1773
Linus Torvalds1da177e2005-04-16 15:20:36 -07001774###
1775# External module support.
1776# When building external modules the kernel used as basis is considered
1777# read-only, and no consistency checks are made and the make
1778# system is not used on the basis kernel. If updates are required
Masahiro Yamada11122b82021-05-04 19:10:58 +09001779# in the basis kernel ordinary make commands (without M=...) must be used.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001780
Masahiro Yamada62128042020-09-09 05:55:57 +09001781# We are always building only modules.
1782KBUILD_BUILTIN :=
Linus Torvalds1da177e2005-04-16 15:20:36 -07001783KBUILD_MODULES := 1
Linus Torvalds1da177e2005-04-16 15:20:36 -07001784
Masahiro Yamada57501212022-09-25 03:19:10 +09001785build-dir := $(KBUILD_EXTMOD)
Masahiro Yamada3d322852020-08-22 23:56:16 +09001786
Masahiro Yamada7f691802021-03-31 22:38:06 +09001787compile_commands.json: $(extmod_prefix)compile_commands.json
Masahiro Yamada3d322852020-08-22 23:56:16 +09001788PHONY += compile_commands.json
1789
Masahiro Yamada76cd3062019-08-11 00:53:05 +09001790clean-dirs := $(KBUILD_EXTMOD)
Masahiro Yamadad98dba82024-04-28 00:32:53 +09001791clean: private rm-files := $(KBUILD_EXTMOD)/Module.symvers $(KBUILD_EXTMOD)/modules.nsdeps \
Nathan Chancelloraba09152024-05-01 15:55:25 -07001792 $(KBUILD_EXTMOD)/compile_commands.json
Linus Torvalds1da177e2005-04-16 15:20:36 -07001793
Masahiro Yamada6072b2c2021-08-01 11:53:46 +09001794PHONY += prepare
1795# now expand this into a simple variable to reduce the cost of shell evaluations
1796prepare: CC_VERSION_TEXT := $(CC_VERSION_TEXT)
1797prepare:
Masahiro Yamada129ab0d2021-12-14 11:53:53 +09001798 @if [ "$(CC_VERSION_TEXT)" != "$(CONFIG_CC_VERSION_TEXT)" ]; then \
Masahiro Yamada6072b2c2021-08-01 11:53:46 +09001799 echo >&2 "warning: the compiler differs from the one used to build the kernel"; \
Masahiro Yamada129ab0d2021-12-14 11:53:53 +09001800 echo >&2 " The kernel was built by: $(CONFIG_CC_VERSION_TEXT)"; \
Masahiro Yamada6072b2c2021-08-01 11:53:46 +09001801 echo >&2 " You are using: $(CC_VERSION_TEXT)"; \
1802 fi
1803
Masahiro Yamadafe69b422016-03-13 09:39:55 +09001804PHONY += help
Linus Torvalds1da177e2005-04-16 15:20:36 -07001805help:
1806 @echo ' Building external modules.'
1807 @echo ' Syntax: make -C path/to/kernel/src M=$$PWD target'
1808 @echo ''
1809 @echo ' modules - default target, build the module(s)'
1810 @echo ' modules_install - install the module'
1811 @echo ' clean - remove generated files in module directory only'
Vinay Varma49a9ef72023-04-11 17:17:15 +08001812 @echo ' rust-analyzer - generate rust-project.json rust-analyzer support file'
Linus Torvalds1da177e2005-04-16 15:20:36 -07001813 @echo ''
Sam Ravnborg06300b22006-01-25 07:13:18 +01001814
Masahiro Yamada5e027972023-08-23 20:50:46 +09001815ifndef CONFIG_MODULES
1816modules modules_install: __external_modules_error
Masahiro Yamada8ae071f2023-06-15 20:17:43 +09001817__external_modules_error:
1818 @echo >&2 '***'
1819 @echo >&2 '*** The present kernel disabled CONFIG_MODULES.'
1820 @echo >&2 '*** You cannot build or install external modules.'
1821 @echo >&2 '***'
1822 @false
Masahiro Yamada5e027972023-08-23 20:50:46 +09001823endif
Masahiro Yamada8ae071f2023-06-15 20:17:43 +09001824
Linus Torvalds1da177e2005-04-16 15:20:36 -07001825endif # KBUILD_EXTMOD
1826
Masahiro Yamada3e3005d2021-03-31 22:38:03 +09001827# ---------------------------------------------------------------------------
1828# Modules
1829
Masahiro Yamada151aeca2023-08-23 20:50:48 +09001830PHONY += modules modules_install modules_sign modules_prepare
Masahiro Yamada3e3005d2021-03-31 22:38:03 +09001831
Masahiro Yamada5e027972023-08-23 20:50:46 +09001832modules_install:
Masahiro Yamada151aeca2023-08-23 20:50:48 +09001833 $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modinst \
1834 sign-only=$(if $(filter modules_install,$(MAKECMDGOALS)),,y)
1835
1836ifeq ($(CONFIG_MODULE_SIG),y)
1837# modules_sign is a subset of modules_install.
1838# 'make modules_install modules_sign' is equivalent to 'make modules_install'.
1839modules_sign: modules_install
1840 @:
1841else
1842modules_sign:
1843 @echo >&2 '***'
1844 @echo >&2 '*** CONFIG_MODULE_SIG is disabled. You cannot sign modules.'
1845 @echo >&2 '***'
1846 @false
1847endif
Masahiro Yamada3e3005d2021-03-31 22:38:03 +09001848
1849ifdef CONFIG_MODULES
1850
Masahiro Yamada57501212022-09-25 03:19:10 +09001851$(MODORDER): $(build-dir)
1852 @:
1853
Masahiro Yamadaf73edc82022-09-25 03:19:13 +09001854# KBUILD_MODPOST_NOFINAL can be set to skip the final link of modules.
1855# This is solely useful to speed up test compiles.
1856modules: modpost
1857ifneq ($(KBUILD_MODPOST_NOFINAL),1)
1858 $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modfinal
1859endif
Masahiro Yamada3e3005d2021-03-31 22:38:03 +09001860
Masahiro Yamada1a998be2021-03-31 22:38:05 +09001861PHONY += modules_check
1862modules_check: $(MODORDER)
1863 $(Q)$(CONFIG_SHELL) $(srctree)/scripts/modules-check.sh $<
1864
Masahiro Yamada3e3005d2021-03-31 22:38:03 +09001865else # CONFIG_MODULES
1866
Masahiro Yamada5e027972023-08-23 20:50:46 +09001867modules:
Masahiro Yamada8ae071f2023-06-15 20:17:43 +09001868 @:
Masahiro Yamada3e3005d2021-03-31 22:38:03 +09001869
Masahiro Yamadaf110e5a2022-08-28 11:39:50 +09001870KBUILD_MODULES :=
1871
Masahiro Yamada3e3005d2021-03-31 22:38:03 +09001872endif # CONFIG_MODULES
1873
Masahiro Yamadaf73edc82022-09-25 03:19:13 +09001874PHONY += modpost
1875modpost: $(if $(single-build),, $(if $(KBUILD_BUILTIN), vmlinux.o)) \
1876 $(if $(KBUILD_MODULES), modules_check)
1877 $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modpost
1878
Masahiro Yamadab1fbfcb2019-11-18 13:52:47 +09001879# Single targets
1880# ---------------------------------------------------------------------------
1881# To build individual files in subdirectories, you can do like this:
1882#
1883# make foo/bar/baz.s
1884#
1885# The supported suffixes for single-target are listed in 'single-targets'
1886#
1887# To build only under specific subdirectories, you can do like this:
1888#
1889# make foo/bar/baz/
1890
1891ifdef single-build
1892
1893# .ko is special because modpost is needed
1894single-ko := $(sort $(filter %.ko, $(MAKECMDGOALS)))
Masahiro Yamadafc93a4c2022-04-07 00:30:22 +09001895single-no-ko := $(filter-out $(single-ko), $(MAKECMDGOALS)) \
1896 $(foreach x, o mod, $(patsubst %.ko, %.$x, $(single-ko)))
Masahiro Yamadab1fbfcb2019-11-18 13:52:47 +09001897
Masahiro Yamadaf73edc82022-09-25 03:19:13 +09001898$(single-ko): single_modules
Masahiro Yamadab1fbfcb2019-11-18 13:52:47 +09001899 @:
Masahiro Yamada57501212022-09-25 03:19:10 +09001900$(single-no-ko): $(build-dir)
Masahiro Yamadab1fbfcb2019-11-18 13:52:47 +09001901 @:
1902
Masahiro Yamadaf110e5a2022-08-28 11:39:50 +09001903# Remove MODORDER when done because it is not the real one.
Masahiro Yamadaf73edc82022-09-25 03:19:13 +09001904PHONY += single_modules
1905single_modules: $(single-no-ko) modules_prepare
Masahiro Yamadaa53da432023-01-01 15:07:09 +09001906 $(Q){ $(foreach m, $(single-ko), echo $(extmod_prefix)$(m:%.ko=%.o);) } > $(MODORDER)
Masahiro Yamadab1fbfcb2019-11-18 13:52:47 +09001907 $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modpost
Masahiro Yamadaf73edc82022-09-25 03:19:13 +09001908ifneq ($(KBUILD_MODPOST_NOFINAL),1)
1909 $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modfinal
1910endif
Masahiro Yamadaf110e5a2022-08-28 11:39:50 +09001911 $(Q)rm -f $(MODORDER)
Masahiro Yamadab1fbfcb2019-11-18 13:52:47 +09001912
Masahiro Yamada57501212022-09-25 03:19:10 +09001913single-goals := $(addprefix $(build-dir)/, $(single-no-ko))
Masahiro Yamadab1fbfcb2019-11-18 13:52:47 +09001914
Masahiro Yamada3753af72022-10-15 05:18:11 +09001915KBUILD_MODULES := 1
1916
Masahiro Yamadab1fbfcb2019-11-18 13:52:47 +09001917endif
1918
Masahiro Yamadac99f3912019-08-11 00:53:04 +09001919# Preset locale variables to speed up the build process. Limit locale
1920# tweaks to this spot to avoid wrong language settings when running
1921# make menuconfig etc.
1922# Error messages still appears in the original language
Masahiro Yamada57501212022-09-25 03:19:10 +09001923PHONY += $(build-dir)
1924$(build-dir): prepare
1925 $(Q)$(MAKE) $(build)=$@ need-builtin=1 need-modorder=1 $(single-goals)
Masahiro Yamadac99f3912019-08-11 00:53:04 +09001926
Masahiro Yamada76cd3062019-08-11 00:53:05 +09001927clean-dirs := $(addprefix _clean_, $(clean-dirs))
1928PHONY += $(clean-dirs) clean
1929$(clean-dirs):
1930 $(Q)$(MAKE) $(clean)=$(patsubst _clean_%,%,$@)
1931
Michal Marek88d7be02010-09-06 12:00:08 +02001932clean: $(clean-dirs)
Michal Marek88d7be02010-09-06 12:00:08 +02001933 $(call cmd,rmfiles)
Masahiro Yamada5c816642022-02-11 14:14:11 +09001934 @find $(or $(KBUILD_EXTMOD), .) $(RCS_FIND_IGNORE) \
Miguel Ojeda2f7ab122021-07-03 16:42:57 +02001935 \( -name '*.[aios]' -o -name '*.rsi' -o -name '*.ko' -o -name '.*.cmd' \
Rob Herring4f0e3a52018-09-06 13:26:07 -05001936 -o -name '*.ko.*' \
Andrew Davisdcad2402022-11-14 14:59:39 -06001937 -o -name '*.dtb' -o -name '*.dtbo' \
1938 -o -name '*.dtb.S' -o -name '*.dtbo.S' \
Masahiro Yamada24507872024-01-09 21:07:34 +09001939 -o -name '*.dt.yaml' -o -name 'dtbs-list' \
Masahiro Yamadaef46d9b2017-11-17 01:49:13 +09001940 -o -name '*.dwo' -o -name '*.lst' \
Masahiro Yamada5e9e95cc92023-06-12 00:50:57 +09001941 -o -name '*.su' -o -name '*.mod' \
Michal Marek88d7be02010-09-06 12:00:08 +02001942 -o -name '.*.d' -o -name '.*.tmp' -o -name '*.mod.c' \
Masahiro Yamada9a8dfb32018-03-23 22:04:31 +09001943 -o -name '*.lex.c' -o -name '*.tab.[ch]' \
Masahiro Yamada4fa8bc92018-03-23 22:04:37 +09001944 -o -name '*.asn1.[ch]' \
Michal Marek88d7be02010-09-06 12:00:08 +02001945 -o -name '*.symtypes' -o -name 'modules.order' \
Emese Revfy6b90bd42016-05-24 00:09:38 +02001946 -o -name '*.c.[012]*.*' \
Vinícius Tinti433db3e2017-04-24 13:04:58 -07001947 -o -name '*.ll' \
Sami Tolvanen38e89182020-12-11 10:46:20 -08001948 -o -name '*.gcno' \
Thomas Weißschuh9c73bcf2023-01-18 05:05:34 +00001949 -o -name '*.*.symversions' \) -type f -print \
1950 -o -name '.tmp_*' -print \
1951 | xargs rm -rf
Michal Marek88d7be02010-09-06 12:00:08 +02001952
Linus Torvalds1da177e2005-04-16 15:20:36 -07001953# Generate tags for editors
1954# ---------------------------------------------------------------------------
Sam Ravnborga680eed2008-12-03 22:24:13 +01001955quiet_cmd_tags = GEN $@
Masahiro Yamada858805b2019-08-25 22:28:37 +09001956 cmd_tags = $(BASH) $(srctree)/scripts/tags.sh $@
Linus Torvalds1da177e2005-04-16 15:20:36 -07001957
Jianbin Kangf4ed1002011-01-14 20:07:05 +08001958tags TAGS cscope gtags: FORCE
Linus Torvalds1da177e2005-04-16 15:20:36 -07001959 $(call cmd,tags)
1960
John Hubbard5045b4602024-06-27 17:43:56 -07001961# Generate rust-project.json (a file that describes the structure of non-Cargo
1962# Rust projects) for rust-analyzer (an implementation of the Language Server
1963# Protocol).
Vinay Varma49a9ef72023-04-11 17:17:15 +08001964PHONY += rust-analyzer
1965rust-analyzer:
John Hubbard6dc9d9c2024-06-27 17:43:55 -07001966 $(Q)$(CONFIG_SHELL) $(srctree)/scripts/rust_is_available.sh
Vinay Varma49a9ef72023-04-11 17:17:15 +08001967 $(Q)$(MAKE) $(build)=rust $@
1968
Matthias Maennicheb8305a2019-09-06 11:32:32 +01001969# Script to generate missing namespace dependencies
1970# ---------------------------------------------------------------------------
1971
1972PHONY += nsdeps
Masahiro Yamadabff9c622019-10-29 21:38:06 +09001973nsdeps: export KBUILD_NSDEPS=1
Matthias Maennicheb8305a2019-09-06 11:32:32 +01001974nsdeps: modules
Masahiro Yamadabff9c622019-10-29 21:38:06 +09001975 $(Q)$(CONFIG_SHELL) $(srctree)/scripts/nsdeps
Matthias Maennicheb8305a2019-09-06 11:32:32 +01001976
Masahiro Yamada3d322852020-08-22 23:56:16 +09001977# Clang Tooling
1978# ---------------------------------------------------------------------------
1979
1980quiet_cmd_gen_compile_commands = GEN $@
1981 cmd_gen_compile_commands = $(PYTHON3) $< -a $(AR) -o $@ $(filter-out $<, $(real-prereqs))
1982
Masahiro Yamada7f691802021-03-31 22:38:06 +09001983$(extmod_prefix)compile_commands.json: scripts/clang-tools/gen_compile_commands.py \
Masahiro Yamada32164842022-09-25 03:19:14 +09001984 $(if $(KBUILD_EXTMOD),, vmlinux.a $(KBUILD_VMLINUX_LIBS)) \
Masahiro Yamada3d322852020-08-22 23:56:16 +09001985 $(if $(CONFIG_MODULES), $(MODORDER)) FORCE
1986 $(call if_changed,gen_compile_commands)
1987
Masahiro Yamada7f691802021-03-31 22:38:06 +09001988targets += $(extmod_prefix)compile_commands.json
Masahiro Yamada3d322852020-08-22 23:56:16 +09001989
Nathan Huckleberry6ad7cbc2020-08-22 23:56:18 +09001990PHONY += clang-tidy clang-analyzer
1991
1992ifdef CONFIG_CC_IS_CLANG
1993quiet_cmd_clang_tools = CHECK $<
1994 cmd_clang_tools = $(PYTHON3) $(srctree)/scripts/clang-tools/run-clang-tools.py $@ $<
1995
Masahiro Yamada7f691802021-03-31 22:38:06 +09001996clang-tidy clang-analyzer: $(extmod_prefix)compile_commands.json
Nathan Huckleberry6ad7cbc2020-08-22 23:56:18 +09001997 $(call cmd,clang_tools)
1998else
1999clang-tidy clang-analyzer:
2000 @echo "$@ requires CC=clang" >&2
2001 @false
2002endif
2003
Linus Torvalds1da177e2005-04-16 15:20:36 -07002004# Scripts to check various things for consistency
2005# ---------------------------------------------------------------------------
2006
Jacob Keller7dfbea42020-10-09 17:18:44 -07002007PHONY += includecheck versioncheck coccicheck export_report
Peter Foley279f3dd2011-04-26 17:15:01 -04002008
Linus Torvalds1da177e2005-04-16 15:20:36 -07002009includecheck:
Peter Foley436f8762011-04-26 17:18:29 -04002010 find $(srctree)/* $(RCS_FIND_IGNORE) \
Linus Torvalds1da177e2005-04-16 15:20:36 -07002011 -name '*.[hcS]' -type f -print | sort \
Geert Uytterhoeven80007432007-11-05 11:51:44 +01002012 | xargs $(PERL) -w $(srctree)/scripts/checkincludes.pl
Linus Torvalds1da177e2005-04-16 15:20:36 -07002013
2014versioncheck:
Peter Foley2ee2d292011-04-26 17:19:28 -04002015 find $(srctree)/* $(RCS_FIND_IGNORE) \
Linus Torvalds1da177e2005-04-16 15:20:36 -07002016 -name '*.[hcS]' -type f -print | sort \
Geert Uytterhoeven80007432007-11-05 11:51:44 +01002017 | xargs $(PERL) -w $(srctree)/scripts/checkversion.pl
Linus Torvalds1da177e2005-04-16 15:20:36 -07002018
Nicolas Palix74425ee2010-06-06 17:15:01 +02002019coccicheck:
Masahiro Yamada858805b2019-08-25 22:28:37 +09002020 $(Q)$(BASH) $(srctree)/scripts/$@
Nicolas Palix74425ee2010-06-06 17:15:01 +02002021
Adrian Bunk295ac052007-08-24 23:04:56 +02002022export_report:
2023 $(PERL) $(srctree)/scripts/export_report.pl
2024
Mike Marciniszync398ff02013-06-24 08:48:37 -04002025PHONY += checkstack kernelrelease kernelversion image_name
Jeff Dikee3ccf6e2006-09-27 01:50:37 -07002026
Jeff Dike011e3a92006-12-13 00:34:12 -08002027# UML needs a little special treatment here. It wants to use the host
2028# toolchain, so needs $(SUBARCH) passed to checkstack.pl. Everyone
2029# else wants $(ARCH), including people doing cross-builds, which means
2030# that $(SUBARCH) doesn't work here.
2031ifeq ($(ARCH), um)
2032CHECKSTACK_ARCH := $(SUBARCH)
2033else
2034CHECKSTACK_ARCH := $(ARCH)
2035endif
Heiko Carstens66242cf2023-11-20 19:37:19 +01002036MINSTACKSIZE ?= 100
Linus Torvalds1da177e2005-04-16 15:20:36 -07002037checkstack:
2038 $(OBJDUMP) -d vmlinux $$(find . -name '*.ko') | \
Heiko Carstens66242cf2023-11-20 19:37:19 +01002039 $(PERL) $(srctree)/scripts/checkstack.pl $(CHECKSTACK_ARCH) $(MINSTACKSIZE)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002040
Amerigo Wang7b8ea532010-08-20 05:36:06 -04002041kernelrelease:
Masahiro Yamada1cb86b62023-01-28 01:19:42 +09002042 @$(filechk_kernel.release)
Amerigo Wang01ab1782010-06-28 10:45:21 +08002043
Sam Ravnborgcb584552006-01-09 21:20:34 +01002044kernelversion:
Sam Ravnborg2244cbd2006-01-16 12:12:12 +01002045 @echo $(KERNELVERSION)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002046
Mike Marciniszync398ff02013-06-24 08:48:37 -04002047image_name:
2048 @echo $(KBUILD_IMAGE)
2049
Masahiro Yamada76a48b82023-07-22 13:47:55 +09002050PHONY += run-command
2051run-command:
2052 $(Q)$(KBUILD_RUN_COMMAND)
2053
Linus Torvalds1da177e2005-04-16 15:20:36 -07002054quiet_cmd_rmfiles = $(if $(wildcard $(rm-files)),CLEAN $(wildcard $(rm-files)))
Masahiro Yamada0663c682020-05-04 17:08:07 +09002055 cmd_rmfiles = rm -rf $(rm-files)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002056
Masahiro Yamada392885e2018-11-30 10:05:22 +09002057# read saved command lines for existing targets
2058existing-targets := $(wildcard $(sort $(targets)))
Linus Torvalds1da177e2005-04-16 15:20:36 -07002059
Masahiro Yamadab9999232019-02-22 16:40:08 +09002060-include $(foreach f,$(existing-targets),$(dir $(f)).$(notdir $(f)).cmd)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002061
SZ Lin (林上智)46b7c492020-03-01 00:09:58 +08002062endif # config-build
Masahiro Yamada2042b542019-08-11 00:53:03 +09002063endif # mixed-build
2064endif # need-sub-make
Linus Torvalds1da177e2005-04-16 15:20:36 -07002065
Paul Smith4f193362006-03-05 17:14:10 -05002066PHONY += FORCE
Linus Torvalds1da177e2005-04-16 15:20:36 -07002067FORCE:
Paul Smith4f193362006-03-05 17:14:10 -05002068
Ulf Magnussonbd412d82018-07-05 12:33:07 +09002069# Declare the contents of the PHONY variable as phony. We keep that
Kirill Smelkovfe8d0a42009-04-09 15:34:34 +04002070# information in a variable so we can use it in if_changed and friends.
Paul Smith4f193362006-03-05 17:14:10 -05002071.PHONY: $(PHONY)