1VERSION = 4 2PATCHLEVEL = 3 3SUBLEVEL = 0 4EXTRAVERSION = 5NAME = Blurry Fish Butt 6 7# *DOCUMENTATION* 8# To see a list of typical targets execute "make help" 9# More info can be located in ./README 10# Comments in this file are targeted only to the developer, do not 11# expect to learn how to build the kernel reading this file. 12 13# o Do not use make's built-in rules and variables 14# (this increases performance and avoids hard-to-debug behaviour); 15# o Look for make include files relative to root of kernel src 16MAKEFLAGS += -rR --include-dir=$(CURDIR) 17 18# Avoid funny character set dependencies 19unexport LC_ALL 20LC_COLLATE=C 21LC_NUMERIC=C 22export LC_COLLATE LC_NUMERIC 23 24# Avoid interference with shell env settings 25unexport GREP_OPTIONS 26 27# We are using a recursive build, so we need to do a little thinking 28# to get the ordering right. 29# 30# Most importantly: sub-Makefiles should only ever modify files in 31# their own directory. If in some directory we have a dependency on 32# a file in another dir (which doesn't happen often, but it's often 33# unavoidable when linking the built-in.o targets which finally 34# turn into vmlinux), we will call a sub make in that other dir, and 35# after that we are sure that everything which is in that other dir 36# is now up to date. 37# 38# The only cases where we need to modify files which have global 39# effects are thus separated out and done before the recursive 40# descending is started. They are now explicitly listed as the 41# prepare rule. 42 43# Beautify output 44# --------------------------------------------------------------------------- 45# 46# Normally, we echo the whole command before executing it. By making 47# that echo $($(quiet)$(cmd)), we now have the possibility to set 48# $(quiet) to choose other forms of output instead, e.g. 49# 50# quiet_cmd_cc_o_c = Compiling $(RELDIR)/$@ 51# cmd_cc_o_c = $(CC) $(c_flags) -c -o $@ $< 52# 53# If $(quiet) is empty, the whole command will be printed. 54# If it is set to "quiet_", only the short version will be printed. 55# If it is set to "silent_", nothing will be printed at all, since 56# the variable $(silent_cmd_cc_o_c) doesn't exist. 57# 58# A simple variant is to prefix commands with $(Q) - that's useful 59# for commands that shall be hidden in non-verbose mode. 60# 61# $(Q)ln $@ :< 62# 63# If KBUILD_VERBOSE equals 0 then the above command will be hidden. 64# If KBUILD_VERBOSE equals 1 then the above command is displayed. 65# 66# To put more focus on warnings, be less verbose as default 67# Use 'make V=1' to see the full commands 68 69ifeq ("$(origin V)", "command line") 70 KBUILD_VERBOSE = $(V) 71endif 72ifndef KBUILD_VERBOSE 73 KBUILD_VERBOSE = 0 74endif 75 76ifeq ($(KBUILD_VERBOSE),1) 77 quiet = 78 Q = 79else 80 quiet=quiet_ 81 Q = @ 82endif 83 84# If the user is running make -s (silent mode), suppress echoing of 85# commands 86 87ifneq ($(filter 4.%,$(MAKE_VERSION)),) # make-4 88ifneq ($(filter %s ,$(firstword x$(MAKEFLAGS))),) 89 quiet=silent_ 90endif 91else # make-3.8x 92ifneq ($(filter s% -s%,$(MAKEFLAGS)),) 93 quiet=silent_ 94endif 95endif 96 97export quiet Q KBUILD_VERBOSE 98 99# kbuild supports saving output files in a separate directory. 100# To locate output files in a separate directory two syntaxes are supported. 101# In both cases the working directory must be the root of the kernel src. 102# 1) O= 103# Use "make O=dir/to/store/output/files/" 104# 105# 2) Set KBUILD_OUTPUT 106# Set the environment variable KBUILD_OUTPUT to point to the directory 107# where the output files shall be placed. 108# export KBUILD_OUTPUT=dir/to/store/output/files/ 109# make 110# 111# The O= assignment takes precedence over the KBUILD_OUTPUT environment 112# variable. 113 114# KBUILD_SRC is set on invocation of make in OBJ directory 115# KBUILD_SRC is not intended to be used by the regular user (for now) 116ifeq ($(KBUILD_SRC),) 117 118# OK, Make called in directory where kernel src resides 119# Do we want to locate output files in a separate directory? 120ifeq ("$(origin O)", "command line") 121 KBUILD_OUTPUT := $(O) 122endif 123 124# That's our default target when none is given on the command line 125PHONY := _all 126_all: 127 128# Cancel implicit rules on top Makefile 129$(CURDIR)/Makefile Makefile: ; 130 131ifneq ($(KBUILD_OUTPUT),) 132# Invoke a second make in the output directory, passing relevant variables 133# check that the output directory actually exists 134saved-output := $(KBUILD_OUTPUT) 135KBUILD_OUTPUT := $(shell mkdir -p $(KBUILD_OUTPUT) && cd $(KBUILD_OUTPUT) \ 136 && /bin/pwd) 137$(if $(KBUILD_OUTPUT),, \ 138 $(error failed to create output directory "$(saved-output)")) 139 140PHONY += $(MAKECMDGOALS) sub-make 141 142$(filter-out _all sub-make $(CURDIR)/Makefile, $(MAKECMDGOALS)) _all: sub-make 143 @: 144 145sub-make: FORCE 146 $(Q)$(MAKE) -C $(KBUILD_OUTPUT) KBUILD_SRC=$(CURDIR) \ 147 -f $(CURDIR)/Makefile $(filter-out _all sub-make,$(MAKECMDGOALS)) 148 149# Leave processing to above invocation of make 150skip-makefile := 1 151endif # ifneq ($(KBUILD_OUTPUT),) 152endif # ifeq ($(KBUILD_SRC),) 153 154# We process the rest of the Makefile if this is the final invocation of make 155ifeq ($(skip-makefile),) 156 157# Do not print "Entering directory ...", 158# but we want to display it when entering to the output directory 159# so that IDEs/editors are able to understand relative filenames. 160MAKEFLAGS += --no-print-directory 161 162# Call a source code checker (by default, "sparse") as part of the 163# C compilation. 164# 165# Use 'make C=1' to enable checking of only re-compiled files. 166# Use 'make C=2' to enable checking of *all* source files, regardless 167# of whether they are re-compiled or not. 168# 169# See the file "Documentation/sparse.txt" for more details, including 170# where to get the "sparse" utility. 171 172ifeq ("$(origin C)", "command line") 173 KBUILD_CHECKSRC = $(C) 174endif 175ifndef KBUILD_CHECKSRC 176 KBUILD_CHECKSRC = 0 177endif 178 179# Use make M=dir to specify directory of external module to build 180# Old syntax make ... SUBDIRS=$PWD is still supported 181# Setting the environment variable KBUILD_EXTMOD take precedence 182ifdef SUBDIRS 183 KBUILD_EXTMOD ?= $(SUBDIRS) 184endif 185 186ifeq ("$(origin M)", "command line") 187 KBUILD_EXTMOD := $(M) 188endif 189 190# If building an external module we do not care about the all: rule 191# but instead _all depend on modules 192PHONY += all 193ifeq ($(KBUILD_EXTMOD),) 194_all: all 195else 196_all: modules 197endif 198 199ifeq ($(KBUILD_SRC),) 200 # building in the source tree 201 srctree := . 202else 203 ifeq ($(KBUILD_SRC)/,$(dir $(CURDIR))) 204 # building in a subdirectory of the source tree 205 srctree := .. 206 else 207 srctree := $(KBUILD_SRC) 208 endif 209endif 210objtree := . 211src := $(srctree) 212obj := $(objtree) 213 214VPATH := $(srctree)$(if $(KBUILD_EXTMOD),:$(KBUILD_EXTMOD)) 215 216export srctree objtree VPATH 217 218# SUBARCH tells the usermode build what the underlying arch is. That is set 219# first, and if a usermode build is happening, the "ARCH=um" on the command 220# line overrides the setting of ARCH below. If a native build is happening, 221# then ARCH is assigned, getting whatever value it gets normally, and 222# SUBARCH is subsequently ignored. 223 224SUBARCH := $(shell uname -m | sed -e s/i.86/x86/ -e s/x86_64/x86/ \ 225 -e s/sun4u/sparc64/ \ 226 -e s/arm.*/arm/ -e s/sa110/arm/ \ 227 -e s/s390x/s390/ -e s/parisc64/parisc/ \ 228 -e s/ppc.*/powerpc/ -e s/mips.*/mips/ \ 229 -e s/sh[234].*/sh/ -e s/aarch64.*/arm64/ ) 230 231# Cross compiling and selecting different set of gcc/bin-utils 232# --------------------------------------------------------------------------- 233# 234# When performing cross compilation for other architectures ARCH shall be set 235# to the target architecture. (See arch/* for the possibilities). 236# ARCH can be set during invocation of make: 237# make ARCH=ia64 238# Another way is to have ARCH set in the environment. 239# The default ARCH is the host where make is executed. 240 241# CROSS_COMPILE specify the prefix used for all executables used 242# during compilation. Only gcc and related bin-utils executables 243# are prefixed with $(CROSS_COMPILE). 244# CROSS_COMPILE can be set on the command line 245# make CROSS_COMPILE=ia64-linux- 246# Alternatively CROSS_COMPILE can be set in the environment. 247# A third alternative is to store a setting in .config so that plain 248# "make" in the configured kernel build directory always uses that. 249# Default value for CROSS_COMPILE is not to prefix executables 250# Note: Some architectures assign CROSS_COMPILE in their arch/*/Makefile 251ARCH ?= $(SUBARCH) 252CROSS_COMPILE ?= $(CONFIG_CROSS_COMPILE:"%"=%) 253 254# Architecture as present in compile.h 255UTS_MACHINE := $(ARCH) 256SRCARCH := $(ARCH) 257 258# Additional ARCH settings for x86 259ifeq ($(ARCH),i386) 260 SRCARCH := x86 261endif 262ifeq ($(ARCH),x86_64) 263 SRCARCH := x86 264endif 265 266# Additional ARCH settings for sparc 267ifeq ($(ARCH),sparc32) 268 SRCARCH := sparc 269endif 270ifeq ($(ARCH),sparc64) 271 SRCARCH := sparc 272endif 273 274# Additional ARCH settings for sh 275ifeq ($(ARCH),sh64) 276 SRCARCH := sh 277endif 278 279# Additional ARCH settings for tile 280ifeq ($(ARCH),tilepro) 281 SRCARCH := tile 282endif 283ifeq ($(ARCH),tilegx) 284 SRCARCH := tile 285endif 286 287# Where to locate arch specific headers 288hdr-arch := $(SRCARCH) 289 290KCONFIG_CONFIG ?= .config 291export KCONFIG_CONFIG 292 293# SHELL used by kbuild 294CONFIG_SHELL := $(shell if [ -x "$$BASH" ]; then echo $$BASH; \ 295 else if [ -x /bin/bash ]; then echo /bin/bash; \ 296 else echo sh; fi ; fi) 297 298HOSTCC = gcc 299HOSTCXX = g++ 300HOSTCFLAGS = -Wall -Wmissing-prototypes -Wstrict-prototypes -O2 -fomit-frame-pointer -std=gnu89 301HOSTCXXFLAGS = -O2 302 303ifeq ($(shell $(HOSTCC) -v 2>&1 | grep -c "clang version"), 1) 304HOSTCFLAGS += -Wno-unused-value -Wno-unused-parameter \ 305 -Wno-missing-field-initializers -fno-delete-null-pointer-checks 306endif 307 308# Decide whether to build built-in, modular, or both. 309# Normally, just do built-in. 310 311KBUILD_MODULES := 312KBUILD_BUILTIN := 1 313 314# If we have only "make modules", don't compile built-in objects. 315# When we're building modules with modversions, we need to consider 316# the built-in objects during the descend as well, in order to 317# make sure the checksums are up to date before we record them. 318 319ifeq ($(MAKECMDGOALS),modules) 320 KBUILD_BUILTIN := $(if $(CONFIG_MODVERSIONS),1) 321endif 322 323# If we have "make <whatever> modules", compile modules 324# in addition to whatever we do anyway. 325# Just "make" or "make all" shall build modules as well 326 327ifneq ($(filter all _all modules,$(MAKECMDGOALS)),) 328 KBUILD_MODULES := 1 329endif 330 331ifeq ($(MAKECMDGOALS),) 332 KBUILD_MODULES := 1 333endif 334 335export KBUILD_MODULES KBUILD_BUILTIN 336export KBUILD_CHECKSRC KBUILD_SRC KBUILD_EXTMOD 337 338# We need some generic definitions (do not try to remake the file). 339scripts/Kbuild.include: ; 340include scripts/Kbuild.include 341 342# Make variables (CC, etc...) 343AS = $(CROSS_COMPILE)as 344LD = $(CROSS_COMPILE)ld 345CC = $(CROSS_COMPILE)gcc 346CPP = $(CC) -E 347AR = $(CROSS_COMPILE)ar 348NM = $(CROSS_COMPILE)nm 349STRIP = $(CROSS_COMPILE)strip 350OBJCOPY = $(CROSS_COMPILE)objcopy 351OBJDUMP = $(CROSS_COMPILE)objdump 352AWK = awk 353GENKSYMS = scripts/genksyms/genksyms 354INSTALLKERNEL := installkernel 355DEPMOD = /sbin/depmod 356PERL = perl 357PYTHON = python 358CHECK = sparse 359 360CHECKFLAGS := -D__linux__ -Dlinux -D__STDC__ -Dunix -D__unix__ \ 361 -Wbitwise -Wno-return-void $(CF) 362CFLAGS_MODULE = 363AFLAGS_MODULE = 364LDFLAGS_MODULE = 365CFLAGS_KERNEL = 366AFLAGS_KERNEL = 367CFLAGS_GCOV = -fprofile-arcs -ftest-coverage 368 369 370# Use USERINCLUDE when you must reference the UAPI directories only. 371USERINCLUDE := \ 372 -I$(srctree)/arch/$(hdr-arch)/include/uapi \ 373 -Iarch/$(hdr-arch)/include/generated/uapi \ 374 -I$(srctree)/include/uapi \ 375 -Iinclude/generated/uapi \ 376 -include $(srctree)/include/linux/kconfig.h 377 378# Use LINUXINCLUDE when you must reference the include/ directory. 379# Needed to be compatible with the O= option 380LINUXINCLUDE := \ 381 -I$(srctree)/arch/$(hdr-arch)/include \ 382 -Iarch/$(hdr-arch)/include/generated/uapi \ 383 -Iarch/$(hdr-arch)/include/generated \ 384 $(if $(KBUILD_SRC), -I$(srctree)/include) \ 385 -Iinclude \ 386 $(USERINCLUDE) 387 388KBUILD_CPPFLAGS := -D__KERNEL__ 389 390KBUILD_CFLAGS := -Wall -Wundef -Wstrict-prototypes -Wno-trigraphs \ 391 -fno-strict-aliasing -fno-common \ 392 -Werror-implicit-function-declaration \ 393 -Wno-format-security \ 394 -std=gnu89 395 396KBUILD_AFLAGS_KERNEL := 397KBUILD_CFLAGS_KERNEL := 398KBUILD_AFLAGS := -D__ASSEMBLY__ 399KBUILD_AFLAGS_MODULE := -DMODULE 400KBUILD_CFLAGS_MODULE := -DMODULE 401KBUILD_LDFLAGS_MODULE := -T $(srctree)/scripts/module-common.lds 402 403# Read KERNELRELEASE from include/config/kernel.release (if it exists) 404KERNELRELEASE = $(shell cat include/config/kernel.release 2> /dev/null) 405KERNELVERSION = $(VERSION)$(if $(PATCHLEVEL),.$(PATCHLEVEL)$(if $(SUBLEVEL),.$(SUBLEVEL)))$(EXTRAVERSION) 406 407export VERSION PATCHLEVEL SUBLEVEL KERNELRELEASE KERNELVERSION 408export ARCH SRCARCH CONFIG_SHELL HOSTCC HOSTCFLAGS CROSS_COMPILE AS LD CC 409export CPP AR NM STRIP OBJCOPY OBJDUMP 410export MAKE AWK GENKSYMS INSTALLKERNEL PERL PYTHON UTS_MACHINE 411export HOSTCXX HOSTCXXFLAGS LDFLAGS_MODULE CHECK CHECKFLAGS 412 413export KBUILD_CPPFLAGS NOSTDINC_FLAGS LINUXINCLUDE OBJCOPYFLAGS LDFLAGS 414export KBUILD_CFLAGS CFLAGS_KERNEL CFLAGS_MODULE CFLAGS_GCOV CFLAGS_KASAN 415export KBUILD_AFLAGS AFLAGS_KERNEL AFLAGS_MODULE 416export KBUILD_AFLAGS_MODULE KBUILD_CFLAGS_MODULE KBUILD_LDFLAGS_MODULE 417export KBUILD_AFLAGS_KERNEL KBUILD_CFLAGS_KERNEL 418export KBUILD_ARFLAGS 419 420# When compiling out-of-tree modules, put MODVERDIR in the module 421# tree rather than in the kernel tree. The kernel tree might 422# even be read-only. 423export MODVERDIR := $(if $(KBUILD_EXTMOD),$(firstword $(KBUILD_EXTMOD))/).tmp_versions 424 425# Files to ignore in find ... statements 426 427export RCS_FIND_IGNORE := \( -name SCCS -o -name BitKeeper -o -name .svn -o \ 428 -name CVS -o -name .pc -o -name .hg -o -name .git \) \ 429 -prune -o 430export RCS_TAR_IGNORE := --exclude SCCS --exclude BitKeeper --exclude .svn \ 431 --exclude CVS --exclude .pc --exclude .hg --exclude .git 432 433# =========================================================================== 434# Rules shared between *config targets and build targets 435 436# Basic helpers built in scripts/ 437PHONY += scripts_basic 438scripts_basic: 439 $(Q)$(MAKE) $(build)=scripts/basic 440 $(Q)rm -f .tmp_quiet_recordmcount 441 442# To avoid any implicit rule to kick in, define an empty command. 443scripts/basic/%: scripts_basic ; 444 445PHONY += outputmakefile 446# outputmakefile generates a Makefile in the output directory, if using a 447# separate output directory. This allows convenient use of make in the 448# output directory. 449outputmakefile: 450ifneq ($(KBUILD_SRC),) 451 $(Q)ln -fsn $(srctree) source 452 $(Q)$(CONFIG_SHELL) $(srctree)/scripts/mkmakefile \ 453 $(srctree) $(objtree) $(VERSION) $(PATCHLEVEL) 454endif 455 456# Support for using generic headers in asm-generic 457PHONY += asm-generic 458asm-generic: 459 $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.asm-generic \ 460 src=asm obj=arch/$(SRCARCH)/include/generated/asm 461 $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.asm-generic \ 462 src=uapi/asm obj=arch/$(SRCARCH)/include/generated/uapi/asm 463 464# To make sure we do not include .config for any of the *config targets 465# catch them early, and hand them over to scripts/kconfig/Makefile 466# It is allowed to specify more targets when calling make, including 467# mixing *config targets and build targets. 468# For example 'make oldconfig all'. 469# Detect when mixed targets is specified, and make a second invocation 470# of make so .config is not included in this case either (for *config). 471 472version_h := include/generated/uapi/linux/version.h 473old_version_h := include/linux/version.h 474 475no-dot-config-targets := clean mrproper distclean \ 476 cscope gtags TAGS tags help% %docs check% coccicheck \ 477 $(version_h) headers_% archheaders archscripts \ 478 kernelversion %src-pkg 479 480config-targets := 0 481mixed-targets := 0 482dot-config := 1 483 484ifneq ($(filter $(no-dot-config-targets), $(MAKECMDGOALS)),) 485 ifeq ($(filter-out $(no-dot-config-targets), $(MAKECMDGOALS)),) 486 dot-config := 0 487 endif 488endif 489 490ifeq ($(KBUILD_EXTMOD),) 491 ifneq ($(filter config %config,$(MAKECMDGOALS)),) 492 config-targets := 1 493 ifneq ($(words $(MAKECMDGOALS)),1) 494 mixed-targets := 1 495 endif 496 endif 497endif 498 499ifeq ($(mixed-targets),1) 500# =========================================================================== 501# We're called with mixed targets (*config and build targets). 502# Handle them one by one. 503 504PHONY += $(MAKECMDGOALS) __build_one_by_one 505 506$(filter-out __build_one_by_one, $(MAKECMDGOALS)): __build_one_by_one 507 @: 508 509__build_one_by_one: 510 $(Q)set -e; \ 511 for i in $(MAKECMDGOALS); do \ 512 $(MAKE) -f $(srctree)/Makefile $$i; \ 513 done 514 515else 516ifeq ($(config-targets),1) 517# =========================================================================== 518# *config targets only - make sure prerequisites are updated, and descend 519# in scripts/kconfig to make the *config target 520 521# Read arch specific Makefile to set KBUILD_DEFCONFIG as needed. 522# KBUILD_DEFCONFIG may point out an alternative default configuration 523# used for 'make defconfig' 524include arch/$(SRCARCH)/Makefile 525export KBUILD_DEFCONFIG KBUILD_KCONFIG 526 527config: scripts_basic outputmakefile FORCE 528 $(Q)$(MAKE) $(build)=scripts/kconfig $@ 529 530%config: scripts_basic outputmakefile FORCE 531 $(Q)$(MAKE) $(build)=scripts/kconfig $@ 532 533else 534# =========================================================================== 535# Build targets only - this includes vmlinux, arch specific targets, clean 536# targets and others. In general all targets except *config targets. 537 538ifeq ($(KBUILD_EXTMOD),) 539# Additional helpers built in scripts/ 540# Carefully list dependencies so we do not try to build scripts twice 541# in parallel 542PHONY += scripts 543scripts: scripts_basic include/config/auto.conf include/config/tristate.conf \ 544 asm-generic 545 $(Q)$(MAKE) $(build)=$(@) 546 547# Objects we will link into vmlinux / subdirs we need to visit 548init-y := init/ 549drivers-y := drivers/ sound/ firmware/ 550net-y := net/ 551libs-y := lib/ 552core-y := usr/ 553endif # KBUILD_EXTMOD 554 555ifeq ($(dot-config),1) 556# Read in config 557-include include/config/auto.conf 558 559ifeq ($(KBUILD_EXTMOD),) 560# Read in dependencies to all Kconfig* files, make sure to run 561# oldconfig if changes are detected. 562-include include/config/auto.conf.cmd 563 564# To avoid any implicit rule to kick in, define an empty command 565$(KCONFIG_CONFIG) include/config/auto.conf.cmd: ; 566 567# If .config is newer than include/config/auto.conf, someone tinkered 568# with it and forgot to run make oldconfig. 569# if auto.conf.cmd is missing then we are probably in a cleaned tree so 570# we execute the config step to be sure to catch updated Kconfig files 571include/config/%.conf: $(KCONFIG_CONFIG) include/config/auto.conf.cmd 572 $(Q)$(MAKE) -f $(srctree)/Makefile silentoldconfig 573else 574# external modules needs include/generated/autoconf.h and include/config/auto.conf 575# but do not care if they are up-to-date. Use auto.conf to trigger the test 576PHONY += include/config/auto.conf 577 578include/config/auto.conf: 579 $(Q)test -e include/generated/autoconf.h -a -e $@ || ( \ 580 echo >&2; \ 581 echo >&2 " ERROR: Kernel configuration is invalid."; \ 582 echo >&2 " include/generated/autoconf.h or $@ are missing.";\ 583 echo >&2 " Run 'make oldconfig && make prepare' on kernel src to fix it."; \ 584 echo >&2 ; \ 585 /bin/false) 586 587endif # KBUILD_EXTMOD 588 589else 590# Dummy target needed, because used as prerequisite 591include/config/auto.conf: ; 592endif # $(dot-config) 593 594# The all: target is the default when no target is given on the 595# command line. 596# This allow a user to issue only 'make' to build a kernel including modules 597# Defaults to vmlinux, but the arch makefile usually adds further targets 598all: vmlinux 599 600# The arch Makefile can set ARCH_{CPP,A,C}FLAGS to override the default 601# values of the respective KBUILD_* variables 602ARCH_CPPFLAGS := 603ARCH_AFLAGS := 604ARCH_CFLAGS := 605include arch/$(SRCARCH)/Makefile 606 607KBUILD_CFLAGS += $(call cc-option,-fno-delete-null-pointer-checks,) 608 609ifdef CONFIG_CC_OPTIMIZE_FOR_SIZE 610KBUILD_CFLAGS += -Os $(call cc-disable-warning,maybe-uninitialized,) 611else 612KBUILD_CFLAGS += -O2 613endif 614 615# Tell gcc to never replace conditional load with a non-conditional one 616KBUILD_CFLAGS += $(call cc-option,--param=allow-store-data-races=0) 617 618ifdef CONFIG_READABLE_ASM 619# Disable optimizations that make assembler listings hard to read. 620# reorder blocks reorders the control in the function 621# ipa clone creates specialized cloned functions 622# partial inlining inlines only parts of functions 623KBUILD_CFLAGS += $(call cc-option,-fno-reorder-blocks,) \ 624 $(call cc-option,-fno-ipa-cp-clone,) \ 625 $(call cc-option,-fno-partial-inlining) 626endif 627 628ifneq ($(CONFIG_FRAME_WARN),0) 629KBUILD_CFLAGS += $(call cc-option,-Wframe-larger-than=${CONFIG_FRAME_WARN}) 630endif 631 632# Handle stack protector mode. 633# 634# Since kbuild can potentially perform two passes (first with the old 635# .config values and then with updated .config values), we cannot error out 636# if a desired compiler option is unsupported. If we were to error, kbuild 637# could never get to the second pass and actually notice that we changed 638# the option to something that was supported. 639# 640# Additionally, we don't want to fallback and/or silently change which compiler 641# flags will be used, since that leads to producing kernels with different 642# security feature characteristics depending on the compiler used. ("But I 643# selected CC_STACKPROTECTOR_STRONG! Why did it build with _REGULAR?!") 644# 645# The middle ground is to warn here so that the failed option is obvious, but 646# to let the build fail with bad compiler flags so that we can't produce a 647# kernel when there is a CONFIG and compiler mismatch. 648# 649ifdef CONFIG_CC_STACKPROTECTOR_REGULAR 650 stackp-flag := -fstack-protector 651 ifeq ($(call cc-option, $(stackp-flag)),) 652 $(warning Cannot use CONFIG_CC_STACKPROTECTOR_REGULAR: \ 653 -fstack-protector not supported by compiler) 654 endif 655else 656ifdef CONFIG_CC_STACKPROTECTOR_STRONG 657 stackp-flag := -fstack-protector-strong 658 ifeq ($(call cc-option, $(stackp-flag)),) 659 $(warning Cannot use CONFIG_CC_STACKPROTECTOR_STRONG: \ 660 -fstack-protector-strong not supported by compiler) 661 endif 662else 663 # Force off for distro compilers that enable stack protector by default. 664 stackp-flag := $(call cc-option, -fno-stack-protector) 665endif 666endif 667KBUILD_CFLAGS += $(stackp-flag) 668 669ifeq ($(cc-name),clang) 670KBUILD_CPPFLAGS += $(call cc-option,-Qunused-arguments,) 671KBUILD_CPPFLAGS += $(call cc-option,-Wno-unknown-warning-option,) 672KBUILD_CFLAGS += $(call cc-disable-warning, unused-variable) 673KBUILD_CFLAGS += $(call cc-disable-warning, format-invalid-specifier) 674KBUILD_CFLAGS += $(call cc-disable-warning, gnu) 675# Quiet clang warning: comparison of unsigned expression < 0 is always false 676KBUILD_CFLAGS += $(call cc-disable-warning, tautological-compare) 677# CLANG uses a _MergedGlobals as optimization, but this breaks modpost, as the 678# source of a reference will be _MergedGlobals and not on of the whitelisted names. 679# See modpost pattern 2 680KBUILD_CFLAGS += $(call cc-option, -mno-global-merge,) 681KBUILD_CFLAGS += $(call cc-option, -fcatch-undefined-behavior) 682else 683 684# This warning generated too much noise in a regular build. 685# Use make W=1 to enable this warning (see scripts/Makefile.build) 686KBUILD_CFLAGS += $(call cc-disable-warning, unused-but-set-variable) 687endif 688 689ifdef CONFIG_FRAME_POINTER 690KBUILD_CFLAGS += -fno-omit-frame-pointer -fno-optimize-sibling-calls 691else 692# Some targets (ARM with Thumb2, for example), can't be built with frame 693# pointers. For those, we don't have FUNCTION_TRACER automatically 694# select FRAME_POINTER. However, FUNCTION_TRACER adds -pg, and this is 695# incompatible with -fomit-frame-pointer with current GCC, so we don't use 696# -fomit-frame-pointer with FUNCTION_TRACER. 697ifndef CONFIG_FUNCTION_TRACER 698KBUILD_CFLAGS += -fomit-frame-pointer 699endif 700endif 701 702KBUILD_CFLAGS += $(call cc-option, -fno-var-tracking-assignments) 703 704ifdef CONFIG_DEBUG_INFO 705ifdef CONFIG_DEBUG_INFO_SPLIT 706KBUILD_CFLAGS += $(call cc-option, -gsplit-dwarf, -g) 707else 708KBUILD_CFLAGS += -g 709endif 710KBUILD_AFLAGS += -Wa,-gdwarf-2 711endif 712ifdef CONFIG_DEBUG_INFO_DWARF4 713KBUILD_CFLAGS += $(call cc-option, -gdwarf-4,) 714endif 715 716ifdef CONFIG_DEBUG_INFO_REDUCED 717KBUILD_CFLAGS += $(call cc-option, -femit-struct-debug-baseonly) \ 718 $(call cc-option,-fno-var-tracking) 719endif 720 721ifdef CONFIG_FUNCTION_TRACER 722ifndef CC_FLAGS_FTRACE 723CC_FLAGS_FTRACE := -pg 724endif 725export CC_FLAGS_FTRACE 726ifdef CONFIG_HAVE_FENTRY 727CC_USING_FENTRY := $(call cc-option, -mfentry -DCC_USING_FENTRY) 728endif 729KBUILD_CFLAGS += $(CC_FLAGS_FTRACE) $(CC_USING_FENTRY) 730KBUILD_AFLAGS += $(CC_USING_FENTRY) 731ifdef CONFIG_DYNAMIC_FTRACE 732 ifdef CONFIG_HAVE_C_RECORDMCOUNT 733 BUILD_C_RECORDMCOUNT := y 734 export BUILD_C_RECORDMCOUNT 735 endif 736endif 737endif 738 739# We trigger additional mismatches with less inlining 740ifdef CONFIG_DEBUG_SECTION_MISMATCH 741KBUILD_CFLAGS += $(call cc-option, -fno-inline-functions-called-once) 742endif 743 744# arch Makefile may override CC so keep this after arch Makefile is included 745NOSTDINC_FLAGS += -nostdinc -isystem $(shell $(CC) -print-file-name=include) 746CHECKFLAGS += $(NOSTDINC_FLAGS) 747 748# warn about C99 declaration after statement 749KBUILD_CFLAGS += $(call cc-option,-Wdeclaration-after-statement,) 750 751# disable pointer signed / unsigned warnings in gcc 4.0 752KBUILD_CFLAGS += $(call cc-disable-warning, pointer-sign) 753 754# disable invalid "can't wrap" optimizations for signed / pointers 755KBUILD_CFLAGS += $(call cc-option,-fno-strict-overflow) 756 757# conserve stack if available 758KBUILD_CFLAGS += $(call cc-option,-fconserve-stack) 759 760# disallow errors like 'EXPORT_GPL(foo);' with missing header 761KBUILD_CFLAGS += $(call cc-option,-Werror=implicit-int) 762 763# require functions to have arguments in prototypes, not empty 'int foo()' 764KBUILD_CFLAGS += $(call cc-option,-Werror=strict-prototypes) 765 766# Prohibit date/time macros, which would make the build non-deterministic 767KBUILD_CFLAGS += $(call cc-option,-Werror=date-time) 768 769# use the deterministic mode of AR if available 770KBUILD_ARFLAGS := $(call ar-option,D) 771 772# check for 'asm goto' 773ifeq ($(shell $(CONFIG_SHELL) $(srctree)/scripts/gcc-goto.sh $(CC)), y) 774 KBUILD_CFLAGS += -DCC_HAVE_ASM_GOTO 775 KBUILD_AFLAGS += -DCC_HAVE_ASM_GOTO 776endif 777 778include scripts/Makefile.kasan 779include scripts/Makefile.extrawarn 780 781# Add any arch overrides and user supplied CPPFLAGS, AFLAGS and CFLAGS as the 782# last assignments 783KBUILD_CPPFLAGS += $(ARCH_CPPFLAGS) $(KCPPFLAGS) 784KBUILD_AFLAGS += $(ARCH_AFLAGS) $(KAFLAGS) 785KBUILD_CFLAGS += $(ARCH_CFLAGS) $(KCFLAGS) 786 787# Use --build-id when available. 788LDFLAGS_BUILD_ID = $(patsubst -Wl$(comma)%,%,\ 789 $(call cc-ldoption, -Wl$(comma)--build-id,)) 790KBUILD_LDFLAGS_MODULE += $(LDFLAGS_BUILD_ID) 791LDFLAGS_vmlinux += $(LDFLAGS_BUILD_ID) 792 793ifeq ($(CONFIG_STRIP_ASM_SYMS),y) 794LDFLAGS_vmlinux += $(call ld-option, -X,) 795endif 796 797# Default kernel image to build when no specific target is given. 798# KBUILD_IMAGE may be overruled on the command line or 799# set in the environment 800# Also any assignments in arch/$(ARCH)/Makefile take precedence over 801# this default value 802export KBUILD_IMAGE ?= vmlinux 803 804# 805# INSTALL_PATH specifies where to place the updated kernel and system map 806# images. Default is /boot, but you can set it to other values 807export INSTALL_PATH ?= /boot 808 809# 810# INSTALL_DTBS_PATH specifies a prefix for relocations required by build roots. 811# Like INSTALL_MOD_PATH, it isn't defined in the Makefile, but can be passed as 812# an argument if needed. Otherwise it defaults to the kernel install path 813# 814export INSTALL_DTBS_PATH ?= $(INSTALL_PATH)/dtbs/$(KERNELRELEASE) 815 816# 817# INSTALL_MOD_PATH specifies a prefix to MODLIB for module directory 818# relocations required by build roots. This is not defined in the 819# makefile but the argument can be passed to make if needed. 820# 821 822MODLIB = $(INSTALL_MOD_PATH)/lib/modules/$(KERNELRELEASE) 823export MODLIB 824 825# 826# INSTALL_MOD_STRIP, if defined, will cause modules to be 827# stripped after they are installed. If INSTALL_MOD_STRIP is '1', then 828# the default option --strip-debug will be used. Otherwise, 829# INSTALL_MOD_STRIP value will be used as the options to the strip command. 830 831ifdef INSTALL_MOD_STRIP 832ifeq ($(INSTALL_MOD_STRIP),1) 833mod_strip_cmd = $(STRIP) --strip-debug 834else 835mod_strip_cmd = $(STRIP) $(INSTALL_MOD_STRIP) 836endif # INSTALL_MOD_STRIP=1 837else 838mod_strip_cmd = true 839endif # INSTALL_MOD_STRIP 840export mod_strip_cmd 841 842# CONFIG_MODULE_COMPRESS, if defined, will cause module to be compressed 843# after they are installed in agreement with CONFIG_MODULE_COMPRESS_GZIP 844# or CONFIG_MODULE_COMPRESS_XZ. 845 846mod_compress_cmd = true 847ifdef CONFIG_MODULE_COMPRESS 848 ifdef CONFIG_MODULE_COMPRESS_GZIP 849 mod_compress_cmd = gzip -n -f 850 endif # CONFIG_MODULE_COMPRESS_GZIP 851 ifdef CONFIG_MODULE_COMPRESS_XZ 852 mod_compress_cmd = xz -f 853 endif # CONFIG_MODULE_COMPRESS_XZ 854endif # CONFIG_MODULE_COMPRESS 855export mod_compress_cmd 856 857# Select initial ramdisk compression format, default is gzip(1). 858# This shall be used by the dracut(8) tool while creating an initramfs image. 859# 860INITRD_COMPRESS-y := gzip 861INITRD_COMPRESS-$(CONFIG_RD_BZIP2) := bzip2 862INITRD_COMPRESS-$(CONFIG_RD_LZMA) := lzma 863INITRD_COMPRESS-$(CONFIG_RD_XZ) := xz 864INITRD_COMPRESS-$(CONFIG_RD_LZO) := lzo 865INITRD_COMPRESS-$(CONFIG_RD_LZ4) := lz4 866# do not export INITRD_COMPRESS, since we didn't actually 867# choose a sane default compression above. 868# export INITRD_COMPRESS := $(INITRD_COMPRESS-y) 869 870ifdef CONFIG_MODULE_SIG_ALL 871$(eval $(call config_filename,MODULE_SIG_KEY)) 872 873mod_sign_cmd = scripts/sign-file $(CONFIG_MODULE_SIG_HASH) $(MODULE_SIG_KEY_SRCPREFIX)$(CONFIG_MODULE_SIG_KEY) certs/signing_key.x509 874else 875mod_sign_cmd = true 876endif 877export mod_sign_cmd 878 879 880ifeq ($(KBUILD_EXTMOD),) 881core-y += kernel/ certs/ mm/ fs/ ipc/ security/ crypto/ block/ 882 883vmlinux-dirs := $(patsubst %/,%,$(filter %/, $(init-y) $(init-m) \ 884 $(core-y) $(core-m) $(drivers-y) $(drivers-m) \ 885 $(net-y) $(net-m) $(libs-y) $(libs-m))) 886 887vmlinux-alldirs := $(sort $(vmlinux-dirs) $(patsubst %/,%,$(filter %/, \ 888 $(init-) $(core-) $(drivers-) $(net-) $(libs-)))) 889 890init-y := $(patsubst %/, %/built-in.o, $(init-y)) 891core-y := $(patsubst %/, %/built-in.o, $(core-y)) 892drivers-y := $(patsubst %/, %/built-in.o, $(drivers-y)) 893net-y := $(patsubst %/, %/built-in.o, $(net-y)) 894libs-y1 := $(patsubst %/, %/lib.a, $(libs-y)) 895libs-y2 := $(patsubst %/, %/built-in.o, $(libs-y)) 896libs-y := $(libs-y1) $(libs-y2) 897 898# Externally visible symbols (used by link-vmlinux.sh) 899export KBUILD_VMLINUX_INIT := $(head-y) $(init-y) 900export KBUILD_VMLINUX_MAIN := $(core-y) $(libs-y) $(drivers-y) $(net-y) 901export KBUILD_LDS := arch/$(SRCARCH)/kernel/vmlinux.lds 902export LDFLAGS_vmlinux 903# used by scripts/pacmage/Makefile 904export KBUILD_ALLDIRS := $(sort $(filter-out arch/%,$(vmlinux-alldirs)) arch Documentation include samples scripts tools virt) 905 906vmlinux-deps := $(KBUILD_LDS) $(KBUILD_VMLINUX_INIT) $(KBUILD_VMLINUX_MAIN) 907 908# Final link of vmlinux 909 cmd_link-vmlinux = $(CONFIG_SHELL) $< $(LD) $(LDFLAGS) $(LDFLAGS_vmlinux) 910quiet_cmd_link-vmlinux = LINK $@ 911 912# Include targets which we want to 913# execute if the rest of the kernel build went well. 914vmlinux: scripts/link-vmlinux.sh $(vmlinux-deps) FORCE 915ifdef CONFIG_HEADERS_CHECK 916 $(Q)$(MAKE) -f $(srctree)/Makefile headers_check 917endif 918ifdef CONFIG_SAMPLES 919 $(Q)$(MAKE) $(build)=samples 920endif 921ifdef CONFIG_BUILD_DOCSRC 922 $(Q)$(MAKE) $(build)=Documentation 923endif 924ifdef CONFIG_GDB_SCRIPTS 925 $(Q)ln -fsn `cd $(srctree) && /bin/pwd`/scripts/gdb/vmlinux-gdb.py 926endif 927 +$(call if_changed,link-vmlinux) 928 929# The actual objects are generated when descending, 930# make sure no implicit rule kicks in 931$(sort $(vmlinux-deps)): $(vmlinux-dirs) ; 932 933# Handle descending into subdirectories listed in $(vmlinux-dirs) 934# Preset locale variables to speed up the build process. Limit locale 935# tweaks to this spot to avoid wrong language settings when running 936# make menuconfig etc. 937# Error messages still appears in the original language 938 939PHONY += $(vmlinux-dirs) 940$(vmlinux-dirs): prepare scripts 941 $(Q)$(MAKE) $(build)=$@ 942 943define filechk_kernel.release 944 echo "$(KERNELVERSION)$$($(CONFIG_SHELL) $(srctree)/scripts/setlocalversion $(srctree))" 945endef 946 947# Store (new) KERNELRELEASE string in include/config/kernel.release 948include/config/kernel.release: include/config/auto.conf FORCE 949 $(call filechk,kernel.release) 950 951 952# Things we need to do before we recursively start building the kernel 953# or the modules are listed in "prepare". 954# A multi level approach is used. prepareN is processed before prepareN-1. 955# archprepare is used in arch Makefiles and when processed asm symlink, 956# version.h and scripts_basic is processed / created. 957 958# Listed in dependency order 959PHONY += prepare archprepare prepare0 prepare1 prepare2 prepare3 960 961# prepare3 is used to check if we are building in a separate output directory, 962# and if so do: 963# 1) Check that make has not been executed in the kernel src $(srctree) 964prepare3: include/config/kernel.release 965ifneq ($(KBUILD_SRC),) 966 @$(kecho) ' Using $(srctree) as source for kernel' 967 $(Q)if [ -f $(srctree)/.config -o -d $(srctree)/include/config ]; then \ 968 echo >&2 " $(srctree) is not clean, please run 'make mrproper'"; \ 969 echo >&2 " in the '$(srctree)' directory.";\ 970 /bin/false; \ 971 fi; 972endif 973 974# prepare2 creates a makefile if using a separate output directory 975prepare2: prepare3 outputmakefile asm-generic 976 977prepare1: prepare2 $(version_h) include/generated/utsrelease.h \ 978 include/config/auto.conf 979 $(cmd_crmodverdir) 980 981archprepare: archheaders archscripts prepare1 scripts_basic 982 983prepare0: archprepare FORCE 984 $(Q)$(MAKE) $(build)=. 985 986# All the preparing.. 987prepare: prepare0 988 989# Generate some files 990# --------------------------------------------------------------------------- 991 992# KERNELRELEASE can change from a few different places, meaning version.h 993# needs to be updated, so this check is forced on all builds 994 995uts_len := 64 996define filechk_utsrelease.h 997 if [ `echo -n "$(KERNELRELEASE)" | wc -c ` -gt $(uts_len) ]; then \ 998 echo '"$(KERNELRELEASE)" exceeds $(uts_len) characters' >&2; \ 999 exit 1; \ 1000 fi; \ 1001 (echo \#define UTS_RELEASE \"$(KERNELRELEASE)\";) 1002endef 1003 1004define filechk_version.h 1005 (echo \#define LINUX_VERSION_CODE $(shell \ 1006 expr $(VERSION) \* 65536 + 0$(PATCHLEVEL) \* 256 + 0$(SUBLEVEL)); \ 1007 echo '#define KERNEL_VERSION(a,b,c) (((a) << 16) + ((b) << 8) + (c))';) 1008endef 1009 1010$(version_h): $(srctree)/Makefile FORCE 1011 $(call filechk,version.h) 1012 $(Q)rm -f $(old_version_h) 1013 1014include/generated/utsrelease.h: include/config/kernel.release FORCE 1015 $(call filechk,utsrelease.h) 1016 1017PHONY += headerdep 1018headerdep: 1019 $(Q)find $(srctree)/include/ -name '*.h' | xargs --max-args 1 \ 1020 $(srctree)/scripts/headerdep.pl -I$(srctree)/include 1021 1022# --------------------------------------------------------------------------- 1023# Firmware install 1024INSTALL_FW_PATH=$(INSTALL_MOD_PATH)/lib/firmware 1025export INSTALL_FW_PATH 1026 1027PHONY += firmware_install 1028firmware_install: FORCE 1029 @mkdir -p $(objtree)/firmware 1030 $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.fwinst obj=firmware __fw_install 1031 1032# --------------------------------------------------------------------------- 1033# Kernel headers 1034 1035#Default location for installed headers 1036export INSTALL_HDR_PATH = $(objtree)/usr 1037 1038# If we do an all arch process set dst to asm-$(hdr-arch) 1039hdr-dst = $(if $(KBUILD_HEADERS), dst=include/asm-$(hdr-arch), dst=include/asm) 1040 1041PHONY += archheaders 1042archheaders: 1043 1044PHONY += archscripts 1045archscripts: 1046 1047PHONY += __headers 1048__headers: $(version_h) scripts_basic asm-generic archheaders archscripts FORCE 1049 $(Q)$(MAKE) $(build)=scripts build_unifdef 1050 1051PHONY += headers_install_all 1052headers_install_all: 1053 $(Q)$(CONFIG_SHELL) $(srctree)/scripts/headers.sh install 1054 1055PHONY += headers_install 1056headers_install: __headers 1057 $(if $(wildcard $(srctree)/arch/$(hdr-arch)/include/uapi/asm/Kbuild),, \ 1058 $(error Headers not exportable for the $(SRCARCH) architecture)) 1059 $(Q)$(MAKE) $(hdr-inst)=include/uapi 1060 $(Q)$(MAKE) $(hdr-inst)=arch/$(hdr-arch)/include/uapi/asm $(hdr-dst) 1061 1062PHONY += headers_check_all 1063headers_check_all: headers_install_all 1064 $(Q)$(CONFIG_SHELL) $(srctree)/scripts/headers.sh check 1065 1066PHONY += headers_check 1067headers_check: headers_install 1068 $(Q)$(MAKE) $(hdr-inst)=include/uapi HDRCHECK=1 1069 $(Q)$(MAKE) $(hdr-inst)=arch/$(hdr-arch)/include/uapi/asm $(hdr-dst) HDRCHECK=1 1070 1071# --------------------------------------------------------------------------- 1072# Kernel selftest 1073 1074PHONY += kselftest 1075kselftest: 1076 $(Q)$(MAKE) -C tools/testing/selftests run_tests 1077 1078# --------------------------------------------------------------------------- 1079# Modules 1080 1081ifdef CONFIG_MODULES 1082 1083# By default, build modules as well 1084 1085all: modules 1086 1087# Build modules 1088# 1089# A module can be listed more than once in obj-m resulting in 1090# duplicate lines in modules.order files. Those are removed 1091# using awk while concatenating to the final file. 1092 1093PHONY += modules 1094modules: $(vmlinux-dirs) $(if $(KBUILD_BUILTIN),vmlinux) modules.builtin 1095 $(Q)$(AWK) '!x[$$0]++' $(vmlinux-dirs:%=$(objtree)/%/modules.order) > $(objtree)/modules.order 1096 @$(kecho) ' Building modules, stage 2.'; 1097 $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modpost 1098 $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.fwinst obj=firmware __fw_modbuild 1099 1100modules.builtin: $(vmlinux-dirs:%=%/modules.builtin) 1101 $(Q)$(AWK) '!x[$$0]++' $^ > $(objtree)/modules.builtin 1102 1103%/modules.builtin: include/config/auto.conf 1104 $(Q)$(MAKE) $(modbuiltin)=$* 1105 1106 1107# Target to prepare building external modules 1108PHONY += modules_prepare 1109modules_prepare: prepare scripts 1110 1111# Target to install modules 1112PHONY += modules_install 1113modules_install: _modinst_ _modinst_post 1114 1115PHONY += _modinst_ 1116_modinst_: 1117 @rm -rf $(MODLIB)/kernel 1118 @rm -f $(MODLIB)/source 1119 @mkdir -p $(MODLIB)/kernel 1120 @ln -s `cd $(srctree) && /bin/pwd` $(MODLIB)/source 1121 @if [ ! $(objtree) -ef $(MODLIB)/build ]; then \ 1122 rm -f $(MODLIB)/build ; \ 1123 ln -s $(CURDIR) $(MODLIB)/build ; \ 1124 fi 1125 @cp -f $(objtree)/modules.order $(MODLIB)/ 1126 @cp -f $(objtree)/modules.builtin $(MODLIB)/ 1127 $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modinst 1128 1129# This depmod is only for convenience to give the initial 1130# boot a modules.dep even before / is mounted read-write. However the 1131# boot script depmod is the master version. 1132PHONY += _modinst_post 1133_modinst_post: _modinst_ 1134 $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.fwinst obj=firmware __fw_modinst 1135 $(call cmd,depmod) 1136 1137ifeq ($(CONFIG_MODULE_SIG), y) 1138PHONY += modules_sign 1139modules_sign: 1140 $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modsign 1141endif 1142 1143else # CONFIG_MODULES 1144 1145# Modules not configured 1146# --------------------------------------------------------------------------- 1147 1148modules modules_install: FORCE 1149 @echo >&2 1150 @echo >&2 "The present kernel configuration has modules disabled." 1151 @echo >&2 "Type 'make config' and enable loadable module support." 1152 @echo >&2 "Then build a kernel with module support enabled." 1153 @echo >&2 1154 @exit 1 1155 1156endif # CONFIG_MODULES 1157 1158### 1159# Cleaning is done on three levels. 1160# make clean Delete most generated files 1161# Leave enough to build external modules 1162# make mrproper Delete the current configuration, and all generated files 1163# make distclean Remove editor backup files, patch leftover files and the like 1164 1165# Directories & files removed with 'make clean' 1166CLEAN_DIRS += $(MODVERDIR) 1167 1168# Directories & files removed with 'make mrproper' 1169MRPROPER_DIRS += include/config usr/include include/generated \ 1170 arch/*/include/generated .tmp_objdiff 1171MRPROPER_FILES += .config .config.old .version .old_version \ 1172 Module.symvers tags TAGS cscope* GPATH GTAGS GRTAGS GSYMS \ 1173 signing_key.pem signing_key.priv signing_key.x509 \ 1174 x509.genkey extra_certificates signing_key.x509.keyid \ 1175 signing_key.x509.signer vmlinux-gdb.py 1176 1177# clean - Delete most, but leave enough to build external modules 1178# 1179clean: rm-dirs := $(CLEAN_DIRS) 1180clean: rm-files := $(CLEAN_FILES) 1181clean-dirs := $(addprefix _clean_, . $(vmlinux-alldirs) Documentation samples) 1182 1183PHONY += $(clean-dirs) clean archclean vmlinuxclean 1184$(clean-dirs): 1185 $(Q)$(MAKE) $(clean)=$(patsubst _clean_%,%,$@) 1186 1187vmlinuxclean: 1188 $(Q)$(CONFIG_SHELL) $(srctree)/scripts/link-vmlinux.sh clean 1189 1190clean: archclean vmlinuxclean 1191 1192# mrproper - Delete all generated files, including .config 1193# 1194mrproper: rm-dirs := $(wildcard $(MRPROPER_DIRS)) 1195mrproper: rm-files := $(wildcard $(MRPROPER_FILES)) 1196mrproper-dirs := $(addprefix _mrproper_,Documentation/DocBook scripts) 1197 1198PHONY += $(mrproper-dirs) mrproper archmrproper 1199$(mrproper-dirs): 1200 $(Q)$(MAKE) $(clean)=$(patsubst _mrproper_%,%,$@) 1201 1202mrproper: clean archmrproper $(mrproper-dirs) 1203 $(call cmd,rmdirs) 1204 $(call cmd,rmfiles) 1205 1206# distclean 1207# 1208PHONY += distclean 1209 1210distclean: mrproper 1211 @find $(srctree) $(RCS_FIND_IGNORE) \ 1212 \( -name '*.orig' -o -name '*.rej' -o -name '*~' \ 1213 -o -name '*.bak' -o -name '#*#' -o -name '.*.orig' \ 1214 -o -name '.*.rej' -o -name '*%' -o -name 'core' \) \ 1215 -type f -print | xargs rm -f 1216 1217 1218# Packaging of the kernel to various formats 1219# --------------------------------------------------------------------------- 1220# rpm target kept for backward compatibility 1221package-dir := scripts/package 1222 1223%src-pkg: FORCE 1224 $(Q)$(MAKE) $(build)=$(package-dir) $@ 1225%pkg: include/config/kernel.release FORCE 1226 $(Q)$(MAKE) $(build)=$(package-dir) $@ 1227rpm: include/config/kernel.release FORCE 1228 $(Q)$(MAKE) $(build)=$(package-dir) $@ 1229 1230 1231# Brief documentation of the typical targets used 1232# --------------------------------------------------------------------------- 1233 1234boards := $(wildcard $(srctree)/arch/$(SRCARCH)/configs/*_defconfig) 1235boards := $(sort $(notdir $(boards))) 1236board-dirs := $(dir $(wildcard $(srctree)/arch/$(SRCARCH)/configs/*/*_defconfig)) 1237board-dirs := $(sort $(notdir $(board-dirs:/=))) 1238 1239help: 1240 @echo 'Cleaning targets:' 1241 @echo ' clean - Remove most generated files but keep the config and' 1242 @echo ' enough build support to build external modules' 1243 @echo ' mrproper - Remove all generated files + config + various backup files' 1244 @echo ' distclean - mrproper + remove editor backup and patch files' 1245 @echo '' 1246 @echo 'Configuration targets:' 1247 @$(MAKE) -f $(srctree)/scripts/kconfig/Makefile help 1248 @echo '' 1249 @echo 'Other generic targets:' 1250 @echo ' all - Build all targets marked with [*]' 1251 @echo '* vmlinux - Build the bare kernel' 1252 @echo '* modules - Build all modules' 1253 @echo ' modules_install - Install all modules to INSTALL_MOD_PATH (default: /)' 1254 @echo ' firmware_install- Install all firmware to INSTALL_FW_PATH' 1255 @echo ' (default: $$(INSTALL_MOD_PATH)/lib/firmware)' 1256 @echo ' dir/ - Build all files in dir and below' 1257 @echo ' dir/file.[oisS] - Build specified target only' 1258 @echo ' dir/file.lst - Build specified mixed source/assembly target only' 1259 @echo ' (requires a recent binutils and recent build (System.map))' 1260 @echo ' dir/file.ko - Build module including final link' 1261 @echo ' modules_prepare - Set up for building external modules' 1262 @echo ' tags/TAGS - Generate tags file for editors' 1263 @echo ' cscope - Generate cscope index' 1264 @echo ' gtags - Generate GNU GLOBAL index' 1265 @echo ' kernelrelease - Output the release version string (use with make -s)' 1266 @echo ' kernelversion - Output the version stored in Makefile (use with make -s)' 1267 @echo ' image_name - Output the image name (use with make -s)' 1268 @echo ' headers_install - Install sanitised kernel headers to INSTALL_HDR_PATH'; \ 1269 echo ' (default: $(INSTALL_HDR_PATH))'; \ 1270 echo '' 1271 @echo 'Static analysers' 1272 @echo ' checkstack - Generate a list of stack hogs' 1273 @echo ' namespacecheck - Name space analysis on compiled kernel' 1274 @echo ' versioncheck - Sanity check on version.h usage' 1275 @echo ' includecheck - Check for duplicate included header files' 1276 @echo ' export_report - List the usages of all exported symbols' 1277 @echo ' headers_check - Sanity check on exported headers' 1278 @echo ' headerdep - Detect inclusion cycles in headers' 1279 @$(MAKE) -f $(srctree)/scripts/Makefile.help checker-help 1280 @echo '' 1281 @echo 'Kernel selftest' 1282 @echo ' kselftest - Build and run kernel selftest (run as root)' 1283 @echo ' Build, install, and boot kernel before' 1284 @echo ' running kselftest on it' 1285 @echo '' 1286 @echo 'Kernel packaging:' 1287 @$(MAKE) $(build)=$(package-dir) help 1288 @echo '' 1289 @echo 'Documentation targets:' 1290 @$(MAKE) -f $(srctree)/Documentation/DocBook/Makefile dochelp 1291 @echo '' 1292 @echo 'Architecture specific targets ($(SRCARCH)):' 1293 @$(if $(archhelp),$(archhelp),\ 1294 echo ' No architecture specific help defined for $(SRCARCH)') 1295 @echo '' 1296 @$(if $(boards), \ 1297 $(foreach b, $(boards), \ 1298 printf " %-24s - Build for %s\\n" $(b) $(subst _defconfig,,$(b));) \ 1299 echo '') 1300 @$(if $(board-dirs), \ 1301 $(foreach b, $(board-dirs), \ 1302 printf " %-16s - Show %s-specific targets\\n" help-$(b) $(b);) \ 1303 printf " %-16s - Show all of the above\\n" help-boards; \ 1304 echo '') 1305 1306 @echo ' make V=0|1 [targets] 0 => quiet build (default), 1 => verbose build' 1307 @echo ' make V=2 [targets] 2 => give reason for rebuild of target' 1308 @echo ' make O=dir [targets] Locate all output files in "dir", including .config' 1309 @echo ' make C=1 [targets] Check all c source with $$CHECK (sparse by default)' 1310 @echo ' make C=2 [targets] Force check of all c source with $$CHECK' 1311 @echo ' make RECORDMCOUNT_WARN=1 [targets] Warn about ignored mcount sections' 1312 @echo ' make W=n [targets] Enable extra gcc checks, n=1,2,3 where' 1313 @echo ' 1: warnings which may be relevant and do not occur too often' 1314 @echo ' 2: warnings which occur quite often but may still be relevant' 1315 @echo ' 3: more obscure warnings, can most likely be ignored' 1316 @echo ' Multiple levels can be combined with W=12 or W=123' 1317 @echo '' 1318 @echo 'Execute "make" or "make all" to build all targets marked with [*] ' 1319 @echo 'For further info see the ./README file' 1320 1321 1322help-board-dirs := $(addprefix help-,$(board-dirs)) 1323 1324help-boards: $(help-board-dirs) 1325 1326boards-per-dir = $(sort $(notdir $(wildcard $(srctree)/arch/$(SRCARCH)/configs/$*/*_defconfig))) 1327 1328$(help-board-dirs): help-%: 1329 @echo 'Architecture specific targets ($(SRCARCH) $*):' 1330 @$(if $(boards-per-dir), \ 1331 $(foreach b, $(boards-per-dir), \ 1332 printf " %-24s - Build for %s\\n" $*/$(b) $(subst _defconfig,,$(b));) \ 1333 echo '') 1334 1335 1336# Documentation targets 1337# --------------------------------------------------------------------------- 1338%docs: scripts_basic FORCE 1339 $(Q)$(MAKE) $(build)=scripts build_docproc 1340 $(Q)$(MAKE) $(build)=Documentation/DocBook $@ 1341 1342else # KBUILD_EXTMOD 1343 1344### 1345# External module support. 1346# When building external modules the kernel used as basis is considered 1347# read-only, and no consistency checks are made and the make 1348# system is not used on the basis kernel. If updates are required 1349# in the basis kernel ordinary make commands (without M=...) must 1350# be used. 1351# 1352# The following are the only valid targets when building external 1353# modules. 1354# make M=dir clean Delete all automatically generated files 1355# make M=dir modules Make all modules in specified dir 1356# make M=dir Same as 'make M=dir modules' 1357# make M=dir modules_install 1358# Install the modules built in the module directory 1359# Assumes install directory is already created 1360 1361# We are always building modules 1362KBUILD_MODULES := 1 1363PHONY += crmodverdir 1364crmodverdir: 1365 $(cmd_crmodverdir) 1366 1367PHONY += $(objtree)/Module.symvers 1368$(objtree)/Module.symvers: 1369 @test -e $(objtree)/Module.symvers || ( \ 1370 echo; \ 1371 echo " WARNING: Symbol version dump $(objtree)/Module.symvers"; \ 1372 echo " is missing; modules will have no dependencies and modversions."; \ 1373 echo ) 1374 1375module-dirs := $(addprefix _module_,$(KBUILD_EXTMOD)) 1376PHONY += $(module-dirs) modules 1377$(module-dirs): crmodverdir $(objtree)/Module.symvers 1378 $(Q)$(MAKE) $(build)=$(patsubst _module_%,%,$@) 1379 1380modules: $(module-dirs) 1381 @$(kecho) ' Building modules, stage 2.'; 1382 $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modpost 1383 1384PHONY += modules_install 1385modules_install: _emodinst_ _emodinst_post 1386 1387install-dir := $(if $(INSTALL_MOD_DIR),$(INSTALL_MOD_DIR),extra) 1388PHONY += _emodinst_ 1389_emodinst_: 1390 $(Q)mkdir -p $(MODLIB)/$(install-dir) 1391 $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modinst 1392 1393PHONY += _emodinst_post 1394_emodinst_post: _emodinst_ 1395 $(call cmd,depmod) 1396 1397clean-dirs := $(addprefix _clean_,$(KBUILD_EXTMOD)) 1398 1399PHONY += $(clean-dirs) clean 1400$(clean-dirs): 1401 $(Q)$(MAKE) $(clean)=$(patsubst _clean_%,%,$@) 1402 1403clean: rm-dirs := $(MODVERDIR) 1404clean: rm-files := $(KBUILD_EXTMOD)/Module.symvers 1405 1406help: 1407 @echo ' Building external modules.' 1408 @echo ' Syntax: make -C path/to/kernel/src M=$$PWD target' 1409 @echo '' 1410 @echo ' modules - default target, build the module(s)' 1411 @echo ' modules_install - install the module' 1412 @echo ' clean - remove generated files in module directory only' 1413 @echo '' 1414 1415# Dummies... 1416PHONY += prepare scripts 1417prepare: ; 1418scripts: ; 1419endif # KBUILD_EXTMOD 1420 1421clean: $(clean-dirs) 1422 $(call cmd,rmdirs) 1423 $(call cmd,rmfiles) 1424 @find $(if $(KBUILD_EXTMOD), $(KBUILD_EXTMOD), .) $(RCS_FIND_IGNORE) \ 1425 \( -name '*.[oas]' -o -name '*.ko' -o -name '.*.cmd' \ 1426 -o -name '*.ko.*' \ 1427 -o -name '*.dwo' \ 1428 -o -name '*.su' \ 1429 -o -name '.*.d' -o -name '.*.tmp' -o -name '*.mod.c' \ 1430 -o -name '*.symtypes' -o -name 'modules.order' \ 1431 -o -name modules.builtin -o -name '.tmp_*.o.*' \ 1432 -o -name '*.gcno' \) -type f -print | xargs rm -f 1433 1434# Generate tags for editors 1435# --------------------------------------------------------------------------- 1436quiet_cmd_tags = GEN $@ 1437 cmd_tags = $(CONFIG_SHELL) $(srctree)/scripts/tags.sh $@ 1438 1439tags TAGS cscope gtags: FORCE 1440 $(call cmd,tags) 1441 1442# Scripts to check various things for consistency 1443# --------------------------------------------------------------------------- 1444 1445PHONY += includecheck versioncheck coccicheck namespacecheck export_report 1446 1447includecheck: 1448 find $(srctree)/* $(RCS_FIND_IGNORE) \ 1449 -name '*.[hcS]' -type f -print | sort \ 1450 | xargs $(PERL) -w $(srctree)/scripts/checkincludes.pl 1451 1452versioncheck: 1453 find $(srctree)/* $(RCS_FIND_IGNORE) \ 1454 -name '*.[hcS]' -type f -print | sort \ 1455 | xargs $(PERL) -w $(srctree)/scripts/checkversion.pl 1456 1457coccicheck: 1458 $(Q)$(CONFIG_SHELL) $(srctree)/scripts/$@ 1459 1460namespacecheck: 1461 $(PERL) $(srctree)/scripts/namespace.pl 1462 1463export_report: 1464 $(PERL) $(srctree)/scripts/export_report.pl 1465 1466endif #ifeq ($(config-targets),1) 1467endif #ifeq ($(mixed-targets),1) 1468 1469PHONY += checkstack kernelrelease kernelversion image_name 1470 1471# UML needs a little special treatment here. It wants to use the host 1472# toolchain, so needs $(SUBARCH) passed to checkstack.pl. Everyone 1473# else wants $(ARCH), including people doing cross-builds, which means 1474# that $(SUBARCH) doesn't work here. 1475ifeq ($(ARCH), um) 1476CHECKSTACK_ARCH := $(SUBARCH) 1477else 1478CHECKSTACK_ARCH := $(ARCH) 1479endif 1480checkstack: 1481 $(OBJDUMP) -d vmlinux $$(find . -name '*.ko') | \ 1482 $(PERL) $(src)/scripts/checkstack.pl $(CHECKSTACK_ARCH) 1483 1484kernelrelease: 1485 @echo "$(KERNELVERSION)$$($(CONFIG_SHELL) $(srctree)/scripts/setlocalversion $(srctree))" 1486 1487kernelversion: 1488 @echo $(KERNELVERSION) 1489 1490image_name: 1491 @echo $(KBUILD_IMAGE) 1492 1493# Clear a bunch of variables before executing the submake 1494tools/: FORCE 1495 $(Q)mkdir -p $(objtree)/tools 1496 $(Q)$(MAKE) LDFLAGS= MAKEFLAGS="$(filter --j% -j,$(MAKEFLAGS))" O=$(O) subdir=tools -C $(src)/tools/ 1497 1498tools/%: FORCE 1499 $(Q)mkdir -p $(objtree)/tools 1500 $(Q)$(MAKE) LDFLAGS= MAKEFLAGS="$(filter --j% -j,$(MAKEFLAGS))" O=$(O) subdir=tools -C $(src)/tools/ $* 1501 1502# Single targets 1503# --------------------------------------------------------------------------- 1504# Single targets are compatible with: 1505# - build with mixed source and output 1506# - build with separate output dir 'make O=...' 1507# - external modules 1508# 1509# target-dir => where to store outputfile 1510# build-dir => directory in kernel source tree to use 1511 1512ifeq ($(KBUILD_EXTMOD),) 1513 build-dir = $(patsubst %/,%,$(dir $@)) 1514 target-dir = $(dir $@) 1515else 1516 zap-slash=$(filter-out .,$(patsubst %/,%,$(dir $@))) 1517 build-dir = $(KBUILD_EXTMOD)$(if $(zap-slash),/$(zap-slash)) 1518 target-dir = $(if $(KBUILD_EXTMOD),$(dir $<),$(dir $@)) 1519endif 1520 1521%.s: %.c prepare scripts FORCE 1522 $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@) 1523%.i: %.c prepare scripts FORCE 1524 $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@) 1525%.o: %.c prepare scripts FORCE 1526 $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@) 1527%.lst: %.c prepare scripts FORCE 1528 $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@) 1529%.s: %.S prepare scripts FORCE 1530 $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@) 1531%.o: %.S prepare scripts FORCE 1532 $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@) 1533%.symtypes: %.c prepare scripts FORCE 1534 $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@) 1535 1536# Modules 1537/: prepare scripts FORCE 1538 $(cmd_crmodverdir) 1539 $(Q)$(MAKE) KBUILD_MODULES=$(if $(CONFIG_MODULES),1) \ 1540 $(build)=$(build-dir) 1541# Make sure the latest headers are built for Documentation 1542Documentation/: headers_install 1543%/: prepare scripts FORCE 1544 $(cmd_crmodverdir) 1545 $(Q)$(MAKE) KBUILD_MODULES=$(if $(CONFIG_MODULES),1) \ 1546 $(build)=$(build-dir) 1547%.ko: prepare scripts FORCE 1548 $(cmd_crmodverdir) 1549 $(Q)$(MAKE) KBUILD_MODULES=$(if $(CONFIG_MODULES),1) \ 1550 $(build)=$(build-dir) $(@:.ko=.o) 1551 $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modpost 1552 1553# FIXME Should go into a make.lib or something 1554# =========================================================================== 1555 1556quiet_cmd_rmdirs = $(if $(wildcard $(rm-dirs)),CLEAN $(wildcard $(rm-dirs))) 1557 cmd_rmdirs = rm -rf $(rm-dirs) 1558 1559quiet_cmd_rmfiles = $(if $(wildcard $(rm-files)),CLEAN $(wildcard $(rm-files))) 1560 cmd_rmfiles = rm -f $(rm-files) 1561 1562# Run depmod only if we have System.map and depmod is executable 1563quiet_cmd_depmod = DEPMOD $(KERNELRELEASE) 1564 cmd_depmod = $(CONFIG_SHELL) $(srctree)/scripts/depmod.sh $(DEPMOD) \ 1565 $(KERNELRELEASE) "$(patsubst y,_,$(CONFIG_HAVE_UNDERSCORE_SYMBOL_PREFIX))" 1566 1567# Create temporary dir for module support files 1568# clean it up only when building all modules 1569cmd_crmodverdir = $(Q)mkdir -p $(MODVERDIR) \ 1570 $(if $(KBUILD_MODULES),; rm -f $(MODVERDIR)/*) 1571 1572# read all saved command lines 1573 1574targets := $(wildcard $(sort $(targets))) 1575cmd_files := $(wildcard .*.cmd $(foreach f,$(targets),$(dir $(f)).$(notdir $(f)).cmd)) 1576 1577ifneq ($(cmd_files),) 1578 $(cmd_files): ; # Do not try to update included dependency files 1579 include $(cmd_files) 1580endif 1581 1582endif # skip-makefile 1583 1584PHONY += FORCE 1585FORCE: 1586 1587# Declare the contents of the .PHONY variable as phony. We keep that 1588# information in a variable so we can use it in if_changed and friends. 1589.PHONY: $(PHONY) 1590