Makefile 67.1 KB
Newer Older
1
# SPDX-License-Identifier: GPL-2.0
Linus Torvalds's avatar
Linus Torvalds committed
2
VERSION = 6
Linus Torvalds's avatar
Linus Torvalds committed
3
PATCHLEVEL = 12
Linus Torvalds's avatar
Linus Torvalds committed
4
SUBLEVEL = 0
Linus Torvalds's avatar
Linus Torvalds committed
5
EXTRAVERSION = -rc1
Linus Torvalds's avatar
Linus Torvalds committed
6
NAME = Baby Opossum Posse
Linus Torvalds's avatar
Linus Torvalds committed
7 8 9 10 11 12 13

# *DOCUMENTATION*
# To see a list of typical targets execute "make help"
# More info can be located in ./README
# Comments in this file are targeted only to the developer, do not
# expect to learn how to build the kernel reading this file.

14 15
ifeq ($(filter output-sync,$(.FEATURES)),)
$(error GNU Make >= 4.0 is required. Your Make version is $(MAKE_VERSION))
16 17
endif

18 19 20
$(if $(filter __%, $(MAKECMDGOALS)), \
	$(error targets prefixed with '__' are only for internal use))

21
# That's our default target when none is given on the command line
22 23
PHONY := __all
__all:
24

Linus Torvalds's avatar
Linus Torvalds committed
25 26 27 28 29 30
# We are using a recursive build, so we need to do a little thinking
# to get the ordering right.
#
# Most importantly: sub-Makefiles should only ever modify files in
# their own directory. If in some directory we have a dependency on
# a file in another dir (which doesn't happen often, but it's often
31
# unavoidable when linking the built-in.a targets which finally
Linus Torvalds's avatar
Linus Torvalds committed
32 33 34 35 36 37 38 39 40
# turn into vmlinux), we will call a sub make in that other dir, and
# after that we are sure that everything which is in that other dir
# is now up to date.
#
# The only cases where we need to modify files which have global
# effects are thus separated out and done before the recursive
# descending is started. They are now explicitly listed as the
# prepare rule.

41
this-makefile := $(lastword $(MAKEFILE_LIST))
42 43
abs_srctree := $(realpath $(dir $(this-makefile)))
abs_objtree := $(CURDIR)
44

45
ifneq ($(sub_make_done),1)
46 47 48 49 50 51 52 53 54 55 56 57 58 59

# Do not use make's built-in rules and variables
# (this increases performance and avoids hard-to-debug behaviour)
MAKEFLAGS += -rR

# Avoid funny character set dependencies
unexport LC_ALL
LC_COLLATE=C
LC_NUMERIC=C
export LC_COLLATE LC_NUMERIC

# Avoid interference with shell env settings
unexport GREP_OPTIONS

60 61 62
# Beautify output
# ---------------------------------------------------------------------------
#
63 64 65
# Most of build commands in Kbuild start with "cmd_". You can optionally define
# "quiet_cmd_*". If defined, the short log is printed. Otherwise, no log from
# that command is printed by default.
66
#
67 68 69
# e.g.)
#    quiet_cmd_depmod = DEPMOD  $(MODLIB)
#          cmd_depmod = $(srctree)/scripts/depmod.sh $(DEPMOD) $(KERNELRELEASE)
70 71 72 73
#
# A simple variant is to prefix commands with $(Q) - that's useful
# for commands that shall be hidden in non-verbose mode.
#
74
#    $(Q)$(MAKE) $(build)=scripts/basic
75
#
76 77
# If KBUILD_VERBOSE contains 1, the whole command is echoed.
# If KBUILD_VERBOSE contains 2, the reason for rebuilding is printed.
78
#
Linus Torvalds's avatar
Linus Torvalds committed
79 80 81
# To put more focus on warnings, be less verbose as default
# Use 'make V=1' to see the full commands

82 83
ifeq ("$(origin V)", "command line")
  KBUILD_VERBOSE = $(V)
Linus Torvalds's avatar
Linus Torvalds committed
84 85
endif

86 87 88 89
quiet = quiet_
Q = @

ifneq ($(findstring 1, $(KBUILD_VERBOSE)),)
90 91 92 93 94 95
  quiet =
  Q =
endif

# If the user is running make -s (silent mode), suppress echoing of
# commands
96
ifneq ($(findstring s,$(firstword -$(MAKEFLAGS))),)
97
quiet=silent_
Masahiro Yamada's avatar
Masahiro Yamada committed
98
override KBUILD_VERBOSE :=
99 100 101 102
endif

export quiet Q KBUILD_VERBOSE

103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121
# Call a source code checker (by default, "sparse") as part of the
# C compilation.
#
# Use 'make C=1' to enable checking of only re-compiled files.
# Use 'make C=2' to enable checking of *all* source files, regardless
# of whether they are re-compiled or not.
#
# See the file "Documentation/dev-tools/sparse.rst" for more details,
# including where to get the "sparse" utility.

ifeq ("$(origin C)", "command line")
  KBUILD_CHECKSRC = $(C)
endif
ifndef KBUILD_CHECKSRC
  KBUILD_CHECKSRC = 0
endif

export KBUILD_CHECKSRC

Miguel Ojeda's avatar
Miguel Ojeda committed
122 123 124 125 126 127 128 129 130
# Enable "clippy" (a linter) as part of the Rust compilation.
#
# Use 'make CLIPPY=1' to enable it.
ifeq ("$(origin CLIPPY)", "command line")
  KBUILD_CLIPPY := $(CLIPPY)
endif

export KBUILD_CLIPPY

131 132 133 134 135 136 137 138 139
# Use make M=dir or set the environment variable KBUILD_EXTMOD to specify the
# directory of external module to build. Setting M= takes precedence.
ifeq ("$(origin M)", "command line")
  KBUILD_EXTMOD := $(M)
endif

$(if $(word 2, $(KBUILD_EXTMOD)), \
	$(error building multiple external modules is not supported))

140 141 142
$(foreach x, % :, $(if $(findstring $x, $(KBUILD_EXTMOD)), \
	$(error module directory path cannot contain '$x')))

143 144 145 146 147
# Remove trailing slashes
ifneq ($(filter %/, $(KBUILD_EXTMOD)),)
KBUILD_EXTMOD := $(shell dirname $(KBUILD_EXTMOD).)
endif

148 149
export KBUILD_EXTMOD

150 151 152 153 154 155 156 157 158
# backward compatibility
KBUILD_EXTRA_WARN ?= $(KBUILD_ENABLE_EXTRA_GCC_CHECKS)

ifeq ("$(origin W)", "command line")
  KBUILD_EXTRA_WARN := $(W)
endif

export KBUILD_EXTRA_WARN

159 160 161 162 163 164 165 166 167 168
# Kbuild will save output files in the current working directory.
# This does not need to match to the root of the kernel source tree.
#
# For example, you can do this:
#
#  cd /dir/to/store/output/files; make -f /dir/to/kernel/source/Makefile
#
# If you want to save output files in a different location, there are
# two syntaxes to specify it.
#
Linus Torvalds's avatar
Linus Torvalds committed
169 170
# 1) O=
# Use "make O=dir/to/store/output/files/"
171
#
Linus Torvalds's avatar
Linus Torvalds committed
172
# 2) Set KBUILD_OUTPUT
173 174
# Set the environment variable KBUILD_OUTPUT to point to the output directory.
# export KBUILD_OUTPUT=dir/to/store/output/files/; make
Linus Torvalds's avatar
Linus Torvalds committed
175 176 177 178
#
# The O= assignment takes precedence over the KBUILD_OUTPUT environment
# variable.

179
# Do we want to change the working directory?
180 181
ifeq ("$(origin O)", "command line")
  KBUILD_OUTPUT := $(O)
Linus Torvalds's avatar
Linus Torvalds committed
182 183
endif

184
ifneq ($(KBUILD_OUTPUT),)
185 186
# $(realpath ...) gets empty if the path does not exist. Run 'mkdir -p' first.
$(shell mkdir -p "$(KBUILD_OUTPUT)")
187
# $(realpath ...) resolves symlinks
188 189
abs_objtree := $(realpath $(KBUILD_OUTPUT))
$(if $(abs_objtree),,$(error failed to create output directory "$(KBUILD_OUTPUT)"))
190 191 192 193 194
endif # ifneq ($(KBUILD_OUTPUT),)

ifneq ($(words $(subst :, ,$(abs_srctree))), 1)
$(error source directory cannot contain spaces or colons)
endif
Linus Torvalds's avatar
Linus Torvalds committed
195

196 197
export sub_make_done := 1

198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214
endif # sub_make_done

ifeq ($(abs_objtree),$(CURDIR))
# Suppress "Entering directory ..." if we are at the final work directory.
no-print-directory := --no-print-directory
else
# Recursion to show "Entering directory ..."
need-sub-make := 1
endif

ifeq ($(filter --no-print-directory, $(MAKEFLAGS)),)
# If --no-print-directory is unset, recurse once again to set it.
# You may end up recursing into __sub-make twice. This is needed due to the
# behavior change in GNU Make 4.4.1.
need-sub-make := 1
endif

215 216
ifeq ($(need-sub-make),1)

217
PHONY += $(MAKECMDGOALS) __sub-make
218

219
$(filter-out $(this-makefile), $(MAKECMDGOALS)) __all: __sub-make
220
	@:
221

222
# Invoke a second make in the output directory, passing relevant variables
223
__sub-make:
224 225
	$(Q)$(MAKE) $(no-print-directory) -C $(abs_objtree) \
	-f $(abs_srctree)/Makefile $(MAKECMDGOALS)
Linus Torvalds's avatar
Linus Torvalds committed
226

227
else # need-sub-make
228

Linus Torvalds's avatar
Linus Torvalds committed
229
# We process the rest of the Makefile if this is the final invocation of make
230

231
ifeq ($(abs_srctree),$(abs_objtree))
232 233
        # building in the source tree
        srctree := .
234
	building_out_of_srctree :=
235
else
236
        ifeq ($(abs_srctree)/,$(dir $(abs_objtree)))
237 238 239
                # building in a subdirectory of the source tree
                srctree := ..
        else
240
                srctree := $(abs_srctree)
241
        endif
242
	building_out_of_srctree := 1
243
endif
244

245 246 247
ifneq ($(KBUILD_ABS_SRCTREE),)
srctree := $(abs_srctree)
endif
248

249
objtree		:= .
250 251 252 253 254

VPATH		:=

ifeq ($(KBUILD_EXTMOD),)
ifdef building_out_of_srctree
255
VPATH		:= $(srctree)
256 257
endif
endif
Linus Torvalds's avatar
Linus Torvalds committed
258

259
export building_out_of_srctree srctree objtree VPATH
Linus Torvalds's avatar
Linus Torvalds committed
260

261 262 263 264 265 266 267 268 269 270
# To make sure we do not include .config for any of the *config targets
# catch them early, and hand them over to scripts/kconfig/Makefile
# It is allowed to specify more targets when calling make, including
# mixing *config targets and build targets.
# For example 'make oldconfig all'.
# Detect when mixed targets is specified, and make a second invocation
# of make so .config is not included in this case either (for *config).

version_h := include/generated/uapi/linux/version.h

271 272
clean-targets := %clean mrproper cleandocs
no-dot-config-targets := $(clean-targets) \
273
			 cscope gtags TAGS tags help% %docs check% coccicheck \
274
			 $(version_h) headers headers_% archheaders archscripts \
275
			 %asm-generic kernelversion %src-pkg dt_binding_check \
276
			 outputmakefile rustavailable rustfmt rustfmtcheck
277
no-sync-config-targets := $(no-dot-config-targets) %install modules_sign kernelrelease \
278
			  image_name
279
single-targets := %.a %.i %.ko %.lds %.ll %.lst %.mod %.o %.rsi %.s %.symtypes %/
280

281 282 283 284
config-build	:=
mixed-build	:=
need-config	:= 1
may-sync-config	:= 1
285
single-build	:=
286 287

ifneq ($(filter $(no-dot-config-targets), $(MAKECMDGOALS)),)
288
    ifeq ($(filter-out $(no-dot-config-targets), $(MAKECMDGOALS)),)
289
        need-config :=
290
    endif
291 292
endif

293
ifneq ($(filter $(no-sync-config-targets), $(MAKECMDGOALS)),)
294
    ifeq ($(filter-out $(no-sync-config-targets), $(MAKECMDGOALS)),)
295
        may-sync-config :=
296
    endif
297 298
endif

299 300
need-compiler := $(may-sync-config)

301
ifneq ($(KBUILD_EXTMOD),)
302
    may-sync-config :=
303 304
endif

305
ifeq ($(KBUILD_EXTMOD),)
306 307 308 309
    ifneq ($(filter %config,$(MAKECMDGOALS)),)
        config-build := 1
        ifneq ($(words $(MAKECMDGOALS)),1)
            mixed-build := 1
310
        endif
311
    endif
312
endif
313

314 315
# We cannot build single targets and the others at the same time
ifneq ($(filter $(single-targets), $(MAKECMDGOALS)),)
316
    single-build := 1
317
    ifneq ($(filter-out $(single-targets), $(MAKECMDGOALS)),)
318
        mixed-build := 1
319
    endif
320 321
endif

322 323
# For "make -j clean all", "make -j mrproper defconfig all", etc.
ifneq ($(filter $(clean-targets),$(MAKECMDGOALS)),)
324 325 326
    ifneq ($(filter-out $(clean-targets),$(MAKECMDGOALS)),)
        mixed-build := 1
    endif
327 328
endif

329 330
# install and modules_install need also be processed one by one
ifneq ($(filter install,$(MAKECMDGOALS)),)
331 332 333
    ifneq ($(filter modules_install,$(MAKECMDGOALS)),)
        mixed-build := 1
    endif
334 335
endif

