| 1 | # SPDX-License-Identifier: GPL-2.0 |
| 2 | VERSION = 6 |
| 3 | PATCHLEVEL = 4 |
| 4 | SUBLEVEL = 0 |
| 5 | EXTRAVERSION = -rc2 |
| 6 | NAME = Hurr durr I'ma ninja sloth |
| 7 | |
| 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 | |
| 14 | ifeq ($(filter undefine,$(.FEATURES)),) |
| 15 | $(error GNU Make >= 3.82 is required. Your Make version is $(MAKE_VERSION)) |
| 16 | endif |
| 17 | |
| 18 | $(if $(filter __%, $(MAKECMDGOALS)), \ |
| 19 | $(error targets prefixed with '__' are only for internal use)) |
| 20 | |
| 21 | # That's our default target when none is given on the command line |
| 22 | PHONY := __all |
| 23 | __all: |
| 24 | |
| 25 | # 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 |
| 31 | # unavoidable when linking the built-in.a targets which finally |
| 32 | # 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 | |
| 41 | ifneq ($(sub_make_done),1) |
| 42 | |
| 43 | # Do not use make's built-in rules and variables |
| 44 | # (this increases performance and avoids hard-to-debug behaviour) |
| 45 | MAKEFLAGS += -rR |
| 46 | |
| 47 | # Avoid funny character set dependencies |
| 48 | unexport LC_ALL |
| 49 | LC_COLLATE=C |
| 50 | LC_NUMERIC=C |
| 51 | export LC_COLLATE LC_NUMERIC |
| 52 | |
| 53 | # Avoid interference with shell env settings |
| 54 | unexport GREP_OPTIONS |
| 55 | |
| 56 | # Beautify output |
| 57 | # --------------------------------------------------------------------------- |
| 58 | # |
| 59 | # Most of build commands in Kbuild start with "cmd_". You can optionally define |
| 60 | # "quiet_cmd_*". If defined, the short log is printed. Otherwise, no log from |
| 61 | # that command is printed by default. |
| 62 | # |
| 63 | # e.g.) |
| 64 | # quiet_cmd_depmod = DEPMOD $(MODLIB) |
| 65 | # cmd_depmod = $(srctree)/scripts/depmod.sh $(DEPMOD) $(KERNELRELEASE) |
| 66 | # |
| 67 | # A simple variant is to prefix commands with $(Q) - that's useful |
| 68 | # for commands that shall be hidden in non-verbose mode. |
| 69 | # |
| 70 | # $(Q)$(MAKE) $(build)=scripts/basic |
| 71 | # |
| 72 | # If KBUILD_VERBOSE contains 1, the whole command is echoed. |
| 73 | # If KBUILD_VERBOSE contains 2, the reason for rebuilding is printed. |
| 74 | # |
| 75 | # To put more focus on warnings, be less verbose as default |
| 76 | # Use 'make V=1' to see the full commands |
| 77 | |
| 78 | ifeq ("$(origin V)", "command line") |
| 79 | KBUILD_VERBOSE = $(V) |
| 80 | endif |
| 81 | |
| 82 | quiet = quiet_ |
| 83 | Q = @ |
| 84 | |
| 85 | ifneq ($(findstring 1, $(KBUILD_VERBOSE)),) |
| 86 | quiet = |
| 87 | Q = |
| 88 | endif |
| 89 | |
| 90 | # If the user is running make -s (silent mode), suppress echoing of |
| 91 | # commands |
| 92 | # make-4.0 (and later) keep single letter options in the 1st word of MAKEFLAGS. |
| 93 | |
| 94 | ifeq ($(filter 3.%,$(MAKE_VERSION)),) |
| 95 | short-opts := $(firstword -$(MAKEFLAGS)) |
| 96 | else |
| 97 | short-opts := $(filter-out --%,$(MAKEFLAGS)) |
| 98 | endif |
| 99 | |
| 100 | ifneq ($(findstring s,$(short-opts)),) |
| 101 | quiet=silent_ |
| 102 | override KBUILD_VERBOSE := |
| 103 | endif |
| 104 | |
| 105 | export quiet Q KBUILD_VERBOSE |
| 106 | |
| 107 | # Call a source code checker (by default, "sparse") as part of the |
| 108 | # C compilation. |
| 109 | # |
| 110 | # Use 'make C=1' to enable checking of only re-compiled files. |
| 111 | # Use 'make C=2' to enable checking of *all* source files, regardless |
| 112 | # of whether they are re-compiled or not. |
| 113 | # |
| 114 | # See the file "Documentation/dev-tools/sparse.rst" for more details, |
| 115 | # including where to get the "sparse" utility. |
| 116 | |
| 117 | ifeq ("$(origin C)", "command line") |
| 118 | KBUILD_CHECKSRC = $(C) |
| 119 | endif |
| 120 | ifndef KBUILD_CHECKSRC |
| 121 | KBUILD_CHECKSRC = 0 |
| 122 | endif |
| 123 | |
| 124 | export KBUILD_CHECKSRC |
| 125 | |
| 126 | # Enable "clippy" (a linter) as part of the Rust compilation. |
| 127 | # |
| 128 | # Use 'make CLIPPY=1' to enable it. |
| 129 | ifeq ("$(origin CLIPPY)", "command line") |
| 130 | KBUILD_CLIPPY := $(CLIPPY) |
| 131 | endif |
| 132 | |
| 133 | export KBUILD_CLIPPY |
| 134 | |
| 135 | # Use make M=dir or set the environment variable KBUILD_EXTMOD to specify the |
| 136 | # directory of external module to build. Setting M= takes precedence. |
| 137 | ifeq ("$(origin M)", "command line") |
| 138 | KBUILD_EXTMOD := $(M) |
| 139 | endif |
| 140 | |
| 141 | $(if $(word 2, $(KBUILD_EXTMOD)), \ |
| 142 | $(error building multiple external modules is not supported)) |
| 143 | |
| 144 | $(foreach x, % :, $(if $(findstring $x, $(KBUILD_EXTMOD)), \ |
| 145 | $(error module directory path cannot contain '$x'))) |
| 146 | |
| 147 | # Remove trailing slashes |
| 148 | ifneq ($(filter %/, $(KBUILD_EXTMOD)),) |
| 149 | KBUILD_EXTMOD := $(shell dirname $(KBUILD_EXTMOD).) |
| 150 | endif |
| 151 | |
| 152 | export KBUILD_EXTMOD |
| 153 | |
| 154 | # Kbuild will save output files in the current working directory. |
| 155 | # This does not need to match to the root of the kernel source tree. |
| 156 | # |
| 157 | # For example, you can do this: |
| 158 | # |
| 159 | # cd /dir/to/store/output/files; make -f /dir/to/kernel/source/Makefile |
| 160 | # |
| 161 | # If you want to save output files in a different location, there are |
| 162 | # two syntaxes to specify it. |
| 163 | # |
| 164 | # 1) O= |
| 165 | # Use "make O=dir/to/store/output/files/" |
| 166 | # |
| 167 | # 2) Set KBUILD_OUTPUT |
| 168 | # Set the environment variable KBUILD_OUTPUT to point to the output directory. |
| 169 | # export KBUILD_OUTPUT=dir/to/store/output/files/; make |
| 170 | # |
| 171 | # The O= assignment takes precedence over the KBUILD_OUTPUT environment |
| 172 | # variable. |
| 173 | |
| 174 | # Do we want to change the working directory? |
| 175 | ifeq ("$(origin O)", "command line") |
| 176 | KBUILD_OUTPUT := $(O) |
| 177 | endif |
| 178 | |
| 179 | ifneq ($(KBUILD_OUTPUT),) |
| 180 | # Make's built-in functions such as $(abspath ...), $(realpath ...) cannot |
| 181 | # expand a shell special character '~'. We use a somewhat tedious way here. |
| 182 | abs_objtree := $(shell mkdir -p $(KBUILD_OUTPUT) && cd $(KBUILD_OUTPUT) && pwd) |
| 183 | $(if $(abs_objtree),, \ |
| 184 | $(error failed to create output directory "$(KBUILD_OUTPUT)")) |
| 185 | |
| 186 | # $(realpath ...) resolves symlinks |
| 187 | abs_objtree := $(realpath $(abs_objtree)) |
| 188 | else |
| 189 | abs_objtree := $(CURDIR) |
| 190 | endif # ifneq ($(KBUILD_OUTPUT),) |
| 191 | |
| 192 | ifeq ($(abs_objtree),$(CURDIR)) |
| 193 | # Suppress "Entering directory ..." unless we are changing the work directory. |
| 194 | MAKEFLAGS += --no-print-directory |
| 195 | else |
| 196 | need-sub-make := 1 |
| 197 | endif |
| 198 | |
| 199 | this-makefile := $(lastword $(MAKEFILE_LIST)) |
| 200 | abs_srctree := $(realpath $(dir $(this-makefile))) |
| 201 | |
| 202 | ifneq ($(words $(subst :, ,$(abs_srctree))), 1) |
| 203 | $(error source directory cannot contain spaces or colons) |
| 204 | endif |
| 205 | |
| 206 | ifneq ($(filter 3.%,$(MAKE_VERSION)),) |
| 207 | # 'MAKEFLAGS += -rR' does not immediately become effective for GNU Make 3.x |
| 208 | # We need to invoke sub-make to avoid implicit rules in the top Makefile. |
| 209 | need-sub-make := 1 |
| 210 | # Cancel implicit rules for this Makefile. |
| 211 | $(this-makefile): ; |
| 212 | endif |
| 213 | |
| 214 | export abs_srctree abs_objtree |
| 215 | export sub_make_done := 1 |
| 216 | |
| 217 | ifeq ($(need-sub-make),1) |
| 218 | |
| 219 | PHONY += $(MAKECMDGOALS) __sub-make |
| 220 | |
| 221 | $(filter-out $(this-makefile), $(MAKECMDGOALS)) __all: __sub-make |
| 222 | @: |
| 223 | |
| 224 | # Invoke a second make in the output directory, passing relevant variables |
| 225 | __sub-make: |
| 226 | $(Q)$(MAKE) -C $(abs_objtree) -f $(abs_srctree)/Makefile $(MAKECMDGOALS) |
| 227 | |
| 228 | endif # need-sub-make |
| 229 | endif # sub_make_done |
| 230 | |
| 231 | # We process the rest of the Makefile if this is the final invocation of make |
| 232 | ifeq ($(need-sub-make),) |
| 233 | |
| 234 | # Do not print "Entering directory ...", |
| 235 | # but we want to display it when entering to the output directory |
| 236 | # so that IDEs/editors are able to understand relative filenames. |
| 237 | MAKEFLAGS += --no-print-directory |
| 238 | |
| 239 | ifeq ($(abs_srctree),$(abs_objtree)) |
| 240 | # building in the source tree |
| 241 | srctree := . |
| 242 | building_out_of_srctree := |
| 243 | else |
| 244 | ifeq ($(abs_srctree)/,$(dir $(abs_objtree))) |
| 245 | # building in a subdirectory of the source tree |
| 246 | srctree := .. |
| 247 | else |
| 248 | srctree := $(abs_srctree) |
| 249 | endif |
| 250 | building_out_of_srctree := 1 |
| 251 | endif |
| 252 | |
| 253 | ifneq ($(KBUILD_ABS_SRCTREE),) |
| 254 | srctree := $(abs_srctree) |
| 255 | endif |
| 256 | |
| 257 | objtree := . |
| 258 | VPATH := $(srctree) |
| 259 | |
| 260 | export building_out_of_srctree srctree objtree VPATH |
| 261 | |
| 262 | # To make sure we do not include .config for any of the *config targets |
| 263 | # catch them early, and hand them over to scripts/kconfig/Makefile |
| 264 | # It is allowed to specify more targets when calling make, including |
| 265 | # mixing *config targets and build targets. |
| 266 | # For example 'make oldconfig all'. |
| 267 | # Detect when mixed targets is specified, and make a second invocation |
| 268 | # of make so .config is not included in this case either (for *config). |
| 269 | |
| 270 | version_h := include/generated/uapi/linux/version.h |
| 271 | |
| 272 | clean-targets := %clean mrproper cleandocs |
| 273 | no-dot-config-targets := $(clean-targets) \ |
| 274 | cscope gtags TAGS tags help% %docs check% coccicheck \ |
| 275 | $(version_h) headers headers_% archheaders archscripts \ |
| 276 | %asm-generic kernelversion %src-pkg dt_binding_check \ |
| 277 | outputmakefile rustavailable rustfmt rustfmtcheck |
| 278 | # Installation targets should not require compiler. Unfortunately, vdso_install |
| 279 | # is an exception where build artifacts may be updated. This must be fixed. |
| 280 | no-compiler-targets := $(no-dot-config-targets) install dtbs_install \ |
| 281 | headers_install modules_install kernelrelease image_name |
| 282 | no-sync-config-targets := $(no-dot-config-targets) %install kernelrelease \ |
| 283 | image_name |
| 284 | single-targets := %.a %.i %.ko %.lds %.ll %.lst %.mod %.o %.rsi %.s %.symtypes %/ |
| 285 | |
| 286 | config-build := |
| 287 | mixed-build := |
| 288 | need-config := 1 |
| 289 | need-compiler := 1 |
| 290 | may-sync-config := 1 |
| 291 | single-build := |
| 292 | |
| 293 | ifneq ($(filter $(no-dot-config-targets), $(MAKECMDGOALS)),) |
| 294 | ifeq ($(filter-out $(no-dot-config-targets), $(MAKECMDGOALS)),) |
| 295 | need-config := |
| 296 | endif |
| 297 | endif |
| 298 | |
| 299 | ifneq ($(filter $(no-compiler-targets), $(MAKECMDGOALS)),) |
| 300 | ifeq ($(filter-out $(no-compiler-targets), $(MAKECMDGOALS)),) |
| 301 | need-compiler := |
| 302 | endif |
| 303 | endif |
| 304 | |
| 305 | ifneq ($(filter $(no-sync-config-targets), $(MAKECMDGOALS)),) |
| 306 | ifeq ($(filter-out $(no-sync-config-targets), $(MAKECMDGOALS)),) |
| 307 | may-sync-config := |
| 308 | endif |
| 309 | endif |
| 310 | |
| 311 | ifneq ($(KBUILD_EXTMOD),) |
| 312 | may-sync-config := |
| 313 | endif |
| 314 | |
| 315 | ifeq ($(KBUILD_EXTMOD),) |
| 316 | ifneq ($(filter %config,$(MAKECMDGOALS)),) |
| 317 | config-build := 1 |
| 318 | ifneq ($(words $(MAKECMDGOALS)),1) |
| 319 | mixed-build := 1 |
| 320 | endif |
| 321 | endif |
| 322 | endif |
| 323 | |
| 324 | # We cannot build single targets and the others at the same time |
| 325 | ifneq ($(filter $(single-targets), $(MAKECMDGOALS)),) |
| 326 | single-build := 1 |
| 327 | ifneq ($(filter-out $(single-targets), $(MAKECMDGOALS)),) |
| 328 | mixed-build := 1 |
| 329 | endif |
| 330 | endif |
| 331 | |
| 332 | # For "make -j clean all", "make -j mrproper defconfig all", etc. |
| 333 | ifneq ($(filter $(clean-targets),$(MAKECMDGOALS)),) |
| 334 | ifneq ($(filter-out $(clean-targets),$(MAKECMDGOALS)),) |
| 335 | mixed-build := 1 |
| 336 | endif |
| 337 | endif |
| 338 | |
| 339 | # install and modules_install need also be processed one by one |
| 340 | ifneq ($(filter install,$(MAKECMDGOALS)),) |
| 341 | ifneq ($(filter modules_install,$(MAKECMDGOALS)),) |
| 342 | mixed-build := 1 |
| 343 | endif |
| 344 | endif |
| 345 | |
| 346 | ifdef mixed-build |
| 347 | # =========================================================================== |
| 348 | # We're called with mixed targets (*config and build targets). |
| 349 | # Handle them one by one. |
| 350 | |
| 351 | PHONY += $(MAKECMDGOALS) __build_one_by_one |
| 352 | |
| 353 | $(MAKECMDGOALS): __build_one_by_one |
| 354 | @: |
| 355 | |
| 356 | __build_one_by_one: |
| 357 | $(Q)set -e; \ |
| 358 | for i in $(MAKECMDGOALS); do \ |
| 359 | $(MAKE) -f $(srctree)/Makefile $$i; \ |
| 360 | done |
| 361 | |
| 362 | else # !mixed-build |
| 363 | |
| 364 | include $(srctree)/scripts/Kbuild.include |
| 365 | |
| 366 | # Read KERNELRELEASE from include/config/kernel.release (if it exists) |
| 367 | KERNELRELEASE = $(call read-file, include/config/kernel.release) |
| 368 | KERNELVERSION = $(VERSION)$(if $(PATCHLEVEL),.$(PATCHLEVEL)$(if $(SUBLEVEL),.$(SUBLEVEL)))$(EXTRAVERSION) |
| 369 | export VERSION PATCHLEVEL SUBLEVEL KERNELRELEASE KERNELVERSION |
| 370 | |
| 371 | include $(srctree)/scripts/subarch.include |
| 372 | |
| 373 | # Cross compiling and selecting different set of gcc/bin-utils |
| 374 | # --------------------------------------------------------------------------- |
| 375 | # |
| 376 | # When performing cross compilation for other architectures ARCH shall be set |
| 377 | # to the target architecture. (See arch/* for the possibilities). |
| 378 | # ARCH can be set during invocation of make: |
| 379 | # make ARCH=ia64 |
| 380 | # Another way is to have ARCH set in the environment. |
| 381 | # The default ARCH is the host where make is executed. |
| 382 | |
| 383 | # CROSS_COMPILE specify the prefix used for all executables used |
| 384 | # during compilation. Only gcc and related bin-utils executables |
| 385 | # are prefixed with $(CROSS_COMPILE). |
| 386 | # CROSS_COMPILE can be set on the command line |
| 387 | # make CROSS_COMPILE=ia64-linux- |
| 388 | # Alternatively CROSS_COMPILE can be set in the environment. |
| 389 | # Default value for CROSS_COMPILE is not to prefix executables |
| 390 | # Note: Some architectures assign CROSS_COMPILE in their arch/*/Makefile |
| 391 | ARCH ?= $(SUBARCH) |
| 392 | |
| 393 | # Architecture as present in compile.h |
| 394 | UTS_MACHINE := $(ARCH) |
| 395 | SRCARCH := $(ARCH) |
| 396 | |
| 397 | # Additional ARCH settings for x86 |
| 398 | ifeq ($(ARCH),i386) |
| 399 | SRCARCH := x86 |
| 400 | endif |
| 401 | ifeq ($(ARCH),x86_64) |
| 402 | SRCARCH := x86 |
| 403 | endif |
| 404 | |
| 405 | # Additional ARCH settings for sparc |
| 406 | ifeq ($(ARCH),sparc32) |
| 407 | SRCARCH := sparc |
| 408 | endif |
| 409 | ifeq ($(ARCH),sparc64) |
| 410 | SRCARCH := sparc |
| 411 | endif |
| 412 | |
| 413 | # Additional ARCH settings for parisc |
| 414 | ifeq ($(ARCH),parisc64) |
| 415 | SRCARCH := parisc |
| 416 | endif |
| 417 | |
| 418 | export cross_compiling := |
| 419 | ifneq ($(SRCARCH),$(SUBARCH)) |
| 420 | cross_compiling := 1 |
| 421 | endif |
| 422 | |
| 423 | KCONFIG_CONFIG ?= .config |
| 424 | export KCONFIG_CONFIG |
| 425 | |
| 426 | # SHELL used by kbuild |
| 427 | CONFIG_SHELL := sh |
| 428 | |
| 429 | HOST_LFS_CFLAGS := $(shell getconf LFS_CFLAGS 2>/dev/null) |
| 430 | HOST_LFS_LDFLAGS := $(shell getconf LFS_LDFLAGS 2>/dev/null) |
| 431 | HOST_LFS_LIBS := $(shell getconf LFS_LIBS 2>/dev/null) |
| 432 | |
| 433 | ifneq ($(LLVM),) |
| 434 | ifneq ($(filter %/,$(LLVM)),) |
| 435 | LLVM_PREFIX := $(LLVM) |
| 436 | else ifneq ($(filter -%,$(LLVM)),) |
| 437 | LLVM_SUFFIX := $(LLVM) |
| 438 | endif |
| 439 | |
| 440 | HOSTCC = $(LLVM_PREFIX)clang$(LLVM_SUFFIX) |
| 441 | HOSTCXX = $(LLVM_PREFIX)clang++$(LLVM_SUFFIX) |
| 442 | else |
| 443 | HOSTCC = gcc |
| 444 | HOSTCXX = g++ |
| 445 | endif |
| 446 | HOSTRUSTC = rustc |
| 447 | HOSTPKG_CONFIG = pkg-config |
| 448 | |
| 449 | KBUILD_USERHOSTCFLAGS := -Wall -Wmissing-prototypes -Wstrict-prototypes \ |
| 450 | -O2 -fomit-frame-pointer -std=gnu11 \ |
| 451 | -Wdeclaration-after-statement |
| 452 | KBUILD_USERCFLAGS := $(KBUILD_USERHOSTCFLAGS) $(USERCFLAGS) |
| 453 | KBUILD_USERLDFLAGS := $(USERLDFLAGS) |
| 454 | |
| 455 | # These flags apply to all Rust code in the tree, including the kernel and |
| 456 | # host programs. |
| 457 | export rust_common_flags := --edition=2021 \ |
| 458 | -Zbinary_dep_depinfo=y \ |
| 459 | -Dunsafe_op_in_unsafe_fn -Drust_2018_idioms \ |
| 460 | -Dunreachable_pub -Dnon_ascii_idents \ |
| 461 | -Wmissing_docs \ |
| 462 | -Drustdoc::missing_crate_level_docs \ |
| 463 | -Dclippy::correctness -Dclippy::style \ |
| 464 | -Dclippy::suspicious -Dclippy::complexity \ |
| 465 | -Dclippy::perf \ |
| 466 | -Dclippy::let_unit_value -Dclippy::mut_mut \ |
| 467 | -Dclippy::needless_bitwise_bool \ |
| 468 | -Dclippy::needless_continue \ |
| 469 | -Wclippy::dbg_macro |
| 470 | |
| 471 | KBUILD_HOSTCFLAGS := $(KBUILD_USERHOSTCFLAGS) $(HOST_LFS_CFLAGS) $(HOSTCFLAGS) |
| 472 | KBUILD_HOSTCXXFLAGS := -Wall -O2 $(HOST_LFS_CFLAGS) $(HOSTCXXFLAGS) |
| 473 | KBUILD_HOSTRUSTFLAGS := $(rust_common_flags) -O -Cstrip=debuginfo \ |
| 474 | -Zallow-features= $(HOSTRUSTFLAGS) |
| 475 | KBUILD_HOSTLDFLAGS := $(HOST_LFS_LDFLAGS) $(HOSTLDFLAGS) |
| 476 | KBUILD_HOSTLDLIBS := $(HOST_LFS_LIBS) $(HOSTLDLIBS) |
| 477 | |
| 478 | # Make variables (CC, etc...) |
| 479 | CPP = $(CC) -E |
| 480 | ifneq ($(LLVM),) |
| 481 | CC = $(LLVM_PREFIX)clang$(LLVM_SUFFIX) |
| 482 | LD = $(LLVM_PREFIX)ld.lld$(LLVM_SUFFIX) |
| 483 | AR = $(LLVM_PREFIX)llvm-ar$(LLVM_SUFFIX) |
| 484 | NM = $(LLVM_PREFIX)llvm-nm$(LLVM_SUFFIX) |
| 485 | OBJCOPY = $(LLVM_PREFIX)llvm-objcopy$(LLVM_SUFFIX) |
| 486 | OBJDUMP = $(LLVM_PREFIX)llvm-objdump$(LLVM_SUFFIX) |
| 487 | READELF = $(LLVM_PREFIX)llvm-readelf$(LLVM_SUFFIX) |
| 488 | STRIP = $(LLVM_PREFIX)llvm-strip$(LLVM_SUFFIX) |
| 489 | else |
| 490 | CC = $(CROSS_COMPILE)gcc |
| 491 | LD = $(CROSS_COMPILE)ld |
| 492 | AR = $(CROSS_COMPILE)ar |
| 493 | NM = $(CROSS_COMPILE)nm |
| 494 | OBJCOPY = $(CROSS_COMPILE)objcopy |
| 495 | OBJDUMP = $(CROSS_COMPILE)objdump |
| 496 | READELF = $(CROSS_COMPILE)readelf |
| 497 | STRIP = $(CROSS_COMPILE)strip |
| 498 | endif |
| 499 | RUSTC = rustc |
| 500 | RUSTDOC = rustdoc |
| 501 | RUSTFMT = rustfmt |
| 502 | CLIPPY_DRIVER = clippy-driver |
| 503 | BINDGEN = bindgen |
| 504 | CARGO = cargo |
| 505 | PAHOLE = pahole |
| 506 | RESOLVE_BTFIDS = $(objtree)/tools/bpf/resolve_btfids/resolve_btfids |
| 507 | LEX = flex |
| 508 | YACC = bison |
| 509 | AWK = awk |
| 510 | INSTALLKERNEL := installkernel |
| 511 | DEPMOD = depmod |
| 512 | PERL = perl |
| 513 | PYTHON3 = python3 |
| 514 | CHECK = sparse |
| 515 | BASH = bash |
| 516 | KGZIP = gzip |
| 517 | KBZIP2 = bzip2 |
| 518 | KLZOP = lzop |
| 519 | LZMA = lzma |
| 520 | LZ4 = lz4c |
| 521 | XZ = xz |
| 522 | ZSTD = zstd |
| 523 | |
| 524 | PAHOLE_FLAGS = $(shell PAHOLE=$(PAHOLE) $(srctree)/scripts/pahole-flags.sh) |
| 525 | |
| 526 | CHECKFLAGS := -D__linux__ -Dlinux -D__STDC__ -Dunix -D__unix__ \ |
| 527 | -Wbitwise -Wno-return-void -Wno-unknown-attribute $(CF) |
| 528 | NOSTDINC_FLAGS := |
| 529 | CFLAGS_MODULE = |
| 530 | RUSTFLAGS_MODULE = |
| 531 | AFLAGS_MODULE = |
| 532 | LDFLAGS_MODULE = |
| 533 | CFLAGS_KERNEL = |
| 534 | RUSTFLAGS_KERNEL = |
| 535 | AFLAGS_KERNEL = |
| 536 | LDFLAGS_vmlinux = |
| 537 | |
| 538 | # Use USERINCLUDE when you must reference the UAPI directories only. |
| 539 | USERINCLUDE := \ |
| 540 | -I$(srctree)/arch/$(SRCARCH)/include/uapi \ |
| 541 | -I$(objtree)/arch/$(SRCARCH)/include/generated/uapi \ |
| 542 | -I$(srctree)/include/uapi \ |
| 543 | -I$(objtree)/include/generated/uapi \ |
| 544 | -include $(srctree)/include/linux/compiler-version.h \ |
| 545 | -include $(srctree)/include/linux/kconfig.h |
| 546 | |
| 547 | # Use LINUXINCLUDE when you must reference the include/ directory. |
| 548 | # Needed to be compatible with the O= option |
| 549 | LINUXINCLUDE := \ |
| 550 | -I$(srctree)/arch/$(SRCARCH)/include \ |
| 551 | -I$(objtree)/arch/$(SRCARCH)/include/generated \ |
| 552 | $(if $(building_out_of_srctree),-I$(srctree)/include) \ |
| 553 | -I$(objtree)/include \ |
| 554 | $(USERINCLUDE) |
| 555 | |
| 556 | KBUILD_AFLAGS := -D__ASSEMBLY__ -fno-PIE |
| 557 | KBUILD_CFLAGS := -Wall -Wundef -Werror=strict-prototypes -Wno-trigraphs \ |
| 558 | -fno-strict-aliasing -fno-common -fshort-wchar -fno-PIE \ |
| 559 | -Werror=implicit-function-declaration -Werror=implicit-int \ |
| 560 | -Werror=return-type -Wno-format-security -funsigned-char \ |
| 561 | -std=gnu11 |
| 562 | KBUILD_CPPFLAGS := -D__KERNEL__ |
| 563 | KBUILD_RUSTFLAGS := $(rust_common_flags) \ |
| 564 | --target=$(objtree)/scripts/target.json \ |
| 565 | -Cpanic=abort -Cembed-bitcode=n -Clto=n \ |
| 566 | -Cforce-unwind-tables=n -Ccodegen-units=1 \ |
| 567 | -Csymbol-mangling-version=v0 \ |
| 568 | -Crelocation-model=static \ |
| 569 | -Zfunction-sections=n \ |
| 570 | -Dclippy::float_arithmetic |
| 571 | |
| 572 | KBUILD_AFLAGS_KERNEL := |
| 573 | KBUILD_CFLAGS_KERNEL := |
| 574 | KBUILD_RUSTFLAGS_KERNEL := |
| 575 | KBUILD_AFLAGS_MODULE := -DMODULE |
| 576 | KBUILD_CFLAGS_MODULE := -DMODULE |
| 577 | KBUILD_RUSTFLAGS_MODULE := --cfg MODULE |
| 578 | KBUILD_LDFLAGS_MODULE := |
| 579 | KBUILD_LDFLAGS := |
| 580 | CLANG_FLAGS := |
| 581 | |
| 582 | ifeq ($(KBUILD_CLIPPY),1) |
| 583 | RUSTC_OR_CLIPPY_QUIET := CLIPPY |
| 584 | RUSTC_OR_CLIPPY = $(CLIPPY_DRIVER) |
| 585 | else |
| 586 | RUSTC_OR_CLIPPY_QUIET := RUSTC |
| 587 | RUSTC_OR_CLIPPY = $(RUSTC) |
| 588 | endif |
| 589 | |
| 590 | ifdef RUST_LIB_SRC |
| 591 | export RUST_LIB_SRC |
| 592 | endif |
| 593 | |
| 594 | # Allows the usage of unstable features in stable compilers. |
| 595 | export RUSTC_BOOTSTRAP := 1 |
| 596 | |
| 597 | export ARCH SRCARCH CONFIG_SHELL BASH HOSTCC KBUILD_HOSTCFLAGS CROSS_COMPILE LD CC HOSTPKG_CONFIG |
| 598 | export RUSTC RUSTDOC RUSTFMT RUSTC_OR_CLIPPY_QUIET RUSTC_OR_CLIPPY BINDGEN CARGO |
| 599 | export HOSTRUSTC KBUILD_HOSTRUSTFLAGS |
| 600 | export CPP AR NM STRIP OBJCOPY OBJDUMP READELF PAHOLE RESOLVE_BTFIDS LEX YACC AWK INSTALLKERNEL |
| 601 | export PERL PYTHON3 CHECK CHECKFLAGS MAKE UTS_MACHINE HOSTCXX |
| 602 | export KGZIP KBZIP2 KLZOP LZMA LZ4 XZ ZSTD |
| 603 | export KBUILD_HOSTCXXFLAGS KBUILD_HOSTLDFLAGS KBUILD_HOSTLDLIBS LDFLAGS_MODULE |
| 604 | export KBUILD_USERCFLAGS KBUILD_USERLDFLAGS |
| 605 | |
| 606 | export KBUILD_CPPFLAGS NOSTDINC_FLAGS LINUXINCLUDE OBJCOPYFLAGS KBUILD_LDFLAGS |
| 607 | export KBUILD_CFLAGS CFLAGS_KERNEL CFLAGS_MODULE |
| 608 | export KBUILD_RUSTFLAGS RUSTFLAGS_KERNEL RUSTFLAGS_MODULE |
| 609 | export KBUILD_AFLAGS AFLAGS_KERNEL AFLAGS_MODULE |
| 610 | export KBUILD_AFLAGS_MODULE KBUILD_CFLAGS_MODULE KBUILD_RUSTFLAGS_MODULE KBUILD_LDFLAGS_MODULE |
| 611 | export KBUILD_AFLAGS_KERNEL KBUILD_CFLAGS_KERNEL KBUILD_RUSTFLAGS_KERNEL |
| 612 | export PAHOLE_FLAGS |
| 613 | |
| 614 | # Files to ignore in find ... statements |
| 615 | |
| 616 | export RCS_FIND_IGNORE := \( -name SCCS -o -name BitKeeper -o -name .svn -o \ |
| 617 | -name CVS -o -name .pc -o -name .hg -o -name .git \) \ |
| 618 | -prune -o |
| 619 | export RCS_TAR_IGNORE := --exclude SCCS --exclude BitKeeper --exclude .svn \ |
| 620 | --exclude CVS --exclude .pc --exclude .hg --exclude .git |
| 621 | |
| 622 | # =========================================================================== |
| 623 | # Rules shared between *config targets and build targets |
| 624 | |
| 625 | # Basic helpers built in scripts/basic/ |
| 626 | PHONY += scripts_basic |
| 627 | scripts_basic: |
| 628 | $(Q)$(MAKE) $(build)=scripts/basic |
| 629 | |
| 630 | PHONY += outputmakefile |
| 631 | ifdef building_out_of_srctree |
| 632 | # Before starting out-of-tree build, make sure the source tree is clean. |
| 633 | # outputmakefile generates a Makefile in the output directory, if using a |
| 634 | # separate output directory. This allows convenient use of make in the |
| 635 | # output directory. |
| 636 | # At the same time when output Makefile generated, generate .gitignore to |
| 637 | # ignore whole output directory |
| 638 | |
| 639 | quiet_cmd_makefile = GEN Makefile |
| 640 | cmd_makefile = { \ |
| 641 | echo "\# Automatically generated by $(srctree)/Makefile: don't edit"; \ |
| 642 | echo "include $(srctree)/Makefile"; \ |
| 643 | } > Makefile |
| 644 | |
| 645 | outputmakefile: |
| 646 | @if [ -f $(srctree)/.config -o \ |
| 647 | -d $(srctree)/include/config -o \ |
| 648 | -d $(srctree)/arch/$(SRCARCH)/include/generated ]; then \ |
| 649 | echo >&2 "***"; \ |
| 650 | echo >&2 "*** The source tree is not clean, please run 'make$(if $(findstring command line, $(origin ARCH)), ARCH=$(ARCH)) mrproper'"; \ |
| 651 | echo >&2 "*** in $(abs_srctree)";\ |
| 652 | echo >&2 "***"; \ |
| 653 | false; \ |
| 654 | fi |
| 655 | $(Q)ln -fsn $(srctree) source |
| 656 | $(call cmd,makefile) |
| 657 | $(Q)test -e .gitignore || \ |
| 658 | { echo "# this is build directory, ignore it"; echo "*"; } > .gitignore |
| 659 | endif |
| 660 | |
| 661 | # The expansion should be delayed until arch/$(SRCARCH)/Makefile is included. |
| 662 | # Some architectures define CROSS_COMPILE in arch/$(SRCARCH)/Makefile. |
| 663 | # CC_VERSION_TEXT is referenced from Kconfig (so it needs export), |
| 664 | # and from include/config/auto.conf.cmd to detect the compiler upgrade. |
| 665 | CC_VERSION_TEXT = $(subst $(pound),,$(shell LC_ALL=C $(CC) --version 2>/dev/null | head -n 1)) |
| 666 | |
| 667 | ifneq ($(findstring clang,$(CC_VERSION_TEXT)),) |
| 668 | include $(srctree)/scripts/Makefile.clang |
| 669 | endif |
| 670 | |
| 671 | # Include this also for config targets because some architectures need |
| 672 | # cc-cross-prefix to determine CROSS_COMPILE. |
| 673 | ifdef need-compiler |
| 674 | include $(srctree)/scripts/Makefile.compiler |
| 675 | endif |
| 676 | |
| 677 | ifdef config-build |
| 678 | # =========================================================================== |
| 679 | # *config targets only - make sure prerequisites are updated, and descend |
| 680 | # in scripts/kconfig to make the *config target |
| 681 | |
| 682 | # Read arch specific Makefile to set KBUILD_DEFCONFIG as needed. |
| 683 | # KBUILD_DEFCONFIG may point out an alternative default configuration |
| 684 | # used for 'make defconfig' |
| 685 | include $(srctree)/arch/$(SRCARCH)/Makefile |
| 686 | export KBUILD_DEFCONFIG KBUILD_KCONFIG CC_VERSION_TEXT |
| 687 | |
| 688 | config: outputmakefile scripts_basic FORCE |
| 689 | $(Q)$(MAKE) $(build)=scripts/kconfig $@ |
| 690 | |
| 691 | %config: outputmakefile scripts_basic FORCE |
| 692 | $(Q)$(MAKE) $(build)=scripts/kconfig $@ |
| 693 | |
| 694 | else #!config-build |
| 695 | # =========================================================================== |
| 696 | # Build targets only - this includes vmlinux, arch specific targets, clean |
| 697 | # targets and others. In general all targets except *config targets. |
| 698 | |
| 699 | # If building an external module we do not care about the all: rule |
| 700 | # but instead __all depend on modules |
| 701 | PHONY += all |
| 702 | ifeq ($(KBUILD_EXTMOD),) |
| 703 | __all: all |
| 704 | else |
| 705 | __all: modules |
| 706 | endif |
| 707 | |
| 708 | targets := |
| 709 | |
| 710 | # Decide whether to build built-in, modular, or both. |
| 711 | # Normally, just do built-in. |
| 712 | |
| 713 | KBUILD_MODULES := |
| 714 | KBUILD_BUILTIN := 1 |
| 715 | |
| 716 | # If we have only "make modules", don't compile built-in objects. |
| 717 | ifeq ($(MAKECMDGOALS),modules) |
| 718 | KBUILD_BUILTIN := |
| 719 | endif |
| 720 | |
| 721 | # If we have "make <whatever> modules", compile modules |
| 722 | # in addition to whatever we do anyway. |
| 723 | # Just "make" or "make all" shall build modules as well |
| 724 | |
| 725 | ifneq ($(filter all modules nsdeps %compile_commands.json clang-%,$(MAKECMDGOALS)),) |
| 726 | KBUILD_MODULES := 1 |
| 727 | endif |
| 728 | |
| 729 | ifeq ($(MAKECMDGOALS),) |
| 730 | KBUILD_MODULES := 1 |
| 731 | endif |
| 732 | |
| 733 | export KBUILD_MODULES KBUILD_BUILTIN |
| 734 | |
| 735 | ifdef need-config |
| 736 | include include/config/auto.conf |
| 737 | endif |
| 738 | |
| 739 | ifeq ($(KBUILD_EXTMOD),) |
| 740 | # Objects we will link into vmlinux / subdirs we need to visit |
| 741 | core-y := |
| 742 | drivers-y := |
| 743 | libs-y := lib/ |
| 744 | endif # KBUILD_EXTMOD |
| 745 | |
| 746 | # The all: target is the default when no target is given on the |
| 747 | # command line. |
| 748 | # This allow a user to issue only 'make' to build a kernel including modules |
| 749 | # Defaults to vmlinux, but the arch makefile usually adds further targets |
| 750 | all: vmlinux |
| 751 | |
| 752 | CFLAGS_GCOV := -fprofile-arcs -ftest-coverage |
| 753 | ifdef CONFIG_CC_IS_GCC |
| 754 | CFLAGS_GCOV += -fno-tree-loop-im |
| 755 | endif |
| 756 | export CFLAGS_GCOV |
| 757 | |
| 758 | # The arch Makefiles can override CC_FLAGS_FTRACE. We may also append it later. |
| 759 | ifdef CONFIG_FUNCTION_TRACER |
| 760 | CC_FLAGS_FTRACE := -pg |
| 761 | endif |
| 762 | |
| 763 | include $(srctree)/arch/$(SRCARCH)/Makefile |
| 764 | |
| 765 | ifdef need-config |
| 766 | ifdef may-sync-config |
| 767 | # Read in dependencies to all Kconfig* files, make sure to run syncconfig if |
| 768 | # changes are detected. This should be included after arch/$(SRCARCH)/Makefile |
| 769 | # because some architectures define CROSS_COMPILE there. |
| 770 | include include/config/auto.conf.cmd |
| 771 | |
| 772 | $(KCONFIG_CONFIG): |
| 773 | @echo >&2 '***' |
| 774 | @echo >&2 '*** Configuration file "$@" not found!' |
| 775 | @echo >&2 '***' |
| 776 | @echo >&2 '*** Please run some configurator (e.g. "make oldconfig" or' |
| 777 | @echo >&2 '*** "make menuconfig" or "make xconfig").' |
| 778 | @echo >&2 '***' |
| 779 | @/bin/false |
| 780 | |
| 781 | # The actual configuration files used during the build are stored in |
| 782 | # include/generated/ and include/config/. Update them if .config is newer than |
| 783 | # include/config/auto.conf (which mirrors .config). |
| 784 | # |
| 785 | # This exploits the 'multi-target pattern rule' trick. |
| 786 | # The syncconfig should be executed only once to make all the targets. |
| 787 | # (Note: use the grouped target '&:' when we bump to GNU Make 4.3) |
| 788 | # |
| 789 | # Do not use $(call cmd,...) here. That would suppress prompts from syncconfig, |
| 790 | # so you cannot notice that Kconfig is waiting for the user input. |
| 791 | %/config/auto.conf %/config/auto.conf.cmd %/generated/autoconf.h %/generated/rustc_cfg: $(KCONFIG_CONFIG) |
| 792 | $(Q)$(kecho) " SYNC $@" |
| 793 | $(Q)$(MAKE) -f $(srctree)/Makefile syncconfig |
| 794 | else # !may-sync-config |
| 795 | # External modules and some install targets need include/generated/autoconf.h |
| 796 | # and include/config/auto.conf but do not care if they are up-to-date. |
| 797 | # Use auto.conf to trigger the test |
| 798 | PHONY += include/config/auto.conf |
| 799 | |
| 800 | include/config/auto.conf: |
| 801 | @test -e include/generated/autoconf.h -a -e $@ || ( \ |
| 802 | echo >&2; \ |
| 803 | echo >&2 " ERROR: Kernel configuration is invalid."; \ |
| 804 | echo >&2 " include/generated/autoconf.h or $@ are missing.";\ |
| 805 | echo >&2 " Run 'make oldconfig && make prepare' on kernel src to fix it."; \ |
| 806 | echo >&2 ; \ |
| 807 | /bin/false) |
| 808 | |
| 809 | endif # may-sync-config |
| 810 | endif # need-config |
| 811 | |
| 812 | KBUILD_CFLAGS += -fno-delete-null-pointer-checks |
| 813 | KBUILD_CFLAGS += $(call cc-disable-warning,frame-address,) |
| 814 | KBUILD_CFLAGS += $(call cc-disable-warning, format-truncation) |
| 815 | KBUILD_CFLAGS += $(call cc-disable-warning, format-overflow) |
| 816 | KBUILD_CFLAGS += $(call cc-disable-warning, address-of-packed-member) |
| 817 | |
| 818 | ifdef CONFIG_CC_OPTIMIZE_FOR_PERFORMANCE |
| 819 | KBUILD_CFLAGS += -O2 |
| 820 | KBUILD_RUSTFLAGS += -Copt-level=2 |
| 821 | else ifdef CONFIG_CC_OPTIMIZE_FOR_SIZE |
| 822 | KBUILD_CFLAGS += -Os |
| 823 | KBUILD_RUSTFLAGS += -Copt-level=s |
| 824 | endif |
| 825 | |
| 826 | # Always set `debug-assertions` and `overflow-checks` because their default |
| 827 | # depends on `opt-level` and `debug-assertions`, respectively. |
| 828 | KBUILD_RUSTFLAGS += -Cdebug-assertions=$(if $(CONFIG_RUST_DEBUG_ASSERTIONS),y,n) |
| 829 | KBUILD_RUSTFLAGS += -Coverflow-checks=$(if $(CONFIG_RUST_OVERFLOW_CHECKS),y,n) |
| 830 | |
| 831 | # Tell gcc to never replace conditional load with a non-conditional one |
| 832 | ifdef CONFIG_CC_IS_GCC |
| 833 | # gcc-10 renamed --param=allow-store-data-races=0 to |
| 834 | # -fno-allow-store-data-races. |
| 835 | KBUILD_CFLAGS += $(call cc-option,--param=allow-store-data-races=0) |
| 836 | KBUILD_CFLAGS += $(call cc-option,-fno-allow-store-data-races) |
| 837 | endif |
| 838 | |
| 839 | ifdef CONFIG_READABLE_ASM |
| 840 | # Disable optimizations that make assembler listings hard to read. |
| 841 | # reorder blocks reorders the control in the function |
| 842 | # ipa clone creates specialized cloned functions |
| 843 | # partial inlining inlines only parts of functions |
| 844 | KBUILD_CFLAGS += -fno-reorder-blocks -fno-ipa-cp-clone -fno-partial-inlining |
| 845 | endif |
| 846 | |
| 847 | ifneq ($(CONFIG_FRAME_WARN),0) |
| 848 | KBUILD_CFLAGS += -Wframe-larger-than=$(CONFIG_FRAME_WARN) |
| 849 | endif |
| 850 | |
| 851 | stackp-flags-y := -fno-stack-protector |
| 852 | stackp-flags-$(CONFIG_STACKPROTECTOR) := -fstack-protector |
| 853 | stackp-flags-$(CONFIG_STACKPROTECTOR_STRONG) := -fstack-protector-strong |
| 854 | |
| 855 | KBUILD_CFLAGS += $(stackp-flags-y) |
| 856 | |
| 857 | KBUILD_CPPFLAGS-$(CONFIG_WERROR) += -Werror |
| 858 | KBUILD_CPPFLAGS += $(KBUILD_CPPFLAGS-y) |
| 859 | KBUILD_CFLAGS-$(CONFIG_CC_NO_ARRAY_BOUNDS) += -Wno-array-bounds |
| 860 | |
| 861 | KBUILD_RUSTFLAGS-$(CONFIG_WERROR) += -Dwarnings |
| 862 | KBUILD_RUSTFLAGS += $(KBUILD_RUSTFLAGS-y) |
| 863 | |
| 864 | ifdef CONFIG_CC_IS_CLANG |
| 865 | # The kernel builds with '-std=gnu11' so use of GNU extensions is acceptable. |
| 866 | KBUILD_CFLAGS += -Wno-gnu |
| 867 | else |
| 868 | |
| 869 | # gcc inanely warns about local variables called 'main' |
| 870 | KBUILD_CFLAGS += -Wno-main |
| 871 | endif |
| 872 | |
| 873 | # These warnings generated too much noise in a regular build. |
| 874 | # Use make W=1 to enable them (see scripts/Makefile.extrawarn) |
| 875 | KBUILD_CFLAGS += $(call cc-disable-warning, unused-but-set-variable) |
| 876 | KBUILD_CFLAGS += $(call cc-disable-warning, unused-const-variable) |
| 877 | |
| 878 | # These result in bogus false positives |
| 879 | KBUILD_CFLAGS += $(call cc-disable-warning, dangling-pointer) |
| 880 | |
| 881 | ifdef CONFIG_FRAME_POINTER |
| 882 | KBUILD_CFLAGS += -fno-omit-frame-pointer -fno-optimize-sibling-calls |
| 883 | KBUILD_RUSTFLAGS += -Cforce-frame-pointers=y |
| 884 | else |
| 885 | # Some targets (ARM with Thumb2, for example), can't be built with frame |
| 886 | # pointers. For those, we don't have FUNCTION_TRACER automatically |
| 887 | # select FRAME_POINTER. However, FUNCTION_TRACER adds -pg, and this is |
| 888 | # incompatible with -fomit-frame-pointer with current GCC, so we don't use |
| 889 | # -fomit-frame-pointer with FUNCTION_TRACER. |
| 890 | # In the Rust target specification, "frame-pointer" is set explicitly |
| 891 | # to "may-omit". |
| 892 | ifndef CONFIG_FUNCTION_TRACER |
| 893 | KBUILD_CFLAGS += -fomit-frame-pointer |
| 894 | endif |
| 895 | endif |
| 896 | |
| 897 | # Initialize all stack variables with a 0xAA pattern. |
| 898 | ifdef CONFIG_INIT_STACK_ALL_PATTERN |
| 899 | KBUILD_CFLAGS += -ftrivial-auto-var-init=pattern |
| 900 | endif |
| 901 | |
| 902 | # Initialize all stack variables with a zero value. |
| 903 | ifdef CONFIG_INIT_STACK_ALL_ZERO |
| 904 | KBUILD_CFLAGS += -ftrivial-auto-var-init=zero |
| 905 | ifdef CONFIG_CC_HAS_AUTO_VAR_INIT_ZERO_ENABLER |
| 906 | # https://github.com/llvm/llvm-project/issues/44842 |
| 907 | CC_AUTO_VAR_INIT_ZERO_ENABLER := -enable-trivial-auto-var-init-zero-knowing-it-will-be-removed-from-clang |
| 908 | export CC_AUTO_VAR_INIT_ZERO_ENABLER |
| 909 | KBUILD_CFLAGS += $(CC_AUTO_VAR_INIT_ZERO_ENABLER) |
| 910 | endif |
| 911 | endif |
| 912 | |
| 913 | # While VLAs have been removed, GCC produces unreachable stack probes |
| 914 | # for the randomize_kstack_offset feature. Disable it for all compilers. |
| 915 | KBUILD_CFLAGS += $(call cc-option, -fno-stack-clash-protection) |
| 916 | |
| 917 | # Clear used registers at func exit (to reduce data lifetime and ROP gadgets). |
| 918 | ifdef CONFIG_ZERO_CALL_USED_REGS |
| 919 | KBUILD_CFLAGS += -fzero-call-used-regs=used-gpr |
| 920 | endif |
| 921 | |
| 922 | ifdef CONFIG_FUNCTION_TRACER |
| 923 | ifdef CONFIG_FTRACE_MCOUNT_USE_CC |
| 924 | CC_FLAGS_FTRACE += -mrecord-mcount |
| 925 | ifdef CONFIG_HAVE_NOP_MCOUNT |
| 926 | ifeq ($(call cc-option-yn, -mnop-mcount),y) |
| 927 | CC_FLAGS_FTRACE += -mnop-mcount |
| 928 | CC_FLAGS_USING += -DCC_USING_NOP_MCOUNT |
| 929 | endif |
| 930 | endif |
| 931 | endif |
| 932 | ifdef CONFIG_FTRACE_MCOUNT_USE_OBJTOOL |
| 933 | ifdef CONFIG_HAVE_OBJTOOL_NOP_MCOUNT |
| 934 | CC_FLAGS_USING += -DCC_USING_NOP_MCOUNT |
| 935 | endif |
| 936 | endif |
| 937 | ifdef CONFIG_FTRACE_MCOUNT_USE_RECORDMCOUNT |
| 938 | ifdef CONFIG_HAVE_C_RECORDMCOUNT |
| 939 | BUILD_C_RECORDMCOUNT := y |
| 940 | export BUILD_C_RECORDMCOUNT |
| 941 | endif |
| 942 | endif |
| 943 | ifdef CONFIG_HAVE_FENTRY |
| 944 | # s390-linux-gnu-gcc did not support -mfentry until gcc-9. |
| 945 | ifeq ($(call cc-option-yn, -mfentry),y) |
| 946 | CC_FLAGS_FTRACE += -mfentry |
| 947 | CC_FLAGS_USING += -DCC_USING_FENTRY |
| 948 | endif |
| 949 | endif |
| 950 | export CC_FLAGS_FTRACE |
| 951 | KBUILD_CFLAGS += $(CC_FLAGS_FTRACE) $(CC_FLAGS_USING) |
| 952 | KBUILD_AFLAGS += $(CC_FLAGS_USING) |
| 953 | endif |
| 954 | |
| 955 | # We trigger additional mismatches with less inlining |
| 956 | ifdef CONFIG_DEBUG_SECTION_MISMATCH |
| 957 | KBUILD_CFLAGS += -fno-inline-functions-called-once |
| 958 | endif |
| 959 | |
| 960 | # `rustc`'s `-Zfunction-sections` applies to data too (as of 1.59.0). |
| 961 | ifdef CONFIG_LD_DEAD_CODE_DATA_ELIMINATION |
| 962 | KBUILD_CFLAGS_KERNEL += -ffunction-sections -fdata-sections |
| 963 | KBUILD_RUSTFLAGS_KERNEL += -Zfunction-sections=y |
| 964 | LDFLAGS_vmlinux += --gc-sections |
| 965 | endif |
| 966 | |
| 967 | ifdef CONFIG_SHADOW_CALL_STACK |
| 968 | ifndef CONFIG_DYNAMIC_SCS |
| 969 | CC_FLAGS_SCS := -fsanitize=shadow-call-stack |
| 970 | KBUILD_CFLAGS += $(CC_FLAGS_SCS) |
| 971 | endif |
| 972 | export CC_FLAGS_SCS |
| 973 | endif |
| 974 | |
| 975 | ifdef CONFIG_LTO_CLANG |
| 976 | ifdef CONFIG_LTO_CLANG_THIN |
| 977 | CC_FLAGS_LTO := -flto=thin -fsplit-lto-unit |
| 978 | KBUILD_LDFLAGS += --thinlto-cache-dir=$(extmod_prefix).thinlto-cache |
| 979 | else |
| 980 | CC_FLAGS_LTO := -flto |
| 981 | endif |
| 982 | CC_FLAGS_LTO += -fvisibility=hidden |
| 983 | |
| 984 | # Limit inlining across translation units to reduce binary size |
| 985 | KBUILD_LDFLAGS += -mllvm -import-instr-limit=5 |
| 986 | |
| 987 | # Check for frame size exceeding threshold during prolog/epilog insertion |
| 988 | # when using lld < 13.0.0. |
| 989 | ifneq ($(CONFIG_FRAME_WARN),0) |
| 990 | ifeq ($(call test-lt, $(CONFIG_LLD_VERSION), 130000),y) |
| 991 | KBUILD_LDFLAGS += -plugin-opt=-warn-stack-size=$(CONFIG_FRAME_WARN) |
| 992 | endif |
| 993 | endif |
| 994 | endif |
| 995 | |
| 996 | ifdef CONFIG_LTO |
| 997 | KBUILD_CFLAGS += -fno-lto $(CC_FLAGS_LTO) |
| 998 | KBUILD_AFLAGS += -fno-lto |
| 999 | export CC_FLAGS_LTO |
| 1000 | endif |
| 1001 | |
| 1002 | ifdef CONFIG_CFI_CLANG |
| 1003 | CC_FLAGS_CFI := -fsanitize=kcfi |
| 1004 | KBUILD_CFLAGS += $(CC_FLAGS_CFI) |
| 1005 | export CC_FLAGS_CFI |
| 1006 | endif |
| 1007 | |
| 1008 | ifneq ($(CONFIG_FUNCTION_ALIGNMENT),0) |
| 1009 | KBUILD_CFLAGS += -falign-functions=$(CONFIG_FUNCTION_ALIGNMENT) |
| 1010 | endif |
| 1011 | |
| 1012 | # arch Makefile may override CC so keep this after arch Makefile is included |
| 1013 | NOSTDINC_FLAGS += -nostdinc |
| 1014 | |
| 1015 | # warn about C99 declaration after statement |
| 1016 | KBUILD_CFLAGS += -Wdeclaration-after-statement |
| 1017 | |
| 1018 | # Variable Length Arrays (VLAs) should not be used anywhere in the kernel |
| 1019 | KBUILD_CFLAGS += -Wvla |
| 1020 | |
| 1021 | # disable pointer signed / unsigned warnings in gcc 4.0 |
| 1022 | KBUILD_CFLAGS += -Wno-pointer-sign |
| 1023 | |
| 1024 | # In order to make sure new function cast mismatches are not introduced |
| 1025 | # in the kernel (to avoid tripping CFI checking), the kernel should be |
| 1026 | # globally built with -Wcast-function-type. |
| 1027 | KBUILD_CFLAGS += $(call cc-option, -Wcast-function-type) |
| 1028 | |
| 1029 | # disable stringop warnings in gcc 8+ |
| 1030 | KBUILD_CFLAGS += $(call cc-disable-warning, stringop-truncation) |
| 1031 | |
| 1032 | # We'll want to enable this eventually, but it's not going away for 5.7 at least |
| 1033 | KBUILD_CFLAGS += $(call cc-disable-warning, stringop-overflow) |
| 1034 | |
| 1035 | # Another good warning that we'll want to enable eventually |
| 1036 | KBUILD_CFLAGS += $(call cc-disable-warning, restrict) |
| 1037 | |
| 1038 | # Enabled with W=2, disabled by default as noisy |
| 1039 | ifdef CONFIG_CC_IS_GCC |
| 1040 | KBUILD_CFLAGS += -Wno-maybe-uninitialized |
| 1041 | endif |
| 1042 | |
| 1043 | # The allocators already balk at large sizes, so silence the compiler |
| 1044 | # warnings for bounds checks involving those possible values. While |
| 1045 | # -Wno-alloc-size-larger-than would normally be used here, earlier versions |
| 1046 | # of gcc (<9.1) weirdly don't handle the option correctly when _other_ |
| 1047 | # warnings are produced (?!). Using -Walloc-size-larger-than=SIZE_MAX |
| 1048 | # doesn't work (as it is documented to), silently resolving to "0" prior to |
| 1049 | # version 9.1 (and producing an error more recently). Numeric values larger |
| 1050 | # than PTRDIFF_MAX also don't work prior to version 9.1, which are silently |
| 1051 | # ignored, continuing to default to PTRDIFF_MAX. So, left with no other |
| 1052 | # choice, we must perform a versioned check to disable this warning. |
| 1053 | # https://lore.kernel.org/lkml/20210824115859.187f272f@canb.auug.org.au |
| 1054 | KBUILD_CFLAGS-$(call gcc-min-version, 90100) += -Wno-alloc-size-larger-than |
| 1055 | KBUILD_CFLAGS += $(KBUILD_CFLAGS-y) $(CONFIG_CC_IMPLICIT_FALLTHROUGH) |
| 1056 | |
| 1057 | # disable invalid "can't wrap" optimizations for signed / pointers |
| 1058 | KBUILD_CFLAGS += -fno-strict-overflow |
| 1059 | |
| 1060 | # Make sure -fstack-check isn't enabled (like gentoo apparently did) |
| 1061 | KBUILD_CFLAGS += -fno-stack-check |
| 1062 | |
| 1063 | # conserve stack if available |
| 1064 | ifdef CONFIG_CC_IS_GCC |
| 1065 | KBUILD_CFLAGS += -fconserve-stack |
| 1066 | endif |
| 1067 | |
| 1068 | # Prohibit date/time macros, which would make the build non-deterministic |
| 1069 | KBUILD_CFLAGS += -Werror=date-time |
| 1070 | |
| 1071 | # enforce correct pointer usage |
| 1072 | KBUILD_CFLAGS += $(call cc-option,-Werror=incompatible-pointer-types) |
| 1073 | |
| 1074 | # Require designated initializers for all marked structures |
| 1075 | KBUILD_CFLAGS += $(call cc-option,-Werror=designated-init) |
| 1076 | |
| 1077 | # change __FILE__ to the relative path from the srctree |
| 1078 | KBUILD_CPPFLAGS += $(call cc-option,-fmacro-prefix-map=$(srctree)/=) |
| 1079 | |
| 1080 | # include additional Makefiles when needed |
| 1081 | include-y := scripts/Makefile.extrawarn |
| 1082 | include-$(CONFIG_DEBUG_INFO) += scripts/Makefile.debug |
| 1083 | include-$(CONFIG_KASAN) += scripts/Makefile.kasan |
| 1084 | include-$(CONFIG_KCSAN) += scripts/Makefile.kcsan |
| 1085 | include-$(CONFIG_KMSAN) += scripts/Makefile.kmsan |
| 1086 | include-$(CONFIG_UBSAN) += scripts/Makefile.ubsan |
| 1087 | include-$(CONFIG_KCOV) += scripts/Makefile.kcov |
| 1088 | include-$(CONFIG_RANDSTRUCT) += scripts/Makefile.randstruct |
| 1089 | include-$(CONFIG_GCC_PLUGINS) += scripts/Makefile.gcc-plugins |
| 1090 | |
| 1091 | include $(addprefix $(srctree)/, $(include-y)) |
| 1092 | |
| 1093 | # scripts/Makefile.gcc-plugins is intentionally included last. |
| 1094 | # Do not add $(call cc-option,...) below this line. When you build the kernel |
| 1095 | # from the clean source tree, the GCC plugins do not exist at this point. |
| 1096 | |
| 1097 | # Add user supplied CPPFLAGS, AFLAGS, CFLAGS and RUSTFLAGS as the last assignments |
| 1098 | KBUILD_CPPFLAGS += $(KCPPFLAGS) |
| 1099 | KBUILD_AFLAGS += $(KAFLAGS) |
| 1100 | KBUILD_CFLAGS += $(KCFLAGS) |
| 1101 | KBUILD_RUSTFLAGS += $(KRUSTFLAGS) |
| 1102 | |
| 1103 | KBUILD_LDFLAGS_MODULE += --build-id=sha1 |
| 1104 | LDFLAGS_vmlinux += --build-id=sha1 |
| 1105 | |
| 1106 | KBUILD_LDFLAGS += -z noexecstack |
| 1107 | ifeq ($(CONFIG_LD_IS_BFD),y) |
| 1108 | KBUILD_LDFLAGS += $(call ld-option,--no-warn-rwx-segments) |
| 1109 | endif |
| 1110 | |
| 1111 | ifeq ($(CONFIG_STRIP_ASM_SYMS),y) |
| 1112 | LDFLAGS_vmlinux += -X |
| 1113 | endif |
| 1114 | |
| 1115 | ifeq ($(CONFIG_RELR),y) |
| 1116 | # ld.lld before 15 did not support -z pack-relative-relocs. |
| 1117 | LDFLAGS_vmlinux += $(call ld-option,--pack-dyn-relocs=relr,-z pack-relative-relocs) |
| 1118 | endif |
| 1119 | |
| 1120 | # We never want expected sections to be placed heuristically by the |
| 1121 | # linker. All sections should be explicitly named in the linker script. |
| 1122 | ifdef CONFIG_LD_ORPHAN_WARN |
| 1123 | LDFLAGS_vmlinux += --orphan-handling=$(CONFIG_LD_ORPHAN_WARN_LEVEL) |
| 1124 | endif |
| 1125 | |
| 1126 | # Align the bit size of userspace programs with the kernel |
| 1127 | KBUILD_USERCFLAGS += $(filter -m32 -m64 --target=%, $(KBUILD_CFLAGS)) |
| 1128 | KBUILD_USERLDFLAGS += $(filter -m32 -m64 --target=%, $(KBUILD_CFLAGS)) |
| 1129 | |
| 1130 | # make the checker run with the right architecture |
| 1131 | CHECKFLAGS += --arch=$(ARCH) |
| 1132 | |
| 1133 | # insure the checker run with the right endianness |
| 1134 | CHECKFLAGS += $(if $(CONFIG_CPU_BIG_ENDIAN),-mbig-endian,-mlittle-endian) |
| 1135 | |
| 1136 | # the checker needs the correct machine size |
| 1137 | CHECKFLAGS += $(if $(CONFIG_64BIT),-m64,-m32) |
| 1138 | |
| 1139 | # Default kernel image to build when no specific target is given. |
| 1140 | # KBUILD_IMAGE may be overruled on the command line or |
| 1141 | # set in the environment |
| 1142 | # Also any assignments in arch/$(ARCH)/Makefile take precedence over |
| 1143 | # this default value |
| 1144 | export KBUILD_IMAGE ?= vmlinux |
| 1145 | |
| 1146 | # |
| 1147 | # INSTALL_PATH specifies where to place the updated kernel and system map |
| 1148 | # images. Default is /boot, but you can set it to other values |
| 1149 | export INSTALL_PATH ?= /boot |
| 1150 | |
| 1151 | # |
| 1152 | # INSTALL_DTBS_PATH specifies a prefix for relocations required by build roots. |
| 1153 | # Like INSTALL_MOD_PATH, it isn't defined in the Makefile, but can be passed as |
| 1154 | # an argument if needed. Otherwise it defaults to the kernel install path |
| 1155 | # |
| 1156 | export INSTALL_DTBS_PATH ?= $(INSTALL_PATH)/dtbs/$(KERNELRELEASE) |
| 1157 | |
| 1158 | # |
| 1159 | # INSTALL_MOD_PATH specifies a prefix to MODLIB for module directory |
| 1160 | # relocations required by build roots. This is not defined in the |
| 1161 | # makefile but the argument can be passed to make if needed. |
| 1162 | # |
| 1163 | |
| 1164 | MODLIB = $(INSTALL_MOD_PATH)/lib/modules/$(KERNELRELEASE) |
| 1165 | export MODLIB |
| 1166 | |
| 1167 | PHONY += prepare0 |
| 1168 | |
| 1169 | export extmod_prefix = $(if $(KBUILD_EXTMOD),$(KBUILD_EXTMOD)/) |
| 1170 | export MODORDER := $(extmod_prefix)modules.order |
| 1171 | export MODULES_NSDEPS := $(extmod_prefix)modules.nsdeps |
| 1172 | |
| 1173 | ifeq ($(KBUILD_EXTMOD),) |
| 1174 | |
| 1175 | build-dir := . |
| 1176 | clean-dirs := $(sort . Documentation \ |
| 1177 | $(patsubst %/,%,$(filter %/, $(core-) \ |
| 1178 | $(drivers-) $(libs-)))) |
| 1179 | |
| 1180 | export ARCH_CORE := $(core-y) |
| 1181 | export ARCH_LIB := $(filter %/, $(libs-y)) |
| 1182 | export ARCH_DRIVERS := $(drivers-y) $(drivers-m) |
| 1183 | # Externally visible symbols (used by link-vmlinux.sh) |
| 1184 | |
| 1185 | KBUILD_VMLINUX_OBJS := ./built-in.a |
| 1186 | ifdef CONFIG_MODULES |
| 1187 | KBUILD_VMLINUX_OBJS += $(patsubst %/, %/lib.a, $(filter %/, $(libs-y))) |
| 1188 | KBUILD_VMLINUX_LIBS := $(filter-out %/, $(libs-y)) |
| 1189 | else |
| 1190 | KBUILD_VMLINUX_LIBS := $(patsubst %/,%/lib.a, $(libs-y)) |
| 1191 | endif |
| 1192 | |
| 1193 | export KBUILD_VMLINUX_LIBS |
| 1194 | export KBUILD_LDS := arch/$(SRCARCH)/kernel/vmlinux.lds |
| 1195 | |
| 1196 | # Recurse until adjust_autoksyms.sh is satisfied |
| 1197 | PHONY += autoksyms_recursive |
| 1198 | ifdef CONFIG_TRIM_UNUSED_KSYMS |
| 1199 | # For the kernel to actually contain only the needed exported symbols, |
| 1200 | # we have to build modules as well to determine what those symbols are. |
| 1201 | # (this can be evaluated only once include/config/auto.conf has been included) |
| 1202 | KBUILD_MODULES := 1 |
| 1203 | |
| 1204 | autoksyms_recursive: $(build-dir) modules.order |
| 1205 | $(Q)$(CONFIG_SHELL) $(srctree)/scripts/adjust_autoksyms.sh \ |
| 1206 | "$(MAKE) -f $(srctree)/Makefile autoksyms_recursive" |
| 1207 | endif |
| 1208 | |
| 1209 | autoksyms_h := $(if $(CONFIG_TRIM_UNUSED_KSYMS), include/generated/autoksyms.h) |
| 1210 | |
| 1211 | quiet_cmd_autoksyms_h = GEN $@ |
| 1212 | cmd_autoksyms_h = mkdir -p $(dir $@); \ |
| 1213 | $(CONFIG_SHELL) $(srctree)/scripts/gen_autoksyms.sh $@ |
| 1214 | |
| 1215 | $(autoksyms_h): |
| 1216 | $(call cmd,autoksyms_h) |
| 1217 | |
| 1218 | # '$(AR) mPi' needs 'T' to workaround the bug of llvm-ar <= 14 |
| 1219 | quiet_cmd_ar_vmlinux.a = AR $@ |
| 1220 | cmd_ar_vmlinux.a = \ |
| 1221 | rm -f $@; \ |
| 1222 | $(AR) cDPrST $@ $(KBUILD_VMLINUX_OBJS); \ |
| 1223 | $(AR) mPiT $$($(AR) t $@ | sed -n 1p) $@ $$($(AR) t $@ | grep -F -f $(srctree)/scripts/head-object-list.txt) |
| 1224 | |
| 1225 | targets += vmlinux.a |
| 1226 | vmlinux.a: $(KBUILD_VMLINUX_OBJS) scripts/head-object-list.txt autoksyms_recursive FORCE |
| 1227 | $(call if_changed,ar_vmlinux.a) |
| 1228 | |
| 1229 | PHONY += vmlinux_o |
| 1230 | vmlinux_o: vmlinux.a $(KBUILD_VMLINUX_LIBS) |
| 1231 | $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.vmlinux_o |
| 1232 | |
| 1233 | vmlinux.o modules.builtin.modinfo modules.builtin: vmlinux_o |
| 1234 | @: |
| 1235 | |
| 1236 | PHONY += vmlinux |
| 1237 | # LDFLAGS_vmlinux in the top Makefile defines linker flags for the top vmlinux, |
| 1238 | # not for decompressors. LDFLAGS_vmlinux in arch/*/boot/compressed/Makefile is |
| 1239 | # unrelated; the decompressors just happen to have the same base name, |
| 1240 | # arch/*/boot/compressed/vmlinux. |
| 1241 | # Export LDFLAGS_vmlinux only to scripts/Makefile.vmlinux. |
| 1242 | # |
| 1243 | # _LDFLAGS_vmlinux is a workaround for the 'private export' bug: |
| 1244 | # https://savannah.gnu.org/bugs/?61463 |
| 1245 | # For Make > 4.4, the following simple code will work: |
| 1246 | # vmlinux: private export LDFLAGS_vmlinux := $(LDFLAGS_vmlinux) |
| 1247 | vmlinux: private _LDFLAGS_vmlinux := $(LDFLAGS_vmlinux) |
| 1248 | vmlinux: export LDFLAGS_vmlinux = $(_LDFLAGS_vmlinux) |
| 1249 | vmlinux: vmlinux.o $(KBUILD_LDS) modpost |
| 1250 | $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.vmlinux |
| 1251 | |
| 1252 | # The actual objects are generated when descending, |
| 1253 | # make sure no implicit rule kicks in |
| 1254 | $(sort $(KBUILD_LDS) $(KBUILD_VMLINUX_OBJS) $(KBUILD_VMLINUX_LIBS)): . ; |
| 1255 | |
| 1256 | ifeq ($(origin KERNELRELEASE),file) |
| 1257 | filechk_kernel.release = $(srctree)/scripts/setlocalversion $(srctree) |
| 1258 | else |
| 1259 | filechk_kernel.release = echo $(KERNELRELEASE) |
| 1260 | endif |
| 1261 | |
| 1262 | # Store (new) KERNELRELEASE string in include/config/kernel.release |
| 1263 | include/config/kernel.release: FORCE |
| 1264 | $(call filechk,kernel.release) |
| 1265 | |
| 1266 | # Additional helpers built in scripts/ |
| 1267 | # Carefully list dependencies so we do not try to build scripts twice |
| 1268 | # in parallel |
| 1269 | PHONY += scripts |
| 1270 | scripts: scripts_basic scripts_dtc |
| 1271 | $(Q)$(MAKE) $(build)=$(@) |
| 1272 | |
| 1273 | # Things we need to do before we recursively start building the kernel |
| 1274 | # or the modules are listed in "prepare". |
| 1275 | # A multi level approach is used. prepareN is processed before prepareN-1. |
| 1276 | # archprepare is used in arch Makefiles and when processed asm symlink, |
| 1277 | # version.h and scripts_basic is processed / created. |
| 1278 | |
| 1279 | PHONY += prepare archprepare |
| 1280 | |
| 1281 | archprepare: outputmakefile archheaders archscripts scripts include/config/kernel.release \ |
| 1282 | asm-generic $(version_h) $(autoksyms_h) include/generated/utsrelease.h \ |
| 1283 | include/generated/compile.h include/generated/autoconf.h remove-stale-files |
| 1284 | |
| 1285 | prepare0: archprepare |
| 1286 | $(Q)$(MAKE) $(build)=scripts/mod |
| 1287 | $(Q)$(MAKE) $(build)=. prepare |
| 1288 | |
| 1289 | # All the preparing.. |
| 1290 | prepare: prepare0 |
| 1291 | ifdef CONFIG_RUST |
| 1292 | $(Q)$(CONFIG_SHELL) $(srctree)/scripts/rust_is_available.sh -v |
| 1293 | $(Q)$(MAKE) $(build)=rust |
| 1294 | endif |
| 1295 | |
| 1296 | PHONY += remove-stale-files |
| 1297 | remove-stale-files: |
| 1298 | $(Q)$(srctree)/scripts/remove-stale-files |
| 1299 | |
| 1300 | # Support for using generic headers in asm-generic |
| 1301 | asm-generic := -f $(srctree)/scripts/Makefile.asm-generic obj |
| 1302 | |
| 1303 | PHONY += asm-generic uapi-asm-generic |
| 1304 | asm-generic: uapi-asm-generic |
| 1305 | $(Q)$(MAKE) $(asm-generic)=arch/$(SRCARCH)/include/generated/asm \ |
| 1306 | generic=include/asm-generic |
| 1307 | uapi-asm-generic: |
| 1308 | $(Q)$(MAKE) $(asm-generic)=arch/$(SRCARCH)/include/generated/uapi/asm \ |
| 1309 | generic=include/uapi/asm-generic |
| 1310 | |
| 1311 | # Generate some files |
| 1312 | # --------------------------------------------------------------------------- |
| 1313 | |
| 1314 | # KERNELRELEASE can change from a few different places, meaning version.h |
| 1315 | # needs to be updated, so this check is forced on all builds |
| 1316 | |
| 1317 | uts_len := 64 |
| 1318 | define filechk_utsrelease.h |
| 1319 | if [ `echo -n "$(KERNELRELEASE)" | wc -c ` -gt $(uts_len) ]; then \ |
| 1320 | echo '"$(KERNELRELEASE)" exceeds $(uts_len) characters' >&2; \ |
| 1321 | exit 1; \ |
| 1322 | fi; \ |
| 1323 | echo \#define UTS_RELEASE \"$(KERNELRELEASE)\" |
| 1324 | endef |
| 1325 | |
| 1326 | define filechk_version.h |
| 1327 | if [ $(SUBLEVEL) -gt 255 ]; then \ |
| 1328 | echo \#define LINUX_VERSION_CODE $(shell \ |
| 1329 | expr $(VERSION) \* 65536 + $(PATCHLEVEL) \* 256 + 255); \ |
| 1330 | else \ |
| 1331 | echo \#define LINUX_VERSION_CODE $(shell \ |
| 1332 | expr $(VERSION) \* 65536 + $(PATCHLEVEL) \* 256 + $(SUBLEVEL)); \ |
| 1333 | fi; \ |
| 1334 | echo '#define KERNEL_VERSION(a,b,c) (((a) << 16) + ((b) << 8) + \ |
| 1335 | ((c) > 255 ? 255 : (c)))'; \ |
| 1336 | echo \#define LINUX_VERSION_MAJOR $(VERSION); \ |
| 1337 | echo \#define LINUX_VERSION_PATCHLEVEL $(PATCHLEVEL); \ |
| 1338 | echo \#define LINUX_VERSION_SUBLEVEL $(SUBLEVEL) |
| 1339 | endef |
| 1340 | |
| 1341 | $(version_h): PATCHLEVEL := $(or $(PATCHLEVEL), 0) |
| 1342 | $(version_h): SUBLEVEL := $(or $(SUBLEVEL), 0) |
| 1343 | $(version_h): FORCE |
| 1344 | $(call filechk,version.h) |
| 1345 | |
| 1346 | include/generated/utsrelease.h: include/config/kernel.release FORCE |
| 1347 | $(call filechk,utsrelease.h) |
| 1348 | |
| 1349 | filechk_compile.h = $(srctree)/scripts/mkcompile_h \ |
| 1350 | "$(UTS_MACHINE)" "$(CONFIG_CC_VERSION_TEXT)" "$(LD)" |
| 1351 | |
| 1352 | include/generated/compile.h: FORCE |
| 1353 | $(call filechk,compile.h) |
| 1354 | |
| 1355 | PHONY += headerdep |
| 1356 | headerdep: |
| 1357 | $(Q)find $(srctree)/include/ -name '*.h' | xargs --max-args 1 \ |
| 1358 | $(srctree)/scripts/headerdep.pl -I$(srctree)/include |
| 1359 | |
| 1360 | # --------------------------------------------------------------------------- |
| 1361 | # Kernel headers |
| 1362 | |
| 1363 | #Default location for installed headers |
| 1364 | export INSTALL_HDR_PATH = $(objtree)/usr |
| 1365 | |
| 1366 | quiet_cmd_headers_install = INSTALL $(INSTALL_HDR_PATH)/include |
| 1367 | cmd_headers_install = \ |
| 1368 | mkdir -p $(INSTALL_HDR_PATH); \ |
| 1369 | rsync -mrl --include='*/' --include='*\.h' --exclude='*' \ |
| 1370 | usr/include $(INSTALL_HDR_PATH) |
| 1371 | |
| 1372 | PHONY += headers_install |
| 1373 | headers_install: headers |
| 1374 | $(call cmd,headers_install) |
| 1375 | |
| 1376 | PHONY += archheaders archscripts |
| 1377 | |
| 1378 | hdr-inst := -f $(srctree)/scripts/Makefile.headersinst obj |
| 1379 | |
| 1380 | PHONY += headers |
| 1381 | headers: $(version_h) scripts_unifdef uapi-asm-generic archheaders archscripts |
| 1382 | $(if $(filter um, $(SRCARCH)), $(error Headers not exportable for UML)) |
| 1383 | $(Q)$(MAKE) $(hdr-inst)=include/uapi |
| 1384 | $(Q)$(MAKE) $(hdr-inst)=arch/$(SRCARCH)/include/uapi |
| 1385 | |
| 1386 | ifdef CONFIG_HEADERS_INSTALL |
| 1387 | prepare: headers |
| 1388 | endif |
| 1389 | |
| 1390 | PHONY += scripts_unifdef |
| 1391 | scripts_unifdef: scripts_basic |
| 1392 | $(Q)$(MAKE) $(build)=scripts scripts/unifdef |
| 1393 | |
| 1394 | # --------------------------------------------------------------------------- |
| 1395 | # Install |
| 1396 | |
| 1397 | # Many distributions have the custom install script, /sbin/installkernel. |
| 1398 | # If DKMS is installed, 'make install' will eventually recurse back |
| 1399 | # to this Makefile to build and install external modules. |
| 1400 | # Cancel sub_make_done so that options such as M=, V=, etc. are parsed. |
| 1401 | |
| 1402 | quiet_cmd_install = INSTALL $(INSTALL_PATH) |
| 1403 | cmd_install = unset sub_make_done; $(srctree)/scripts/install.sh |
| 1404 | |
| 1405 | # --------------------------------------------------------------------------- |
| 1406 | # Tools |
| 1407 | |
| 1408 | ifdef CONFIG_OBJTOOL |
| 1409 | prepare: tools/objtool |
| 1410 | endif |
| 1411 | |
| 1412 | ifdef CONFIG_BPF |
| 1413 | ifdef CONFIG_DEBUG_INFO_BTF |
| 1414 | prepare: tools/bpf/resolve_btfids |
| 1415 | endif |
| 1416 | endif |
| 1417 | |
| 1418 | PHONY += resolve_btfids_clean |
| 1419 | |
| 1420 | resolve_btfids_O = $(abspath $(objtree))/tools/bpf/resolve_btfids |
| 1421 | |
| 1422 | # tools/bpf/resolve_btfids directory might not exist |
| 1423 | # in output directory, skip its clean in that case |
| 1424 | resolve_btfids_clean: |
| 1425 | ifneq ($(wildcard $(resolve_btfids_O)),) |
| 1426 | $(Q)$(MAKE) -sC $(srctree)/tools/bpf/resolve_btfids O=$(resolve_btfids_O) clean |
| 1427 | endif |
| 1428 | |
| 1429 | # Clear a bunch of variables before executing the submake |
| 1430 | ifeq ($(quiet),silent_) |
| 1431 | tools_silent=s |
| 1432 | endif |
| 1433 | |
| 1434 | tools/: FORCE |
| 1435 | $(Q)mkdir -p $(objtree)/tools |
| 1436 | $(Q)$(MAKE) LDFLAGS= MAKEFLAGS="$(tools_silent) $(filter --j% -j,$(MAKEFLAGS))" O=$(abspath $(objtree)) subdir=tools -C $(srctree)/tools/ |
| 1437 | |
| 1438 | tools/%: FORCE |
| 1439 | $(Q)mkdir -p $(objtree)/tools |
| 1440 | $(Q)$(MAKE) LDFLAGS= MAKEFLAGS="$(tools_silent) $(filter --j% -j,$(MAKEFLAGS))" O=$(abspath $(objtree)) subdir=tools -C $(srctree)/tools/ $* |
| 1441 | |
| 1442 | # --------------------------------------------------------------------------- |
| 1443 | # Kernel selftest |
| 1444 | |
| 1445 | PHONY += kselftest |
| 1446 | kselftest: headers |
| 1447 | $(Q)$(MAKE) -C $(srctree)/tools/testing/selftests run_tests |
| 1448 | |
| 1449 | kselftest-%: headers FORCE |
| 1450 | $(Q)$(MAKE) -C $(srctree)/tools/testing/selftests $* |
| 1451 | |
| 1452 | PHONY += kselftest-merge |
| 1453 | kselftest-merge: |
| 1454 | $(if $(wildcard $(objtree)/.config),, $(error No .config exists, config your kernel first!)) |
| 1455 | $(Q)find $(srctree)/tools/testing/selftests -name config | \ |
| 1456 | xargs $(srctree)/scripts/kconfig/merge_config.sh -m $(objtree)/.config |
| 1457 | $(Q)$(MAKE) -f $(srctree)/Makefile olddefconfig |
| 1458 | |
| 1459 | # --------------------------------------------------------------------------- |
| 1460 | # Devicetree files |
| 1461 | |
| 1462 | ifneq ($(wildcard $(srctree)/arch/$(SRCARCH)/boot/dts/),) |
| 1463 | dtstree := arch/$(SRCARCH)/boot/dts |
| 1464 | endif |
| 1465 | |
| 1466 | ifneq ($(dtstree),) |
| 1467 | |
| 1468 | %.dtb: dtbs_prepare |
| 1469 | $(Q)$(MAKE) $(build)=$(dtstree) $(dtstree)/$@ |
| 1470 | |
| 1471 | %.dtbo: dtbs_prepare |
| 1472 | $(Q)$(MAKE) $(build)=$(dtstree) $(dtstree)/$@ |
| 1473 | |
| 1474 | PHONY += dtbs dtbs_prepare dtbs_install dtbs_check |
| 1475 | dtbs: dtbs_prepare |
| 1476 | $(Q)$(MAKE) $(build)=$(dtstree) |
| 1477 | |
| 1478 | # include/config/kernel.release is actually needed when installing DTBs because |
| 1479 | # INSTALL_DTBS_PATH contains $(KERNELRELEASE). However, we do not want to make |
| 1480 | # dtbs_install depend on it as dtbs_install may run as root. |
| 1481 | dtbs_prepare: include/config/kernel.release scripts_dtc |
| 1482 | |
| 1483 | ifneq ($(filter dtbs_check, $(MAKECMDGOALS)),) |
| 1484 | export CHECK_DTBS=y |
| 1485 | endif |
| 1486 | |
| 1487 | ifneq ($(CHECK_DTBS),) |
| 1488 | dtbs_prepare: dt_binding_check |
| 1489 | endif |
| 1490 | |
| 1491 | dtbs_check: dtbs |
| 1492 | |
| 1493 | dtbs_install: |
| 1494 | $(Q)$(MAKE) $(dtbinst)=$(dtstree) dst=$(INSTALL_DTBS_PATH) |
| 1495 | |
| 1496 | ifdef CONFIG_OF_EARLY_FLATTREE |
| 1497 | all: dtbs |
| 1498 | endif |
| 1499 | |
| 1500 | endif |
| 1501 | |
| 1502 | PHONY += scripts_dtc |
| 1503 | scripts_dtc: scripts_basic |
| 1504 | $(Q)$(MAKE) $(build)=scripts/dtc |
| 1505 | |
| 1506 | ifneq ($(filter dt_binding_check, $(MAKECMDGOALS)),) |
| 1507 | export CHECK_DT_BINDING=y |
| 1508 | endif |
| 1509 | |
| 1510 | PHONY += dt_binding_check |
| 1511 | dt_binding_check: scripts_dtc |
| 1512 | $(Q)$(MAKE) $(build)=Documentation/devicetree/bindings |
| 1513 | |
| 1514 | PHONY += dt_compatible_check |
| 1515 | dt_compatible_check: dt_binding_check |
| 1516 | $(Q)$(MAKE) $(build)=Documentation/devicetree/bindings $@ |
| 1517 | |
| 1518 | # --------------------------------------------------------------------------- |
| 1519 | # Modules |
| 1520 | |
| 1521 | ifdef CONFIG_MODULES |
| 1522 | |
| 1523 | # By default, build modules as well |
| 1524 | |
| 1525 | all: modules |
| 1526 | |
| 1527 | # When we're building modules with modversions, we need to consider |
| 1528 | # the built-in objects during the descend as well, in order to |
| 1529 | # make sure the checksums are up to date before we record them. |
| 1530 | ifdef CONFIG_MODVERSIONS |
| 1531 | KBUILD_BUILTIN := 1 |
| 1532 | endif |
| 1533 | |
| 1534 | # Build modules |
| 1535 | # |
| 1536 | |
| 1537 | # *.ko are usually independent of vmlinux, but CONFIG_DEBUG_INFO_BTF_MODULES |
| 1538 | # is an exception. |
| 1539 | ifdef CONFIG_DEBUG_INFO_BTF_MODULES |
| 1540 | KBUILD_BUILTIN := 1 |
| 1541 | modules: vmlinux |
| 1542 | endif |
| 1543 | |
| 1544 | modules: modules_prepare |
| 1545 | |
| 1546 | # Target to prepare building external modules |
| 1547 | modules_prepare: prepare |
| 1548 | $(Q)$(MAKE) $(build)=scripts scripts/module.lds |
| 1549 | |
| 1550 | export modules_sign_only := |
| 1551 | |
| 1552 | ifeq ($(CONFIG_MODULE_SIG),y) |
| 1553 | PHONY += modules_sign |
| 1554 | modules_sign: modules_install |
| 1555 | @: |
| 1556 | |
| 1557 | # modules_sign is a subset of modules_install. |
| 1558 | # 'make modules_install modules_sign' is equivalent to 'make modules_install'. |
| 1559 | ifeq ($(filter modules_install,$(MAKECMDGOALS)),) |
| 1560 | modules_sign_only := y |
| 1561 | endif |
| 1562 | endif |
| 1563 | |
| 1564 | modinst_pre := |
| 1565 | ifneq ($(filter modules_install,$(MAKECMDGOALS)),) |
| 1566 | modinst_pre := __modinst_pre |
| 1567 | endif |
| 1568 | |
| 1569 | modules_install: $(modinst_pre) |
| 1570 | PHONY += __modinst_pre |
| 1571 | __modinst_pre: |
| 1572 | @rm -rf $(MODLIB)/kernel |
| 1573 | @rm -f $(MODLIB)/source |
| 1574 | @mkdir -p $(MODLIB)/kernel |
| 1575 | @ln -s $(abspath $(srctree)) $(MODLIB)/source |
| 1576 | @if [ ! $(objtree) -ef $(MODLIB)/build ]; then \ |
| 1577 | rm -f $(MODLIB)/build ; \ |
| 1578 | ln -s $(CURDIR) $(MODLIB)/build ; \ |
| 1579 | fi |
| 1580 | @sed 's:^\(.*\)\.o$$:kernel/\1.ko:' modules.order > $(MODLIB)/modules.order |
| 1581 | @cp -f modules.builtin $(MODLIB)/ |
| 1582 | @cp -f $(objtree)/modules.builtin.modinfo $(MODLIB)/ |
| 1583 | |
| 1584 | endif # CONFIG_MODULES |
| 1585 | |
| 1586 | ### |
| 1587 | # Cleaning is done on three levels. |
| 1588 | # make clean Delete most generated files |
| 1589 | # Leave enough to build external modules |
| 1590 | # make mrproper Delete the current configuration, and all generated files |
| 1591 | # make distclean Remove editor backup files, patch leftover files and the like |
| 1592 | |
| 1593 | # Directories & files removed with 'make clean' |
| 1594 | CLEAN_FILES += include/ksym vmlinux.symvers modules-only.symvers \ |
| 1595 | modules.builtin modules.builtin.modinfo modules.nsdeps \ |
| 1596 | compile_commands.json .thinlto-cache rust/test rust/doc \ |
| 1597 | rust-project.json .vmlinux.objs .vmlinux.export.c |
| 1598 | |
| 1599 | # Directories & files removed with 'make mrproper' |
| 1600 | MRPROPER_FILES += include/config include/generated \ |
| 1601 | arch/$(SRCARCH)/include/generated .objdiff \ |
| 1602 | debian snap tar-install \ |
| 1603 | .config .config.old .version \ |
| 1604 | Module.symvers \ |
| 1605 | certs/signing_key.pem \ |
| 1606 | certs/x509.genkey \ |
| 1607 | vmlinux-gdb.py \ |
| 1608 | *.spec rpmbuild \ |
| 1609 | rust/libmacros.so |
| 1610 | |
| 1611 | # clean - Delete most, but leave enough to build external modules |
| 1612 | # |
| 1613 | clean: rm-files := $(CLEAN_FILES) |
| 1614 | |
| 1615 | PHONY += archclean vmlinuxclean |
| 1616 | |
| 1617 | vmlinuxclean: |
| 1618 | $(Q)$(CONFIG_SHELL) $(srctree)/scripts/link-vmlinux.sh clean |
| 1619 | $(Q)$(if $(ARCH_POSTLINK), $(MAKE) -f $(ARCH_POSTLINK) clean) |
| 1620 | |
| 1621 | clean: archclean vmlinuxclean resolve_btfids_clean |
| 1622 | |
| 1623 | # mrproper - Delete all generated files, including .config |
| 1624 | # |
| 1625 | mrproper: rm-files := $(wildcard $(MRPROPER_FILES)) |
| 1626 | mrproper-dirs := $(addprefix _mrproper_,scripts) |
| 1627 | |
| 1628 | PHONY += $(mrproper-dirs) mrproper |
| 1629 | $(mrproper-dirs): |
| 1630 | $(Q)$(MAKE) $(clean)=$(patsubst _mrproper_%,%,$@) |
| 1631 | |
| 1632 | mrproper: clean $(mrproper-dirs) |
| 1633 | $(call cmd,rmfiles) |
| 1634 | @find . $(RCS_FIND_IGNORE) \ |
| 1635 | \( -name '*.rmeta' \) \ |
| 1636 | -type f -print | xargs rm -f |
| 1637 | |
| 1638 | # distclean |
| 1639 | # |
| 1640 | PHONY += distclean |
| 1641 | |
| 1642 | distclean: mrproper |
| 1643 | @find . $(RCS_FIND_IGNORE) \ |
| 1644 | \( -name '*.orig' -o -name '*.rej' -o -name '*~' \ |
| 1645 | -o -name '*.bak' -o -name '#*#' -o -name '*%' \ |
| 1646 | -o -name 'core' -o -name tags -o -name TAGS -o -name 'cscope*' \ |
| 1647 | -o -name GPATH -o -name GRTAGS -o -name GSYMS -o -name GTAGS \) \ |
| 1648 | -type f -print | xargs rm -f |
| 1649 | |
| 1650 | |
| 1651 | # Packaging of the kernel to various formats |
| 1652 | # --------------------------------------------------------------------------- |
| 1653 | |
| 1654 | %src-pkg: FORCE |
| 1655 | $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.package $@ |
| 1656 | %pkg: include/config/kernel.release FORCE |
| 1657 | $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.package $@ |
| 1658 | |
| 1659 | # Brief documentation of the typical targets used |
| 1660 | # --------------------------------------------------------------------------- |
| 1661 | |
| 1662 | boards := $(wildcard $(srctree)/arch/$(SRCARCH)/configs/*_defconfig) |
| 1663 | boards := $(sort $(notdir $(boards))) |
| 1664 | board-dirs := $(dir $(wildcard $(srctree)/arch/$(SRCARCH)/configs/*/*_defconfig)) |
| 1665 | board-dirs := $(sort $(notdir $(board-dirs:/=))) |
| 1666 | |
| 1667 | PHONY += help |
| 1668 | help: |
| 1669 | @echo 'Cleaning targets:' |
| 1670 | @echo ' clean - Remove most generated files but keep the config and' |
| 1671 | @echo ' enough build support to build external modules' |
| 1672 | @echo ' mrproper - Remove all generated files + config + various backup files' |
| 1673 | @echo ' distclean - mrproper + remove editor backup and patch files' |
| 1674 | @echo '' |
| 1675 | @echo 'Configuration targets:' |
| 1676 | @$(MAKE) -f $(srctree)/scripts/kconfig/Makefile help |
| 1677 | @echo '' |
| 1678 | @echo 'Other generic targets:' |
| 1679 | @echo ' all - Build all targets marked with [*]' |
| 1680 | @echo '* vmlinux - Build the bare kernel' |
| 1681 | @echo '* modules - Build all modules' |
| 1682 | @echo ' modules_install - Install all modules to INSTALL_MOD_PATH (default: /)' |
| 1683 | @echo ' dir/ - Build all files in dir and below' |
| 1684 | @echo ' dir/file.[ois] - Build specified target only' |
| 1685 | @echo ' dir/file.ll - Build the LLVM assembly file' |
| 1686 | @echo ' (requires compiler support for LLVM assembly generation)' |
| 1687 | @echo ' dir/file.lst - Build specified mixed source/assembly target only' |
| 1688 | @echo ' (requires a recent binutils and recent build (System.map))' |
| 1689 | @echo ' dir/file.ko - Build module including final link' |
| 1690 | @echo ' modules_prepare - Set up for building external modules' |
| 1691 | @echo ' tags/TAGS - Generate tags file for editors' |
| 1692 | @echo ' cscope - Generate cscope index' |
| 1693 | @echo ' gtags - Generate GNU GLOBAL index' |
| 1694 | @echo ' kernelrelease - Output the release version string (use with make -s)' |
| 1695 | @echo ' kernelversion - Output the version stored in Makefile (use with make -s)' |
| 1696 | @echo ' image_name - Output the image name (use with make -s)' |
| 1697 | @echo ' headers_install - Install sanitised kernel headers to INSTALL_HDR_PATH'; \ |
| 1698 | echo ' (default: $(INSTALL_HDR_PATH))'; \ |
| 1699 | echo '' |
| 1700 | @echo 'Static analysers:' |
| 1701 | @echo ' checkstack - Generate a list of stack hogs' |
| 1702 | @echo ' versioncheck - Sanity check on version.h usage' |
| 1703 | @echo ' includecheck - Check for duplicate included header files' |
| 1704 | @echo ' export_report - List the usages of all exported symbols' |
| 1705 | @echo ' headerdep - Detect inclusion cycles in headers' |
| 1706 | @echo ' coccicheck - Check with Coccinelle' |
| 1707 | @echo ' clang-analyzer - Check with clang static analyzer' |
| 1708 | @echo ' clang-tidy - Check with clang-tidy' |
| 1709 | @echo '' |
| 1710 | @echo 'Tools:' |
| 1711 | @echo ' nsdeps - Generate missing symbol namespace dependencies' |
| 1712 | @echo '' |
| 1713 | @echo 'Kernel selftest:' |
| 1714 | @echo ' kselftest - Build and run kernel selftest' |
| 1715 | @echo ' Build, install, and boot kernel before' |
| 1716 | @echo ' running kselftest on it' |
| 1717 | @echo ' Run as root for full coverage' |
| 1718 | @echo ' kselftest-all - Build kernel selftest' |
| 1719 | @echo ' kselftest-install - Build and install kernel selftest' |
| 1720 | @echo ' kselftest-clean - Remove all generated kselftest files' |
| 1721 | @echo ' kselftest-merge - Merge all the config dependencies of' |
| 1722 | @echo ' kselftest to existing .config.' |
| 1723 | @echo '' |
| 1724 | @echo 'Rust targets:' |
| 1725 | @echo ' rustavailable - Checks whether the Rust toolchain is' |
| 1726 | @echo ' available and, if not, explains why.' |
| 1727 | @echo ' rustfmt - Reformat all the Rust code in the kernel' |
| 1728 | @echo ' rustfmtcheck - Checks if all the Rust code in the kernel' |
| 1729 | @echo ' is formatted, printing a diff otherwise.' |
| 1730 | @echo ' rustdoc - Generate Rust documentation' |
| 1731 | @echo ' (requires kernel .config)' |
| 1732 | @echo ' rusttest - Runs the Rust tests' |
| 1733 | @echo ' (requires kernel .config; downloads external repos)' |
| 1734 | @echo ' rust-analyzer - Generate rust-project.json rust-analyzer support file' |
| 1735 | @echo ' (requires kernel .config)' |
| 1736 | @echo ' dir/file.[os] - Build specified target only' |
| 1737 | @echo ' dir/file.rsi - Build macro expanded source, similar to C preprocessing.' |
| 1738 | @echo ' Run with RUSTFMT=n to skip reformatting if needed.' |
| 1739 | @echo ' The output is not intended to be compilable.' |
| 1740 | @echo ' dir/file.ll - Build the LLVM assembly file' |
| 1741 | @echo '' |
| 1742 | @$(if $(dtstree), \ |
| 1743 | echo 'Devicetree:'; \ |
| 1744 | echo '* dtbs - Build device tree blobs for enabled boards'; \ |
| 1745 | echo ' dtbs_install - Install dtbs to $(INSTALL_DTBS_PATH)'; \ |
| 1746 | echo ' dt_binding_check - Validate device tree binding documents'; \ |
| 1747 | echo ' dtbs_check - Validate device tree source files';\ |
| 1748 | echo '') |
| 1749 | |
| 1750 | @echo 'Userspace tools targets:' |
| 1751 | @echo ' use "make tools/help"' |
| 1752 | @echo ' or "cd tools; make help"' |
| 1753 | @echo '' |
| 1754 | @echo 'Kernel packaging:' |
| 1755 | @$(MAKE) -f $(srctree)/scripts/Makefile.package help |
| 1756 | @echo '' |
| 1757 | @echo 'Documentation targets:' |
| 1758 | @$(MAKE) -f $(srctree)/Documentation/Makefile dochelp |
| 1759 | @echo '' |
| 1760 | @echo 'Architecture specific targets ($(SRCARCH)):' |
| 1761 | @$(or $(archhelp),\ |
| 1762 | echo ' No architecture specific help defined for $(SRCARCH)') |
| 1763 | @echo '' |
| 1764 | @$(if $(boards), \ |
| 1765 | $(foreach b, $(boards), \ |
| 1766 | printf " %-27s - Build for %s\\n" $(b) $(subst _defconfig,,$(b));) \ |
| 1767 | echo '') |
| 1768 | @$(if $(board-dirs), \ |
| 1769 | $(foreach b, $(board-dirs), \ |
| 1770 | printf " %-16s - Show %s-specific targets\\n" help-$(b) $(b);) \ |
| 1771 | printf " %-16s - Show all of the above\\n" help-boards; \ |
| 1772 | echo '') |
| 1773 | |
| 1774 | @echo ' make V=n [targets] 1: verbose build' |
| 1775 | @echo ' 2: give reason for rebuild of target' |
| 1776 | @echo ' V=1 and V=2 can be combined with V=12' |
| 1777 | @echo ' make O=dir [targets] Locate all output files in "dir", including .config' |
| 1778 | @echo ' make C=1 [targets] Check re-compiled c source with $$CHECK' |
| 1779 | @echo ' (sparse by default)' |
| 1780 | @echo ' make C=2 [targets] Force check of all c source with $$CHECK' |
| 1781 | @echo ' make RECORDMCOUNT_WARN=1 [targets] Warn about ignored mcount sections' |
| 1782 | @echo ' make W=n [targets] Enable extra build checks, n=1,2,3 where' |
| 1783 | @echo ' 1: warnings which may be relevant and do not occur too often' |
| 1784 | @echo ' 2: warnings which occur quite often but may still be relevant' |
| 1785 | @echo ' 3: more obscure warnings, can most likely be ignored' |
| 1786 | @echo ' e: warnings are being treated as errors' |
| 1787 | @echo ' Multiple levels can be combined with W=12 or W=123' |
| 1788 | @$(if $(dtstree), \ |
| 1789 | echo ' make CHECK_DTBS=1 [targets] Check all generated dtb files against schema'; \ |
| 1790 | echo ' This can be applied both to "dtbs" and to individual "foo.dtb" targets' ; \ |
| 1791 | ) |
| 1792 | @echo '' |
| 1793 | @echo 'Execute "make" or "make all" to build all targets marked with [*] ' |
| 1794 | @echo 'For further info see the ./README file' |
| 1795 | |
| 1796 | |
| 1797 | help-board-dirs := $(addprefix help-,$(board-dirs)) |
| 1798 | |
| 1799 | help-boards: $(help-board-dirs) |
| 1800 | |
| 1801 | boards-per-dir = $(sort $(notdir $(wildcard $(srctree)/arch/$(SRCARCH)/configs/$*/*_defconfig))) |
| 1802 | |
| 1803 | $(help-board-dirs): help-%: |
| 1804 | @echo 'Architecture specific targets ($(SRCARCH) $*):' |
| 1805 | @$(if $(boards-per-dir), \ |
| 1806 | $(foreach b, $(boards-per-dir), \ |
| 1807 | printf " %-24s - Build for %s\\n" $*/$(b) $(subst _defconfig,,$(b));) \ |
| 1808 | echo '') |
| 1809 | |
| 1810 | |
| 1811 | # Documentation targets |
| 1812 | # --------------------------------------------------------------------------- |
| 1813 | DOC_TARGETS := xmldocs latexdocs pdfdocs htmldocs epubdocs cleandocs \ |
| 1814 | linkcheckdocs dochelp refcheckdocs texinfodocs infodocs |
| 1815 | PHONY += $(DOC_TARGETS) |
| 1816 | $(DOC_TARGETS): |
| 1817 | $(Q)$(MAKE) $(build)=Documentation $@ |
| 1818 | |
| 1819 | |
| 1820 | # Rust targets |
| 1821 | # --------------------------------------------------------------------------- |
| 1822 | |
| 1823 | # "Is Rust available?" target |
| 1824 | PHONY += rustavailable |
| 1825 | rustavailable: |
| 1826 | $(Q)$(CONFIG_SHELL) $(srctree)/scripts/rust_is_available.sh -v && echo "Rust is available!" |
| 1827 | |
| 1828 | # Documentation target |
| 1829 | # |
| 1830 | # Using the singular to avoid running afoul of `no-dot-config-targets`. |
| 1831 | PHONY += rustdoc |
| 1832 | rustdoc: prepare |
| 1833 | $(Q)$(MAKE) $(build)=rust $@ |
| 1834 | |
| 1835 | # Testing target |
| 1836 | PHONY += rusttest |
| 1837 | rusttest: prepare |
| 1838 | $(Q)$(MAKE) $(build)=rust $@ |
| 1839 | |
| 1840 | # Formatting targets |
| 1841 | PHONY += rustfmt rustfmtcheck |
| 1842 | |
| 1843 | # We skip `rust/alloc` since we want to minimize the diff w.r.t. upstream. |
| 1844 | # |
| 1845 | # We match using absolute paths since `find` does not resolve them |
| 1846 | # when matching, which is a problem when e.g. `srctree` is `..`. |
| 1847 | # We `grep` afterwards in order to remove the directory entry itself. |
| 1848 | rustfmt: |
| 1849 | $(Q)find $(abs_srctree) -type f -name '*.rs' \ |
| 1850 | -o -path $(abs_srctree)/rust/alloc -prune \ |
| 1851 | -o -path $(abs_objtree)/rust/test -prune \ |
| 1852 | | grep -Fv $(abs_srctree)/rust/alloc \ |
| 1853 | | grep -Fv $(abs_objtree)/rust/test \ |
| 1854 | | grep -Fv generated \ |
| 1855 | | xargs $(RUSTFMT) $(rustfmt_flags) |
| 1856 | |
| 1857 | rustfmtcheck: rustfmt_flags = --check |
| 1858 | rustfmtcheck: rustfmt |
| 1859 | |
| 1860 | # IDE support targets |
| 1861 | PHONY += rust-analyzer |
| 1862 | rust-analyzer: |
| 1863 | $(Q)$(MAKE) $(build)=rust $@ |
| 1864 | |
| 1865 | # Misc |
| 1866 | # --------------------------------------------------------------------------- |
| 1867 | |
| 1868 | PHONY += misc-check |
| 1869 | misc-check: |
| 1870 | $(Q)$(srctree)/scripts/misc-check |
| 1871 | |
| 1872 | all: misc-check |
| 1873 | |
| 1874 | PHONY += scripts_gdb |
| 1875 | scripts_gdb: prepare0 |
| 1876 | $(Q)$(MAKE) $(build)=scripts/gdb |
| 1877 | $(Q)ln -fsn $(abspath $(srctree)/scripts/gdb/vmlinux-gdb.py) |
| 1878 | |
| 1879 | ifdef CONFIG_GDB_SCRIPTS |
| 1880 | all: scripts_gdb |
| 1881 | endif |
| 1882 | |
| 1883 | else # KBUILD_EXTMOD |
| 1884 | |
| 1885 | filechk_kernel.release = echo $(KERNELRELEASE) |
| 1886 | |
| 1887 | ### |
| 1888 | # External module support. |
| 1889 | # When building external modules the kernel used as basis is considered |
| 1890 | # read-only, and no consistency checks are made and the make |
| 1891 | # system is not used on the basis kernel. If updates are required |
| 1892 | # in the basis kernel ordinary make commands (without M=...) must be used. |
| 1893 | |
| 1894 | # We are always building only modules. |
| 1895 | KBUILD_BUILTIN := |
| 1896 | KBUILD_MODULES := 1 |
| 1897 | |
| 1898 | build-dir := $(KBUILD_EXTMOD) |
| 1899 | |
| 1900 | compile_commands.json: $(extmod_prefix)compile_commands.json |
| 1901 | PHONY += compile_commands.json |
| 1902 | |
| 1903 | clean-dirs := $(KBUILD_EXTMOD) |
| 1904 | clean: rm-files := $(KBUILD_EXTMOD)/Module.symvers $(KBUILD_EXTMOD)/modules.nsdeps \ |
| 1905 | $(KBUILD_EXTMOD)/compile_commands.json $(KBUILD_EXTMOD)/.thinlto-cache |
| 1906 | |
| 1907 | PHONY += prepare |
| 1908 | # now expand this into a simple variable to reduce the cost of shell evaluations |
| 1909 | prepare: CC_VERSION_TEXT := $(CC_VERSION_TEXT) |
| 1910 | prepare: |
| 1911 | @if [ "$(CC_VERSION_TEXT)" != "$(CONFIG_CC_VERSION_TEXT)" ]; then \ |
| 1912 | echo >&2 "warning: the compiler differs from the one used to build the kernel"; \ |
| 1913 | echo >&2 " The kernel was built by: $(CONFIG_CC_VERSION_TEXT)"; \ |
| 1914 | echo >&2 " You are using: $(CC_VERSION_TEXT)"; \ |
| 1915 | fi |
| 1916 | |
| 1917 | PHONY += help |
| 1918 | help: |
| 1919 | @echo ' Building external modules.' |
| 1920 | @echo ' Syntax: make -C path/to/kernel/src M=$$PWD target' |
| 1921 | @echo '' |
| 1922 | @echo ' modules - default target, build the module(s)' |
| 1923 | @echo ' modules_install - install the module' |
| 1924 | @echo ' clean - remove generated files in module directory only' |
| 1925 | @echo '' |
| 1926 | |
| 1927 | endif # KBUILD_EXTMOD |
| 1928 | |
| 1929 | # --------------------------------------------------------------------------- |
| 1930 | # Modules |
| 1931 | |
| 1932 | PHONY += modules modules_install modules_prepare |
| 1933 | |
| 1934 | ifdef CONFIG_MODULES |
| 1935 | |
| 1936 | $(MODORDER): $(build-dir) |
| 1937 | @: |
| 1938 | |
| 1939 | # KBUILD_MODPOST_NOFINAL can be set to skip the final link of modules. |
| 1940 | # This is solely useful to speed up test compiles. |
| 1941 | modules: modpost |
| 1942 | ifneq ($(KBUILD_MODPOST_NOFINAL),1) |
| 1943 | $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modfinal |
| 1944 | endif |
| 1945 | |
| 1946 | PHONY += modules_check |
| 1947 | modules_check: $(MODORDER) |
| 1948 | $(Q)$(CONFIG_SHELL) $(srctree)/scripts/modules-check.sh $< |
| 1949 | |
| 1950 | quiet_cmd_depmod = DEPMOD $(MODLIB) |
| 1951 | cmd_depmod = $(CONFIG_SHELL) $(srctree)/scripts/depmod.sh $(DEPMOD) \ |
| 1952 | $(KERNELRELEASE) |
| 1953 | |
| 1954 | modules_install: |
| 1955 | $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modinst |
| 1956 | $(call cmd,depmod) |
| 1957 | |
| 1958 | else # CONFIG_MODULES |
| 1959 | |
| 1960 | # Modules not configured |
| 1961 | # --------------------------------------------------------------------------- |
| 1962 | |
| 1963 | modules modules_install: |
| 1964 | @echo >&2 '***' |
| 1965 | @echo >&2 '*** The present kernel configuration has modules disabled.' |
| 1966 | @echo >&2 '*** To use the module feature, please run "make menuconfig" etc.' |
| 1967 | @echo >&2 '*** to enable CONFIG_MODULES.' |
| 1968 | @echo >&2 '***' |
| 1969 | @exit 1 |
| 1970 | |
| 1971 | KBUILD_MODULES := |
| 1972 | |
| 1973 | endif # CONFIG_MODULES |
| 1974 | |
| 1975 | PHONY += modpost |
| 1976 | modpost: $(if $(single-build),, $(if $(KBUILD_BUILTIN), vmlinux.o)) \ |
| 1977 | $(if $(KBUILD_MODULES), modules_check) |
| 1978 | $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modpost |
| 1979 | |
| 1980 | # Single targets |
| 1981 | # --------------------------------------------------------------------------- |
| 1982 | # To build individual files in subdirectories, you can do like this: |
| 1983 | # |
| 1984 | # make foo/bar/baz.s |
| 1985 | # |
| 1986 | # The supported suffixes for single-target are listed in 'single-targets' |
| 1987 | # |
| 1988 | # To build only under specific subdirectories, you can do like this: |
| 1989 | # |
| 1990 | # make foo/bar/baz/ |
| 1991 | |
| 1992 | ifdef single-build |
| 1993 | |
| 1994 | # .ko is special because modpost is needed |
| 1995 | single-ko := $(sort $(filter %.ko, $(MAKECMDGOALS))) |
| 1996 | single-no-ko := $(filter-out $(single-ko), $(MAKECMDGOALS)) \ |
| 1997 | $(foreach x, o mod, $(patsubst %.ko, %.$x, $(single-ko))) |
| 1998 | |
| 1999 | $(single-ko): single_modules |
| 2000 | @: |
| 2001 | $(single-no-ko): $(build-dir) |
| 2002 | @: |
| 2003 | |
| 2004 | # Remove MODORDER when done because it is not the real one. |
| 2005 | PHONY += single_modules |
| 2006 | single_modules: $(single-no-ko) modules_prepare |
| 2007 | $(Q){ $(foreach m, $(single-ko), echo $(extmod_prefix)$(m:%.ko=%.o);) } > $(MODORDER) |
| 2008 | $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modpost |
| 2009 | ifneq ($(KBUILD_MODPOST_NOFINAL),1) |
| 2010 | $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modfinal |
| 2011 | endif |
| 2012 | $(Q)rm -f $(MODORDER) |
| 2013 | |
| 2014 | single-goals := $(addprefix $(build-dir)/, $(single-no-ko)) |
| 2015 | |
| 2016 | KBUILD_MODULES := 1 |
| 2017 | |
| 2018 | endif |
| 2019 | |
| 2020 | # Preset locale variables to speed up the build process. Limit locale |
| 2021 | # tweaks to this spot to avoid wrong language settings when running |
| 2022 | # make menuconfig etc. |
| 2023 | # Error messages still appears in the original language |
| 2024 | PHONY += $(build-dir) |
| 2025 | $(build-dir): prepare |
| 2026 | $(Q)$(MAKE) $(build)=$@ need-builtin=1 need-modorder=1 $(single-goals) |
| 2027 | |
| 2028 | clean-dirs := $(addprefix _clean_, $(clean-dirs)) |
| 2029 | PHONY += $(clean-dirs) clean |
| 2030 | $(clean-dirs): |
| 2031 | $(Q)$(MAKE) $(clean)=$(patsubst _clean_%,%,$@) |
| 2032 | |
| 2033 | clean: $(clean-dirs) |
| 2034 | $(call cmd,rmfiles) |
| 2035 | @find $(or $(KBUILD_EXTMOD), .) $(RCS_FIND_IGNORE) \ |
| 2036 | \( -name '*.[aios]' -o -name '*.rsi' -o -name '*.ko' -o -name '.*.cmd' \ |
| 2037 | -o -name '*.ko.*' \ |
| 2038 | -o -name '*.dtb' -o -name '*.dtbo' \ |
| 2039 | -o -name '*.dtb.S' -o -name '*.dtbo.S' \ |
| 2040 | -o -name '*.dt.yaml' \ |
| 2041 | -o -name '*.dwo' -o -name '*.lst' \ |
| 2042 | -o -name '*.su' -o -name '*.mod' -o -name '*.usyms' \ |
| 2043 | -o -name '.*.d' -o -name '.*.tmp' -o -name '*.mod.c' \ |
| 2044 | -o -name '*.lex.c' -o -name '*.tab.[ch]' \ |
| 2045 | -o -name '*.asn1.[ch]' \ |
| 2046 | -o -name '*.symtypes' -o -name 'modules.order' \ |
| 2047 | -o -name '*.c.[012]*.*' \ |
| 2048 | -o -name '*.ll' \ |
| 2049 | -o -name '*.gcno' \ |
| 2050 | -o -name '*.*.symversions' \) -type f -print \ |
| 2051 | -o -name '.tmp_*' -print \ |
| 2052 | | xargs rm -rf |
| 2053 | |
| 2054 | # Generate tags for editors |
| 2055 | # --------------------------------------------------------------------------- |
| 2056 | quiet_cmd_tags = GEN $@ |
| 2057 | cmd_tags = $(BASH) $(srctree)/scripts/tags.sh $@ |
| 2058 | |
| 2059 | tags TAGS cscope gtags: FORCE |
| 2060 | $(call cmd,tags) |
| 2061 | |
| 2062 | # Script to generate missing namespace dependencies |
| 2063 | # --------------------------------------------------------------------------- |
| 2064 | |
| 2065 | PHONY += nsdeps |
| 2066 | nsdeps: export KBUILD_NSDEPS=1 |
| 2067 | nsdeps: modules |
| 2068 | $(Q)$(CONFIG_SHELL) $(srctree)/scripts/nsdeps |
| 2069 | |
| 2070 | # Clang Tooling |
| 2071 | # --------------------------------------------------------------------------- |
| 2072 | |
| 2073 | quiet_cmd_gen_compile_commands = GEN $@ |
| 2074 | cmd_gen_compile_commands = $(PYTHON3) $< -a $(AR) -o $@ $(filter-out $<, $(real-prereqs)) |
| 2075 | |
| 2076 | $(extmod_prefix)compile_commands.json: scripts/clang-tools/gen_compile_commands.py \ |
| 2077 | $(if $(KBUILD_EXTMOD),, vmlinux.a $(KBUILD_VMLINUX_LIBS)) \ |
| 2078 | $(if $(CONFIG_MODULES), $(MODORDER)) FORCE |
| 2079 | $(call if_changed,gen_compile_commands) |
| 2080 | |
| 2081 | targets += $(extmod_prefix)compile_commands.json |
| 2082 | |
| 2083 | PHONY += clang-tidy clang-analyzer |
| 2084 | |
| 2085 | ifdef CONFIG_CC_IS_CLANG |
| 2086 | quiet_cmd_clang_tools = CHECK $< |
| 2087 | cmd_clang_tools = $(PYTHON3) $(srctree)/scripts/clang-tools/run-clang-tools.py $@ $< |
| 2088 | |
| 2089 | clang-tidy clang-analyzer: $(extmod_prefix)compile_commands.json |
| 2090 | $(call cmd,clang_tools) |
| 2091 | else |
| 2092 | clang-tidy clang-analyzer: |
| 2093 | @echo "$@ requires CC=clang" >&2 |
| 2094 | @false |
| 2095 | endif |
| 2096 | |
| 2097 | # Scripts to check various things for consistency |
| 2098 | # --------------------------------------------------------------------------- |
| 2099 | |
| 2100 | PHONY += includecheck versioncheck coccicheck export_report |
| 2101 | |
| 2102 | includecheck: |
| 2103 | find $(srctree)/* $(RCS_FIND_IGNORE) \ |
| 2104 | -name '*.[hcS]' -type f -print | sort \ |
| 2105 | | xargs $(PERL) -w $(srctree)/scripts/checkincludes.pl |
| 2106 | |
| 2107 | versioncheck: |
| 2108 | find $(srctree)/* $(RCS_FIND_IGNORE) \ |
| 2109 | -name '*.[hcS]' -type f -print | sort \ |
| 2110 | | xargs $(PERL) -w $(srctree)/scripts/checkversion.pl |
| 2111 | |
| 2112 | coccicheck: |
| 2113 | $(Q)$(BASH) $(srctree)/scripts/$@ |
| 2114 | |
| 2115 | export_report: |
| 2116 | $(PERL) $(srctree)/scripts/export_report.pl |
| 2117 | |
| 2118 | PHONY += checkstack kernelrelease kernelversion image_name |
| 2119 | |
| 2120 | # UML needs a little special treatment here. It wants to use the host |
| 2121 | # toolchain, so needs $(SUBARCH) passed to checkstack.pl. Everyone |
| 2122 | # else wants $(ARCH), including people doing cross-builds, which means |
| 2123 | # that $(SUBARCH) doesn't work here. |
| 2124 | ifeq ($(ARCH), um) |
| 2125 | CHECKSTACK_ARCH := $(SUBARCH) |
| 2126 | else |
| 2127 | CHECKSTACK_ARCH := $(ARCH) |
| 2128 | endif |
| 2129 | checkstack: |
| 2130 | $(OBJDUMP) -d vmlinux $$(find . -name '*.ko') | \ |
| 2131 | $(PERL) $(srctree)/scripts/checkstack.pl $(CHECKSTACK_ARCH) |
| 2132 | |
| 2133 | kernelrelease: |
| 2134 | @$(filechk_kernel.release) |
| 2135 | |
| 2136 | kernelversion: |
| 2137 | @echo $(KERNELVERSION) |
| 2138 | |
| 2139 | image_name: |
| 2140 | @echo $(KBUILD_IMAGE) |
| 2141 | |
| 2142 | quiet_cmd_rmfiles = $(if $(wildcard $(rm-files)),CLEAN $(wildcard $(rm-files))) |
| 2143 | cmd_rmfiles = rm -rf $(rm-files) |
| 2144 | |
| 2145 | # read saved command lines for existing targets |
| 2146 | existing-targets := $(wildcard $(sort $(targets))) |
| 2147 | |
| 2148 | -include $(foreach f,$(existing-targets),$(dir $(f)).$(notdir $(f)).cmd) |
| 2149 | |
| 2150 | endif # config-build |
| 2151 | endif # mixed-build |
| 2152 | endif # need-sub-make |
| 2153 | |
| 2154 | PHONY += FORCE |
| 2155 | FORCE: |
| 2156 | |
| 2157 | # Declare the contents of the PHONY variable as phony. We keep that |
| 2158 | # information in a variable so we can use it in if_changed and friends. |
| 2159 | .PHONY: $(PHONY) |