]> git.proxmox.com Git - mirror_ubuntu-focal-kernel.git/blame - Makefile
mmc: core: retry CMD1 in mmc_send_op_cond() even if the ocr = 0
[mirror_ubuntu-focal-kernel.git] / Makefile
CommitLineData
b2441318 1# SPDX-License-Identifier: GPL-2.0
bfeffd15 2VERSION = 5
9e98c678 3PATCHLEVEL = 1
55922c9d 4SUBLEVEL = 0
dc4060a5 5EXTRAVERSION = -rc5
2e6e902d 6NAME = Shy Crocodile
1da177e4
LT
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
ba634ece
MY
14# That's our default target when none is given on the command line
15PHONY := _all
16_all:
17
1da177e4
LT
18# We are using a recursive build, so we need to do a little thinking
19# to get the ordering right.
20#
21# Most importantly: sub-Makefiles should only ever modify files in
22# their own directory. If in some directory we have a dependency on
23# a file in another dir (which doesn't happen often, but it's often
f49821ee 24# unavoidable when linking the built-in.a targets which finally
1da177e4
LT
25# turn into vmlinux), we will call a sub make in that other dir, and
26# after that we are sure that everything which is in that other dir
27# is now up to date.
28#
29# The only cases where we need to modify files which have global
30# effects are thus separated out and done before the recursive
31# descending is started. They are now explicitly listed as the
32# prepare rule.
33
221cc2d2 34ifneq ($(sub_make_done),1)
3812b8c5
MY
35
36# Do not use make's built-in rules and variables
37# (this increases performance and avoids hard-to-debug behaviour)
38MAKEFLAGS += -rR
39
40# Avoid funny character set dependencies
41unexport LC_ALL
42LC_COLLATE=C
43LC_NUMERIC=C
44export LC_COLLATE LC_NUMERIC
45
46# Avoid interference with shell env settings
47unexport GREP_OPTIONS
48
066b7ed9
MM
49# Beautify output
50# ---------------------------------------------------------------------------
51#
52# Normally, we echo the whole command before executing it. By making
53# that echo $($(quiet)$(cmd)), we now have the possibility to set
54# $(quiet) to choose other forms of output instead, e.g.
55#
56# quiet_cmd_cc_o_c = Compiling $(RELDIR)/$@
57# cmd_cc_o_c = $(CC) $(c_flags) -c -o $@ $<
58#
59# If $(quiet) is empty, the whole command will be printed.
60# If it is set to "quiet_", only the short version will be printed.
61# If it is set to "silent_", nothing will be printed at all, since
62# the variable $(silent_cmd_cc_o_c) doesn't exist.
63#
64# A simple variant is to prefix commands with $(Q) - that's useful
65# for commands that shall be hidden in non-verbose mode.
66#
67# $(Q)ln $@ :<
68#
69# If KBUILD_VERBOSE equals 0 then the above command will be hidden.
70# If KBUILD_VERBOSE equals 1 then the above command is displayed.
71#
1da177e4
LT
72# To put more focus on warnings, be less verbose as default
73# Use 'make V=1' to see the full commands
74
b8b0618c
CR
75ifeq ("$(origin V)", "command line")
76 KBUILD_VERBOSE = $(V)
1da177e4
LT
77endif
78ifndef KBUILD_VERBOSE
79 KBUILD_VERBOSE = 0
80endif
81
066b7ed9
MM
82ifeq ($(KBUILD_VERBOSE),1)
83 quiet =
84 Q =
85else
86 quiet=quiet_
87 Q = @
88endif
89
90# If the user is running make -s (silent mode), suppress echoing of
91# commands
92
6f0fa58e 93ifneq ($(findstring s,$(filter-out --%,$(MAKEFLAGS))),)
066b7ed9
MM
94 quiet=silent_
95endif
066b7ed9
MM
96
97export quiet Q KBUILD_VERBOSE
98
1da177e4
LT
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/"
070b98bf 104#
1da177e4
LT
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
c4e6fff1
C
114# KBUILD_SRC is not intended to be used by the regular user (for now),
115# it is set on invocation of make with KBUILD_OUTPUT or O= specified.
1da177e4
LT
116
117# OK, Make called in directory where kernel src resides
118# Do we want to locate output files in a separate directory?
b8b0618c
CR
119ifeq ("$(origin O)", "command line")
120 KBUILD_OUTPUT := $(O)
1da177e4
LT
121endif
122
51193b76
RJ
123ifneq ($(words $(subst :, ,$(CURDIR))), 1)
124 $(error main directory cannot contain spaces nor colons)
125endif
126
1da177e4 127ifneq ($(KBUILD_OUTPUT),)
1da177e4
LT
128# check that the output directory actually exists
129saved-output := $(KBUILD_OUTPUT)
028568d8 130KBUILD_OUTPUT := $(shell mkdir -p $(KBUILD_OUTPUT) && cd $(KBUILD_OUTPUT) \
16f8259c 131 && pwd)
1da177e4 132$(if $(KBUILD_OUTPUT),, \
1c9e70a5 133 $(error failed to create output directory "$(saved-output)"))
1da177e4 134
80463f1b
MY
135# Look for make include files relative to root of kernel src
136#
137# This does not become effective immediately because MAKEFLAGS is re-parsed
138# once after the Makefile is read. It is OK since we are going to invoke
139# 'sub-make' below.
140MAKEFLAGS += --include-dir=$(CURDIR)
141
688931a5 142need-sub-make := 1
3812b8c5
MY
143else
144
145# Do not print "Entering directory ..." at all for in-tree build.
146MAKEFLAGS += --no-print-directory
147
148endif # ifneq ($(KBUILD_OUTPUT),)
149
688931a5
MY
150ifneq ($(filter 3.%,$(MAKE_VERSION)),)
151# 'MAKEFLAGS += -rR' does not immediately become effective for GNU Make 3.x
152# We need to invoke sub-make to avoid implicit rules in the top Makefile.
153need-sub-make := 1
154# Cancel implicit rules for this Makefile.
155$(lastword $(MAKEFILE_LIST)): ;
156endif
157
221cc2d2
MY
158export sub_make_done := 1
159
688931a5
MY
160ifeq ($(need-sub-make),1)
161
0b35786d
MM
162PHONY += $(MAKECMDGOALS) sub-make
163
1cacc9ab 164$(filter-out _all sub-make $(CURDIR)/Makefile, $(MAKECMDGOALS)) _all: sub-make
16f89098 165 @:
0b35786d 166
c4e6fff1 167# Invoke a second make in the output directory, passing relevant variables
2e8d696b 168sub-make:
221cc2d2 169 $(Q)$(MAKE) \
3812b8c5 170 $(if $(KBUILD_OUTPUT),-C $(KBUILD_OUTPUT) KBUILD_SRC=$(CURDIR)) \
aa55c8e2 171 -f $(CURDIR)/Makefile $(filter-out _all sub-make,$(MAKECMDGOALS))
1da177e4 172
688931a5 173endif # need-sub-make
221cc2d2 174endif # sub_make_done
688931a5 175
1da177e4 176# We process the rest of the Makefile if this is the final invocation of make
688931a5 177ifeq ($(need-sub-make),)
1da177e4 178
7ff52571
MY
179# Do not print "Entering directory ...",
180# but we want to display it when entering to the output directory
181# so that IDEs/editors are able to understand relative filenames.
182MAKEFLAGS += --no-print-directory
183
aa55c8e2
MY
184# Call a source code checker (by default, "sparse") as part of the
185# C compilation.
186#
187# Use 'make C=1' to enable checking of only re-compiled files.
188# Use 'make C=2' to enable checking of *all* source files, regardless
189# of whether they are re-compiled or not.
190#
036db11c
C
191# See the file "Documentation/dev-tools/sparse.rst" for more details,
192# including where to get the "sparse" utility.
aa55c8e2
MY
193
194ifeq ("$(origin C)", "command line")
195 KBUILD_CHECKSRC = $(C)
196endif
197ifndef KBUILD_CHECKSRC
198 KBUILD_CHECKSRC = 0
199endif
200
201# Use make M=dir to specify directory of external module to build
202# Old syntax make ... SUBDIRS=$PWD is still supported
203# Setting the environment variable KBUILD_EXTMOD take precedence
204ifdef SUBDIRS
0126be38
MY
205 $(warning ================= WARNING ================)
206 $(warning 'SUBDIRS' will be removed after Linux 5.3)
207 $(warning Please use 'M=' or 'KBUILD_EXTMOD' instead)
208 $(warning ==========================================)
aa55c8e2
MY
209 KBUILD_EXTMOD ?= $(SUBDIRS)
210endif
211
212ifeq ("$(origin M)", "command line")
213 KBUILD_EXTMOD := $(M)
214endif
215
9da0763b
MM
216ifeq ($(KBUILD_SRC),)
217 # building in the source tree
218 srctree := .
219else
220 ifeq ($(KBUILD_SRC)/,$(dir $(CURDIR)))
221 # building in a subdirectory of the source tree
222 srctree := ..
223 else
224 srctree := $(KBUILD_SRC)
225 endif
226endif
2c1f4f12
MY
227
228export KBUILD_CHECKSRC KBUILD_EXTMOD KBUILD_SRC
229
7e1c0477 230objtree := .
1da177e4
LT
231src := $(srctree)
232obj := $(objtree)
233
6b12de69 234VPATH := $(srctree)
1da177e4 235
11294235 236export srctree objtree VPATH
1da177e4 237
2c1f4f12
MY
238# To make sure we do not include .config for any of the *config targets
239# catch them early, and hand them over to scripts/kconfig/Makefile
240# It is allowed to specify more targets when calling make, including
241# mixing *config targets and build targets.
242# For example 'make oldconfig all'.
243# Detect when mixed targets is specified, and make a second invocation
244# of make so .config is not included in this case either (for *config).
245
246version_h := include/generated/uapi/linux/version.h
247old_version_h := include/linux/version.h
248
22340a06
MY
249clean-targets := %clean mrproper cleandocs
250no-dot-config-targets := $(clean-targets) \
2c1f4f12
MY
251 cscope gtags TAGS tags help% %docs check% coccicheck \
252 $(version_h) headers_% archheaders archscripts \
63e31a67 253 %asm-generic kernelversion %src-pkg
a29d4d8c
MY
254no-sync-config-targets := $(no-dot-config-targets) install %install \
255 kernelrelease
2c1f4f12 256
d7942413
MY
257config-targets := 0
258mixed-targets := 0
259dot-config := 1
260may-sync-config := 1
2c1f4f12
MY
261
262ifneq ($(filter $(no-dot-config-targets), $(MAKECMDGOALS)),)
263 ifeq ($(filter-out $(no-dot-config-targets), $(MAKECMDGOALS)),)
264 dot-config := 0
265 endif
266endif
267
d7942413
MY
268ifneq ($(filter $(no-sync-config-targets), $(MAKECMDGOALS)),)
269 ifeq ($(filter-out $(no-sync-config-targets), $(MAKECMDGOALS)),)
270 may-sync-config := 0
271 endif
272endif
273
274ifneq ($(KBUILD_EXTMOD),)
275 may-sync-config := 0
276endif
277
2c1f4f12
MY
278ifeq ($(KBUILD_EXTMOD),)
279 ifneq ($(filter config %config,$(MAKECMDGOALS)),)
280 config-targets := 1
281 ifneq ($(words $(MAKECMDGOALS)),1)
282 mixed-targets := 1
283 endif
284 endif
285endif
22340a06
MY
286
287# For "make -j clean all", "make -j mrproper defconfig all", etc.
288ifneq ($(filter $(clean-targets),$(MAKECMDGOALS)),)
289 ifneq ($(filter-out $(clean-targets),$(MAKECMDGOALS)),)
290 mixed-targets := 1
291 endif
292endif
293
2c1f4f12
MY
294# install and modules_install need also be processed one by one
295ifneq ($(filter install,$(MAKECMDGOALS)),)
296 ifneq ($(filter modules_install,$(MAKECMDGOALS)),)
297 mixed-targets := 1
298 endif
299endif
300
301ifeq ($(mixed-targets),1)
302# ===========================================================================
303# We're called with mixed targets (*config and build targets).
304# Handle them one by one.
305
306PHONY += $(MAKECMDGOALS) __build_one_by_one
307
308$(filter-out __build_one_by_one, $(MAKECMDGOALS)): __build_one_by_one
309 @:
310
311__build_one_by_one:
312 $(Q)set -e; \
313 for i in $(MAKECMDGOALS); do \
314 $(MAKE) -f $(srctree)/Makefile $$i; \
315 done
316
317else
318
2c1f4f12
MY
319include scripts/Kbuild.include
320
321# Read KERNELRELEASE from include/config/kernel.release (if it exists)
322KERNELRELEASE = $(shell cat include/config/kernel.release 2> /dev/null)
323KERNELVERSION = $(VERSION)$(if $(PATCHLEVEL),.$(PATCHLEVEL)$(if $(SUBLEVEL),.$(SUBLEVEL)))$(EXTRAVERSION)
324export VERSION PATCHLEVEL SUBLEVEL KERNELRELEASE KERNELVERSION
325
b2d35fa5 326include scripts/subarch.include
1da177e4
LT
327
328# Cross compiling and selecting different set of gcc/bin-utils
329# ---------------------------------------------------------------------------
330#
331# When performing cross compilation for other architectures ARCH shall be set
332# to the target architecture. (See arch/* for the possibilities).
333# ARCH can be set during invocation of make:
334# make ARCH=ia64
335# Another way is to have ARCH set in the environment.
336# The default ARCH is the host where make is executed.
337
338# CROSS_COMPILE specify the prefix used for all executables used
339# during compilation. Only gcc and related bin-utils executables
340# are prefixed with $(CROSS_COMPILE).
341# CROSS_COMPILE can be set on the command line
342# make CROSS_COMPILE=ia64-linux-
343# Alternatively CROSS_COMPILE can be set in the environment.
344# Default value for CROSS_COMPILE is not to prefix executables
345# Note: Some architectures assign CROSS_COMPILE in their arch/*/Makefile
2331d1a6 346ARCH ?= $(SUBARCH)
1da177e4
LT
347
348# Architecture as present in compile.h
6752ed90
TG
349UTS_MACHINE := $(ARCH)
350SRCARCH := $(ARCH)
1da177e4 351
d746d647
SR
352# Additional ARCH settings for x86
353ifeq ($(ARCH),i386)
354 SRCARCH := x86
355endif
356ifeq ($(ARCH),x86_64)
357 SRCARCH := x86
358endif
74b469f2 359
5e538790 360# Additional ARCH settings for sparc
e69f58c0
NK
361ifeq ($(ARCH),sparc32)
362 SRCARCH := sparc
363endif
a439fe51 364ifeq ($(ARCH),sparc64)
5e538790 365 SRCARCH := sparc
a439fe51 366endif
2fb9b1bd 367
3cc000b5
PM
368# Additional ARCH settings for sh
369ifeq ($(ARCH),sh64)
370 SRCARCH := sh
371endif
372
14cdd3c4 373KCONFIG_CONFIG ?= .config
41263fc6 374export KCONFIG_CONFIG
14cdd3c4 375
1da177e4
LT
376# SHELL used by kbuild
377CONFIG_SHELL := $(shell if [ -x "$$BASH" ]; then echo $$BASH; \
378 else if [ -x /bin/bash ]; then echo /bin/bash; \
379 else echo sh; fi ; fi)
380
6d79a7b4
MY
381HOST_LFS_CFLAGS := $(shell getconf LFS_CFLAGS 2>/dev/null)
382HOST_LFS_LDFLAGS := $(shell getconf LFS_LDFLAGS 2>/dev/null)
383HOST_LFS_LIBS := $(shell getconf LFS_LIBS 2>/dev/null)
d7f14c66 384
070b98bf
SR
385HOSTCC = gcc
386HOSTCXX = g++
96f14fe7 387KBUILD_HOSTCFLAGS := -Wall -Wmissing-prototypes -Wstrict-prototypes -O2 \
f92d19e0
LA
388 -fomit-frame-pointer -std=gnu89 $(HOST_LFS_CFLAGS) \
389 $(HOSTCFLAGS)
390KBUILD_HOSTCXXFLAGS := -O2 $(HOST_LFS_CFLAGS) $(HOSTCXXFLAGS)
391KBUILD_HOSTLDFLAGS := $(HOST_LFS_LDFLAGS) $(HOSTLDFLAGS)
392KBUILD_HOSTLDLIBS := $(HOST_LFS_LIBS) $(HOSTLDLIBS)
1da177e4 393
1da177e4 394# Make variables (CC, etc...)
1da177e4
LT
395AS = $(CROSS_COMPILE)as
396LD = $(CROSS_COMPILE)ld
397CC = $(CROSS_COMPILE)gcc
398CPP = $(CC) -E
399AR = $(CROSS_COMPILE)ar
400NM = $(CROSS_COMPILE)nm
401STRIP = $(CROSS_COMPILE)strip
402OBJCOPY = $(CROSS_COMPILE)objcopy
403OBJDUMP = $(CROSS_COMPILE)objdump
73a4f6db
MY
404LEX = flex
405YACC = bison
1da177e4 406AWK = awk
caa27b66 407INSTALLKERNEL := installkernel
1da177e4 408DEPMOD = /sbin/depmod
1da177e4 409PERL = perl
011bf125 410PYTHON = python
e9781b52
MY
411PYTHON2 = python2
412PYTHON3 = python3
1da177e4
LT
413CHECK = sparse
414
80a7d1d9 415CHECKFLAGS := -D__linux__ -Dlinux -D__STDC__ -Dunix -D__unix__ \
6c49f359 416 -Wbitwise -Wno-return-void -Wno-unknown-attribute $(CF)
0c22be07 417NOSTDINC_FLAGS :=
6588169d
SR
418CFLAGS_MODULE =
419AFLAGS_MODULE =
420LDFLAGS_MODULE =
1da177e4
LT
421CFLAGS_KERNEL =
422AFLAGS_KERNEL =
b36fad65 423LDFLAGS_vmlinux =
1da177e4 424
abbf1590
DH
425# Use USERINCLUDE when you must reference the UAPI directories only.
426USERINCLUDE := \
9d022c54
MY
427 -I$(srctree)/arch/$(SRCARCH)/include/uapi \
428 -I$(objtree)/arch/$(SRCARCH)/include/generated/uapi \
abbf1590 429 -I$(srctree)/include/uapi \
3308b285 430 -I$(objtree)/include/generated/uapi \
abbf1590
DH
431 -include $(srctree)/include/linux/kconfig.h
432
1da177e4
LT
433# Use LINUXINCLUDE when you must reference the include/ directory.
434# Needed to be compatible with the O= option
abbf1590 435LINUXINCLUDE := \
9d022c54
MY
436 -I$(srctree)/arch/$(SRCARCH)/include \
437 -I$(objtree)/arch/$(SRCARCH)/include/generated \
abbf1590 438 $(if $(KBUILD_SRC), -I$(srctree)/include) \
f8224f7f
MY
439 -I$(objtree)/include \
440 $(USERINCLUDE)
1da177e4 441
42a92bcc 442KBUILD_AFLAGS := -D__ASSEMBLY__ -fno-PIE
eeb5687a 443KBUILD_CFLAGS := -Wall -Wundef -Werror=strict-prototypes -Wno-trigraphs \
42a92bcc 444 -fno-strict-aliasing -fno-common -fshort-wchar -fno-PIE \
b89f25ea 445 -Werror=implicit-function-declaration -Werror=implicit-int \
51b97e35 446 -Wno-format-security \
433dc2eb
MY
447 -std=gnu89
448KBUILD_CPPFLAGS := -D__KERNEL__
80c00ba9
SR
449KBUILD_AFLAGS_KERNEL :=
450KBUILD_CFLAGS_KERNEL :=
6588169d
SR
451KBUILD_AFLAGS_MODULE := -DMODULE
452KBUILD_CFLAGS_MODULE := -DMODULE
453KBUILD_LDFLAGS_MODULE := -T $(srctree)/scripts/module-common.lds
d503ac53 454KBUILD_LDFLAGS :=
433dc2eb 455GCC_PLUGINS_CFLAGS :=
1da177e4 456
96f14fe7 457export ARCH SRCARCH CONFIG_SHELL HOSTCC KBUILD_HOSTCFLAGS CROSS_COMPILE AS LD CC
8377bd2b 458export CPP AR NM STRIP OBJCOPY OBJDUMP KBUILD_HOSTLDFLAGS KBUILD_HOSTLDLIBS
88110713 459export MAKE LEX YACC AWK INSTALLKERNEL PERL PYTHON PYTHON2 PYTHON3 UTS_MACHINE
10844aeb 460export HOSTCXX KBUILD_HOSTCXXFLAGS LDFLAGS_MODULE CHECK CHECKFLAGS
1da177e4 461
d503ac53 462export KBUILD_CPPFLAGS NOSTDINC_FLAGS LINUXINCLUDE OBJCOPYFLAGS KBUILD_LDFLAGS
0e410e15
AK
463export KBUILD_CFLAGS CFLAGS_KERNEL CFLAGS_MODULE
464export CFLAGS_KASAN CFLAGS_KASAN_NOSANITIZE CFLAGS_UBSAN
222d394d 465export KBUILD_AFLAGS AFLAGS_KERNEL AFLAGS_MODULE
6588169d 466export KBUILD_AFLAGS_MODULE KBUILD_CFLAGS_MODULE KBUILD_LDFLAGS_MODULE
80c00ba9 467export KBUILD_AFLAGS_KERNEL KBUILD_CFLAGS_KERNEL
40df759e 468export KBUILD_ARFLAGS
1da177e4
LT
469
470# When compiling out-of-tree modules, put MODVERDIR in the module
471# tree rather than in the kernel tree. The kernel tree might
472# even be read-only.
473export MODVERDIR := $(if $(KBUILD_EXTMOD),$(firstword $(KBUILD_EXTMOD))/).tmp_versions
474
1da177e4
LT
475# Files to ignore in find ... statements
476
ae63b2d7
PB
477export RCS_FIND_IGNORE := \( -name SCCS -o -name BitKeeper -o -name .svn -o \
478 -name CVS -o -name .pc -o -name .hg -o -name .git \) \
479 -prune -o
450c6076
JJ
480export RCS_TAR_IGNORE := --exclude SCCS --exclude BitKeeper --exclude .svn \
481 --exclude CVS --exclude .pc --exclude .hg --exclude .git
1da177e4
LT
482
483# ===========================================================================
484# Rules shared between *config targets and build targets
485
312a3d09 486# Basic helpers built in scripts/basic/
4f193362 487PHONY += scripts_basic
1da177e4
LT
488scripts_basic:
489 $(Q)$(MAKE) $(build)=scripts/basic
638adb05 490 $(Q)rm -f .tmp_quiet_recordmcount
1da177e4 491
4f193362 492PHONY += outputmakefile
fd5f0cd6
JB
493# outputmakefile generates a Makefile in the output directory, if using a
494# separate output directory. This allows convenient use of make in the
495# output directory.
3a51ff34
VK
496# At the same time when output Makefile generated, generate .gitignore to
497# ignore whole output directory
1da177e4 498outputmakefile:
fd5f0cd6 499ifneq ($(KBUILD_SRC),)
92979997 500 $(Q)ln -fsn $(srctree) source
4fd61277 501 $(Q)$(CONFIG_SHELL) $(srctree)/scripts/mkmakefile $(srctree)
156e7cbb
MY
502 $(Q)test -e .gitignore || \
503 { echo "# this is build directory, ignore it"; echo "*"; } > .gitignore
fd5f0cd6 504endif
1da177e4 505
99516742 506ifneq ($(shell $(CC) --version 2>&1 | head -n 1 | grep clang),)
ae6b289a 507ifneq ($(CROSS_COMPILE),)
238bcbc4 508CLANG_FLAGS := --target=$(notdir $(CROSS_COMPILE:%-=%))
ad15006c 509GCC_TOOLCHAIN_DIR := $(dir $(shell which $(CROSS_COMPILE)elfedit))
238bcbc4 510CLANG_FLAGS += --prefix=$(GCC_TOOLCHAIN_DIR)
ef8c4ed9 511GCC_TOOLCHAIN := $(realpath $(GCC_TOOLCHAIN_DIR)/..)
ae6b289a
CF
512endif
513ifneq ($(GCC_TOOLCHAIN),)
238bcbc4 514CLANG_FLAGS += --gcc-toolchain=$(GCC_TOOLCHAIN)
ae6b289a 515endif
238bcbc4
MY
516CLANG_FLAGS += -no-integrated-as
517KBUILD_CFLAGS += $(CLANG_FLAGS)
518KBUILD_AFLAGS += $(CLANG_FLAGS)
3bd98050 519export CLANG_FLAGS
ae6b289a
CF
520endif
521
d5028ba8 522RETPOLINE_CFLAGS_GCC := -mindirect-branch=thunk-extern -mindirect-branch-register
2e549b2e 523RETPOLINE_VDSO_CFLAGS_GCC := -mindirect-branch=thunk-inline -mindirect-branch-register
d5028ba8 524RETPOLINE_CFLAGS_CLANG := -mretpoline-external-thunk
2e549b2e 525RETPOLINE_VDSO_CFLAGS_CLANG := -mretpoline
d5028ba8 526RETPOLINE_CFLAGS := $(call cc-option,$(RETPOLINE_CFLAGS_GCC),$(call cc-option,$(RETPOLINE_CFLAGS_CLANG)))
2e549b2e 527RETPOLINE_VDSO_CFLAGS := $(call cc-option,$(RETPOLINE_VDSO_CFLAGS_GCC),$(call cc-option,$(RETPOLINE_VDSO_CFLAGS_CLANG)))
d5028ba8 528export RETPOLINE_CFLAGS
2e549b2e 529export RETPOLINE_VDSO_CFLAGS
d5028ba8 530
315bab4e
MY
531# The expansion should be delayed until arch/$(SRCARCH)/Makefile is included.
532# Some architectures define CROSS_COMPILE in arch/$(SRCARCH)/Makefile.
533# CC_VERSION_TEXT is referenced from Kconfig (so it needs export),
534# and from include/config/auto.conf.cmd to detect the compiler upgrade.
535CC_VERSION_TEXT = $(shell $(CC) --version | head -n 1)
536
1da177e4
LT
537ifeq ($(config-targets),1)
538# ===========================================================================
539# *config targets only - make sure prerequisites are updated, and descend
540# in scripts/kconfig to make the *config target
541
542# Read arch specific Makefile to set KBUILD_DEFCONFIG as needed.
543# KBUILD_DEFCONFIG may point out an alternative default configuration
544# used for 'make defconfig'
a436bb7b 545include arch/$(SRCARCH)/Makefile
315bab4e 546export KBUILD_DEFCONFIG KBUILD_KCONFIG CC_VERSION_TEXT
1da177e4 547
31110ebb 548config: scripts_basic outputmakefile FORCE
31110ebb
SR
549 $(Q)$(MAKE) $(build)=scripts/kconfig $@
550
551%config: scripts_basic outputmakefile FORCE
1da177e4
LT
552 $(Q)$(MAKE) $(build)=scripts/kconfig $@
553
554else
555# ===========================================================================
556# Build targets only - this includes vmlinux, arch specific targets, clean
557# targets and others. In general all targets except *config targets.
558
2c1f4f12
MY
559# If building an external module we do not care about the all: rule
560# but instead _all depend on modules
561PHONY += all
562ifeq ($(KBUILD_EXTMOD),)
563_all: all
564else
565_all: modules
566endif
567
568# Decide whether to build built-in, modular, or both.
569# Normally, just do built-in.
570
571KBUILD_MODULES :=
572KBUILD_BUILTIN := 1
573
574# If we have only "make modules", don't compile built-in objects.
575# When we're building modules with modversions, we need to consider
576# the built-in objects during the descend as well, in order to
577# make sure the checksums are up to date before we record them.
578
579ifeq ($(MAKECMDGOALS),modules)
580 KBUILD_BUILTIN := $(if $(CONFIG_MODVERSIONS),1)
581endif
582
583# If we have "make <whatever> modules", compile modules
584# in addition to whatever we do anyway.
585# Just "make" or "make all" shall build modules as well
586
587ifneq ($(filter all _all modules,$(MAKECMDGOALS)),)
588 KBUILD_MODULES := 1
589endif
590
591ifeq ($(MAKECMDGOALS),)
592 KBUILD_MODULES := 1
593endif
594
595export KBUILD_MODULES KBUILD_BUILTIN
596
1da177e4 597ifeq ($(KBUILD_EXTMOD),)
1da177e4
LT
598# Objects we will link into vmlinux / subdirs we need to visit
599init-y := init/
f96182e9 600drivers-y := drivers/ sound/
1da177e4
LT
601net-y := net/
602libs-y := lib/
603core-y := usr/
37d9fe47 604virt-y := virt/
1da177e4
LT
605endif # KBUILD_EXTMOD
606
607ifeq ($(dot-config),1)
0a16d2e8 608include include/config/auto.conf
315bab4e
MY
609endif
610
611# The all: target is the default when no target is given on the
612# command line.
613# This allow a user to issue only 'make' to build a kernel including modules
614# Defaults to vmlinux, but the arch makefile usually adds further targets
615all: vmlinux
616
617CFLAGS_GCOV := -fprofile-arcs -ftest-coverage \
618 $(call cc-option,-fno-tree-loop-im) \
619 $(call cc-disable-warning,maybe-uninitialized,)
5aadfdeb 620export CFLAGS_GCOV
315bab4e 621
b1f4ff74
PZ
622# The arch Makefiles can override CC_FLAGS_FTRACE. We may also append it later.
623ifdef CONFIG_FUNCTION_TRACER
624 CC_FLAGS_FTRACE := -pg
625endif
626
315bab4e
MY
627# The arch Makefile can set ARCH_{CPP,A,C}FLAGS to override the default
628# values of the respective KBUILD_* variables
629ARCH_CPPFLAGS :=
630ARCH_AFLAGS :=
631ARCH_CFLAGS :=
632include arch/$(SRCARCH)/Makefile
1da177e4 633
315bab4e 634ifeq ($(dot-config),1)
d7942413 635ifeq ($(may-sync-config),1)
315bab4e
MY
636# Read in dependencies to all Kconfig* files, make sure to run syncconfig if
637# changes are detected. This should be included after arch/$(SRCARCH)/Makefile
638# because some architectures define CROSS_COMPILE there.
c955ccaf 639-include include/config/auto.conf.cmd
1da177e4 640
05850719
MY
641$(KCONFIG_CONFIG):
642 @echo >&2 '***'
643 @echo >&2 '*** Configuration file "$@" not found!'
644 @echo >&2 '***'
645 @echo >&2 '*** Please run some configurator (e.g. "make oldconfig" or'
646 @echo >&2 '*** "make menuconfig" or "make xconfig").'
647 @echo >&2 '***'
648 @/bin/false
1da177e4 649
61277981
UM
650# The actual configuration files used during the build are stored in
651# include/generated/ and include/config/. Update them if .config is newer than
652# include/config/auto.conf (which mirrors .config).
9390dff6
MY
653#
654# This exploits the 'multi-target pattern rule' trick.
655# The syncconfig should be executed only once to make all the targets.
656%/auto.conf %/auto.conf.cmd %/tristate.conf: $(KCONFIG_CONFIG)
911a91c3 657 $(Q)$(MAKE) -f $(srctree)/Makefile syncconfig
3041e47e 658else
d7942413
MY
659# External modules and some install targets need include/generated/autoconf.h
660# and include/config/auto.conf but do not care if they are up-to-date.
661# Use auto.conf to trigger the test
9ee4e336
SR
662PHONY += include/config/auto.conf
663
664include/config/auto.conf:
264a2683 665 $(Q)test -e include/generated/autoconf.h -a -e $@ || ( \
5369f550
MM
666 echo >&2; \
667 echo >&2 " ERROR: Kernel configuration is invalid."; \
668 echo >&2 " include/generated/autoconf.h or $@ are missing.";\
669 echo >&2 " Run 'make oldconfig && make prepare' on kernel src to fix it."; \
670 echo >&2 ; \
9ee4e336
SR
671 /bin/false)
672
d7942413 673endif # may-sync-config
9ee4e336 674endif # $(dot-config)
1da177e4 675
a1c48bb1 676KBUILD_CFLAGS += $(call cc-option,-fno-delete-null-pointer-checks,)
ef6000b4 677KBUILD_CFLAGS += $(call cc-disable-warning,frame-address,)
bd664f6b
LT
678KBUILD_CFLAGS += $(call cc-disable-warning, format-truncation)
679KBUILD_CFLAGS += $(call cc-disable-warning, format-overflow)
680KBUILD_CFLAGS += $(call cc-disable-warning, int-in-bool-context)
a1c48bb1 681
1da177e4 682ifdef CONFIG_CC_OPTIMIZE_FOR_SIZE
a75bb4eb 683KBUILD_CFLAGS += -Os
815eb71e
AB
684else
685KBUILD_CFLAGS += -O2
686endif
1da177e4 687
b303c6df
MY
688ifdef CONFIG_CC_DISABLE_WARN_MAYBE_UNINITIALIZED
689KBUILD_CFLAGS += -Wno-maybe-uninitialized
690endif
a76bcf55 691
69102311
JK
692# Tell gcc to never replace conditional load with a non-conditional one
693KBUILD_CFLAGS += $(call cc-option,--param=allow-store-data-races=0)
694
d677a4d6 695include scripts/Makefile.kcov
6b90bd4b
ER
696include scripts/Makefile.gcc-plugins
697
1873e870
AK
698ifdef CONFIG_READABLE_ASM
699# Disable optimizations that make assembler listings hard to read.
700# reorder blocks reorders the control in the function
701# ipa clone creates specialized cloned functions
702# partial inlining inlines only parts of functions
703KBUILD_CFLAGS += $(call cc-option,-fno-reorder-blocks,) \
704 $(call cc-option,-fno-ipa-cp-clone,) \
705 $(call cc-option,-fno-partial-inlining)
706endif
707
08f67461 708ifneq ($(CONFIG_FRAME_WARN),0)
35bb5b1e
AK
709KBUILD_CFLAGS += $(call cc-option,-Wframe-larger-than=${CONFIG_FRAME_WARN})
710endif
711
2a61f474 712stackp-flags-$(CONFIG_CC_HAS_STACKPROTECTOR_NONE) := -fno-stack-protector
050e9baa
LT
713stackp-flags-$(CONFIG_STACKPROTECTOR) := -fstack-protector
714stackp-flags-$(CONFIG_STACKPROTECTOR_STRONG) := -fstack-protector-strong
2a61f474
MY
715
716KBUILD_CFLAGS += $(stackp-flags-y)
e06b8b98 717
076f421d 718ifdef CONFIG_CC_IS_CLANG
cfe17c9b 719KBUILD_CPPFLAGS += $(call cc-option,-Qunused-arguments,)
cfe17c9b
MY
720KBUILD_CFLAGS += $(call cc-disable-warning, format-invalid-specifier)
721KBUILD_CFLAGS += $(call cc-disable-warning, gnu)
722KBUILD_CFLAGS += $(call cc-disable-warning, address-of-packed-member)
723# Quiet clang warning: comparison of unsigned expression < 0 is always false
724KBUILD_CFLAGS += $(call cc-disable-warning, tautological-compare)
725# CLANG uses a _MergedGlobals as optimization, but this breaks modpost, as the
726# source of a reference will be _MergedGlobals and not on of the whitelisted names.
727# See modpost pattern 2
728KBUILD_CFLAGS += $(call cc-option, -mno-global-merge,)
729KBUILD_CFLAGS += $(call cc-option, -fcatch-undefined-behavior)
cfe17c9b
MY
730else
731
732# These warnings generated too much noise in a regular build.
733# Use make W=1 to enable them (see scripts/Makefile.extrawarn)
9df3e7a7 734KBUILD_CFLAGS += -Wno-unused-but-set-variable
cfe17c9b
MY
735endif
736
0a5f4176 737KBUILD_CFLAGS += $(call cc-disable-warning, unused-const-variable)
1da177e4 738ifdef CONFIG_FRAME_POINTER
a0f97e06 739KBUILD_CFLAGS += -fno-omit-frame-pointer -fno-optimize-sibling-calls
1da177e4 740else
7e9501fd
RV
741# Some targets (ARM with Thumb2, for example), can't be built with frame
742# pointers. For those, we don't have FUNCTION_TRACER automatically
743# select FRAME_POINTER. However, FUNCTION_TRACER adds -pg, and this is
744# incompatible with -fomit-frame-pointer with current GCC, so we don't use
745# -fomit-frame-pointer with FUNCTION_TRACER.
746ifndef CONFIG_FUNCTION_TRACER
a0f97e06 747KBUILD_CFLAGS += -fomit-frame-pointer
1da177e4 748endif
7e9501fd 749endif
1da177e4 750
1e88e415 751DEBUG_CFLAGS := $(call cc-option, -fno-var-tracking-assignments)
2062afb4 752
1da177e4 753ifdef CONFIG_DEBUG_INFO
866ced95 754ifdef CONFIG_DEBUG_INFO_SPLIT
9d937444 755DEBUG_CFLAGS += -gsplit-dwarf
866ced95 756else
1e88e415 757DEBUG_CFLAGS += -g
866ced95 758endif
2288328c 759KBUILD_AFLAGS += -Wa,-gdwarf-2
1da177e4 760endif
bfaf2dd3 761ifdef CONFIG_DEBUG_INFO_DWARF4
9d937444 762DEBUG_CFLAGS += -gdwarf-4
bfaf2dd3 763endif
1da177e4 764
d6f4ceb7 765ifdef CONFIG_DEBUG_INFO_REDUCED
1e88e415 766DEBUG_CFLAGS += $(call cc-option, -femit-struct-debug-baseonly) \
e82c4bb8 767 $(call cc-option,-fno-var-tracking)
d6f4ceb7
AK
768endif
769
1e88e415
MY
770KBUILD_CFLAGS += $(DEBUG_CFLAGS)
771export DEBUG_CFLAGS
772
606576ce 773ifdef CONFIG_FUNCTION_TRACER
07d04081
VG
774ifdef CONFIG_FTRACE_MCOUNT_RECORD
775 # gcc 5 supports generating the mcount tables directly
776 ifeq ($(call cc-option-yn,-mrecord-mcount),y)
777 CC_FLAGS_FTRACE += -mrecord-mcount
778 export CC_USING_RECORD_MCOUNT := 1
779 endif
2f4df001
VG
780 ifdef CONFIG_HAVE_NOP_MCOUNT
781 ifeq ($(call cc-option-yn, -mnop-mcount),y)
782 CC_FLAGS_FTRACE += -mnop-mcount
783 CC_FLAGS_USING += -DCC_USING_NOP_MCOUNT
784 endif
785 endif
07d04081 786endif
a2546fae 787ifdef CONFIG_HAVE_FENTRY
f28bc3c3
VG
788 ifeq ($(call cc-option-yn, -mfentry),y)
789 CC_FLAGS_FTRACE += -mfentry
790 CC_FLAGS_USING += -DCC_USING_FENTRY
791 endif
a2546fae 792endif
f28bc3c3
VG
793export CC_FLAGS_FTRACE
794KBUILD_CFLAGS += $(CC_FLAGS_FTRACE) $(CC_FLAGS_USING)
795KBUILD_AFLAGS += $(CC_FLAGS_USING)
72441cb1 796ifdef CONFIG_DYNAMIC_FTRACE
cf4db259 797 ifdef CONFIG_HAVE_C_RECORDMCOUNT
72441cb1
SR
798 BUILD_C_RECORDMCOUNT := y
799 export BUILD_C_RECORDMCOUNT
800 endif
801endif
16444a8a
ACM
802endif
803
91341d4b
SR
804# We trigger additional mismatches with less inlining
805ifdef CONFIG_DEBUG_SECTION_MISMATCH
806KBUILD_CFLAGS += $(call cc-option, -fno-inline-functions-called-once)
807endif
808
90ad4052 809ifdef CONFIG_LD_DEAD_CODE_DATA_ELIMINATION
e85d1d65
MY
810KBUILD_CFLAGS_KERNEL += -ffunction-sections -fdata-sections
811LDFLAGS_vmlinux += --gc-sections
90ad4052
MY
812endif
813
e8e69931 814# arch Makefile may override CC so keep this after arch Makefile is included
e08d6de4 815NOSTDINC_FLAGS += -nostdinc -isystem $(shell $(CC) -print-file-name=include)
e8e69931 816
1da177e4 817# warn about C99 declaration after statement
a33e7ae2 818KBUILD_CFLAGS += -Wdeclaration-after-statement
1da177e4 819
0bb95f80
KC
820# Variable Length Arrays (VLAs) should not be used anywhere in the kernel
821KBUILD_CFLAGS += $(call cc-option,-Wvla)
822
070b98bf 823# disable pointer signed / unsigned warnings in gcc 4.0
fb073a4b 824KBUILD_CFLAGS += -Wno-pointer-sign
1da177e4 825
217c3e01
SR
826# disable stringop warnings in gcc 8+
827KBUILD_CFLAGS += $(call cc-disable-warning, stringop-truncation)
828
fe8d0a41 829# disable invalid "can't wrap" optimizations for signed / pointers
a137802e 830KBUILD_CFLAGS += $(call cc-option,-fno-strict-overflow)
d0115552 831
87e0d4f0
DB
832# clang sets -fmerge-all-constants by default as optimization, but this
833# is non-conforming behavior for C and in fact breaks the kernel, so we
834# need to disable it here generally.
835KBUILD_CFLAGS += $(call cc-option,-fno-merge-all-constants)
836
837# for gcc -fno-merge-all-constants disables everything, but it is fine
838# to have actual conforming behavior enabled.
839KBUILD_CFLAGS += $(call cc-option,-fmerge-constants)
840
3ce120b1
LT
841# Make sure -fstack-check isn't enabled (like gentoo apparently did)
842KBUILD_CFLAGS += $(call cc-option,-fno-stack-check,)
843
8f7f5c9f
AK
844# conserve stack if available
845KBUILD_CFLAGS += $(call cc-option,-fconserve-stack)
846
fe7c36c7
JT
847# Prohibit date/time macros, which would make the build non-deterministic
848KBUILD_CFLAGS += $(call cc-option,-Werror=date-time)
849
ea8daa7b
DW
850# enforce correct pointer usage
851KBUILD_CFLAGS += $(call cc-option,-Werror=incompatible-pointer-types)
852
c834f0e8
KC
853# Require designated initializers for all marked structures
854KBUILD_CFLAGS += $(call cc-option,-Werror=designated-init)
855
a73619a8
MY
856# change __FILE__ to the relative path from the srctree
857KBUILD_CFLAGS += $(call cc-option,-fmacro-prefix-map=$(srctree)/=)
858
40df759e
MM
859# use the deterministic mode of AR if available
860KBUILD_ARFLAGS := $(call ar-option,D)
861
a436bb7b
MY
862include scripts/Makefile.kasan
863include scripts/Makefile.extrawarn
c6d30853 864include scripts/Makefile.ubsan
a86fe353 865
61754c18
MM
866# Add any arch overrides and user supplied CPPFLAGS, AFLAGS and CFLAGS as the
867# last assignments
868KBUILD_CPPFLAGS += $(ARCH_CPPFLAGS) $(KCPPFLAGS)
869KBUILD_AFLAGS += $(ARCH_AFLAGS) $(KAFLAGS)
870KBUILD_CFLAGS += $(ARCH_CFLAGS) $(KCFLAGS)
52bcc330 871
18991197 872# Use --build-id when available.
0da4fabd 873LDFLAGS_BUILD_ID := $(call ld-option, --build-id)
6588169d 874KBUILD_LDFLAGS_MODULE += $(LDFLAGS_BUILD_ID)
18991197
RM
875LDFLAGS_vmlinux += $(LDFLAGS_BUILD_ID)
876
5d7d18f5 877ifeq ($(CONFIG_STRIP_ASM_SYMS),y)
d79a2719 878LDFLAGS_vmlinux += $(call ld-option, -X,)
5d7d18f5
DH
879endif
880
14516765
LVO
881# insure the checker run with the right endianness
882CHECKFLAGS += $(if $(CONFIG_CPU_BIG_ENDIAN),-mbig-endian,-mlittle-endian)
883
1f2f01b1
LVO
884# the checker needs the correct machine size
885CHECKFLAGS += $(if $(CONFIG_64BIT),-m64,-m32)
886
1da177e4 887# Default kernel image to build when no specific target is given.
070b98bf 888# KBUILD_IMAGE may be overruled on the command line or
1da177e4
LT
889# set in the environment
890# Also any assignments in arch/$(ARCH)/Makefile take precedence over
891# this default value
892export KBUILD_IMAGE ?= vmlinux
893
894#
895# INSTALL_PATH specifies where to place the updated kernel and system map
896# images. Default is /boot, but you can set it to other values
897export INSTALL_PATH ?= /boot
898
f4d4ffc0
JC
899#
900# INSTALL_DTBS_PATH specifies a prefix for relocations required by build roots.
901# Like INSTALL_MOD_PATH, it isn't defined in the Makefile, but can be passed as
902# an argument if needed. Otherwise it defaults to the kernel install path
903#
904export INSTALL_DTBS_PATH ?= $(INSTALL_PATH)/dtbs/$(KERNELRELEASE)
905
1da177e4
LT
906#
907# INSTALL_MOD_PATH specifies a prefix to MODLIB for module directory
908# relocations required by build roots. This is not defined in the
070b98bf 909# makefile but the argument can be passed to make if needed.
1da177e4
LT
910#
911
df9df036 912MODLIB = $(INSTALL_MOD_PATH)/lib/modules/$(KERNELRELEASE)
1da177e4
LT
913export MODLIB
914
ac031f26 915#
3fbb43df
MY
916# INSTALL_MOD_STRIP, if defined, will cause modules to be
917# stripped after they are installed. If INSTALL_MOD_STRIP is '1', then
918# the default option --strip-debug will be used. Otherwise,
919# INSTALL_MOD_STRIP value will be used as the options to the strip command.
2ea03891 920
ac031f26
TT
921ifdef INSTALL_MOD_STRIP
922ifeq ($(INSTALL_MOD_STRIP),1)
2ea03891 923mod_strip_cmd = $(STRIP) --strip-debug
ac031f26 924else
2ea03891 925mod_strip_cmd = $(STRIP) $(INSTALL_MOD_STRIP)
ac031f26
TT
926endif # INSTALL_MOD_STRIP=1
927else
2ea03891 928mod_strip_cmd = true
ac031f26
TT
929endif # INSTALL_MOD_STRIP
930export mod_strip_cmd
931
beb50df3
BJ
932# CONFIG_MODULE_COMPRESS, if defined, will cause module to be compressed
933# after they are installed in agreement with CONFIG_MODULE_COMPRESS_GZIP
934# or CONFIG_MODULE_COMPRESS_XZ.
935
936mod_compress_cmd = true
937ifdef CONFIG_MODULE_COMPRESS
938 ifdef CONFIG_MODULE_COMPRESS_GZIP
3d1450d5 939 mod_compress_cmd = gzip -n -f
beb50df3
BJ
940 endif # CONFIG_MODULE_COMPRESS_GZIP
941 ifdef CONFIG_MODULE_COMPRESS_XZ
3d1450d5 942 mod_compress_cmd = xz -f
beb50df3
BJ
943 endif # CONFIG_MODULE_COMPRESS_XZ
944endif # CONFIG_MODULE_COMPRESS
945export mod_compress_cmd
946
d9d8d7ed 947ifdef CONFIG_MODULE_SIG_ALL
3ee550f1
DW
948$(eval $(call config_filename,MODULE_SIG_KEY))
949
950mod_sign_cmd = scripts/sign-file $(CONFIG_MODULE_SIG_HASH) $(MODULE_SIG_KEY_SRCPREFIX)$(CONFIG_MODULE_SIG_KEY) certs/signing_key.x509
e2a666d5
RR
951else
952mod_sign_cmd = true
953endif
954export mod_sign_cmd
955
056d28d1
REB
956HOST_LIBELF_LIBS = $(shell pkg-config libelf --libs 2>/dev/null || echo -lelf)
957
9f0c18ae
JP
958ifdef CONFIG_STACK_VALIDATION
959 has_libelf := $(call try-run,\
056d28d1 960 echo "int main() {}" | $(HOSTCC) -xc -o /dev/null $(HOST_LIBELF_LIBS) -,1,0)
9f0c18ae
JP
961 ifeq ($(has_libelf),1)
962 objtool_target := tools/objtool FORCE
963 else
9f0c18ae
JP
964 SKIP_STACK_VALIDATION := 1
965 export SKIP_STACK_VALIDATION
966 endif
967endif
968
e00d8880 969PHONY += prepare0
e2a666d5 970
1da177e4 971ifeq ($(KBUILD_EXTMOD),)
cfc411e7 972core-y += kernel/ certs/ mm/ fs/ ipc/ security/ crypto/ block/
1da177e4
LT
973
974vmlinux-dirs := $(patsubst %/,%,$(filter %/, $(init-y) $(init-m) \
975 $(core-y) $(core-m) $(drivers-y) $(drivers-m) \
37d9fe47 976 $(net-y) $(net-m) $(libs-y) $(libs-m) $(virt-y)))
1da177e4
LT
977
978vmlinux-alldirs := $(sort $(vmlinux-dirs) $(patsubst %/,%,$(filter %/, \
37d9fe47 979 $(init-) $(core-) $(drivers-) $(net-) $(libs-) $(virt-))))
1da177e4 980
f49821ee
NP
981init-y := $(patsubst %/, %/built-in.a, $(init-y))
982core-y := $(patsubst %/, %/built-in.a, $(core-y))
983drivers-y := $(patsubst %/, %/built-in.a, $(drivers-y))
984net-y := $(patsubst %/, %/built-in.a, $(net-y))
1da177e4 985libs-y1 := $(patsubst %/, %/lib.a, $(libs-y))
f49821ee
NP
986libs-y2 := $(patsubst %/, %/built-in.a, $(filter-out %.a, $(libs-y)))
987virt-y := $(patsubst %/, %/built-in.a, $(virt-y))
1da177e4 988
1f2bfbd0 989# Externally visible symbols (used by link-vmlinux.sh)
d151e971
MY
990export KBUILD_VMLINUX_OBJS := $(head-y) $(init-y) $(core-y) $(libs-y2) \
991 $(drivers-y) $(net-y) $(virt-y)
3a166fc2 992export KBUILD_VMLINUX_LIBS := $(libs-y1)
95698570 993export KBUILD_LDS := arch/$(SRCARCH)/kernel/vmlinux.lds
1f2bfbd0 994export LDFLAGS_vmlinux
312a3d09 995# used by scripts/package/Makefile
37d9fe47 996export KBUILD_ALLDIRS := $(sort $(filter-out arch/%,$(vmlinux-alldirs)) arch Documentation include samples scripts tools)
9bb48247 997
d151e971 998vmlinux-deps := $(KBUILD_LDS) $(KBUILD_VMLINUX_OBJS) $(KBUILD_VMLINUX_LIBS)
1da177e4 999
3fdc7d3f
MY
1000# Recurse until adjust_autoksyms.sh is satisfied
1001PHONY += autoksyms_recursive
1002autoksyms_recursive: $(vmlinux-deps)
2441e78b 1003ifdef CONFIG_TRIM_UNUSED_KSYMS
ba79d401 1004 $(Q)$(CONFIG_SHELL) $(srctree)/scripts/adjust_autoksyms.sh \
86556392 1005 "$(MAKE) -f $(srctree)/Makefile vmlinux"
2441e78b 1006endif
23121ca2 1007
1f50b80a
MY
1008# For the kernel to actually contain only the needed exported symbols,
1009# we have to build modules as well to determine what those symbols are.
1010# (this can be evaluated only once include/config/auto.conf has been included)
1011ifdef CONFIG_TRIM_UNUSED_KSYMS
1012 KBUILD_MODULES := 1
1013endif
1014
07a422bb
MY
1015autoksyms_h := $(if $(CONFIG_TRIM_UNUSED_KSYMS), include/generated/autoksyms.h)
1016
1017$(autoksyms_h):
1018 $(Q)mkdir -p $(dir $@)
1019 $(Q)touch $@
23121ca2 1020
fbe6e37d
NP
1021ARCH_POSTLINK := $(wildcard $(srctree)/arch/$(SRCARCH)/Makefile.postlink)
1022
1023# Final link of vmlinux with optional arch pass after final link
312a3d09 1024cmd_link-vmlinux = \
d503ac53 1025 $(CONFIG_SHELL) $< $(LD) $(KBUILD_LDFLAGS) $(LDFLAGS_vmlinux) ; \
fbe6e37d 1026 $(if $(ARCH_POSTLINK), $(MAKE) -f $(ARCH_POSTLINK) $@, true)
2441e78b 1027
3fdc7d3f 1028vmlinux: scripts/link-vmlinux.sh autoksyms_recursive $(vmlinux-deps) FORCE
1f2bfbd0 1029 +$(call if_changed,link-vmlinux)
741f98fe 1030
392885ee
MY
1031targets := vmlinux
1032
3fca1700 1033# Build samples along the rest of the kernel. This needs headers_install.
dd92478a
NP
1034ifdef CONFIG_SAMPLES
1035vmlinux-dirs += samples
3fca1700 1036samples: headers_install
dd92478a
NP
1037endif
1038
38385f8f 1039# The actual objects are generated when descending,
1da177e4 1040# make sure no implicit rule kicks in
1f2bfbd0 1041$(sort $(vmlinux-deps)): $(vmlinux-dirs) ;
1da177e4
LT
1042
1043# Handle descending into subdirectories listed in $(vmlinux-dirs)
1044# Preset locale variables to speed up the build process. Limit locale
1045# tweaks to this spot to avoid wrong language settings when running
1046# make menuconfig etc.
1047# Error messages still appears in the original language
1048
4f193362 1049PHONY += $(vmlinux-dirs)
059bc9fc 1050$(vmlinux-dirs): prepare
f7adc312 1051 $(Q)$(MAKE) $(build)=$@ need-builtin=1
1da177e4 1052
ba97df45 1053filechk_kernel.release = \
0d0e7718 1054 echo "$(KERNELVERSION)$$($(CONFIG_SHELL) $(srctree)/scripts/setlocalversion $(srctree))"
0d0e7718 1055
83a35e36 1056# Store (new) KERNELRELEASE string in include/config/kernel.release
2063945f 1057include/config/kernel.release: $(srctree)/Makefile FORCE
0d0e7718 1058 $(call filechk,kernel.release)
cb58455c 1059
d8821622
MY
1060# Additional helpers built in scripts/
1061# Carefully list dependencies so we do not try to build scripts twice
1062# in parallel
1063PHONY += scripts
60df1aee 1064scripts: scripts_basic scripts_dtc
d8821622 1065 $(Q)$(MAKE) $(build)=$(@)
cb58455c 1066
1da177e4 1067# Things we need to do before we recursively start building the kernel
5bb78269
SR
1068# or the modules are listed in "prepare".
1069# A multi level approach is used. prepareN is processed before prepareN-1.
1070# archprepare is used in arch Makefiles and when processed asm symlink,
1071# version.h and scripts_basic is processed / created.
1da177e4 1072
4f1c1008 1073PHONY += prepare archprepare prepare1 prepare3
5bb78269 1074
86feeaa8 1075# prepare3 is used to check if we are building in a separate output directory,
1da177e4
LT
1076# and if so do:
1077# 1) Check that make has not been executed in the kernel src $(srctree)
f1d28fb0 1078prepare3: include/config/kernel.release
1da177e4 1079ifneq ($(KBUILD_SRC),)
fd54f502 1080 @$(kecho) ' Using $(srctree) as source for kernel'
c955ccaf 1081 $(Q)if [ -f $(srctree)/.config -o -d $(srctree)/include/config ]; then \
5369f550
MM
1082 echo >&2 " $(srctree) is not clean, please run 'make mrproper'"; \
1083 echo >&2 " in the '$(srctree)' directory.";\
1da177e4
LT
1084 /bin/false; \
1085 fi;
1da177e4
LT
1086endif
1087
4f1c1008
MY
1088prepare1: prepare3 outputmakefile asm-generic $(version_h) $(autoksyms_h) \
1089 include/generated/utsrelease.h
7bb9d092 1090 $(cmd_crmodverdir)
1da177e4 1091
668c35f6 1092archprepare: archheaders archscripts prepare1 scripts
5bb78269 1093
65bba042 1094prepare0: archprepare
60df1aee 1095 $(Q)$(MAKE) $(build)=scripts/mod
8d36a623 1096 $(Q)$(MAKE) $(build)=.
86feeaa8 1097
1da177e4 1098# All the preparing..
b9ab5ebb
JP
1099prepare: prepare0 prepare-objtool
1100
2c1f4f12 1101# Support for using generic headers in asm-generic
7d0e5c20
MY
1102asm-generic := -f $(srctree)/scripts/Makefile.asm-generic obj
1103
2c1f4f12
MY
1104PHONY += asm-generic uapi-asm-generic
1105asm-generic: uapi-asm-generic
037fc336
MY
1106 $(Q)$(MAKE) $(asm-generic)=arch/$(SRCARCH)/include/generated/asm \
1107 generic=include/asm-generic
2c1f4f12 1108uapi-asm-generic:
037fc336
MY
1109 $(Q)$(MAKE) $(asm-generic)=arch/$(SRCARCH)/include/generated/uapi/asm \
1110 generic=include/uapi/asm-generic
2c1f4f12 1111
b9ab5ebb 1112PHONY += prepare-objtool
3b27a0c8 1113prepare-objtool: $(objtool_target)
ef7cfd00
MY
1114ifeq ($(SKIP_STACK_VALIDATION),1)
1115ifdef CONFIG_UNWINDER_ORC
1116 @echo "error: Cannot generate ORC metadata for CONFIG_UNWINDER_ORC=y, please install libelf-dev, libelf-devel or elfutils-libelf-devel" >&2
1117 @false
1118else
1119 @echo "warning: Cannot use CONFIG_STACK_VALIDATION=y, please install libelf-dev, libelf-devel or elfutils-libelf-devel" >&2
1120endif
1121endif
1da177e4 1122
1da177e4
LT
1123# Generate some files
1124# ---------------------------------------------------------------------------
1125
1126# KERNELRELEASE can change from a few different places, meaning version.h
1127# needs to be updated, so this check is forced on all builds
1128
1129uts_len := 64
63104eec
SR
1130define filechk_utsrelease.h
1131 if [ `echo -n "$(KERNELRELEASE)" | wc -c ` -gt $(uts_len) ]; then \
1132 echo '"$(KERNELRELEASE)" exceeds $(uts_len) characters' >&2; \
1133 exit 1; \
1134 fi; \
ad774086 1135 echo \#define UTS_RELEASE \"$(KERNELRELEASE)\"
63104eec 1136endef
1da177e4
LT
1137
1138define filechk_version.h
ad774086 1139 echo \#define LINUX_VERSION_CODE $(shell \
450c6076 1140 expr $(VERSION) \* 65536 + 0$(PATCHLEVEL) \* 256 + 0$(SUBLEVEL)); \
ad774086 1141 echo '#define KERNEL_VERSION(a,b,c) (((a) << 16) + ((b) << 8) + (c))'
1da177e4
LT
1142endef
1143
43fee2b2 1144$(version_h): FORCE
1da177e4 1145 $(call filechk,version.h)
223c24a7 1146 $(Q)rm -f $(old_version_h)
1da177e4 1147
273b281f 1148include/generated/utsrelease.h: include/config/kernel.release FORCE
63104eec
SR
1149 $(call filechk,utsrelease.h)
1150
179efcb4
VN
1151PHONY += headerdep
1152headerdep:
9663d989
PF
1153 $(Q)find $(srctree)/include/ -name '*.h' | xargs --max-args 1 \
1154 $(srctree)/scripts/headerdep.pl -I$(srctree)/include
179efcb4 1155
8d730cfb
DW
1156# ---------------------------------------------------------------------------
1157# Kernel headers
8d730cfb 1158
e6883b18
SR
1159#Default location for installed headers
1160export INSTALL_HDR_PATH = $(objtree)/usr
6d716275 1161
9d022c54
MY
1162# If we do an all arch process set dst to include/arch-$(SRCARCH)
1163hdr-dst = $(if $(KBUILD_HEADERS), dst=include/arch-$(SRCARCH), dst=include)
e6883b18 1164
f7de64b7 1165PHONY += archheaders archscripts
6520fe55 1166
e6883b18 1167PHONY += __headers
a9d9a400 1168__headers: $(version_h) scripts_basic uapi-asm-generic archheaders archscripts
e1b702cf 1169 $(Q)$(MAKE) $(build)=scripts build_unifdef
e6883b18
SR
1170
1171PHONY += headers_install_all
2fb9b1bd
SR
1172headers_install_all:
1173 $(Q)$(CONFIG_SHELL) $(srctree)/scripts/headers.sh install
6d716275 1174
8d730cfb 1175PHONY += headers_install
e6883b18 1176headers_install: __headers
9d022c54 1177 $(if $(wildcard $(srctree)/arch/$(SRCARCH)/include/uapi/asm/Kbuild),, \
10b63956 1178 $(error Headers not exportable for the $(SRCARCH) architecture))
a8ff49a1 1179 $(Q)$(MAKE) $(hdr-inst)=include/uapi dst=include
9d022c54 1180 $(Q)$(MAKE) $(hdr-inst)=arch/$(SRCARCH)/include/uapi $(hdr-dst)
8d730cfb 1181
1f85712e
MF
1182PHONY += headers_check_all
1183headers_check_all: headers_install_all
2fb9b1bd 1184 $(Q)$(CONFIG_SHELL) $(srctree)/scripts/headers.sh check
1f85712e 1185
68475359
DW
1186PHONY += headers_check
1187headers_check: headers_install
a8ff49a1 1188 $(Q)$(MAKE) $(hdr-inst)=include/uapi dst=include HDRCHECK=1
9d022c54 1189 $(Q)$(MAKE) $(hdr-inst)=arch/$(SRCARCH)/include/uapi $(hdr-dst) HDRCHECK=1
68475359 1190
257edce6
MY
1191ifdef CONFIG_HEADERS_CHECK
1192all: headers_check
1193endif
1194
5a5da78b
SK
1195# ---------------------------------------------------------------------------
1196# Kernel selftest
1197
1198PHONY += kselftest
1199kselftest:
2bc84526 1200 $(Q)$(MAKE) -C $(srctree)/tools/testing/selftests run_tests
5a5da78b 1201
801d2e9f 1202PHONY += kselftest-clean
dcb825a9 1203kselftest-clean:
2bc84526 1204 $(Q)$(MAKE) -C $(srctree)/tools/testing/selftests clean
dcb825a9 1205
3d6dee7a
BJZ
1206PHONY += kselftest-merge
1207kselftest-merge:
1208 $(if $(wildcard $(objtree)/.config),, $(error No .config exists, config your kernel first!))
1209 $(Q)$(CONFIG_SHELL) $(srctree)/scripts/kconfig/merge_config.sh \
1210 -m $(objtree)/.config \
1211 $(srctree)/tools/testing/selftests/*/config
1212 +$(Q)$(MAKE) -f $(srctree)/Makefile olddefconfig
1213
37c8a5fa
RH
1214# ---------------------------------------------------------------------------
1215# Devicetree files
1216
1217ifneq ($(wildcard $(srctree)/arch/$(SRCARCH)/boot/dts/),)
1218dtstree := arch/$(SRCARCH)/boot/dts
1219endif
1220
1221ifneq ($(dtstree),)
1222
1223%.dtb: prepare3 scripts_dtc
1224 $(Q)$(MAKE) $(build)=$(dtstree) $(dtstree)/$@
1225
4f0e3a57
RH
1226PHONY += dtbs dtbs_install dt_binding_check
1227dtbs dtbs_check: prepare3 scripts_dtc
37c8a5fa
RH
1228 $(Q)$(MAKE) $(build)=$(dtstree)
1229
4f0e3a57
RH
1230dtbs_check: export CHECK_DTBS=1
1231dtbs_check: dt_binding_check
1232
37c8a5fa
RH
1233dtbs_install:
1234 $(Q)$(MAKE) $(dtbinst)=$(dtstree)
1235
1236ifdef CONFIG_OF_EARLY_FLATTREE
1237all: dtbs
1238endif
1239
1240endif
1241
1242PHONY += scripts_dtc
1243scripts_dtc: scripts_basic
1244 $(Q)$(MAKE) $(build)=scripts/dtc
1245
4f0e3a57
RH
1246dt_binding_check: scripts_dtc
1247 $(Q)$(MAKE) $(build)=Documentation/devicetree/bindings
1248
1da177e4
LT
1249# ---------------------------------------------------------------------------
1250# Modules
1251
1252ifdef CONFIG_MODULES
1253
070b98bf 1254# By default, build modules as well
1da177e4 1255
73d1393e 1256all: modules
1da177e4 1257
3fbb43df 1258# Build modules
551559e1 1259#
3fbb43df
MY
1260# A module can be listed more than once in obj-m resulting in
1261# duplicate lines in modules.order files. Those are removed
1262# using awk while concatenating to the final file.
1da177e4 1263
4f193362 1264PHONY += modules
2da30e70 1265modules: $(vmlinux-dirs) $(if $(KBUILD_BUILTIN),vmlinux) modules.builtin
551559e1 1266 $(Q)$(AWK) '!x[$$0]++' $(vmlinux-dirs:%=$(objtree)/%/modules.order) > $(objtree)/modules.order
fd54f502 1267 @$(kecho) ' Building modules, stage 2.';
b805aa0e 1268 $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modpost
1da177e4 1269
a6c36632
MM
1270modules.builtin: $(vmlinux-dirs:%=%/modules.builtin)
1271 $(Q)$(AWK) '!x[$$0]++' $^ > $(objtree)/modules.builtin
1272
2063945f 1273%/modules.builtin: include/config/auto.conf include/config/tristate.conf
a6c36632
MM
1274 $(Q)$(MAKE) $(modbuiltin)=$*
1275
1da177e4
LT
1276
1277# Target to prepare building external modules
4f193362 1278PHONY += modules_prepare
059bc9fc 1279modules_prepare: prepare
1da177e4
LT
1280
1281# Target to install modules
4f193362 1282PHONY += modules_install
1da177e4
LT
1283modules_install: _modinst_ _modinst_post
1284
4f193362 1285PHONY += _modinst_
2da30e70 1286_modinst_:
1da177e4
LT
1287 @rm -rf $(MODLIB)/kernel
1288 @rm -f $(MODLIB)/source
1289 @mkdir -p $(MODLIB)/kernel
8e9b4667 1290 @ln -s $(abspath $(srctree)) $(MODLIB)/source
1da177e4
LT
1291 @if [ ! $(objtree) -ef $(MODLIB)/build ]; then \
1292 rm -f $(MODLIB)/build ; \
7e1c0477 1293 ln -s $(CURDIR) $(MODLIB)/build ; \
1da177e4 1294 fi
551559e1 1295 @cp -f $(objtree)/modules.order $(MODLIB)/
bc081dd6 1296 @cp -f $(objtree)/modules.builtin $(MODLIB)/
b805aa0e 1297 $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modinst
1da177e4 1298
50a8ec31 1299# This depmod is only for convenience to give the initial
1da177e4
LT
1300# boot a modules.dep even before / is mounted read-write. However the
1301# boot script depmod is the master version.
4f193362 1302PHONY += _modinst_post
6d128e1e 1303_modinst_post: _modinst_
50a8ec31 1304 $(call cmd,depmod)
1da177e4 1305
d890f510
JB
1306ifeq ($(CONFIG_MODULE_SIG), y)
1307PHONY += modules_sign
1308modules_sign:
1309 $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modsign
1310endif
1311
1da177e4
LT
1312else # CONFIG_MODULES
1313
1314# Modules not configured
1315# ---------------------------------------------------------------------------
1316
612e47ce
MY
1317PHONY += modules modules_install
1318modules modules_install:
5369f550
MM
1319 @echo >&2
1320 @echo >&2 "The present kernel configuration has modules disabled."
1321 @echo >&2 "Type 'make config' and enable loadable module support."
1322 @echo >&2 "Then build a kernel with module support enabled."
1323 @echo >&2
1da177e4
LT
1324 @exit 1
1325
1326endif # CONFIG_MODULES
1327
1da177e4
LT
1328###
1329# Cleaning is done on three levels.
1330# make clean Delete most generated files
1331# Leave enough to build external modules
1332# make mrproper Delete the current configuration, and all generated files
1333# make distclean Remove editor backup files, patch leftover files and the like
1334
1335# Directories & files removed with 'make clean'
fbfa9be9 1336CLEAN_DIRS += $(MODVERDIR) include/ksym
1da177e4
LT
1337
1338# Directories & files removed with 'make mrproper'
d8ecc5cd 1339MRPROPER_DIRS += include/config usr/include include/generated \
3fbb43df 1340 arch/*/include/generated .tmp_objdiff
278ae604 1341MRPROPER_FILES += .config .config.old .version \
d5b71936 1342 Module.symvers tags TAGS cscope* GPATH GTAGS GRTAGS GSYMS \
fb117949
DW
1343 signing_key.pem signing_key.priv signing_key.x509 \
1344 x509.genkey extra_certificates signing_key.x509.keyid \
3ee7b3fa 1345 signing_key.x509.signer vmlinux-gdb.py
1da177e4
LT
1346
1347# clean - Delete most, but leave enough to build external modules
1348#
1349clean: rm-dirs := $(CLEAN_DIRS)
1350clean: rm-files := $(CLEAN_FILES)
fb68d4be 1351clean-dirs := $(addprefix _clean_, . $(vmlinux-alldirs) Documentation samples)
1da177e4 1352
bd1ee804 1353PHONY += $(clean-dirs) clean archclean vmlinuxclean
1da177e4
LT
1354$(clean-dirs):
1355 $(Q)$(MAKE) $(clean)=$(patsubst _clean_%,%,$@)
1356
bd1ee804
PM
1357vmlinuxclean:
1358 $(Q)$(CONFIG_SHELL) $(srctree)/scripts/link-vmlinux.sh clean
fbe6e37d 1359 $(Q)$(if $(ARCH_POSTLINK), $(MAKE) -f $(ARCH_POSTLINK) clean)
bd1ee804
PM
1360
1361clean: archclean vmlinuxclean
1da177e4
LT
1362
1363# mrproper - Delete all generated files, including .config
1364#
1365mrproper: rm-dirs := $(wildcard $(MRPROPER_DIRS))
1366mrproper: rm-files := $(wildcard $(MRPROPER_FILES))
cb43fb57 1367mrproper-dirs := $(addprefix _mrproper_,scripts)
1da177e4 1368
b421b8a6 1369PHONY += $(mrproper-dirs) mrproper
1da177e4
LT
1370$(mrproper-dirs):
1371 $(Q)$(MAKE) $(clean)=$(patsubst _mrproper_%,%,$@)
1372
b421b8a6 1373mrproper: clean $(mrproper-dirs)
1da177e4
LT
1374 $(call cmd,rmdirs)
1375 $(call cmd,rmfiles)
1376
1377# distclean
1378#
4f193362 1379PHONY += distclean
1da177e4
LT
1380
1381distclean: mrproper
1382 @find $(srctree) $(RCS_FIND_IGNORE) \
070b98bf 1383 \( -name '*.orig' -o -name '*.rej' -o -name '*~' \
f78271df
MY
1384 -o -name '*.bak' -o -name '#*#' -o -name '*%' \
1385 -o -name 'core' \) \
1da177e4
LT
1386 -type f -print | xargs rm -f
1387
1388
1389# Packaging of the kernel to various formats
1390# ---------------------------------------------------------------------------
c79624c1 1391package-dir := scripts/package
1da177e4 1392
bafb6747
ACM
1393%src-pkg: FORCE
1394 $(Q)$(MAKE) $(build)=$(package-dir) $@
031ecc6d 1395%pkg: include/config/kernel.release FORCE
6c2133e1 1396 $(Q)$(MAKE) $(build)=$(package-dir) $@
1da177e4
LT
1397
1398
1399# Brief documentation of the typical targets used
1400# ---------------------------------------------------------------------------
1401
5dffbe81 1402boards := $(wildcard $(srctree)/arch/$(SRCARCH)/configs/*_defconfig)
a1e7b7bb 1403boards := $(sort $(notdir $(boards)))
5dffbe81
SB
1404board-dirs := $(dir $(wildcard $(srctree)/arch/$(SRCARCH)/configs/*/*_defconfig))
1405board-dirs := $(sort $(notdir $(board-dirs:/=)))
1da177e4 1406
fe69b420 1407PHONY += help
1da177e4
LT
1408help:
1409 @echo 'Cleaning targets:'
5ea084ef 1410 @echo ' clean - Remove most generated files but keep the config and'
5cc8d246 1411 @echo ' enough build support to build external modules'
5ea084ef 1412 @echo ' mrproper - Remove all generated files + config + various backup files'
5cc8d246 1413 @echo ' distclean - mrproper + remove editor backup and patch files'
1da177e4
LT
1414 @echo ''
1415 @echo 'Configuration targets:'
1416 @$(MAKE) -f $(srctree)/scripts/kconfig/Makefile help
1417 @echo ''
1418 @echo 'Other generic targets:'
1419 @echo ' all - Build all targets marked with [*]'
1420 @echo '* vmlinux - Build the bare kernel'
1421 @echo '* modules - Build all modules'
9cc5d74c 1422 @echo ' modules_install - Install all modules to INSTALL_MOD_PATH (default: /)'
1da177e4 1423 @echo ' dir/ - Build all files in dir and below'
40ab87a4 1424 @echo ' dir/file.[ois] - Build specified target only'
433db3e2
VT
1425 @echo ' dir/file.ll - Build the LLVM assembly file'
1426 @echo ' (requires compiler support for LLVM assembly generation)'
62718979
JP
1427 @echo ' dir/file.lst - Build specified mixed source/assembly target only'
1428 @echo ' (requires a recent binutils and recent build (System.map))'
155ad605 1429 @echo ' dir/file.ko - Build module including final link'
c4d5ee67 1430 @echo ' modules_prepare - Set up for building external modules'
1da177e4
LT
1431 @echo ' tags/TAGS - Generate tags file for editors'
1432 @echo ' cscope - Generate cscope index'
f4ed1009 1433 @echo ' gtags - Generate GNU GLOBAL index'
3f1d9a6c
MM
1434 @echo ' kernelrelease - Output the release version string (use with make -s)'
1435 @echo ' kernelversion - Output the version stored in Makefile (use with make -s)'
1436 @echo ' image_name - Output the image name (use with make -s)'
2fb9b1bd 1437 @echo ' headers_install - Install sanitised kernel headers to INSTALL_HDR_PATH'; \
59df3230 1438 echo ' (default: $(INSTALL_HDR_PATH))'; \
2fb9b1bd 1439 echo ''
31b8cc80 1440 @echo 'Static analysers:'
1da177e4
LT
1441 @echo ' checkstack - Generate a list of stack hogs'
1442 @echo ' namespacecheck - Name space analysis on compiled kernel'
aa025e7d 1443 @echo ' versioncheck - Sanity check on version.h usage'
ec2d987f 1444 @echo ' includecheck - Check for duplicate included header files'
295ac051 1445 @echo ' export_report - List the usages of all exported symbols'
179efcb4 1446 @echo ' headers_check - Sanity check on exported headers'
74425eee 1447 @echo ' headerdep - Detect inclusion cycles in headers'
7f855fc8 1448 @echo ' coccicheck - Check with Coccinelle'
74425eee 1449 @echo ''
31b8cc80 1450 @echo 'Kernel selftest:'
5a5da78b
SK
1451 @echo ' kselftest - Build and run kernel selftest (run as root)'
1452 @echo ' Build, install, and boot kernel before'
1453 @echo ' running kselftest on it'
dcb825a9 1454 @echo ' kselftest-clean - Remove all generated kselftest files'
bbfe63b6 1455 @echo ' kselftest-merge - Merge all the config dependencies of kselftest to existing'
3d6dee7a 1456 @echo ' .config.'
5a5da78b 1457 @echo ''
37c8a5fa
RH
1458 @$(if $(dtstree), \
1459 echo 'Devicetree:'; \
1460 echo '* dtbs - Build device tree blobs for enabled boards'; \
1461 echo ' dtbs_install - Install dtbs to $(INSTALL_DTBS_PATH)'; \
1462 echo '')
1463
31b8cc80
RD
1464 @echo 'Userspace tools targets:'
1465 @echo ' use "make tools/help"'
1466 @echo ' or "cd tools; make help"'
1467 @echo ''
1da177e4 1468 @echo 'Kernel packaging:'
6c2133e1 1469 @$(MAKE) $(build)=$(package-dir) help
1da177e4
LT
1470 @echo ''
1471 @echo 'Documentation targets:'
cb43fb57 1472 @$(MAKE) -f $(srctree)/Documentation/Makefile dochelp
1da177e4 1473 @echo ''
01dee188 1474 @echo 'Architecture specific targets ($(SRCARCH)):'
1da177e4 1475 @$(if $(archhelp),$(archhelp),\
01dee188 1476 echo ' No architecture specific help defined for $(SRCARCH)')
1da177e4
LT
1477 @echo ''
1478 @$(if $(boards), \
1479 $(foreach b, $(boards), \
1480 printf " %-24s - Build for %s\\n" $(b) $(subst _defconfig,,$(b));) \
1481 echo '')
5dffbe81
SB
1482 @$(if $(board-dirs), \
1483 $(foreach b, $(board-dirs), \
1484 printf " %-16s - Show %s-specific targets\\n" help-$(b) $(b);) \
1485 printf " %-16s - Show all of the above\\n" help-boards; \
1486 echo '')
1da177e4
LT
1487
1488 @echo ' make V=0|1 [targets] 0 => quiet build (default), 1 => verbose build'
45d506bd 1489 @echo ' make V=2 [targets] 2 => give reason for rebuild of target'
1da177e4 1490 @echo ' make O=dir [targets] Locate all output files in "dir", including .config'
9ba26a72 1491 @echo ' make C=1 [targets] Check re-compiled c source with $$CHECK (sparse by default)'
701842e3 1492 @echo ' make C=2 [targets] Force check of all c source with $$CHECK'
af07ce3e 1493 @echo ' make RECORDMCOUNT_WARN=1 [targets] Warn about ignored mcount sections'
28bc20dc
SR
1494 @echo ' make W=n [targets] Enable extra gcc checks, n=1,2,3 where'
1495 @echo ' 1: warnings which may be relevant and do not occur too often'
1496 @echo ' 2: warnings which occur quite often but may still be relevant'
1497 @echo ' 3: more obscure warnings, can most likely be ignored'
a6de553d 1498 @echo ' Multiple levels can be combined with W=12 or W=123'
1da177e4
LT
1499 @echo ''
1500 @echo 'Execute "make" or "make all" to build all targets marked with [*] '
1501 @echo 'For further info see the ./README file'
1502
1503
5dffbe81
SB
1504help-board-dirs := $(addprefix help-,$(board-dirs))
1505
1506help-boards: $(help-board-dirs)
1507
fbae4d58 1508boards-per-dir = $(sort $(notdir $(wildcard $(srctree)/arch/$(SRCARCH)/configs/$*/*_defconfig)))
5dffbe81
SB
1509
1510$(help-board-dirs): help-%:
1511 @echo 'Architecture specific targets ($(SRCARCH) $*):'
1512 @$(if $(boards-per-dir), \
1513 $(foreach b, $(boards-per-dir), \
1514 printf " %-24s - Build for %s\\n" $*/$(b) $(subst _defconfig,,$(b));) \
1515 echo '')
1516
1517
1da177e4
LT
1518# Documentation targets
1519# ---------------------------------------------------------------------------
e8939222
JN
1520DOC_TARGETS := xmldocs latexdocs pdfdocs htmldocs epubdocs cleandocs \
1521 linkcheckdocs dochelp refcheckdocs
22cba31b
JN
1522PHONY += $(DOC_TARGETS)
1523$(DOC_TARGETS): scripts_basic FORCE
cb43fb57 1524 $(Q)$(MAKE) $(build)=Documentation $@
1da177e4 1525
67274c08
MY
1526# Misc
1527# ---------------------------------------------------------------------------
1528
1529PHONY += scripts_gdb
1530scripts_gdb: prepare
1e5ff84f 1531 $(Q)$(MAKE) $(build)=scripts/gdb
8d2e5200 1532 $(Q)ln -fsn $(abspath $(srctree)/scripts/gdb/vmlinux-gdb.py)
67274c08
MY
1533
1534ifdef CONFIG_GDB_SCRIPTS
1535all: scripts_gdb
1536endif
1537
1da177e4
LT
1538else # KBUILD_EXTMOD
1539
1540###
1541# External module support.
1542# When building external modules the kernel used as basis is considered
1543# read-only, and no consistency checks are made and the make
1544# system is not used on the basis kernel. If updates are required
1545# in the basis kernel ordinary make commands (without M=...) must
1546# be used.
1547#
1548# The following are the only valid targets when building external
1549# modules.
1550# make M=dir clean Delete all automatically generated files
1551# make M=dir modules Make all modules in specified dir
1552# make M=dir Same as 'make M=dir modules'
1553# make M=dir modules_install
070b98bf 1554# Install the modules built in the module directory
1da177e4
LT
1555# Assumes install directory is already created
1556
1557# We are always building modules
1558KBUILD_MODULES := 1
1da177e4 1559
4f193362 1560PHONY += $(objtree)/Module.symvers
1da177e4
LT
1561$(objtree)/Module.symvers:
1562 @test -e $(objtree)/Module.symvers || ( \
1563 echo; \
1564 echo " WARNING: Symbol version dump $(objtree)/Module.symvers"; \
1565 echo " is missing; modules will have no dependencies and modversions."; \
1566 echo )
1567
1568module-dirs := $(addprefix _module_,$(KBUILD_EXTMOD))
4f193362 1569PHONY += $(module-dirs) modules
e07db28e 1570$(module-dirs): prepare $(objtree)/Module.symvers
1da177e4
LT
1571 $(Q)$(MAKE) $(build)=$(patsubst _module_%,%,$@)
1572
1573modules: $(module-dirs)
fd54f502 1574 @$(kecho) ' Building modules, stage 2.';
b805aa0e 1575 $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modpost
1da177e4 1576
4f193362 1577PHONY += modules_install
a67dc21a 1578modules_install: _emodinst_ _emodinst_post
e6304663 1579
4f193362
PS
1580install-dir := $(if $(INSTALL_MOD_DIR),$(INSTALL_MOD_DIR),extra)
1581PHONY += _emodinst_
a67dc21a 1582_emodinst_:
a67dc21a 1583 $(Q)mkdir -p $(MODLIB)/$(install-dir)
b805aa0e 1584 $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modinst
1da177e4 1585
4f193362 1586PHONY += _emodinst_post
a67dc21a
SR
1587_emodinst_post: _emodinst_
1588 $(call cmd,depmod)
1589
1da177e4
LT
1590clean-dirs := $(addprefix _clean_,$(KBUILD_EXTMOD))
1591
4f193362 1592PHONY += $(clean-dirs) clean
1da177e4
LT
1593$(clean-dirs):
1594 $(Q)$(MAKE) $(clean)=$(patsubst _clean_%,%,$@)
1595
1596clean: rm-dirs := $(MODVERDIR)
88d7be03 1597clean: rm-files := $(KBUILD_EXTMOD)/Module.symvers
1da177e4 1598
fe69b420 1599PHONY += help
1da177e4
LT
1600help:
1601 @echo ' Building external modules.'
1602 @echo ' Syntax: make -C path/to/kernel/src M=$$PWD target'
1603 @echo ''
1604 @echo ' modules - default target, build the module(s)'
1605 @echo ' modules_install - install the module'
1606 @echo ' clean - remove generated files in module directory only'
1607 @echo ''
06300b21 1608
059bc9fc 1609PHONY += prepare
e07db28e
MY
1610prepare:
1611 $(cmd_crmodverdir)
1da177e4
LT
1612endif # KBUILD_EXTMOD
1613
88d7be03
MM
1614clean: $(clean-dirs)
1615 $(call cmd,rmdirs)
1616 $(call cmd,rmfiles)
43f67c98 1617 @find $(if $(KBUILD_EXTMOD), $(KBUILD_EXTMOD), .) $(RCS_FIND_IGNORE) \
ef46d9b3 1618 \( -name '*.[aios]' -o -name '*.ko' -o -name '.*.cmd' \
4f0e3a57
RH
1619 -o -name '*.ko.*' \
1620 -o -name '*.dtb' -o -name '*.dtb.S' -o -name '*.dt.yaml' \
ef46d9b3 1621 -o -name '*.dwo' -o -name '*.lst' \
d523b255 1622 -o -name '*.su' \
88d7be03 1623 -o -name '.*.d' -o -name '.*.tmp' -o -name '*.mod.c' \
9a8dfb39 1624 -o -name '*.lex.c' -o -name '*.tab.[ch]' \
4fa8bc94 1625 -o -name '*.asn1.[ch]' \
88d7be03
MM
1626 -o -name '*.symtypes' -o -name 'modules.order' \
1627 -o -name modules.builtin -o -name '.tmp_*.o.*' \
6b90bd4b 1628 -o -name '*.c.[012]*.*' \
433db3e2 1629 -o -name '*.ll' \
88d7be03
MM
1630 -o -name '*.gcno' \) -type f -print | xargs rm -f
1631
1da177e4
LT
1632# Generate tags for editors
1633# ---------------------------------------------------------------------------
a680eedc
SR
1634quiet_cmd_tags = GEN $@
1635 cmd_tags = $(CONFIG_SHELL) $(srctree)/scripts/tags.sh $@
1da177e4 1636
f4ed1009 1637tags TAGS cscope gtags: FORCE
1da177e4
LT
1638 $(call cmd,tags)
1639
1da177e4
LT
1640# Scripts to check various things for consistency
1641# ---------------------------------------------------------------------------
1642
279f3dd3
PF
1643PHONY += includecheck versioncheck coccicheck namespacecheck export_report
1644
1da177e4 1645includecheck:
436f876c 1646 find $(srctree)/* $(RCS_FIND_IGNORE) \
1da177e4 1647 -name '*.[hcS]' -type f -print | sort \
80007434 1648 | xargs $(PERL) -w $(srctree)/scripts/checkincludes.pl
1da177e4
LT
1649
1650versioncheck:
2ee2d292 1651 find $(srctree)/* $(RCS_FIND_IGNORE) \
1da177e4 1652 -name '*.[hcS]' -type f -print | sort \
80007434 1653 | xargs $(PERL) -w $(srctree)/scripts/checkversion.pl
1da177e4 1654
74425eee
NP
1655coccicheck:
1656 $(Q)$(CONFIG_SHELL) $(srctree)/scripts/$@
1657
1da177e4
LT
1658namespacecheck:
1659 $(PERL) $(srctree)/scripts/namespace.pl
1660
295ac051
AB
1661export_report:
1662 $(PERL) $(srctree)/scripts/export_report.pl
1663
c398ff00 1664PHONY += checkstack kernelrelease kernelversion image_name
e3ccf6e3 1665
011e3a9a
JD
1666# UML needs a little special treatment here. It wants to use the host
1667# toolchain, so needs $(SUBARCH) passed to checkstack.pl. Everyone
1668# else wants $(ARCH), including people doing cross-builds, which means
1669# that $(SUBARCH) doesn't work here.
1670ifeq ($(ARCH), um)
1671CHECKSTACK_ARCH := $(SUBARCH)
1672else
1673CHECKSTACK_ARCH := $(ARCH)
1674endif
1da177e4
LT
1675checkstack:
1676 $(OBJDUMP) -d vmlinux $$(find . -name '*.ko') | \
011e3a9a 1677 $(PERL) $(src)/scripts/checkstack.pl $(CHECKSTACK_ARCH)
1da177e4 1678
7b8ea53d
AW
1679kernelrelease:
1680 @echo "$(KERNELVERSION)$$($(CONFIG_SHELL) $(srctree)/scripts/setlocalversion $(srctree))"
01ab1788 1681
cb58455c 1682kernelversion:
2244cbd8 1683 @echo $(KERNELVERSION)
1da177e4 1684
c398ff00
MM
1685image_name:
1686 @echo $(KBUILD_IMAGE)
1687
ea01fa9f 1688# Clear a bunch of variables before executing the submake
f47a23ce
MY
1689
1690ifeq ($(quiet),silent_)
1691tools_silent=s
1692endif
1693
ea01fa9f 1694tools/: FORCE
bf35182f 1695 $(Q)mkdir -p $(objtree)/tools
8e9b4667 1696 $(Q)$(MAKE) LDFLAGS= MAKEFLAGS="$(tools_silent) $(filter --j% -j,$(MAKEFLAGS))" O=$(abspath $(objtree)) subdir=tools -C $(src)/tools/
ea01fa9f
BP
1697
1698tools/%: FORCE
bf35182f 1699 $(Q)mkdir -p $(objtree)/tools
8e9b4667 1700 $(Q)$(MAKE) LDFLAGS= MAKEFLAGS="$(tools_silent) $(filter --j% -j,$(MAKEFLAGS))" O=$(abspath $(objtree)) subdir=tools -C $(src)/tools/ $*
ea01fa9f 1701
06300b21
SR
1702# Single targets
1703# ---------------------------------------------------------------------------
bc2546a6 1704# Single targets are compatible with:
e1b8513d 1705# - build with mixed source and output
bc2546a6
SR
1706# - build with separate output dir 'make O=...'
1707# - external modules
1708#
1709# target-dir => where to store outputfile
1710# build-dir => directory in kernel source tree to use
1711
6b12de69
MY
1712build-target = $(if $(KBUILD_EXTMOD), $(KBUILD_EXTMOD)/)$@
1713build-dir = $(patsubst %/,%,$(dir $(build-target)))
1714
1715%.i: prepare FORCE
1716 $(Q)$(MAKE) $(build)=$(build-dir) $(build-target)
1717%.ll: prepare FORCE
1718 $(Q)$(MAKE) $(build)=$(build-dir) $(build-target)
1719%.lst: prepare FORCE
1720 $(Q)$(MAKE) $(build)=$(build-dir) $(build-target)
1721%.o: prepare FORCE
1722 $(Q)$(MAKE) $(build)=$(build-dir) $(build-target)
1723%.s: prepare FORCE
1724 $(Q)$(MAKE) $(build)=$(build-dir) $(build-target)
1725%.symtypes: prepare FORCE
1726 $(Q)$(MAKE) $(build)=$(build-dir) $(build-target)
1727%.ko: %.o
1728 $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modpost
06300b21 1729
bc2546a6 1730# Modules
6d3c94e4
MY
1731PHONY += /
1732/: ./
1733
8e2faea8 1734# Make sure the latest headers are built for Documentation
ddea05fa 1735Documentation/ samples/: headers_install
059bc9fc 1736%/: prepare FORCE
648ad9b1 1737 $(Q)$(MAKE) KBUILD_MODULES=1 $(build)=$(build-dir)
06300b21 1738
38385f8f 1739# FIXME Should go into a make.lib or something
1da177e4
LT
1740# ===========================================================================
1741
1742quiet_cmd_rmdirs = $(if $(wildcard $(rm-dirs)),CLEAN $(wildcard $(rm-dirs)))
1743 cmd_rmdirs = rm -rf $(rm-dirs)
1744
1745quiet_cmd_rmfiles = $(if $(wildcard $(rm-files)),CLEAN $(wildcard $(rm-files)))
1746 cmd_rmfiles = rm -f $(rm-files)
1747
bc3c26fe 1748# Run depmod only if we have System.map and depmod is executable
50a8ec31 1749quiet_cmd_depmod = DEPMOD $(KERNELRELEASE)
569658dd 1750 cmd_depmod = $(CONFIG_SHELL) $(srctree)/scripts/depmod.sh $(DEPMOD) \
5a144a1a 1751 $(KERNELRELEASE)
50a8ec31 1752
7bb9d092 1753# Create temporary dir for module support files
ab19f879
SR
1754# clean it up only when building all modules
1755cmd_crmodverdir = $(Q)mkdir -p $(MODVERDIR) \
1756 $(if $(KBUILD_MODULES),; rm -f $(MODVERDIR)/*)
1da177e4 1757
392885ee
MY
1758# read saved command lines for existing targets
1759existing-targets := $(wildcard $(sort $(targets)))
1da177e4 1760
b999923c 1761-include $(foreach f,$(existing-targets),$(dir $(f)).$(notdir $(f)).cmd)
1da177e4 1762
25815cf5
MY
1763endif # ifeq ($(config-targets),1)
1764endif # ifeq ($(mixed-targets),1)
688931a5 1765endif # need-sub-make
1da177e4 1766
4f193362 1767PHONY += FORCE
1da177e4 1768FORCE:
4f193362 1769
bd412d81 1770# Declare the contents of the PHONY variable as phony. We keep that
fe8d0a41 1771# information in a variable so we can use it in if_changed and friends.
4f193362 1772.PHONY: $(PHONY)