336
ifdef mixed-build
337 338 339 340 341 342
# ===========================================================================
# We're called with mixed targets (*config and build targets).
# Handle them one by one.

PHONY += $(MAKECMDGOALS) __build_one_by_one

343
$(MAKECMDGOALS): __build_one_by_one
344 345 346 347 348 349 350 351
	@:

__build_one_by_one:
	$(Q)set -e; \
	for i in $(MAKECMDGOALS); do \
		$(MAKE) -f $(srctree)/Makefile $$i; \
	done

352
else # !mixed-build
353

354
include $(srctree)/scripts/Kbuild.include
355 356

# Read KERNELRELEASE from include/config/kernel.release (if it exists)
357
KERNELRELEASE = $(call read-file, include/config/kernel.release)
358 359 360
KERNELVERSION = $(VERSION)$(if $(PATCHLEVEL),.$(PATCHLEVEL)$(if $(SUBLEVEL),.$(SUBLEVEL)))$(EXTRAVERSION)
export VERSION PATCHLEVEL SUBLEVEL KERNELRELEASE KERNELVERSION

361
include $(srctree)/scripts/subarch.include
Linus Torvalds's avatar
Linus Torvalds committed
362 363 364 365 366 367 368

# Cross compiling and selecting different set of gcc/bin-utils
# ---------------------------------------------------------------------------
#
# When performing cross compilation for other architectures ARCH shall be set
# to the target architecture. (See arch/* for the possibilities).
# ARCH can be set during invocation of make:
369
# make ARCH=arm64
Linus Torvalds's avatar
Linus Torvalds committed
370 371 372 373 374 375 376
# Another way is to have ARCH set in the environment.
# The default ARCH is the host where make is executed.

# CROSS_COMPILE specify the prefix used for all executables used
# during compilation. Only gcc and related bin-utils executables
# are prefixed with $(CROSS_COMPILE).
# CROSS_COMPILE can be set on the command line
377
# make CROSS_COMPILE=aarch64-linux-gnu-
Linus Torvalds's avatar
Linus Torvalds committed
378 379 380
# Alternatively CROSS_COMPILE can be set in the environment.
# Default value for CROSS_COMPILE is not to prefix executables
# Note: Some architectures assign CROSS_COMPILE in their arch/*/Makefile
381
ARCH		?= $(SUBARCH)
Linus Torvalds's avatar
Linus Torvalds committed
382 383

# Architecture as present in compile.h
384 385
UTS_MACHINE 	:= $(ARCH)
SRCARCH 	:= $(ARCH)
Linus Torvalds's avatar
Linus Torvalds committed
386

387 388 389 390 391 392 393
# Additional ARCH settings for x86
ifeq ($(ARCH),i386)
        SRCARCH := x86
endif
ifeq ($(ARCH),x86_64)
        SRCARCH := x86
endif
394

Sam Ravnborg's avatar
Sam Ravnborg committed
395
# Additional ARCH settings for sparc
396 397 398
ifeq ($(ARCH),sparc32)
       SRCARCH := sparc
endif
399
ifeq ($(ARCH),sparc64)
Sam Ravnborg's avatar
Sam Ravnborg committed
400
       SRCARCH := sparc
401
endif
402

403 404 405 406 407
# Additional ARCH settings for parisc
ifeq ($(ARCH),parisc64)
       SRCARCH := parisc
endif

408 409 410 411 412
export cross_compiling :=
ifneq ($(SRCARCH),$(SUBARCH))
cross_compiling := 1
endif

413
KCONFIG_CONFIG	?= .config
414
export KCONFIG_CONFIG
415

Linus Torvalds's avatar
Linus Torvalds committed
416
# SHELL used by kbuild
417
CONFIG_SHELL := sh
Linus Torvalds's avatar
Linus Torvalds committed
418

419 420 421
HOST_LFS_CFLAGS := $(shell getconf LFS_CFLAGS 2>/dev/null)
HOST_LFS_LDFLAGS := $(shell getconf LFS_LDFLAGS 2>/dev/null)
HOST_LFS_LIBS := $(shell getconf LFS_LIBS 2>/dev/null)
422

423
ifneq ($(LLVM),)
424 425 426 427 428 429 430 431
ifneq ($(filter %/,$(LLVM)),)
LLVM_PREFIX := $(LLVM)
else ifneq ($(filter -%,$(LLVM)),)
LLVM_SUFFIX := $(LLVM)
endif

HOSTCC	= $(LLVM_PREFIX)clang$(LLVM_SUFFIX)
HOSTCXX	= $(LLVM_PREFIX)clang++$(LLVM_SUFFIX)
432 433 434 435
else
HOSTCC	= gcc
HOSTCXX	= g++
endif
Miguel Ojeda's avatar
Miguel Ojeda committed
436
HOSTRUSTC = rustc
437
HOSTPKG_CONFIG	= pkg-config
438

439
KBUILD_USERHOSTCFLAGS := -Wall -Wmissing-prototypes -Wstrict-prototypes \
440
			 -O2 -fomit-frame-pointer -std=gnu11
441 442
KBUILD_USERCFLAGS  := $(KBUILD_USERHOSTCFLAGS) $(USERCFLAGS)
KBUILD_USERLDFLAGS := $(USERLDFLAGS)
443

Miguel Ojeda's avatar
Miguel Ojeda committed
444 445 446 447
# These flags apply to all Rust code in the tree, including the kernel and
# host programs.
export rust_common_flags := --edition=2021 \
			    -Zbinary_dep_depinfo=y \
448
			    -Astable_features \
449 450 451 452
			    -Dunsafe_op_in_unsafe_fn \
			    -Dnon_ascii_idents \
			    -Wrust_2018_idioms \
			    -Wunreachable_pub \
Miguel Ojeda's avatar
Miguel Ojeda committed
453
			    -Wmissing_docs \
454
			    -Wrustdoc::missing_crate_level_docs \
455 456
			    -Wclippy::all \
			    -Wclippy::mut_mut \
457 458 459
			    -Wclippy::needless_bitwise_bool \
			    -Wclippy::needless_continue \
			    -Wclippy::no_mangle_with_rust_abi \
Miguel Ojeda's avatar
Miguel Ojeda committed
460 461
			    -Wclippy::dbg_macro

462 463 464 465
KBUILD_HOSTCFLAGS   := $(KBUILD_USERHOSTCFLAGS) $(HOST_LFS_CFLAGS) \
		       $(HOSTCFLAGS) -I $(srctree)/scripts/include
KBUILD_HOSTCXXFLAGS := -Wall -O2 $(HOST_LFS_CFLAGS) $(HOSTCXXFLAGS) \
		       -I $(srctree)/scripts/include
Miguel Ojeda's avatar
Miguel Ojeda committed
466 467
KBUILD_HOSTRUSTFLAGS := $(rust_common_flags) -O -Cstrip=debuginfo \
			-Zallow-features= $(HOSTRUSTFLAGS)
468 469
KBUILD_HOSTLDFLAGS  := $(HOST_LFS_LDFLAGS) $(HOSTLDFLAGS)
KBUILD_HOSTLDLIBS   := $(HOST_LFS_LIBS) $(HOSTLDLIBS)
Linus Torvalds's avatar
Linus Torvalds committed
470 471 472

# Make variables (CC, etc...)
CPP		= $(CC) -E
473
ifneq ($(LLVM),)
474 475 476 477 478 479 480 481
CC		= $(LLVM_PREFIX)clang$(LLVM_SUFFIX)
LD		= $(LLVM_PREFIX)ld.lld$(LLVM_SUFFIX)
AR		= $(LLVM_PREFIX)llvm-ar$(LLVM_SUFFIX)
NM		= $(LLVM_PREFIX)llvm-nm$(LLVM_SUFFIX)
OBJCOPY		= $(LLVM_PREFIX)llvm-objcopy$(LLVM_SUFFIX)
OBJDUMP		= $(LLVM_PREFIX)llvm-objdump$(LLVM_SUFFIX)
READELF		= $(LLVM_PREFIX)llvm-readelf$(LLVM_SUFFIX)
STRIP		= $(LLVM_PREFIX)llvm-strip$(LLVM_SUFFIX)
482 483 484
else
CC		= $(CROSS_COMPILE)gcc
LD		= $(CROSS_COMPILE)ld
Linus Torvalds's avatar
Linus Torvalds committed
485 486 487 488
AR		= $(CROSS_COMPILE)ar
NM		= $(CROSS_COMPILE)nm
OBJCOPY		= $(CROSS_COMPILE)objcopy
OBJDUMP		= $(CROSS_COMPILE)objdump
489
READELF		= $(CROSS_COMPILE)readelf
490 491
STRIP		= $(CROSS_COMPILE)strip
endif
Miguel Ojeda's avatar
Miguel Ojeda committed
492 493 494 495 496
RUSTC		= rustc
RUSTDOC		= rustdoc
RUSTFMT		= rustfmt
CLIPPY_DRIVER	= clippy-driver
BINDGEN		= bindgen
497
PAHOLE		= pahole
498
RESOLVE_BTFIDS	= $(objtree)/tools/bpf/resolve_btfids/resolve_btfids
499 500
LEX		= flex
YACC		= bison
Linus Torvalds's avatar
Linus Torvalds committed
501
AWK		= awk
502
INSTALLKERNEL  := installkernel
Linus Torvalds's avatar
Linus Torvalds committed
503
PERL		= perl
504
PYTHON3		= python3
Linus Torvalds's avatar
Linus Torvalds committed
505
CHECK		= sparse
506
BASH		= bash
507 508 509
KGZIP		= gzip
KBZIP2		= bzip2
KLZOP		= lzop
510 511 512
LZMA		= lzma
LZ4		= lz4c
XZ		= xz
513
ZSTD		= zstd
514

515
CHECKFLAGS     := -D__linux__ -Dlinux -D__STDC__ -Dunix -D__unix__ \
516
		  -Wbitwise -Wno-return-void -Wno-unknown-attribute $(CF)
517
NOSTDINC_FLAGS :=
518
CFLAGS_MODULE   =
Miguel Ojeda's avatar
Miguel Ojeda committed
519
RUSTFLAGS_MODULE =
520 521
AFLAGS_MODULE   =
LDFLAGS_MODULE  =
Linus Torvalds's avatar
Linus Torvalds committed
522
CFLAGS_KERNEL	=
Miguel Ojeda's avatar
Miguel Ojeda committed
523
RUSTFLAGS_KERNEL =
Linus Torvalds's avatar
Linus Torvalds committed
524
AFLAGS_KERNEL	=
525
LDFLAGS_vmlinux =
Linus Torvalds's avatar
Linus Torvalds committed
526

527 528
# Use USERINCLUDE when you must reference the UAPI directories only.
USERINCLUDE    := \
529 530
		-I$(srctree)/arch/$(SRCARCH)/include/uapi \
		-I$(objtree)/arch/$(SRCARCH)/include/generated/uapi \
531
		-I$(srctree)/include/uapi \
532
		-I$(objtree)/include/generated/uapi \
533
                -include $(srctree)/include/linux/compiler-version.h \
534 535
                -include $(srctree)/include/linux/kconfig.h

Linus Torvalds's avatar
Linus Torvalds committed
536 537
# Use LINUXINCLUDE when you must reference the include/ directory.
# Needed to be compatible with the O= option
538
LINUXINCLUDE    := \
539 540
		-I$(srctree)/arch/$(SRCARCH)/include \
		-I$(objtree)/arch/$(SRCARCH)/include/generated \
541
		$(if $(building_out_of_srctree),-I$(srctree)/include) \
542 543
		-I$(objtree)/include \
		$(USERINCLUDE)
Linus Torvalds's avatar
Linus Torvalds committed
544

545
KBUILD_AFLAGS   := -D__ASSEMBLY__ -fno-PIE
546 547 548 549 550 551 552 553 554

KBUILD_CFLAGS :=
KBUILD_CFLAGS += -std=gnu11
KBUILD_CFLAGS += -fshort-wchar
KBUILD_CFLAGS += -funsigned-char
KBUILD_CFLAGS += -fno-common
KBUILD_CFLAGS += -fno-PIE
KBUILD_CFLAGS += -fno-strict-aliasing

555
KBUILD_CPPFLAGS := -D__KERNEL__
Miguel Ojeda's avatar
Miguel Ojeda committed
556 557 558 559 560 561
KBUILD_RUSTFLAGS := $(rust_common_flags) \
		    -Cpanic=abort -Cembed-bitcode=n -Clto=n \
		    -Cforce-unwind-tables=n -Ccodegen-units=1 \
		    -Csymbol-mangling-version=v0 \
		    -Crelocation-model=static \
		    -Zfunction-sections=n \
562
		    -Wclippy::float_arithmetic
Miguel Ojeda's avatar
Miguel Ojeda committed
563

564 565
KBUILD_AFLAGS_KERNEL :=
KBUILD_CFLAGS_KERNEL :=
Miguel Ojeda's avatar
Miguel Ojeda committed
566
KBUILD_RUSTFLAGS_KERNEL :=
567 568
KBUILD_AFLAGS_MODULE  := -DMODULE
KBUILD_CFLAGS_MODULE  := -DMODULE
Miguel Ojeda's avatar
Miguel Ojeda committed
569
KBUILD_RUSTFLAGS_MODULE := --cfg MODULE
570
KBUILD_LDFLAGS_MODULE :=
571
KBUILD_LDFLAGS :=
572
CLANG_FLAGS :=
Linus Torvalds's avatar
Linus Torvalds committed
573

Miguel Ojeda's avatar
Miguel Ojeda committed
574 575 576 577 578 579 580 581 582 583 584
ifeq ($(KBUILD_CLIPPY),1)
	RUSTC_OR_CLIPPY_QUIET := CLIPPY
	RUSTC_OR_CLIPPY = $(CLIPPY_DRIVER)
else
	RUSTC_OR_CLIPPY_QUIET := RUSTC
	RUSTC_OR_CLIPPY = $(RUSTC)
endif

# Allows the usage of unstable features in stable compilers.
export RUSTC_BOOTSTRAP := 1

585
export ARCH SRCARCH CONFIG_SHELL BASH HOSTCC KBUILD_HOSTCFLAGS CROSS_COMPILE LD CC HOSTPKG_CONFIG
586
export RUSTC RUSTDOC RUSTFMT RUSTC_OR_CLIPPY_QUIET RUSTC_OR_CLIPPY BINDGEN
Miguel Ojeda's avatar
Miguel Ojeda committed
587
export HOSTRUSTC KBUILD_HOSTRUSTFLAGS
588
export CPP AR NM STRIP OBJCOPY OBJDUMP READELF PAHOLE RESOLVE_BTFIDS LEX YACC AWK INSTALLKERNEL
589
export PERL PYTHON3 CHECK CHECKFLAGS MAKE UTS_MACHINE HOSTCXX
590
export KGZIP KBZIP2 KLZOP LZMA LZ4 XZ ZSTD
591
export KBUILD_HOSTCXXFLAGS KBUILD_HOSTLDFLAGS KBUILD_HOSTLDLIBS LDFLAGS_MODULE
592
export KBUILD_USERCFLAGS KBUILD_USERLDFLAGS
Linus Torvalds's avatar
Linus Torvalds committed
593

594
export KBUILD_CPPFLAGS NOSTDINC_FLAGS LINUXINCLUDE OBJCOPYFLAGS KBUILD_LDFLAGS
595
export KBUILD_CFLAGS CFLAGS_KERNEL CFLAGS_MODULE
Miguel Ojeda's avatar
Miguel Ojeda committed
596
export KBUILD_RUSTFLAGS RUSTFLAGS_KERNEL RUSTFLAGS_MODULE
597
export KBUILD_AFLAGS AFLAGS_KERNEL AFLAGS_MODULE
Miguel Ojeda's avatar
Miguel Ojeda committed
598 599
export KBUILD_AFLAGS_MODULE KBUILD_CFLAGS_MODULE KBUILD_RUSTFLAGS_MODULE KBUILD_LDFLAGS_MODULE
export KBUILD_AFLAGS_KERNEL KBUILD_CFLAGS_KERNEL KBUILD_RUSTFLAGS_KERNEL
Linus Torvalds's avatar
Linus Torvalds committed
600 601 602

# Files to ignore in find ... statements

603 604 605
export RCS_FIND_IGNORE := \( -name SCCS -o -name BitKeeper -o -name .svn -o    \
			  -name CVS -o -name .pc -o -name .hg -o -name .git \) \
			  -prune -o
Linus Torvalds's avatar
Linus Torvalds committed
606 607 608 609

# ===========================================================================
# Rules shared between *config targets and build targets

610
# Basic helpers built in scripts/basic/
611
PHONY += scripts_basic
Linus Torvalds's avatar
Linus Torvalds committed
612 613 614
scripts_basic:
	$(Q)$(MAKE) $(build)=scripts/basic

615
PHONY += outputmakefile
616
ifdef building_out_of_srctree
617
# Before starting out-of-tree build, make sure the source tree is clean.
618 619 620
# outputmakefile generates a Makefile in the output directory, if using a
# separate output directory. This allows convenient use of make in the
# output directory.
621 622
# At the same time when output Makefile generated, generate .gitignore to
# ignore whole output directory
623 624 625 626 627 628 629

quiet_cmd_makefile = GEN     Makefile
      cmd_makefile = { \
	echo "\# Automatically generated by $(srctree)/Makefile: don't edit"; \
	echo "include $(srctree)/Makefile"; \
	} > Makefile

Linus Torvalds's avatar
Linus Torvalds committed
630
outputmakefile:
631
	@if [ -f $(srctree)/.config -o \
632 633 634 635 636 637 638 639
		 -d $(srctree)/include/config -o \
		 -d $(srctree)/arch/$(SRCARCH)/include/generated ]; then \
		echo >&2 "***"; \
		echo >&2 "*** The source tree is not clean, please run 'make$(if $(findstring command line, $(origin ARCH)), ARCH=$(ARCH)) mrproper'"; \
		echo >&2 "*** in $(abs_srctree)";\
		echo >&2 "***"; \
		false; \
	fi
640
	$(Q)ln -fsn $(srctree) source
641
	$(call cmd,makefile)
642 643
	$(Q)test -e .gitignore || \
	{ echo "# this is build directory, ignore it"; echo "*"; } > .gitignore
644
endif
Linus Torvalds's avatar
Linus Torvalds committed
645

646 647
# The expansion should be delayed until arch/$(SRCARCH)/Makefile is included.
# Some architectures define CROSS_COMPILE in arch/$(SRCARCH)/Makefile.
648 649 650
# CC_VERSION_TEXT and RUSTC_VERSION_TEXT are referenced from Kconfig (so they
# need export), and from include/config/auto.conf.cmd to detect the compiler
# upgrade.
651
CC_VERSION_TEXT = $(subst $(pound),,$(shell LC_ALL=C $(CC) --version 2>/dev/null | head -n 1))
652
RUSTC_VERSION_TEXT = $(subst $(pound),,$(shell $(RUSTC) --version 2>/dev/null))
653 654

ifneq ($(findstring clang,$(CC_VERSION_TEXT)),)
655
include $(srctree)/scripts/Makefile.clang
656 657
endif

658 659
# Include this also for config targets because some architectures need
# cc-cross-prefix to determine CROSS_COMPILE.
660
ifdef need-compiler
661
include $(srctree)/scripts/Makefile.compiler
662
endif
663

664
ifdef config-build
Linus Torvalds's avatar
Linus Torvalds committed
665 666 667 668
# ===========================================================================
# *config targets only - make sure prerequisites are updated, and descend
# in scripts/kconfig to make the *config target

669
# Read arch-specific Makefile to set KBUILD_DEFCONFIG as needed.
Linus Torvalds's avatar
Linus Torvalds committed
670 671
# KBUILD_DEFCONFIG may point out an alternative default configuration
# used for 'make defconfig'
672
include $(srctree)/arch/$(SRCARCH)/Makefile
673
export KBUILD_DEFCONFIG KBUILD_KCONFIG CC_VERSION_TEXT RUSTC_VERSION_TEXT
Linus Torvalds's avatar
Linus Torvalds committed
674

675
config: outputmakefile scripts_basic FORCE
676 677
	$(Q)$(MAKE) $(build)=scripts/kconfig $@

678
%config: outputmakefile scripts_basic FORCE
Linus Torvalds's avatar
Linus Torvalds committed
679 680
	$(Q)$(MAKE) $(build)=scripts/kconfig $@

681
else #!config-build
Linus Torvalds's avatar
Linus Torvalds committed
682
# ===========================================================================
683
# Build targets only - this includes vmlinux, arch-specific targets, clean
Linus Torvalds's avatar
Linus Torvalds committed
684 685
# targets and others. In general all targets except *config targets.

686
# If building an external module we do not care about the all: rule
687
# but instead __all depend on modules
688 689
PHONY += all
ifeq ($(KBUILD_EXTMOD),)
690
__all: all
691
else
692
__all: modules
693 694
endif

695 696
targets :=

697 698 699 700 701 702 703 704
# Decide whether to build built-in, modular, or both.
# Normally, just do built-in.

KBUILD_MODULES :=
KBUILD_BUILTIN := 1

# If we have only "make modules", don't compile built-in objects.
ifeq ($(MAKECMDGOALS),modules)
705
  KBUILD_BUILTIN :=
706 707 708 709 710 711
endif

# If we have "make <whatever> modules", compile modules
# in addition to whatever we do anyway.
# Just "make" or "make all" shall build modules as well

712
ifneq ($(filter all modules nsdeps %compile_commands.json clang-%,$(MAKECMDGOALS)),)
713 714 715 716 717 718 719 720 721
  KBUILD_MODULES := 1
endif

ifeq ($(MAKECMDGOALS),)
  KBUILD_MODULES := 1
endif

export KBUILD_MODULES KBUILD_BUILTIN

722
ifdef need-config
723 724 725
include include/config/auto.conf
endif

Linus Torvalds's avatar
Linus Torvalds committed
726 727
ifeq ($(KBUILD_EXTMOD),)
# Objects we will link into vmlinux / subdirs we need to visit
728 729
core-y		:=
drivers-y	:=
Linus Torvalds's avatar
Linus Torvalds committed
730 731 732
libs-y		:= lib/
endif # KBUILD_EXTMOD

733 734 735 736 737 738
# The all: target is the default when no target is given on the
# command line.
# This allow a user to issue only 'make' to build a kernel including modules
# Defaults to vmlinux, but the arch makefile usually adds further targets
all: vmlinux

739 740 741 742
CFLAGS_GCOV	:= -fprofile-arcs -ftest-coverage
ifdef CONFIG_CC_IS_GCC
CFLAGS_GCOV	+= -fno-tree-loop-im
endif
743
export CFLAGS_GCOV
744

745 746 747 748 749
# The arch Makefiles can override CC_FLAGS_FTRACE. We may also append it later.
ifdef CONFIG_FUNCTION_TRACER
  CC_FLAGS_FTRACE := -pg
endif

750
include $(srctree)/arch/$(SRCARCH)/Makefile
Linus Torvalds's avatar
Linus Torvalds committed
751

752 753
ifdef need-config
ifdef may-sync-config
754 755 756
# Read in dependencies to all Kconfig* files, make sure to run syncconfig if
# changes are detected. This should be included after arch/$(SRCARCH)/Makefile
# because some architectures define CROSS_COMPILE there.
757
include include/config/auto.conf.cmd
Linus Torvalds's avatar
Linus Torvalds committed
758

759 760 761 762 763 764 765 766
$(KCONFIG_CONFIG):
	@echo >&2 '***'
	@echo >&2 '*** Configuration file "$@" not found!'
	@echo >&2 '***'
	@echo >&2 '*** Please run some configurator (e.g. "make oldconfig" or'
	@echo >&2 '*** "make menuconfig" or "make xconfig").'
	@echo >&2 '***'
	@/bin/false
Linus Torvalds's avatar
Linus Torvalds committed
767

768 769 770
# The actual configuration files used during the build are stored in
# include/generated/ and include/config/. Update them if .config is newer than
# include/config/auto.conf (which mirrors .config).
771 772 773
#
# This exploits the 'multi-target pattern rule' trick.
# The syncconfig should be executed only once to make all the targets.
774
# (Note: use the grouped target '&:' when we bump to GNU Make 4.3)
775 776 777
#
# Do not use $(call cmd,...) here. That would suppress prompts from syncconfig,
# so you cannot notice that Kconfig is waiting for the user input.
Miguel Ojeda's avatar
Miguel Ojeda committed
778
%/config/auto.conf %/config/auto.conf.cmd %/generated/autoconf.h %/generated/rustc_cfg: $(KCONFIG_CONFIG)
779 780
	$(Q)$(kecho) "  SYNC    $@"
	$(Q)$(MAKE) -f $(srctree)/Makefile syncconfig
781
else # !may-sync-config
782 783 784
# External modules and some install targets need include/generated/autoconf.h
# and include/config/auto.conf but do not care if they are up-to-date.
# Use auto.conf to trigger the test
785 786 787
PHONY += include/config/auto.conf

include/config/auto.conf:
788
	@test -e include/generated/autoconf.h -a -e $@ || (		\
789 790 791 792 793
	echo >&2;							\
	echo >&2 "  ERROR: Kernel configuration is invalid.";		\
	echo >&2 "         include/generated/autoconf.h or $@ are missing.";\
	echo >&2 "         Run 'make oldconfig && make prepare' on kernel src to fix it.";	\
	echo >&2 ;							\
794 795
	/bin/false)

796
endif # may-sync-config
797
endif # need-config
Linus Torvalds's avatar
Linus Torvalds committed
798

799
KBUILD_CFLAGS	+= -fno-delete-null-pointer-checks
800

801 802
ifdef CONFIG_CC_OPTIMIZE_FOR_PERFORMANCE
KBUILD_CFLAGS += -O2
Miguel Ojeda's avatar
Miguel Ojeda committed
803
KBUILD_RUSTFLAGS += -Copt-level=2
804 805
else ifdef CONFIG_CC_OPTIMIZE_FOR_SIZE
KBUILD_CFLAGS += -Os
Miguel Ojeda's avatar
Miguel Ojeda committed
806
KBUILD_RUSTFLAGS += -Copt-level=s
807
endif
Linus Torvalds's avatar
Linus Torvalds committed
808

Miguel Ojeda's avatar
Miguel Ojeda committed
809 810 811 812 813
# Always set `debug-assertions` and `overflow-checks` because their default
# depends on `opt-level` and `debug-assertions`, respectively.
KBUILD_RUSTFLAGS += -Cdebug-assertions=$(if $(CONFIG_RUST_DEBUG_ASSERTIONS),y,n)
KBUILD_RUSTFLAGS += -Coverflow-checks=$(if $(CONFIG_RUST_OVERFLOW_CHECKS),y,n)

814
# Tell gcc to never replace conditional load with a non-conditional one
815 816 817
ifdef CONFIG_CC_IS_GCC
# gcc-10 renamed --param=allow-store-data-races=0 to
# -fno-allow-store-data-races.
818
KBUILD_CFLAGS	+= $(call cc-option,--param=allow-store-data-races=0)
819
KBUILD_CFLAGS	+= $(call cc-option,-fno-allow-store-data-races)
820
endif
821

Andi Kleen's avatar
Andi Kleen committed
822 823 824 825 826
ifdef CONFIG_READABLE_ASM
# Disable optimizations that make assembler listings hard to read.
# reorder blocks reorders the control in the function
# ipa clone creates specialized cloned functions
# partial inlining inlines only parts of functions
827
KBUILD_CFLAGS += -fno-reorder-blocks -fno-ipa-cp-clone -fno-partial-inlining
Andi Kleen's avatar
Andi Kleen committed
828 829
endif

830
stackp-flags-y                                    := -fno-stack-protector
831 832
stackp-flags-$(CONFIG_STACKPROTECTOR)             := -fstack-protector
stackp-flags-$(CONFIG_STACKPROTECTOR_STRONG)      := -fstack-protector-strong
833 834

KBUILD_CFLAGS += $(stackp-flags-y)
835

Miguel Ojeda's avatar
Miguel Ojeda committed
836 837 838
KBUILD_RUSTFLAGS-$(CONFIG_WERROR) += -Dwarnings
KBUILD_RUSTFLAGS += $(KBUILD_RUSTFLAGS-y)

Linus Torvalds's avatar
Linus Torvalds committed
839
ifdef CONFIG_FRAME_POINTER
840
KBUILD_CFLAGS	+= -fno-omit-frame-pointer -fno-optimize-sibling-calls
Miguel Ojeda's avatar
Miguel Ojeda committed
841
KBUILD_RUSTFLAGS += -Cforce-frame-pointers=y
Linus Torvalds's avatar
Linus Torvalds committed
842
else
843 844 845 846 847
# Some targets (ARM with Thumb2, for example), can't be built with frame
# pointers.  For those, we don't have FUNCTION_TRACER automatically
# select FRAME_POINTER.  However, FUNCTION_TRACER adds -pg, and this is
# incompatible with -fomit-frame-pointer with current GCC, so we don't use
# -fomit-frame-pointer with FUNCTION_TRACER.
Miguel Ojeda's avatar
Miguel Ojeda committed
848 849
# In the Rust target specification, "frame-pointer" is set explicitly
# to "may-omit".
850
ifndef CONFIG_FUNCTION_TRACER
851
KBUILD_CFLAGS	+= -fomit-frame-pointer
Linus Torvalds's avatar
Linus Torvalds committed
852
endif
853
endif
Linus Torvalds's avatar
Linus Torvalds committed
854

855 856
# Initialize all stack variables with a 0xAA pattern.
ifdef CONFIG_INIT_STACK_ALL_PATTERN
857 858 859
KBUILD_CFLAGS	+= -ftrivial-auto-var-init=pattern
endif

860 861 862
# Initialize all stack variables with a zero value.
ifdef CONFIG_INIT_STACK_ALL_ZERO
KBUILD_CFLAGS	+= -ftrivial-auto-var-init=zero
863 864
ifdef CONFIG_CC_HAS_AUTO_VAR_INIT_ZERO_ENABLER
# https://github.com/llvm/llvm-project/issues/44842
865 866 867
CC_AUTO_VAR_INIT_ZERO_ENABLER := -enable-trivial-auto-var-init-zero-knowing-it-will-be-removed-from-clang
export CC_AUTO_VAR_INIT_ZERO_ENABLER
KBUILD_CFLAGS	+= $(CC_AUTO_VAR_INIT_ZERO_ENABLER)
868
endif
869
endif
870

871 872 873 874
# While VLAs have been removed, GCC produces unreachable stack probes
# for the randomize_kstack_offset feature. Disable it for all compilers.
KBUILD_CFLAGS	+= $(call cc-option, -fno-stack-clash-protection)

875 876 877 878 879
# Clear used registers at func exit (to reduce data lifetime and ROP gadgets).
ifdef CONFIG_ZERO_CALL_USED_REGS
KBUILD_CFLAGS	+= -fzero-call-used-regs=used-gpr
endif

880
ifdef CONFIG_FUNCTION_TRACER
881 882
ifdef CONFIG_FTRACE_MCOUNT_USE_CC
  CC_FLAGS_FTRACE	+= -mrecord-mcount
883 884 885 886 887 888
  ifdef CONFIG_HAVE_NOP_MCOUNT
    ifeq ($(call cc-option-yn, -mnop-mcount),y)
      CC_FLAGS_FTRACE	+= -mnop-mcount
      CC_FLAGS_USING	+= -DCC_USING_NOP_MCOUNT
    endif
  endif
889
endif
890
ifdef CONFIG_FTRACE_MCOUNT_USE_OBJTOOL
891 892 893
  ifdef CONFIG_HAVE_OBJTOOL_NOP_MCOUNT
    CC_FLAGS_USING	+= -DCC_USING_NOP_MCOUNT
  endif
894
endif
895 896 897 898 899 900
ifdef CONFIG_FTRACE_MCOUNT_USE_RECORDMCOUNT
  ifdef CONFIG_HAVE_C_RECORDMCOUNT
    BUILD_C_RECORDMCOUNT := y
    export BUILD_C_RECORDMCOUNT
  endif
endif
901
ifdef CONFIG_HAVE_FENTRY
902
  # s390-linux-gnu-gcc did not support -mfentry until gcc-9.
903 904 905 906
  ifeq ($(call cc-option-yn, -mfentry),y)
    CC_FLAGS_FTRACE	+= -mfentry
    CC_FLAGS_USING	+= -DCC_USING_FENTRY
  endif
907
endif
908 909 910
export CC_FLAGS_FTRACE
KBUILD_CFLAGS	+= $(CC_FLAGS_FTRACE) $(CC_FLAGS_USING)
KBUILD_AFLAGS	+= $(CC_FLAGS_USING)
911 912
endif

913 914
# We trigger additional mismatches with less inlining
ifdef CONFIG_DEBUG_SECTION_MISMATCH
915
KBUILD_CFLAGS += -fno-inline-functions-called-once
916 917
endif

Miguel Ojeda's avatar
Miguel Ojeda committed
918
# `rustc`'s `-Zfunction-sections` applies to data too (as of 1.59.0).
919
ifdef CONFIG_LD_DEAD_CODE_DATA_ELIMINATION
920
KBUILD_CFLAGS_KERNEL += -ffunction-sections -fdata-sections
Miguel Ojeda's avatar
Miguel Ojeda committed
921
KBUILD_RUSTFLAGS_KERNEL += -Zfunction-sections=y
922
LDFLAGS_vmlinux += --gc-sections
923 924
endif

925
ifdef CONFIG_SHADOW_CALL_STACK
926
ifndef CONFIG_DYNAMIC_SCS
927 928
CC_FLAGS_SCS	:= -fsanitize=shadow-call-stack
KBUILD_CFLAGS	+= $(CC_FLAGS_SCS)
929
KBUILD_RUSTFLAGS += -Zsanitizer=shadow-call-stack
930
endif
931 932 933
export CC_FLAGS_SCS
endif

934 935
ifdef CONFIG_LTO_CLANG
ifdef CONFIG_LTO_CLANG_THIN
936
CC_FLAGS_LTO	:= -flto=thin -fsplit-lto-unit
937
else
938
CC_FLAGS_LTO	:= -flto
939 940
endif
CC_FLAGS_LTO	+= -fvisibility=hidden
941 942 943

# Limit inlining across translation units to reduce binary size
KBUILD_LDFLAGS += -mllvm -import-instr-limit=5
944
endif
945 946

ifdef CONFIG_LTO
947 948
KBUILD_CFLAGS	+= -fno-lto $(CC_FLAGS_LTO)
KBUILD_AFLAGS	+= -fno-lto
949 950 951
export CC_FLAGS_LTO
endif

Sami Tolvanen's avatar
Sami Tolvanen committed
952
ifdef CONFIG_CFI_CLANG
953
CC_FLAGS_CFI	:= -fsanitize=kcfi
954 955 956
ifdef CONFIG_CFI_ICALL_NORMALIZE_INTEGERS
	CC_FLAGS_CFI	+= -fsanitize-cfi-icall-experimental-normalize-integers
endif
957 958 959 960 961 962 963
ifdef CONFIG_RUST
	# Always pass -Zsanitizer-cfi-normalize-integers as CONFIG_RUST selects
	# CONFIG_CFI_ICALL_NORMALIZE_INTEGERS.
	RUSTC_FLAGS_CFI   := -Zsanitizer=kcfi -Zsanitizer-cfi-normalize-integers
	KBUILD_RUSTFLAGS += $(RUSTC_FLAGS_CFI)
	export RUSTC_FLAGS_CFI
endif
Sami Tolvanen's avatar
Sami Tolvanen committed
964 965 966 967
KBUILD_CFLAGS	+= $(CC_FLAGS_CFI)
export CC_FLAGS_CFI
endif

968 969 970 971 972
# Architectures can define flags to add/remove for floating-point support
CC_FLAGS_FPU	+= -D_LINUX_FPU_COMPILATION_UNIT
export CC_FLAGS_FPU
export CC_FLAGS_NO_FPU

973
ifneq ($(CONFIG_FUNCTION_ALIGNMENT),0)
974 975 976 977 978 979
# Set the minimal function alignment. Use the newer GCC option
# -fmin-function-alignment if it is available, or fall back to -falign-funtions.
# See also CONFIG_CC_HAS_SANE_FUNCTION_ALIGNMENT.
ifdef CONFIG_CC_HAS_MIN_FUNCTION_ALIGNMENT
KBUILD_CFLAGS += -fmin-function-alignment=$(CONFIG_FUNCTION_ALIGNMENT)
else
980
KBUILD_CFLAGS += -falign-functions=$(CONFIG_FUNCTION_ALIGNMENT)
981
endif
982
endif
983

984
# arch Makefile may override CC so keep this after arch Makefile is included
985
NOSTDINC_FLAGS += -nostdinc
986

987 988 989 990 991 992
# To gain proper coverage for CONFIG_UBSAN_BOUNDS and CONFIG_FORTIFY_SOURCE,
# the kernel uses only C99 flexible arrays for dynamically sized trailing
# arrays. Enforce this for everything that may examine structure sizes and
# perform bounds checking.
KBUILD_CFLAGS += $(call cc-option, -fstrict-flex-arrays=3)

993 994 995
#Currently, disable -Wstringop-overflow for GCC 11, globally.
KBUILD_CFLAGS-$(CONFIG_CC_NO_STRINGOP_OVERFLOW) += $(call cc-option, -Wno-stringop-overflow)
KBUILD_CFLAGS-$(CONFIG_CC_STRINGOP_OVERFLOW) += $(call cc-option, -Wstringop-overflow)
996

997
# disable invalid "can't wrap" optimizations for signed / pointers
998
KBUILD_CFLAGS	+= -fno-strict-overflow
999

1000
# Make sure -fstack-check isn't enabled (like gentoo apparently did)
1001
KBUILD_CFLAGS  += -fno-stack-check
1002

1003
# conserve stack if available
1004 1005 1006
ifdef CONFIG_CC_IS_GCC
KBUILD_CFLAGS   += -fconserve-stack
endif
1007

1008
# change __FILE__ to the relative path from the srctree
1009
KBUILD_CPPFLAGS += $(call cc-option,-fmacro-prefix-map=$(srctree)/=)
1010

1011 1012
# include additional Makefiles when needed
include-y			:= scripts/Makefile.extrawarn
1013
include-$(CONFIG_DEBUG_INFO)	+= scripts/Makefile.debug
1014
include-$(CONFIG_DEBUG_INFO_BTF)+= scripts/Makefile.btf
1015 1016
include-$(CONFIG_KASAN)		+= scripts/Makefile.kasan
include-$(CONFIG_KCSAN)		+= scripts/Makefile.kcsan
1017
include-$(CONFIG_KMSAN)		+= scripts/Makefile.kmsan
1018 1019
include-$(CONFIG_UBSAN)		+= scripts/Makefile.ubsan
include-$(CONFIG_KCOV)		+= scripts/Makefile.kcov
1020
include-$(CONFIG_RANDSTRUCT)	+= scripts/Makefile.randstruct
1021 1022 1023
include-$(CONFIG_GCC_PLUGINS)	+= scripts/Makefile.gcc-plugins

include $(addprefix $(srctree)/, $(include-y))
1024

1025 1026 1027
# scripts/Makefile.gcc-plugins is intentionally included last.
# Do not add $(call cc-option,...) below this line. When you build the kernel
# from the clean source tree, the GCC plugins do not exist at this point.
1028

Miguel Ojeda's avatar
Miguel Ojeda committed
1029
# Add user supplied CPPFLAGS, AFLAGS, CFLAGS and RUSTFLAGS as the last assignments
1030 1031 1032
KBUILD_CPPFLAGS += $(KCPPFLAGS)
KBUILD_AFLAGS   += $(KAFLAGS)
KBUILD_CFLAGS   += $(KCFLAGS)
Miguel Ojeda's avatar
Miguel Ojeda committed
1033
KBUILD_RUSTFLAGS += $(KRUSTFLAGS)
1034

1035 1036
KBUILD_LDFLAGS_MODULE += --build-id=sha1
LDFLAGS_vmlinux += --build-id=sha1
Roland McGrath's avatar
Roland McGrath committed
1037

1038 1039 1040 1041 1042
KBUILD_LDFLAGS	+= -z noexecstack
ifeq ($(CONFIG_LD_IS_BFD),y)
KBUILD_LDFLAGS	+= $(call ld-option,--no-warn-rwx-segments)
endif

1043
ifeq ($(CONFIG_STRIP_ASM_SYMS),y)
1044
LDFLAGS_vmlinux	+= -X
1045 1046
endif

1047
ifeq ($(CONFIG_RELR),y)
1048 1049
# ld.lld before 15 did not support -z pack-relative-relocs.
LDFLAGS_vmlinux	+= $(call ld-option,--pack-dyn-relocs=relr,-z pack-relative-relocs)
1050 1051
endif

1052 1053 1054
# We never want expected sections to be placed heuristically by the
# linker. All sections should be explicitly named in the linker script.
ifdef CONFIG_LD_ORPHAN_WARN
1055
LDFLAGS_vmlinux += --orphan-handling=$(CONFIG_LD_ORPHAN_WARN_LEVEL)
1056 1057
endif

1058
# Align the bit size of userspace programs with the kernel
1059 1060
KBUILD_USERCFLAGS  += $(filter -m32 -m64 --target=%, $(KBUILD_CFLAGS))
KBUILD_USERLDFLAGS += $(filter -m32 -m64 --target=%, $(KBUILD_CFLAGS))
1061

1062 1063 1064
# make the checker run with the right architecture
CHECKFLAGS += --arch=$(ARCH)

1065 1066 1067
# insure the checker run with the right endianness
CHECKFLAGS += $(if $(CONFIG_CPU_BIG_ENDIAN),-mbig-endian,-mlittle-endian)

1068 1069 1070
# the checker needs the correct machine size
CHECKFLAGS += $(if $(CONFIG_64BIT),-m64,-m32)

Linus Torvalds's avatar
Linus Torvalds committed
1071
# Default kernel image to build when no specific target is given.
1072
# KBUILD_IMAGE may be overruled on the command line or
Linus Torvalds's avatar
Linus Torvalds committed
1073 1074 1075 1076 1077 1078 1079 1080 1081 1082
# set in the environment
# Also any assignments in arch/$(ARCH)/Makefile take precedence over
# this default value
export KBUILD_IMAGE ?= vmlinux

#
# INSTALL_PATH specifies where to place the updated kernel and system map
# images. Default is /boot, but you can set it to other values
export	INSTALL_PATH ?= /boot

1083 1084 1085 1086 1087 1088 1089
#
# INSTALL_DTBS_PATH specifies a prefix for relocations required by build roots.
# Like INSTALL_MOD_PATH, it isn't defined in the Makefile, but can be passed as
# an argument if needed. Otherwise it defaults to the kernel install path
#
export INSTALL_DTBS_PATH ?= $(INSTALL_PATH)/dtbs/$(KERNELRELEASE)

Linus Torvalds's avatar
Linus Torvalds committed
1090 1091 1092
#
# INSTALL_MOD_PATH specifies a prefix to MODLIB for module directory
# relocations required by build roots.  This is not defined in the
1093
# makefile but the argument can be passed to make if needed.
Linus Torvalds's avatar
Linus Torvalds committed
1094 1095
#

1096
MODLIB	= $(INSTALL_MOD_PATH)/lib/modules/$(KERNELRELEASE)
Linus Torvalds's avatar
Linus Torvalds committed
1097 1098
export MODLIB

1099
PHONY += prepare0
1100

1101
export extmod_prefix = $(if $(KBUILD_EXTMOD),$(KBUILD_EXTMOD)/)
1102 1103
export MODORDER := $(extmod_prefix)modules.order
export MODULES_NSDEPS := $(extmod_prefix)modules.nsdeps
1104

Linus Torvalds's avatar
Linus Torvalds committed
1105 1106
ifeq ($(KBUILD_EXTMOD),)

1107 1108
build-dir	:= .
clean-dirs	:= $(sort . Documentation \
1109
		     $(patsubst %/,%,$(filter %/, $(core-) \
1110
			$(drivers-) $(libs-))))
Linus Torvalds's avatar
Linus Torvalds committed
1111

1112 1113 1114
export ARCH_CORE	:= $(core-y)
export ARCH_LIB		:= $(filter %/, $(libs-y))
export ARCH_DRIVERS	:= $(drivers-y) $(drivers-m)
1115
# Externally visible symbols (used by link-vmlinux.sh)
1116

1117
KBUILD_VMLINUX_OBJS := ./built-in.a
1118
ifdef CONFIG_MODULES
1119 1120
KBUILD_VMLINUX_OBJS += $(patsubst %/, %/lib.a, $(filter %/, $(libs-y)))
KBUILD_VMLINUX_LIBS := $(filter-out %/, $(libs-y))
1121
else
1122
KBUILD_VMLINUX_LIBS := $(patsubst %/,%/lib.a, $(libs-y))
1123
endif
Linus Torvalds's avatar
Linus Torvalds committed
1124

1125
export KBUILD_VMLINUX_LIBS
1126
export KBUILD_LDS          := arch/$(SRCARCH)/kernel/vmlinux.lds
Linus Torvalds's avatar
Linus Torvalds committed
1127

1128
ifdef CONFIG_TRIM_UNUSED_KSYMS
1129 1130
# For the kernel to actually contain only the needed exported symbols,
# we have to build modules as well to determine what those symbols are.
1131
KBUILD_MODULES := 1
1132 1133
endif

1134 1135 1136 1137 1138
# '$(AR) mPi' needs 'T' to workaround the bug of llvm-ar <= 14
quiet_cmd_ar_vmlinux.a = AR      $@
      cmd_ar_vmlinux.a = \
	rm -f $@; \
	$(AR) cDPrST $@ $(KBUILD_VMLINUX_OBJS); \
1139
	$(AR) mPiT $$($(AR) t $@ | sed -n 1p) $@ $$($(AR) t $@ | grep -F -f $(srctree)/scripts/head-object-list.txt)
1140

1141
targets += vmlinux.a
1142
vmlinux.a: $(KBUILD_VMLINUX_OBJS) scripts/head-object-list.txt FORCE
1143
	$(call if_changed,ar_vmlinux.a)
1144

1145 1146
PHONY += vmlinux_o
vmlinux_o: vmlinux.a $(KBUILD_VMLINUX_LIBS)
1147
	$(Q)$(MAKE) -f $(srctree)/scripts/Makefile.vmlinux_o
1148

1149 1150 1151
vmlinux.o modules.builtin.modinfo modules.builtin: vmlinux_o
	@:

1152
PHONY += vmlinux
1153 1154 1155 1156 1157 1158 1159 1160 1161 1162 1163 1164
# LDFLAGS_vmlinux in the top Makefile defines linker flags for the top vmlinux,
# not for decompressors. LDFLAGS_vmlinux in arch/*/boot/compressed/Makefile is
# unrelated; the decompressors just happen to have the same base name,
# arch/*/boot/compressed/vmlinux.
# Export LDFLAGS_vmlinux only to scripts/Makefile.vmlinux.
#
# _LDFLAGS_vmlinux is a workaround for the 'private export' bug:
#   https://savannah.gnu.org/bugs/?61463
# For Make > 4.4, the following simple code will work:
#  vmlinux: private export LDFLAGS_vmlinux := $(LDFLAGS_vmlinux)
vmlinux: private _LDFLAGS_vmlinux := $(LDFLAGS_vmlinux)
vmlinux: export LDFLAGS_vmlinux = $(_LDFLAGS_vmlinux)
1165 1166
vmlinux: vmlinux.o $(KBUILD_LDS) modpost
	$(Q)$(MAKE) -f $(srctree)/scripts/Makefile.vmlinux
1167

1168
# The actual objects are generated when descending,
Linus Torvalds's avatar
Linus Torvalds committed
1169
# make sure no implicit rule kicks in
1170
$(sort $(KBUILD_LDS) $(KBUILD_VMLINUX_OBJS) $(KBUILD_VMLINUX_LIBS)): . ;
Linus Torvalds's avatar
Linus Torvalds committed
1171

1172
ifeq ($(origin KERNELRELEASE),file)
1173
filechk_kernel.release = $(srctree)/scripts/setlocalversion $(srctree)
1174 1175 1176
else
filechk_kernel.release = echo $(KERNELRELEASE)
endif
1177

1178
# Store (new) KERNELRELEASE string in include/config/kernel.release
1179
include/config/kernel.release: FORCE
1180
	$(call filechk,kernel.release)
1181

1182 1183 1184 1185
# Additional helpers built in scripts/
# Carefully list dependencies so we do not try to build scripts twice
# in parallel
PHONY += scripts
1186
scripts: scripts_basic scripts_dtc
1187
	$(Q)$(MAKE) $(build)=$(@)
1188

Linus Torvalds's avatar
Linus Torvalds committed
1189
# Things we need to do before we recursively start building the kernel
1190 1191 1192 1193
# or the modules are listed in "prepare".
# A multi level approach is used. prepareN is processed before prepareN-1.
# archprepare is used in arch Makefiles and when processed asm symlink,
# version.h and scripts_basic is processed / created.
Linus Torvalds's avatar
Linus Torvalds committed
1194

1195
PHONY += prepare archprepare
1196

1197
archprepare: outputmakefile archheaders archscripts scripts include/config/kernel.release \
1198
	asm-generic $(version_h) include/generated/utsrelease.h \
1199
	include/generated/compile.h include/generated/autoconf.h remove-stale-files
1200

1201
prepare0: archprepare
1202
	$(Q)$(MAKE) $(build)=scripts/mod
1203
	$(Q)$(MAKE) $(build)=. prepare
1204

Linus Torvalds's avatar
Linus Torvalds committed
1205
# All the preparing..
1206
prepare: prepare0
Miguel Ojeda's avatar
Miguel Ojeda committed
1207
ifdef CONFIG_RUST
1208
	+$(Q)$(CONFIG_SHELL) $(srctree)/scripts/rust_is_available.sh
Miguel Ojeda's avatar
Miguel Ojeda committed
1209 1210
	$(Q)$(MAKE) $(build)=rust
endif
1211

1212 1213 1214 1215
PHONY += remove-stale-files
remove-stale-files:
	$(Q)$(srctree)/scripts/remove-stale-files

1216
# Support for using generic headers in asm-generic
1217
asm-generic := -f $(srctree)/scripts/Makefile.asm-headers obj
1218

1219 1220
PHONY += asm-generic uapi-asm-generic
asm-generic: uapi-asm-generic
1221 1222
	$(Q)$(MAKE) $(asm-generic)=arch/$(SRCARCH)/include/generated/asm \
	generic=include/asm-generic
1223
uapi-asm-generic:
1224 1225
	$(Q)$(MAKE) $(asm-generic)=arch/$(SRCARCH)/include/generated/uapi/asm \
	generic=include/uapi/asm-generic
1226

Linus Torvalds's avatar
Linus Torvalds committed
1227 1228 1229 1230 1231 1232 1233
# Generate some files
# ---------------------------------------------------------------------------

# KERNELRELEASE can change from a few different places, meaning version.h
# needs to be updated, so this check is forced on all builds

uts_len := 64
1234 1235 1236 1237 1238
define filechk_utsrelease.h
	if [ `echo -n "$(KERNELRELEASE)" | wc -c ` -gt $(uts_len) ]; then \
	  echo '"$(KERNELRELEASE)" exceeds $(uts_len) characters' >&2;    \
	  exit 1;                                                         \
	fi;                                                               \
1239
	echo \#define UTS_RELEASE \"$(KERNELRELEASE)\"
1240
endef
Linus Torvalds's avatar
Linus Torvalds committed
1241 1242

define filechk_version.h
1243 1244
	if [ $(SUBLEVEL) -gt 255 ]; then                                 \
		echo \#define LINUX_VERSION_CODE $(shell                 \
1245
		expr $(VERSION) \* 65536 + $(PATCHLEVEL) \* 256 + 255); \
1246 1247
	else                                                             \
		echo \#define LINUX_VERSION_CODE $(shell                 \
1248
		expr $(VERSION) \* 65536 + $(PATCHLEVEL) \* 256 + $(SUBLEVEL)); \
1249 1250
	fi;                                                              \
	echo '#define KERNEL_VERSION(a,b,c) (((a) << 16) + ((b) << 8) +  \
1251 1252 1253 1254
	((c) > 255 ? 255 : (c)))';                                       \
	echo \#define LINUX_VERSION_MAJOR $(VERSION);                    \
	echo \#define LINUX_VERSION_PATCHLEVEL $(PATCHLEVEL);            \
	echo \#define LINUX_VERSION_SUBLEVEL $(SUBLEVEL)
Linus Torvalds's avatar
Linus Torvalds committed
1255 1256
endef

1257 1258
$(version_h): private PATCHLEVEL := $(or $(PATCHLEVEL), 0)
$(version_h): private SUBLEVEL := $(or $(SUBLEVEL), 0)
1259
$(version_h): FORCE
Linus Torvalds's avatar
Linus Torvalds committed
1260 1261
	$(call filechk,version.h)

1262
include/generated/utsrelease.h: include/config/kernel.release FORCE
1263 1264
	$(call filechk,utsrelease.h)

1265 1266 1267 1268 1269 1270
filechk_compile.h = $(srctree)/scripts/mkcompile_h \
	"$(UTS_MACHINE)" "$(CONFIG_CC_VERSION_TEXT)" "$(LD)"

include/generated/compile.h: FORCE
	$(call filechk,compile.h)

1271 1272
PHONY += headerdep
headerdep:
1273 1274
	$(Q)find $(srctree)/include/ -name '*.h' | xargs --max-args 1 \
	$(srctree)/scripts/headerdep.pl -I$(srctree)/include
1275

1276 1277 1278
# ---------------------------------------------------------------------------
# Kernel headers

1279 1280
#Default location for installed headers
export INSTALL_HDR_PATH = $(objtree)/usr
1281

1282 1283 1284 1285 1286
quiet_cmd_headers_install = INSTALL $(INSTALL_HDR_PATH)/include
      cmd_headers_install = \
	mkdir -p $(INSTALL_HDR_PATH); \
	rsync -mrl --include='*/' --include='*\.h' --exclude='*' \
	usr/include $(INSTALL_HDR_PATH)
1287

1288
PHONY += headers_install
1289 1290
headers_install: headers
	$(call cmd,headers_install)
1291

1292
PHONY += archheaders archscripts
1293

1294
hdr-inst := -f $(srctree)/scripts/Makefile.headersinst obj
1295

1296 1297
PHONY += headers
headers: $(version_h) scripts_unifdef uapi-asm-generic archheaders archscripts
1298
	$(if $(filter um, $(SRCARCH)), $(error Headers not exportable for UML))
1299 1300
	$(Q)$(MAKE) $(hdr-inst)=include/uapi
	$(Q)$(MAKE) $(hdr-inst)=arch/$(SRCARCH)/include/uapi
1301

1302
ifdef CONFIG_HEADERS_INSTALL
1303
prepare: headers
1304
endif
1305

1306 1307 1308 1309
PHONY += scripts_unifdef
scripts_unifdef: scripts_basic
	$(Q)$(MAKE) $(build)=scripts scripts/unifdef

1310 1311 1312 1313
# ---------------------------------------------------------------------------
# Install

# Many distributions have the custom install script, /sbin/installkernel.
Randy Dunlap's avatar
Randy Dunlap committed
1314 1315
# If DKMS is installed, 'make install' will eventually recurse back
# to this Makefile to build and install external modules.
1316 1317
# Cancel sub_make_done so that options such as M=, V=, etc. are parsed.

1318 1319
quiet_cmd_install = INSTALL $(INSTALL_PATH)
      cmd_install = unset sub_make_done; $(srctree)/scripts/install.sh
1320

1321 1322 1323 1324 1325 1326 1327 1328
# ---------------------------------------------------------------------------
# vDSO install

PHONY += vdso_install
vdso_install: export INSTALL_FILES = $(vdso-install-y)
vdso_install:
	$(Q)$(MAKE) -f $(srctree)/scripts/Makefile.vdsoinst

1329 1330 1331
# ---------------------------------------------------------------------------
# Tools

1332
ifdef CONFIG_OBJTOOL
1333 1334 1335 1336 1337 1338 1339 1340 1341
prepare: tools/objtool
endif

ifdef CONFIG_BPF
ifdef CONFIG_DEBUG_INFO_BTF
prepare: tools/bpf/resolve_btfids
endif
endif

1342 1343 1344 1345 1346 1347
# The tools build system is not a part of Kbuild and tends to introduce
# its own unique issues. If you need to integrate a new tool into Kbuild,
# please consider locating that tool outside the tools/ tree and using the
# standard Kbuild "hostprogs" syntax instead of adding a new tools/* entry
# here. See Documentation/kbuild/makefiles.rst for details.

1348 1349 1350 1351 1352 1353 1354 1355 1356 1357 1358
PHONY += resolve_btfids_clean

resolve_btfids_O = $(abspath $(objtree))/tools/bpf/resolve_btfids

# tools/bpf/resolve_btfids directory might not exist
# in output directory, skip its clean in that case
resolve_btfids_clean:
ifneq ($(wildcard $(resolve_btfids_O)),)
	$(Q)$(MAKE) -sC $(srctree)/tools/bpf/resolve_btfids O=$(resolve_btfids_O) clean
endif

1359 1360 1361 1362 1363 1364 1365 1366 1367 1368 1369 1370 1371
# Clear a bunch of variables before executing the submake
ifeq ($(quiet),silent_)
tools_silent=s
endif

tools/: FORCE
	$(Q)mkdir -p $(objtree)/tools
	$(Q)$(MAKE) LDFLAGS= MAKEFLAGS="$(tools_silent) $(filter --j% -j,$(MAKEFLAGS))" O=$(abspath $(objtree)) subdir=tools -C $(srctree)/tools/

tools/%: FORCE
	$(Q)mkdir -p $(objtree)/tools
	$(Q)$(MAKE) LDFLAGS= MAKEFLAGS="$(tools_silent) $(filter --j% -j,$(MAKEFLAGS))" O=$(abspath $(objtree)) subdir=tools -C $(srctree)/tools/ $*

1372 1373 1374 1375
# ---------------------------------------------------------------------------
# Kernel selftest

PHONY += kselftest
1376
kselftest: headers
1377
	$(Q)$(MAKE) -C $(srctree)/tools/testing/selftests run_tests
1378

1379
kselftest-%: headers FORCE
1380
	$(Q)$(MAKE) -C $(srctree)/tools/testing/selftests $*
1381

1382 1383 1384
PHONY += kselftest-merge
kselftest-merge:
	$(if $(wildcard $(objtree)/.config),, $(error No .config exists, config your kernel first!))
1385
	$(Q)find $(srctree)/tools/testing/selftests -name config -o -name config.$(UTS_MACHINE) | \
1386
		xargs $(srctree)/scripts/kconfig/merge_config.sh -y -m $(objtree)/.config
1387
	$(Q)$(MAKE) -f $(srctree)/Makefile olddefconfig
1388

1389 1390 1391 1392 1393 1394 1395 1396 1397
# ---------------------------------------------------------------------------
# Devicetree files

ifneq ($(wildcard $(srctree)/arch/$(SRCARCH)/boot/dts/),)
dtstree := arch/$(SRCARCH)/boot/dts
endif

ifneq ($(dtstree),)

1398
%.dtb: dtbs_prepare
1399
	$(Q)$(MAKE) $(build)=$(dtstree) $(dtstree)/$@
1400

1401
%.dtbo: dtbs_prepare
1402
	$(Q)$(MAKE) $(build)=$(dtstree) $(dtstree)/$@
1403

1404 1405
PHONY += dtbs dtbs_prepare dtbs_install dtbs_check
dtbs: dtbs_prepare
1406
	$(Q)$(MAKE) $(build)=$(dtstree) need-dtbslist=1
1407

1408 1409 1410 1411 1412
# include/config/kernel.release is actually needed when installing DTBs because
# INSTALL_DTBS_PATH contains $(KERNELRELEASE). However, we do not want to make
# dtbs_install depend on it as dtbs_install may run as root.
dtbs_prepare: include/config/kernel.release scripts_dtc

1413
ifneq ($(filter dtbs_check, $(MAKECMDGOALS)),)
1414
export CHECK_DTBS=y
1415 1416 1417
endif

ifneq ($(CHECK_DTBS),)
1418
dtbs_prepare: dt_binding_schemas
1419 1420 1421
endif

dtbs_check: dtbs
1422

1423
dtbs_install:
1424
	$(Q)$(MAKE) -f $(srctree)/scripts/Makefile.dtbinst obj=$(dtstree)
1425 1426 1427 1428 1429 1430 1431 1432 1433 1434 1435

ifdef CONFIG_OF_EARLY_FLATTREE
all: dtbs
endif

endif

PHONY += scripts_dtc
scripts_dtc: scripts_basic
	$(Q)$(MAKE) $(build)=scripts/dtc

1436
ifneq ($(filter dt_binding_check, $(MAKECMDGOALS)),)
1437
export CHECK_DTBS=y
1438 1439
endif

1440 1441 1442 1443 1444
PHONY += dt_binding_check dt_binding_schemas
dt_binding_check: dt_binding_schemas scripts_dtc
	$(Q)$(MAKE) $(build)=Documentation/devicetree/bindings $@

dt_binding_schemas:
1445 1446
	$(Q)$(MAKE) $(build)=Documentation/devicetree/bindings

1447
PHONY += dt_compatible_check
1448
dt_compatible_check: dt_binding_schemas
1449 1450
	$(Q)$(MAKE) $(build)=Documentation/devicetree/bindings $@

Linus Torvalds's avatar
Linus Torvalds committed
1451 1452 1453 1454 1455
# ---------------------------------------------------------------------------
# Modules

ifdef CONFIG_MODULES

1456
# By default, build modules as well
Linus Torvalds's avatar
Linus Torvalds committed
1457

1458
all: modules
Linus Torvalds's avatar
Linus Torvalds committed
1459

1460 1461 1462 1463 1464 1465 1466
# When we're building modules with modversions, we need to consider
# the built-in objects during the descend as well, in order to
# make sure the checksums are up to date before we record them.
ifdef CONFIG_MODVERSIONS
  KBUILD_BUILTIN := 1
endif

1467
# Build modules
Tejun Heo's avatar
Tejun Heo committed
1468
#
Linus Torvalds's avatar
Linus Torvalds committed
1469

1470
# *.ko are usually independent of vmlinux, but CONFIG_DEBUG_INFO_BTF_MODULES
1471 1472
# is an exception.
ifdef CONFIG_DEBUG_INFO_BTF_MODULES
1473
KBUILD_BUILTIN := 1
1474 1475
modules: vmlinux
endif
1476

1477
modules: modules_prepare
1478

Linus Torvalds's avatar
Linus Torvalds committed
1479
# Target to prepare building external modules
1480
modules_prepare: prepare
1481
	$(Q)$(MAKE) $(build)=scripts scripts/module.lds
Linus Torvalds's avatar
Linus Torvalds committed
1482

1483 1484
endif # CONFIG_MODULES

Linus Torvalds's avatar
Linus Torvalds committed
1485 1486 1487 1488 1489 1490 1491 1492
###
# Cleaning is done on three levels.
# make clean     Delete most generated files
#                Leave enough to build external modules
# make mrproper  Delete the current configuration, and all generated files
# make distclean Remove editor backup files, patch leftover files and the like

# Directories & files removed with 'make clean'
1493
CLEAN_FILES += vmlinux.symvers modules-only.symvers \
1494
	       modules.builtin modules.builtin.modinfo modules.nsdeps \
1495
	       modules.builtin.ranges vmlinux.o.map \
1496
	       compile_commands.json rust/test \
1497
	       rust-project.json .vmlinux.objs .vmlinux.export.c
Linus Torvalds's avatar
Linus Torvalds committed
1498 1499

# Directories & files removed with 'make mrproper'
1500
MRPROPER_FILES += include/config include/generated          \
1501
		  arch/$(SRCARCH)/include/generated .objdiff \
1502
		  debian snap tar-install PKGBUILD pacman \
1503
		  .config .config.old .version \
1504
		  Module.symvers \
1505
		  certs/signing_key.pem \
1506 1507
		  certs/x509.genkey \
		  vmlinux-gdb.py \
1508
		  rpmbuild \
1509
		  rust/libmacros.so
Linus Torvalds's avatar
Linus Torvalds committed
1510 1511 1512

# clean - Delete most, but leave enough to build external modules
#
1513
clean: private rm-files := $(CLEAN_FILES)
Linus Torvalds's avatar
Linus Torvalds committed
1514

1515
PHONY += archclean vmlinuxclean
Linus Torvalds's avatar
Linus Torvalds committed
1516

1517 1518
vmlinuxclean:
	$(Q)$(CONFIG_SHELL) $(srctree)/scripts/link-vmlinux.sh clean
1519
	$(Q)$(if $(ARCH_POSTLINK), $(MAKE) -f $(ARCH_POSTLINK) clean)
1520

1521
clean: archclean vmlinuxclean resolve_btfids_clean
Linus Torvalds's avatar
Linus Torvalds committed
1522 1523 1524

# mrproper - Delete all generated files, including .config
#
1525
mrproper: private rm-files := $(MRPROPER_FILES)
1526
mrproper-dirs      := $(addprefix _mrproper_,scripts)
Linus Torvalds's avatar
Linus Torvalds committed
1527

1528
PHONY += $(mrproper-dirs) mrproper
Linus Torvalds's avatar
Linus Torvalds committed
1529 1530 1531
$(mrproper-dirs):
	$(Q)$(MAKE) $(clean)=$(patsubst _mrproper_%,%,$@)

1532
mrproper: clean $(mrproper-dirs)
Linus Torvalds's avatar
Linus Torvalds committed
1533
	$(call cmd,rmfiles)
Miguel Ojeda's avatar
Miguel Ojeda committed
1534 1535 1536
	@find . $(RCS_FIND_IGNORE) \
		\( -name '*.rmeta' \) \
		-type f -print | xargs rm -f
Linus Torvalds's avatar
Linus Torvalds committed
1537 1538 1539

# distclean
#
1540
PHONY += distclean
Linus Torvalds's avatar
Linus Torvalds committed
1541 1542

distclean: mrproper
1543
	@find . $(RCS_FIND_IGNORE) \
1544
		\( -name '*.orig' -o -name '*.rej' -o -name '*~' \
1545
		-o -name '*.bak' -o -name '#*#' -o -name '*%' \
1546 1547
		-o -name 'core' -o -name tags -o -name TAGS -o -name 'cscope*' \
		-o -name GPATH -o -name GRTAGS -o -name GSYMS -o -name GTAGS \) \
Linus Torvalds's avatar
Linus Torvalds committed
1548 1549 1550 1551 1552 1553
		-type f -print | xargs rm -f


# Packaging of the kernel to various formats
# ---------------------------------------------------------------------------

1554
%src-pkg: FORCE
1555
	$(Q)$(MAKE) -f $(srctree)/scripts/Makefile.package $@
1556
%pkg: include/config/kernel.release FORCE
1557
	$(Q)$(MAKE) -f $(srctree)/scripts/Makefile.package $@
Linus Torvalds's avatar
Linus Torvalds committed
1558 1559 1560 1561

# Brief documentation of the typical targets used
# ---------------------------------------------------------------------------

1562
boards := $(wildcard $(srctree)/arch/$(SRCARCH)/configs/*_defconfig)
1563
boards := $(sort $(notdir $(boards)))
1564 1565
board-dirs := $(dir $(wildcard $(srctree)/arch/$(SRCARCH)/configs/*/*_defconfig))
board-dirs := $(sort $(notdir $(board-dirs:/=)))
Linus Torvalds's avatar
Linus Torvalds committed
1566

1567
PHONY += help
Linus Torvalds's avatar
Linus Torvalds committed
1568 1569
help:
	@echo  'Cleaning targets:'
1570
	@echo  '  clean		  - Remove most generated files but keep the config and'
1571
	@echo  '                    enough build support to build external modules'
1572
	@echo  '  mrproper	  - Remove all generated files + config + various backup files'
1573
	@echo  '  distclean	  - mrproper + remove editor backup and patch files'
Linus Torvalds's avatar
Linus Torvalds committed
1574 1575 1576 1577 1578 1579 1580
	@echo  ''
	@$(MAKE) -f $(srctree)/scripts/kconfig/Makefile help
	@echo  ''
	@echo  'Other generic targets:'
	@echo  '  all		  - Build all targets marked with [*]'
	@echo  '* vmlinux	  - Build the bare kernel'
	@echo  '* modules	  - Build all modules'
1581
	@echo  '  modules_install - Install all modules to INSTALL_MOD_PATH (default: /)'
1582
	@echo  '  vdso_install    - Install unstripped vdso to INSTALL_MOD_PATH (default: /)'
Linus Torvalds's avatar
Linus Torvalds committed
1583
	@echo  '  dir/            - Build all files in dir and below'
1584
	@echo  '  dir/file.[ois]  - Build specified target only'
1585 1586
	@echo  '  dir/file.ll     - Build the LLVM assembly file'
	@echo  '                    (requires compiler support for LLVM assembly generation)'
1587 1588
	@echo  '  dir/file.lst    - Build specified mixed source/assembly target only'
	@echo  '                    (requires a recent binutils and recent build (System.map))'
1589
	@echo  '  dir/file.ko     - Build module including final link'
1590
	@echo  '  modules_prepare - Set up for building external modules'
Linus Torvalds's avatar
Linus Torvalds committed
1591 1592
	@echo  '  tags/TAGS	  - Generate tags file for editors'
	@echo  '  cscope	  - Generate cscope index'
1593
	@echo  '  gtags           - Generate GNU GLOBAL index'
1594 1595 1596
	@echo  '  kernelrelease	  - Output the release version string (use with make -s)'
	@echo  '  kernelversion	  - Output the version stored in Makefile (use with make -s)'
	@echo  '  image_name	  - Output the image name (use with make -s)'
1597
	@echo  '  headers_install - Install sanitised kernel headers to INSTALL_HDR_PATH'; \
1598
	 echo  '                    (default: $(INSTALL_HDR_PATH))'; \
1599
	 echo  ''
1600
	@echo  'Static analysers:'
1601 1602
	@echo  '  checkstack      - Generate a list of stack hogs and consider all functions'
	@echo  '                    with a stack size larger than MINSTACKSIZE (default: 100)'
1603
	@echo  '  versioncheck    - Sanity check on version.h usage'
1604
	@echo  '  includecheck    - Check for duplicate included header files'
1605
	@echo  '  export_report   - List the usages of all exported symbols'
1606
	@echo  '  headerdep       - Detect inclusion cycles in headers'
1607
	@echo  '  coccicheck      - Check with Coccinelle'
1608 1609
	@echo  '  clang-analyzer  - Check with clang static analyzer'
	@echo  '  clang-tidy      - Check with clang-tidy'
1610
	@echo  ''
1611 1612 1613
	@echo  'Tools:'
	@echo  '  nsdeps          - Generate missing symbol namespace dependencies'
	@echo  ''
1614
	@echo  'Kernel selftest:'
1615 1616 1617 1618 1619 1620 1621 1622 1623
	@echo  '  kselftest         - Build and run kernel selftest'
	@echo  '                      Build, install, and boot kernel before'
	@echo  '                      running kselftest on it'
	@echo  '                      Run as root for full coverage'
	@echo  '  kselftest-all     - Build kernel selftest'
	@echo  '  kselftest-install - Build and install kernel selftest'
	@echo  '  kselftest-clean   - Remove all generated kselftest files'
	@echo  '  kselftest-merge   - Merge all the config dependencies of'
	@echo  '		      kselftest to existing .config.'
1624
	@echo  ''
Miguel Ojeda's avatar
Miguel Ojeda committed
1625 1626 1627 1628 1629 1630 1631 1632 1633 1634 1635 1636 1637 1638 1639 1640 1641 1642
	@echo  'Rust targets:'
	@echo  '  rustavailable   - Checks whether the Rust toolchain is'
	@echo  '		    available and, if not, explains why.'
	@echo  '  rustfmt	  - Reformat all the Rust code in the kernel'
	@echo  '  rustfmtcheck	  - Checks if all the Rust code in the kernel'
	@echo  '		    is formatted, printing a diff otherwise.'
	@echo  '  rustdoc	  - Generate Rust documentation'
	@echo  '		    (requires kernel .config)'
	@echo  '  rusttest        - Runs the Rust tests'
	@echo  '                    (requires kernel .config; downloads external repos)'
	@echo  '  rust-analyzer	  - Generate rust-project.json rust-analyzer support file'
	@echo  '		    (requires kernel .config)'
	@echo  '  dir/file.[os]   - Build specified target only'
	@echo  '  dir/file.rsi    - Build macro expanded source, similar to C preprocessing.'
	@echo  '                    Run with RUSTFMT=n to skip reformatting if needed.'
	@echo  '                    The output is not intended to be compilable.'
	@echo  '  dir/file.ll     - Build the LLVM assembly file'
	@echo  ''
1643 1644
	@$(if $(dtstree), \
		echo 'Devicetree:'; \
1645 1646 1647 1648 1649
		echo '* dtbs               - Build device tree blobs for enabled boards'; \
		echo '  dtbs_install       - Install dtbs to $(INSTALL_DTBS_PATH)'; \
		echo '  dt_binding_check   - Validate device tree binding documents and examples'; \
		echo '  dt_binding_schema  - Build processed device tree binding schemas'; \
		echo '  dtbs_check         - Validate device tree source files';\
1650 1651
		echo '')

1652 1653 1654 1655
	@echo 'Userspace tools targets:'
	@echo '  use "make tools/help"'
	@echo '  or  "cd tools; make help"'
	@echo  ''
Linus Torvalds's avatar
Linus Torvalds committed
1656
	@echo  'Kernel packaging:'
1657
	@$(MAKE) -f $(srctree)/scripts/Makefile.package help
Linus Torvalds's avatar
Linus Torvalds committed
1658 1659
	@echo  ''
	@echo  'Documentation targets:'
1660
	@$(MAKE) -f $(srctree)/Documentation/Makefile dochelp
Linus Torvalds's avatar
Linus Torvalds committed
1661
	@echo  ''
1662
	@echo  'Architecture-specific targets ($(SRCARCH)):'
1663
	@$(or $(archhelp),\
1664
		echo '  No architecture-specific help defined for $(SRCARCH)')
Linus Torvalds's avatar
Linus Torvalds committed
1665 1666 1667
	@echo  ''
	@$(if $(boards), \
		$(foreach b, $(boards), \
1668
		printf "  %-27s - Build for %s\\n" $(b) $(subst _defconfig,,$(b));) \
Linus Torvalds's avatar
Linus Torvalds committed
1669
		echo '')
1670 1671 1672 1673 1674
	@$(if $(board-dirs), \
		$(foreach b, $(board-dirs), \
		printf "  %-16s - Show %s-specific targets\\n" help-$(b) $(b);) \
		printf "  %-16s - Show all of the above\\n" help-boards; \
		echo '')
Linus Torvalds's avatar
Linus Torvalds committed
1675

Masahiro Yamada's avatar
Masahiro Yamada committed
1676
	@echo  '  make V=n   [targets] 1: verbose build'
1677 1678
	@echo  '                       2: give reason for rebuild of target'
	@echo  '                       V=1 and V=2 can be combined with V=12'
Linus Torvalds's avatar
Linus Torvalds committed
1679
	@echo  '  make O=dir [targets] Locate all output files in "dir", including .config'
1680 1681
	@echo  '  make C=1   [targets] Check re-compiled c source with $$CHECK'
	@echo  '                       (sparse by default)'
1682
	@echo  '  make C=2   [targets] Force check of all c source with $$CHECK'
1683
	@echo  '  make RECORDMCOUNT_WARN=1 [targets] Warn about ignored mcount sections'
1684
	@echo  '  make W=n   [targets] Enable extra build checks, n=1,2,3,c,e where'
1685 1686 1687
	@echo  '		1: warnings which may be relevant and do not occur too often'
	@echo  '		2: warnings which occur quite often but may still be relevant'
	@echo  '		3: more obscure warnings, can most likely be ignored'
1688
	@echo  '		c: extra checks in the configuration stage (Kconfig)'
1689
	@echo  '		e: warnings are being treated as errors'
1690
	@echo  '		Multiple levels can be combined with W=12 or W=123'
1691 1692 1693 1694
	@$(if $(dtstree), \
		echo '  make CHECK_DTBS=1 [targets] Check all generated dtb files against schema'; \
		echo '         This can be applied both to "dtbs" and to individual "foo.dtb" targets' ; \
		)
Linus Torvalds's avatar
Linus Torvalds committed
1695 1696 1697 1698 1699
	@echo  ''
	@echo  'Execute "make" or "make all" to build all targets marked with [*] '
	@echo  'For further info see the ./README file'


1700 1701 1702 1703
help-board-dirs := $(addprefix help-,$(board-dirs))

help-boards: $(help-board-dirs)

1704
boards-per-dir = $(sort $(notdir $(wildcard $(srctree)/arch/$(SRCARCH)/configs/$*/*_defconfig)))
1705 1706

$(help-board-dirs): help-%:
1707
	@echo  'Architecture-specific targets ($(SRCARCH) $*):'
1708 1709 1710 1711 1712 1713
	@$(if $(boards-per-dir), \
		$(foreach b, $(boards-per-dir), \
		printf "  %-24s - Build for %s\\n" $*/$(b) $(subst _defconfig,,$(b));) \
		echo '')


Linus Torvalds's avatar
Linus Torvalds committed
1714 1715
# Documentation targets
# ---------------------------------------------------------------------------
1716
DOC_TARGETS := xmldocs latexdocs pdfdocs htmldocs epubdocs cleandocs \
1717
	       linkcheckdocs dochelp refcheckdocs texinfodocs infodocs
1718
PHONY += $(DOC_TARGETS)
1719
$(DOC_TARGETS):
1720
	$(Q)$(MAKE) $(build)=Documentation $@
Linus Torvalds's avatar
Linus Torvalds committed
1721

Miguel Ojeda's avatar
Miguel Ojeda committed
1722 1723 1724 1725 1726 1727 1728

# Rust targets
# ---------------------------------------------------------------------------

# "Is Rust available?" target
PHONY += rustavailable
rustavailable:
1729
	+$(Q)$(CONFIG_SHELL) $(srctree)/scripts/rust_is_available.sh && echo "Rust is available!"
Miguel Ojeda's avatar
Miguel Ojeda committed
1730 1731 1732 1733 1734 1735 1736 1737 1738 1739 1740 1741 1742 1743 1744 1745 1746 1747 1748 1749 1750 1751 1752 1753 1754 1755 1756 1757 1758 1759 1760 1761 1762

# Documentation target
#
# Using the singular to avoid running afoul of `no-dot-config-targets`.
PHONY += rustdoc
rustdoc: prepare
	$(Q)$(MAKE) $(build)=rust $@

# Testing target
PHONY += rusttest
rusttest: prepare
	$(Q)$(MAKE) $(build)=rust $@

# Formatting targets
PHONY += rustfmt rustfmtcheck

# We skip `rust/alloc` since we want to minimize the diff w.r.t. upstream.
#
# We match using absolute paths since `find` does not resolve them
# when matching, which is a problem when e.g. `srctree` is `..`.
# We `grep` afterwards in order to remove the directory entry itself.
rustfmt:
	$(Q)find $(abs_srctree) -type f -name '*.rs' \
		-o -path $(abs_srctree)/rust/alloc -prune \
		-o -path $(abs_objtree)/rust/test -prune \
		| grep -Fv $(abs_srctree)/rust/alloc \
		| grep -Fv $(abs_objtree)/rust/test \
		| grep -Fv generated \
		| xargs $(RUSTFMT) $(rustfmt_flags)

rustfmtcheck: rustfmt_flags = --check
rustfmtcheck: rustfmt

1763 1764 1765
# Misc
# ---------------------------------------------------------------------------

1766 1767 1768 1769 1770 1771
PHONY += misc-check
misc-check:
	$(Q)$(srctree)/scripts/misc-check

all: misc-check

1772
PHONY += scripts_gdb
1773
scripts_gdb: prepare0
1774
	$(Q)$(MAKE) $(build)=scripts/gdb
1775
	$(Q)ln -fsn $(abspath $(srctree)/scripts/gdb/vmlinux-gdb.py)
1776 1777 1778 1779 1780

ifdef CONFIG_GDB_SCRIPTS
all: scripts_gdb
endif

Linus Torvalds's avatar
Linus Torvalds committed
1781 1782
else # KBUILD_EXTMOD

1783 1784
filechk_kernel.release = echo $(KERNELRELEASE)

Linus Torvalds's avatar
Linus Torvalds committed
1785 1786 1787 1788 1789
###
# External module support.
# When building external modules the kernel used as basis is considered
# read-only, and no consistency checks are made and the make
# system is not used on the basis kernel. If updates are required
1790
# in the basis kernel ordinary make commands (without M=...) must be used.
Linus Torvalds's avatar
Linus Torvalds committed
1791

1792 1793
# We are always building only modules.
KBUILD_BUILTIN :=
Linus Torvalds's avatar
Linus Torvalds committed
1794 1795
KBUILD_MODULES := 1

1796
build-dir := $(KBUILD_EXTMOD)
1797

1798
compile_commands.json: $(extmod_prefix)compile_commands.json
1799 1800
PHONY += compile_commands.json

1801
clean-dirs := $(KBUILD_EXTMOD)
1802
clean: private rm-files := $(KBUILD_EXTMOD)/Module.symvers $(KBUILD_EXTMOD)/modules.nsdeps \
1803
	$(KBUILD_EXTMOD)/compile_commands.json
Linus Torvalds's avatar
Linus Torvalds committed
1804

1805 1806 1807 1808
PHONY += prepare
# now expand this into a simple variable to reduce the cost of shell evaluations
prepare: CC_VERSION_TEXT := $(CC_VERSION_TEXT)
prepare:
1809
	@if [ "$(CC_VERSION_TEXT)" != "$(CONFIG_CC_VERSION_TEXT)" ]; then \
1810
		echo >&2 "warning: the compiler differs from the one used to build the kernel"; \
1811
		echo >&2 "  The kernel was built by: $(CONFIG_CC_VERSION_TEXT)"; \
1812 1813 1814
		echo >&2 "  You are using:           $(CC_VERSION_TEXT)"; \
	fi

1815
PHONY += help
Linus Torvalds's avatar
Linus Torvalds committed
1816 1817 1818 1819 1820 1821 1822
help:
	@echo  '  Building external modules.'
	@echo  '  Syntax: make -C path/to/kernel/src M=$$PWD target'
	@echo  ''
	@echo  '  modules         - default target, build the module(s)'
	@echo  '  modules_install - install the module'
	@echo  '  clean           - remove generated files in module directory only'
1823
	@echo  '  rust-analyzer	  - generate rust-project.json rust-analyzer support file'
Linus Torvalds's avatar
Linus Torvalds committed
1824
	@echo  ''
1825

1826 1827
ifndef CONFIG_MODULES
modules modules_install: __external_modules_error
1828 1829 1830 1831 1832 1833
__external_modules_error:
	@echo >&2 '***'
	@echo >&2 '*** The present kernel disabled CONFIG_MODULES.'
	@echo >&2 '*** You cannot build or install external modules.'
	@echo >&2 '***'
	@false
1834
endif
1835

Linus Torvalds's avatar
Linus Torvalds committed
1836 1837
endif # KBUILD_EXTMOD

1838 1839 1840
# ---------------------------------------------------------------------------
# Modules

1841
PHONY += modules modules_install modules_sign modules_prepare
1842

1843
modules_install:
1844 1845 1846 1847 1848 1849 1850 1851 1852 1853 1854 1855 1856 1857 1858
	$(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modinst \
	sign-only=$(if $(filter modules_install,$(MAKECMDGOALS)),,y)

ifeq ($(CONFIG_MODULE_SIG),y)
# modules_sign is a subset of modules_install.
# 'make modules_install modules_sign' is equivalent to 'make modules_install'.
modules_sign: modules_install
	@:
else
modules_sign:
	@echo >&2 '***'
	@echo >&2 '*** CONFIG_MODULE_SIG is disabled. You cannot sign modules.'
	@echo >&2 '***'
	@false
endif
1859 1860 1861

ifdef CONFIG_MODULES

1862 1863 1864
$(MODORDER): $(build-dir)
	@:

1865 1866 1867 1868 1869 1870
# KBUILD_MODPOST_NOFINAL can be set to skip the final link of modules.
# This is solely useful to speed up test compiles.
modules: modpost
ifneq ($(KBUILD_MODPOST_NOFINAL),1)
	$(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modfinal
endif
1871

1872 1873 1874 1875
PHONY += modules_check
modules_check: $(MODORDER)
	$(Q)$(CONFIG_SHELL) $(srctree)/scripts/modules-check.sh $<

1876 1877
else # CONFIG_MODULES

1878
modules:
1879
	@:
1880

1881 1882
KBUILD_MODULES :=

1883 1884
endif # CONFIG_MODULES

1885 1886 1887 1888 1889
PHONY += modpost
modpost: $(if $(single-build),, $(if $(KBUILD_BUILTIN), vmlinux.o)) \
	 $(if $(KBUILD_MODULES), modules_check)
	$(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modpost

1890 1891 1892 1893 1894 1895 1896 1897 1898 1899 1900 1901 1902 1903 1904 1905
# Single targets
# ---------------------------------------------------------------------------
# To build individual files in subdirectories, you can do like this:
#
#   make foo/bar/baz.s
#
# The supported suffixes for single-target are listed in 'single-targets'
#
# To build only under specific subdirectories, you can do like this:
#
#   make foo/bar/baz/

ifdef single-build

# .ko is special because modpost is needed
single-ko := $(sort $(filter %.ko, $(MAKECMDGOALS)))
1906 1907
single-no-ko := $(filter-out $(single-ko), $(MAKECMDGOALS)) \
		$(foreach x, o mod, $(patsubst %.ko, %.$x, $(single-ko)))
1908

1909
$(single-ko): single_modules
1910
	@:
1911
$(single-no-ko): $(build-dir)
1912 1913
	@:

1914
# Remove MODORDER when done because it is not the real one.
1915 1916
PHONY += single_modules
single_modules: $(single-no-ko) modules_prepare
1917
	$(Q){ $(foreach m, $(single-ko), echo $(extmod_prefix)$(m:%.ko=%.o);) } > $(MODORDER)
1918
	$(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modpost
1919 1920
ifneq ($(KBUILD_MODPOST_NOFINAL),1)
	$(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modfinal
1921
endif
1922
	$(Q)rm -f $(MODORDER)
1923

1924
single-goals := $(addprefix $(build-dir)/, $(single-no-ko))
1925

1926 1927
KBUILD_MODULES := 1

1928 1929
endif

1930 1931 1932 1933
# Preset locale variables to speed up the build process. Limit locale
# tweaks to this spot to avoid wrong language settings when running
# make menuconfig etc.
# Error messages still appears in the original language
1934 1935 1936
PHONY += $(build-dir)
$(build-dir): prepare
	$(Q)$(MAKE) $(build)=$@ need-builtin=1 need-modorder=1 $(single-goals)
1937

1938 1939 1940 1941 1942
clean-dirs := $(addprefix _clean_, $(clean-dirs))
PHONY += $(clean-dirs) clean
$(clean-dirs):
	$(Q)$(MAKE) $(clean)=$(patsubst _clean_%,%,$@)

1943 1944
clean: $(clean-dirs)
	$(call cmd,rmfiles)
1945
	@find $(or $(KBUILD_EXTMOD), .) $(RCS_FIND_IGNORE) \
Miguel Ojeda's avatar
Miguel Ojeda committed
1946
		\( -name '*.[aios]' -o -name '*.rsi' -o -name '*.ko' -o -name '.*.cmd' \
1947
		-o -name '*.ko.*' \
1948 1949
		-o -name '*.dtb' -o -name '*.dtbo' \
		-o -name '*.dtb.S' -o -name '*.dtbo.S' \
1950
		-o -name '*.dt.yaml' -o -name 'dtbs-list' \
1951
		-o -name '*.dwo' -o -name '*.lst' \
1952
		-o -name '*.su' -o -name '*.mod' \
1953
		-o -name '.*.d' -o -name '.*.tmp' -o -name '*.mod.c' \
1954
		-o -name '*.lex.c' -o -name '*.tab.[ch]' \
1955
		-o -name '*.asn1.[ch]' \
1956
		-o -name '*.symtypes' -o -name 'modules.order' \
Emese Revfy's avatar
Emese Revfy committed
1957
		-o -name '*.c.[012]*.*' \
1958
		-o -name '*.ll' \
1959
		-o -name '*.gcno' \
1960
		\) -type f -print \
1961 1962
		-o -name '.tmp_*' -print \
		| xargs rm -rf
1963

Linus Torvalds's avatar
Linus Torvalds committed
1964 1965
# Generate tags for editors
# ---------------------------------------------------------------------------
1966
quiet_cmd_tags = GEN     $@
1967
      cmd_tags = $(BASH) $(srctree)/scripts/tags.sh $@
Linus Torvalds's avatar
Linus Torvalds committed
1968

1969
tags TAGS cscope gtags: FORCE
Linus Torvalds's avatar
Linus Torvalds committed
1970 1971
	$(call cmd,tags)

1972 1973 1974
# Generate rust-project.json (a file that describes the structure of non-Cargo
# Rust projects) for rust-analyzer (an implementation of the Language Server
# Protocol).
1975 1976
PHONY += rust-analyzer
rust-analyzer:
1977
	+$(Q)$(CONFIG_SHELL) $(srctree)/scripts/rust_is_available.sh
1978 1979
	$(Q)$(MAKE) $(build)=rust $@

1980 1981 1982 1983
# Script to generate missing namespace dependencies
# ---------------------------------------------------------------------------

PHONY += nsdeps
1984
nsdeps: export KBUILD_NSDEPS=1
1985
nsdeps: modules
1986
	$(Q)$(CONFIG_SHELL) $(srctree)/scripts/nsdeps
1987

1988 1989 1990 1991 1992 1993
# Clang Tooling
# ---------------------------------------------------------------------------

quiet_cmd_gen_compile_commands = GEN     $@
      cmd_gen_compile_commands = $(PYTHON3) $< -a $(AR) -o $@ $(filter-out $<, $(real-prereqs))

1994
$(extmod_prefix)compile_commands.json: $(srctree)/scripts/clang-tools/gen_compile_commands.py \
1995
	$(if $(KBUILD_EXTMOD),, vmlinux.a $(KBUILD_VMLINUX_LIBS)) \
1996 1997 1998
	$(if $(CONFIG_MODULES), $(MODORDER)) FORCE
	$(call if_changed,gen_compile_commands)

1999
targets += $(extmod_prefix)compile_commands.json
2000

2001 2002 2003 2004 2005 2006
PHONY += clang-tidy clang-analyzer

ifdef CONFIG_CC_IS_CLANG
quiet_cmd_clang_tools = CHECK   $<
      cmd_clang_tools = $(PYTHON3) $(srctree)/scripts/clang-tools/run-clang-tools.py $@ $<

2007
clang-tidy clang-analyzer: $(extmod_prefix)compile_commands.json
2008 2009 2010 2011 2012 2013 2014
	$(call cmd,clang_tools)
else
clang-tidy clang-analyzer:
	@echo "$@ requires CC=clang" >&2
	@false
endif

Linus Torvalds's avatar
Linus Torvalds committed
2015 2016 2017
# Scripts to check various things for consistency
# ---------------------------------------------------------------------------

2018
PHONY += includecheck versioncheck coccicheck export_report
Peter Foley's avatar
Peter Foley committed
2019

Linus Torvalds's avatar
Linus Torvalds committed
2020
includecheck:
2021
	find $(srctree)/* $(RCS_FIND_IGNORE) \
Linus Torvalds's avatar
Linus Torvalds committed
2022
		-name '*.[hcS]' -type f -print | sort \
2023
		| xargs $(PERL) -w $(srctree)/scripts/checkincludes.pl
Linus Torvalds's avatar
Linus Torvalds committed
2024 2025

versioncheck:
2026
	find $(srctree)/* $(RCS_FIND_IGNORE) \
Linus Torvalds's avatar
Linus Torvalds committed
2027
		-name '*.[hcS]' -type f -print | sort \
2028
		| xargs $(PERL) -w $(srctree)/scripts/checkversion.pl
Linus Torvalds's avatar
Linus Torvalds committed
2029

2030
coccicheck:
2031
	$(Q)$(BASH) $(srctree)/scripts/$@
2032

2033 2034 2035
export_report:
	$(PERL) $(srctree)/scripts/export_report.pl

2036
PHONY += checkstack kernelrelease kernelversion image_name
2037

2038 2039 2040 2041 2042 2043 2044 2045 2046
# UML needs a little special treatment here.  It wants to use the host
# toolchain, so needs $(SUBARCH) passed to checkstack.pl.  Everyone
# else wants $(ARCH), including people doing cross-builds, which means
# that $(SUBARCH) doesn't work here.
ifeq ($(ARCH), um)
CHECKSTACK_ARCH := $(SUBARCH)
else
CHECKSTACK_ARCH := $(ARCH)
endif
2047
MINSTACKSIZE	?= 100
Linus Torvalds's avatar
Linus Torvalds committed
2048 2049
checkstack:
	$(OBJDUMP) -d vmlinux $$(find . -name '*.ko') | \
2050
	$(PERL) $(srctree)/scripts/checkstack.pl $(CHECKSTACK_ARCH) $(MINSTACKSIZE)
Linus Torvalds's avatar
Linus Torvalds committed
2051

2052
kernelrelease:
2053
	@$(filechk_kernel.release)
2054

2055
kernelversion:
2056
	@echo $(KERNELVERSION)
Linus Torvalds's avatar
Linus Torvalds committed
2057

2058 2059 2060
image_name:
	@echo $(KBUILD_IMAGE)

2061 2062 2063 2064
PHONY += run-command
run-command:
	$(Q)$(KBUILD_RUN_COMMAND)

Linus Torvalds's avatar
Linus Torvalds committed
2065
quiet_cmd_rmfiles = $(if $(wildcard $(rm-files)),CLEAN   $(wildcard $(rm-files)))
2066
      cmd_rmfiles = rm -rf $(rm-files)
Linus Torvalds's avatar
Linus Torvalds committed
2067

2068 2069
# read saved command lines for existing targets
existing-targets := $(wildcard $(sort $(targets)))
Linus Torvalds's avatar
Linus Torvalds committed
2070

2071
-include $(foreach f,$(existing-targets),$(dir $(f)).$(notdir $(f)).cmd)
Linus Torvalds's avatar
Linus Torvalds committed
2072

2073
endif # config-build
2074 2075
endif # mixed-build
endif # need-sub-make
Linus Torvalds's avatar
Linus Torvalds committed
2076

2077
PHONY += FORCE
Linus Torvalds's avatar
Linus Torvalds committed
2078
FORCE:
2079

2080
# Declare the contents of the PHONY variable as phony.  We keep that
2081
# information in a variable so we can use it in if_changed and friends.
2082
.PHONY: $(PHONY)