xref: /openbmc/linux/Makefile (revision e07db28eea38ed4e332b3a89f3995c86b713cb5b)
1 b2441318SGreg Kroah-Hartman# SPDX-License-Identifier: GPL-2.0
2 c517d838SLinus TorvaldsVERSION = 4
3 65102238SLinus TorvaldsPATCHLEVEL = 20
4 55922c9dSLinus TorvaldsSUBLEVEL = 0
5 ccda4af0SLinus TorvaldsEXTRAVERSION = -rc2
6 84df9525SGreg Kroah-HartmanNAME = "People's Front"
7 1da177e4SLinus Torvalds
8 1da177e4SLinus Torvalds# *DOCUMENTATION*
9 1da177e4SLinus Torvalds# To see a list of typical targets execute "make help"
10 1da177e4SLinus Torvalds# More info can be located in ./README
11 1da177e4SLinus Torvalds# Comments in this file are targeted only to the developer, do not
12 1da177e4SLinus Torvalds# expect to learn how to build the kernel reading this file.
13 1da177e4SLinus Torvalds
14 ba634eceSMasahiro Yamada# That's our default target when none is given on the command line
15 ba634eceSMasahiro YamadaPHONY := _all
16 ba634eceSMasahiro Yamada_all:
17 ba634eceSMasahiro Yamada
18 80463f1bSMasahiro Yamada# Do not use make's built-in rules and variables
19 80463f1bSMasahiro Yamada# (this increases performance and avoids hard-to-debug behaviour)
20 80463f1bSMasahiro YamadaMAKEFLAGS += -rR
21 1da177e4SLinus Torvalds
22 c051346bSH. Peter Anvin# Avoid funny character set dependencies
23 06b5dc64SH. Peter Anvinunexport LC_ALL
24 c051346bSH. Peter AnvinLC_COLLATE=C
25 c051346bSH. Peter AnvinLC_NUMERIC=C
26 07105202SMichal Marekexport LC_COLLATE LC_NUMERIC
27 c051346bSH. Peter Anvin
28 ab7474eaSBorislav Petkov# Avoid interference with shell env settings
29 ab7474eaSBorislav Petkovunexport GREP_OPTIONS
30 ab7474eaSBorislav Petkov
31 1da177e4SLinus Torvalds# We are using a recursive build, so we need to do a little thinking
32 1da177e4SLinus Torvalds# to get the ordering right.
33 1da177e4SLinus Torvalds#
34 1da177e4SLinus Torvalds# Most importantly: sub-Makefiles should only ever modify files in
35 1da177e4SLinus Torvalds# their own directory. If in some directory we have a dependency on
36 1da177e4SLinus Torvalds# a file in another dir (which doesn't happen often, but it's often
37 f49821eeSNicholas Piggin# unavoidable when linking the built-in.a targets which finally
38 1da177e4SLinus Torvalds# turn into vmlinux), we will call a sub make in that other dir, and
39 1da177e4SLinus Torvalds# after that we are sure that everything which is in that other dir
40 1da177e4SLinus Torvalds# is now up to date.
41 1da177e4SLinus Torvalds#
42 1da177e4SLinus Torvalds# The only cases where we need to modify files which have global
43 1da177e4SLinus Torvalds# effects are thus separated out and done before the recursive
44 1da177e4SLinus Torvalds# descending is started. They are now explicitly listed as the
45 1da177e4SLinus Torvalds# prepare rule.
46 1da177e4SLinus Torvalds
47 066b7ed9SMichal Marek# Beautify output
48 066b7ed9SMichal Marek# ---------------------------------------------------------------------------
49 066b7ed9SMichal Marek#
50 066b7ed9SMichal Marek# Normally, we echo the whole command before executing it. By making
51 066b7ed9SMichal Marek# that echo $($(quiet)$(cmd)), we now have the possibility to set
52 066b7ed9SMichal Marek# $(quiet) to choose other forms of output instead, e.g.
53 066b7ed9SMichal Marek#
54 066b7ed9SMichal Marek#         quiet_cmd_cc_o_c = Compiling $(RELDIR)/$@
55 066b7ed9SMichal Marek#         cmd_cc_o_c       = $(CC) $(c_flags) -c -o $@ $<
56 066b7ed9SMichal Marek#
57 066b7ed9SMichal Marek# If $(quiet) is empty, the whole command will be printed.
58 066b7ed9SMichal Marek# If it is set to "quiet_", only the short version will be printed.
59 066b7ed9SMichal Marek# If it is set to "silent_", nothing will be printed at all, since
60 066b7ed9SMichal Marek# the variable $(silent_cmd_cc_o_c) doesn't exist.
61 066b7ed9SMichal Marek#
62 066b7ed9SMichal Marek# A simple variant is to prefix commands with $(Q) - that's useful
63 066b7ed9SMichal Marek# for commands that shall be hidden in non-verbose mode.
64 066b7ed9SMichal Marek#
65 066b7ed9SMichal Marek#	$(Q)ln $@ :<
66 066b7ed9SMichal Marek#
67 066b7ed9SMichal Marek# If KBUILD_VERBOSE equals 0 then the above command will be hidden.
68 066b7ed9SMichal Marek# If KBUILD_VERBOSE equals 1 then the above command is displayed.
69 066b7ed9SMichal Marek#
70 1da177e4SLinus Torvalds# To put more focus on warnings, be less verbose as default
71 1da177e4SLinus Torvalds# Use 'make V=1' to see the full commands
72 1da177e4SLinus Torvalds
73 1da177e4SLinus Torvaldsifeq ("$(origin V)", "command line")
74 1da177e4SLinus Torvalds  KBUILD_VERBOSE = $(V)
75 1da177e4SLinus Torvaldsendif
76 1da177e4SLinus Torvaldsifndef KBUILD_VERBOSE
77 1da177e4SLinus Torvalds  KBUILD_VERBOSE = 0
78 1da177e4SLinus Torvaldsendif
79 1da177e4SLinus Torvalds
80 066b7ed9SMichal Marekifeq ($(KBUILD_VERBOSE),1)
81 066b7ed9SMichal Marek  quiet =
82 066b7ed9SMichal Marek  Q =
83 066b7ed9SMichal Marekelse
84 066b7ed9SMichal Marek  quiet=quiet_
85 066b7ed9SMichal Marek  Q = @
86 066b7ed9SMichal Marekendif
87 066b7ed9SMichal Marek
88 066b7ed9SMichal Marek# If the user is running make -s (silent mode), suppress echoing of
89 066b7ed9SMichal Marek# commands
90 066b7ed9SMichal Marek
91 6f0fa58eSMasahiro Yamadaifneq ($(findstring s,$(filter-out --%,$(MAKEFLAGS))),)
92 066b7ed9SMichal Marek  quiet=silent_
93 e572d088SJosh Poimboeuf  tools_silent=s
94 066b7ed9SMichal Marekendif
95 066b7ed9SMichal Marek
96 066b7ed9SMichal Marekexport quiet Q KBUILD_VERBOSE
97 066b7ed9SMichal Marek
98 1da177e4SLinus Torvalds# kbuild supports saving output files in a separate directory.
99 1da177e4SLinus Torvalds# To locate output files in a separate directory two syntaxes are supported.
100 1da177e4SLinus Torvalds# In both cases the working directory must be the root of the kernel src.
101 1da177e4SLinus Torvalds# 1) O=
102 1da177e4SLinus Torvalds# Use "make O=dir/to/store/output/files/"
103 1da177e4SLinus Torvalds#
104 1da177e4SLinus Torvalds# 2) Set KBUILD_OUTPUT
105 1da177e4SLinus Torvalds# Set the environment variable KBUILD_OUTPUT to point to the directory
106 1da177e4SLinus Torvalds# where the output files shall be placed.
107 1da177e4SLinus Torvalds# export KBUILD_OUTPUT=dir/to/store/output/files/
108 1da177e4SLinus Torvalds# make
109 1da177e4SLinus Torvalds#
110 1da177e4SLinus Torvalds# The O= assignment takes precedence over the KBUILD_OUTPUT environment
111 1da177e4SLinus Torvalds# variable.
112 1da177e4SLinus Torvalds
113 c4e6fff1SCao jin# KBUILD_SRC is not intended to be used by the regular user (for now),
114 c4e6fff1SCao jin# it is set on invocation of make with KBUILD_OUTPUT or O= specified.
115 1da177e4SLinus Torvaldsifeq ($(KBUILD_SRC),)
116 1da177e4SLinus Torvalds
117 1da177e4SLinus Torvalds# OK, Make called in directory where kernel src resides
118 1da177e4SLinus Torvalds# Do we want to locate output files in a separate directory?
119 1da177e4SLinus Torvaldsifeq ("$(origin O)", "command line")
120 1da177e4SLinus Torvalds  KBUILD_OUTPUT := $(O)
121 1da177e4SLinus Torvaldsendif
122 1da177e4SLinus Torvalds
123 1cacc9abSSam Ravnborg# Cancel implicit rules on top Makefile
124 1cacc9abSSam Ravnborg$(CURDIR)/Makefile Makefile: ;
125 1cacc9abSSam Ravnborg
126 51193b76SRobert Jarzmikifneq ($(words $(subst :, ,$(CURDIR))), 1)
127 51193b76SRobert Jarzmik  $(error main directory cannot contain spaces nor colons)
128 51193b76SRobert Jarzmikendif
129 51193b76SRobert Jarzmik
130 1da177e4SLinus Torvaldsifneq ($(KBUILD_OUTPUT),)
131 1da177e4SLinus Torvalds# check that the output directory actually exists
132 1da177e4SLinus Torvaldssaved-output := $(KBUILD_OUTPUT)
133 028568d8SMasahiro YamadaKBUILD_OUTPUT := $(shell mkdir -p $(KBUILD_OUTPUT) && cd $(KBUILD_OUTPUT) \
134 16f8259cSBjørn Forsman								&& pwd)
135 1da177e4SLinus Torvalds$(if $(KBUILD_OUTPUT),, \
136 1c9e70a5SMasahiro Yamada     $(error failed to create output directory "$(saved-output)"))
137 1da177e4SLinus Torvalds
138 80463f1bSMasahiro Yamada# Look for make include files relative to root of kernel src
139 80463f1bSMasahiro Yamada#
140 80463f1bSMasahiro Yamada# This does not become effective immediately because MAKEFLAGS is re-parsed
141 80463f1bSMasahiro Yamada# once after the Makefile is read.  It is OK since we are going to invoke
142 80463f1bSMasahiro Yamada# 'sub-make' below.
143 80463f1bSMasahiro YamadaMAKEFLAGS += --include-dir=$(CURDIR)
144 80463f1bSMasahiro Yamada
145 0b35786dSMilton MillerPHONY += $(MAKECMDGOALS) sub-make
146 0b35786dSMilton Miller
147 1cacc9abSSam Ravnborg$(filter-out _all sub-make $(CURDIR)/Makefile, $(MAKECMDGOALS)) _all: sub-make
148 16f89098SCharles Keepax	@:
149 0b35786dSMilton Miller
150 c4e6fff1SCao jin# Invoke a second make in the output directory, passing relevant variables
151 2e8d696bSMasahiro Yamadasub-make:
152 745a2543SMasahiro Yamada	$(Q)$(MAKE) -C $(KBUILD_OUTPUT) KBUILD_SRC=$(CURDIR) \
153 aa55c8e2SMasahiro Yamada	-f $(CURDIR)/Makefile $(filter-out _all sub-make,$(MAKECMDGOALS))
154 1da177e4SLinus Torvalds
155 1da177e4SLinus Torvalds# Leave processing to above invocation of make
156 1da177e4SLinus Torvaldsskip-makefile := 1
157 1da177e4SLinus Torvaldsendif # ifneq ($(KBUILD_OUTPUT),)
158 1da177e4SLinus Torvaldsendif # ifeq ($(KBUILD_SRC),)
159 1da177e4SLinus Torvalds
160 1da177e4SLinus Torvalds# We process the rest of the Makefile if this is the final invocation of make
161 1da177e4SLinus Torvaldsifeq ($(skip-makefile),)
162 1da177e4SLinus Torvalds
163 7ff52571SMasahiro Yamada# Do not print "Entering directory ...",
164 7ff52571SMasahiro Yamada# but we want to display it when entering to the output directory
165 7ff52571SMasahiro Yamada# so that IDEs/editors are able to understand relative filenames.
166 7ff52571SMasahiro YamadaMAKEFLAGS += --no-print-directory
167 7ff52571SMasahiro Yamada
168 aa55c8e2SMasahiro Yamada# Call a source code checker (by default, "sparse") as part of the
169 aa55c8e2SMasahiro Yamada# C compilation.
170 aa55c8e2SMasahiro Yamada#
171 aa55c8e2SMasahiro Yamada# Use 'make C=1' to enable checking of only re-compiled files.
172 aa55c8e2SMasahiro Yamada# Use 'make C=2' to enable checking of *all* source files, regardless
173 aa55c8e2SMasahiro Yamada# of whether they are re-compiled or not.
174 aa55c8e2SMasahiro Yamada#
175 036db11cSCao jin# See the file "Documentation/dev-tools/sparse.rst" for more details,
176 036db11cSCao jin# including where to get the "sparse" utility.
177 aa55c8e2SMasahiro Yamada
178 aa55c8e2SMasahiro Yamadaifeq ("$(origin C)", "command line")
179 aa55c8e2SMasahiro Yamada  KBUILD_CHECKSRC = $(C)
180 aa55c8e2SMasahiro Yamadaendif
181 aa55c8e2SMasahiro Yamadaifndef KBUILD_CHECKSRC
182 aa55c8e2SMasahiro Yamada  KBUILD_CHECKSRC = 0
183 aa55c8e2SMasahiro Yamadaendif
184 aa55c8e2SMasahiro Yamada
185 aa55c8e2SMasahiro Yamada# Use make M=dir to specify directory of external module to build
186 aa55c8e2SMasahiro Yamada# Old syntax make ... SUBDIRS=$PWD is still supported
187 aa55c8e2SMasahiro Yamada# Setting the environment variable KBUILD_EXTMOD take precedence
188 aa55c8e2SMasahiro Yamadaifdef SUBDIRS
189 0126be38SMasahiro Yamada  $(warning ================= WARNING ================)
190 0126be38SMasahiro Yamada  $(warning 'SUBDIRS' will be removed after Linux 5.3)
191 0126be38SMasahiro Yamada  $(warning Please use 'M=' or 'KBUILD_EXTMOD' instead)
192 0126be38SMasahiro Yamada  $(warning ==========================================)
193 aa55c8e2SMasahiro Yamada  KBUILD_EXTMOD ?= $(SUBDIRS)
194 aa55c8e2SMasahiro Yamadaendif
195 aa55c8e2SMasahiro Yamada
196 aa55c8e2SMasahiro Yamadaifeq ("$(origin M)", "command line")
197 aa55c8e2SMasahiro Yamada  KBUILD_EXTMOD := $(M)
198 aa55c8e2SMasahiro Yamadaendif
199 aa55c8e2SMasahiro Yamada
200 9da0763bSMichal Marekifeq ($(KBUILD_SRC),)
201 9da0763bSMichal Marek        # building in the source tree
202 9da0763bSMichal Marek        srctree := .
203 9da0763bSMichal Marekelse
204 9da0763bSMichal Marek        ifeq ($(KBUILD_SRC)/,$(dir $(CURDIR)))
205 9da0763bSMichal Marek                # building in a subdirectory of the source tree
206 9da0763bSMichal Marek                srctree := ..
207 9da0763bSMichal Marek        else
208 9da0763bSMichal Marek                srctree := $(KBUILD_SRC)
209 9da0763bSMichal Marek        endif
210 9da0763bSMichal Marekendif
211 2c1f4f12SMasahiro Yamada
212 2c1f4f12SMasahiro Yamadaexport KBUILD_CHECKSRC KBUILD_EXTMOD KBUILD_SRC
213 2c1f4f12SMasahiro Yamada
214 7e1c0477SMichal Marekobjtree		:= .
215 1da177e4SLinus Torvaldssrc		:= $(srctree)
216 1da177e4SLinus Torvaldsobj		:= $(objtree)
217 1da177e4SLinus Torvalds
218 0f558c33SMattia DongiliVPATH		:= $(srctree)$(if $(KBUILD_EXTMOD),:$(KBUILD_EXTMOD))
219 1da177e4SLinus Torvalds
220 11294235SAmerigo Wangexport srctree objtree VPATH
221 1da177e4SLinus Torvalds
222 2c1f4f12SMasahiro Yamada# To make sure we do not include .config for any of the *config targets
223 2c1f4f12SMasahiro Yamada# catch them early, and hand them over to scripts/kconfig/Makefile
224 2c1f4f12SMasahiro Yamada# It is allowed to specify more targets when calling make, including
225 2c1f4f12SMasahiro Yamada# mixing *config targets and build targets.
226 2c1f4f12SMasahiro Yamada# For example 'make oldconfig all'.
227 2c1f4f12SMasahiro Yamada# Detect when mixed targets is specified, and make a second invocation
228 2c1f4f12SMasahiro Yamada# of make so .config is not included in this case either (for *config).
229 2c1f4f12SMasahiro Yamada
230 2c1f4f12SMasahiro Yamadaversion_h := include/generated/uapi/linux/version.h
231 2c1f4f12SMasahiro Yamadaold_version_h := include/linux/version.h
232 2c1f4f12SMasahiro Yamada
233 22340a06SMasahiro Yamadaclean-targets := %clean mrproper cleandocs
234 22340a06SMasahiro Yamadano-dot-config-targets := $(clean-targets) \
235 2c1f4f12SMasahiro Yamada			 cscope gtags TAGS tags help% %docs check% coccicheck \
236 2c1f4f12SMasahiro Yamada			 $(version_h) headers_% archheaders archscripts \
237 63e31a67SMasahiro Yamada			 %asm-generic kernelversion %src-pkg
238 a29d4d8cSMasahiro Yamadano-sync-config-targets := $(no-dot-config-targets) install %install \
239 a29d4d8cSMasahiro Yamada			   kernelrelease
240 2c1f4f12SMasahiro Yamada
241 2c1f4f12SMasahiro Yamadaconfig-targets  := 0
242 2c1f4f12SMasahiro Yamadamixed-targets   := 0
243 2c1f4f12SMasahiro Yamadadot-config      := 1
244 d7942413SMasahiro Yamadamay-sync-config := 1
245 2c1f4f12SMasahiro Yamada
246 2c1f4f12SMasahiro Yamadaifneq ($(filter $(no-dot-config-targets), $(MAKECMDGOALS)),)
247 2c1f4f12SMasahiro Yamada	ifeq ($(filter-out $(no-dot-config-targets), $(MAKECMDGOALS)),)
248 2c1f4f12SMasahiro Yamada		dot-config := 0
249 2c1f4f12SMasahiro Yamada	endif
250 2c1f4f12SMasahiro Yamadaendif
251 2c1f4f12SMasahiro Yamada
252 d7942413SMasahiro Yamadaifneq ($(filter $(no-sync-config-targets), $(MAKECMDGOALS)),)
253 d7942413SMasahiro Yamada	ifeq ($(filter-out $(no-sync-config-targets), $(MAKECMDGOALS)),)
254 d7942413SMasahiro Yamada		may-sync-config := 0
255 d7942413SMasahiro Yamada	endif
256 d7942413SMasahiro Yamadaendif
257 d7942413SMasahiro Yamada
258 d7942413SMasahiro Yamadaifneq ($(KBUILD_EXTMOD),)
259 d7942413SMasahiro Yamada	may-sync-config := 0
260 d7942413SMasahiro Yamadaendif
261 d7942413SMasahiro Yamada
262 2c1f4f12SMasahiro Yamadaifeq ($(KBUILD_EXTMOD),)
263 2c1f4f12SMasahiro Yamada        ifneq ($(filter config %config,$(MAKECMDGOALS)),)
264 2c1f4f12SMasahiro Yamada                config-targets := 1
265 2c1f4f12SMasahiro Yamada                ifneq ($(words $(MAKECMDGOALS)),1)
266 2c1f4f12SMasahiro Yamada                        mixed-targets := 1
267 2c1f4f12SMasahiro Yamada                endif
268 2c1f4f12SMasahiro Yamada        endif
269 2c1f4f12SMasahiro Yamadaendif
270 22340a06SMasahiro Yamada
271 22340a06SMasahiro Yamada# For "make -j clean all", "make -j mrproper defconfig all", etc.
272 22340a06SMasahiro Yamadaifneq ($(filter $(clean-targets),$(MAKECMDGOALS)),)
273 22340a06SMasahiro Yamada        ifneq ($(filter-out $(clean-targets),$(MAKECMDGOALS)),)
274 22340a06SMasahiro Yamada                mixed-targets := 1
275 22340a06SMasahiro Yamada        endif
276 22340a06SMasahiro Yamadaendif
277 22340a06SMasahiro Yamada
278 2c1f4f12SMasahiro Yamada# install and modules_install need also be processed one by one
279 2c1f4f12SMasahiro Yamadaifneq ($(filter install,$(MAKECMDGOALS)),)
280 2c1f4f12SMasahiro Yamada        ifneq ($(filter modules_install,$(MAKECMDGOALS)),)
281 2c1f4f12SMasahiro Yamada	        mixed-targets := 1
282 2c1f4f12SMasahiro Yamada        endif
283 2c1f4f12SMasahiro Yamadaendif
284 2c1f4f12SMasahiro Yamada
285 2c1f4f12SMasahiro Yamadaifeq ($(mixed-targets),1)
286 2c1f4f12SMasahiro Yamada# ===========================================================================
287 2c1f4f12SMasahiro Yamada# We're called with mixed targets (*config and build targets).
288 2c1f4f12SMasahiro Yamada# Handle them one by one.
289 2c1f4f12SMasahiro Yamada
290 2c1f4f12SMasahiro YamadaPHONY += $(MAKECMDGOALS) __build_one_by_one
291 2c1f4f12SMasahiro Yamada
292 2c1f4f12SMasahiro Yamada$(filter-out __build_one_by_one, $(MAKECMDGOALS)): __build_one_by_one
293 2c1f4f12SMasahiro Yamada	@:
294 2c1f4f12SMasahiro Yamada
295 2c1f4f12SMasahiro Yamada__build_one_by_one:
296 2c1f4f12SMasahiro Yamada	$(Q)set -e; \
297 2c1f4f12SMasahiro Yamada	for i in $(MAKECMDGOALS); do \
298 2c1f4f12SMasahiro Yamada		$(MAKE) -f $(srctree)/Makefile $$i; \
299 2c1f4f12SMasahiro Yamada	done
300 2c1f4f12SMasahiro Yamada
301 2c1f4f12SMasahiro Yamadaelse
302 2c1f4f12SMasahiro Yamada
303 2c1f4f12SMasahiro Yamada# We need some generic definitions (do not try to remake the file).
304 2c1f4f12SMasahiro Yamadascripts/Kbuild.include: ;
305 2c1f4f12SMasahiro Yamadainclude scripts/Kbuild.include
306 2c1f4f12SMasahiro Yamada
307 2c1f4f12SMasahiro Yamada# Read KERNELRELEASE from include/config/kernel.release (if it exists)
308 2c1f4f12SMasahiro YamadaKERNELRELEASE = $(shell cat include/config/kernel.release 2> /dev/null)
309 2c1f4f12SMasahiro YamadaKERNELVERSION = $(VERSION)$(if $(PATCHLEVEL),.$(PATCHLEVEL)$(if $(SUBLEVEL),.$(SUBLEVEL)))$(EXTRAVERSION)
310 2c1f4f12SMasahiro Yamadaexport VERSION PATCHLEVEL SUBLEVEL KERNELRELEASE KERNELVERSION
311 2c1f4f12SMasahiro Yamada
312 b2d35fa5SAnders Roxellinclude scripts/subarch.include
313 1da177e4SLinus Torvalds
314 1da177e4SLinus Torvalds# Cross compiling and selecting different set of gcc/bin-utils
315 1da177e4SLinus Torvalds# ---------------------------------------------------------------------------
316 1da177e4SLinus Torvalds#
317 1da177e4SLinus Torvalds# When performing cross compilation for other architectures ARCH shall be set
318 1da177e4SLinus Torvalds# to the target architecture. (See arch/* for the possibilities).
319 1da177e4SLinus Torvalds# ARCH can be set during invocation of make:
320 1da177e4SLinus Torvalds# make ARCH=ia64
321 1da177e4SLinus Torvalds# Another way is to have ARCH set in the environment.
322 1da177e4SLinus Torvalds# The default ARCH is the host where make is executed.
323 1da177e4SLinus Torvalds
324 1da177e4SLinus Torvalds# CROSS_COMPILE specify the prefix used for all executables used
325 1da177e4SLinus Torvalds# during compilation. Only gcc and related bin-utils executables
326 1da177e4SLinus Torvalds# are prefixed with $(CROSS_COMPILE).
327 1da177e4SLinus Torvalds# CROSS_COMPILE can be set on the command line
328 1da177e4SLinus Torvalds# make CROSS_COMPILE=ia64-linux-
329 1da177e4SLinus Torvalds# Alternatively CROSS_COMPILE can be set in the environment.
330 1da177e4SLinus Torvalds# Default value for CROSS_COMPILE is not to prefix executables
331 1da177e4SLinus Torvalds# Note: Some architectures assign CROSS_COMPILE in their arch/*/Makefile
332 2331d1a6SSam RavnborgARCH		?= $(SUBARCH)
333 1da177e4SLinus Torvalds
334 1da177e4SLinus Torvalds# Architecture as present in compile.h
335 1da177e4SLinus TorvaldsUTS_MACHINE 	:= $(ARCH)
336 6752ed90SThomas GleixnerSRCARCH 	:= $(ARCH)
337 1da177e4SLinus Torvalds
338 d746d647SSam Ravnborg# Additional ARCH settings for x86
339 d746d647SSam Ravnborgifeq ($(ARCH),i386)
340 d746d647SSam Ravnborg        SRCARCH := x86
341 d746d647SSam Ravnborgendif
342 d746d647SSam Ravnborgifeq ($(ARCH),x86_64)
343 d746d647SSam Ravnborg        SRCARCH := x86
344 d746d647SSam Ravnborgendif
345 74b469f2SSam Ravnborg
346 5e538790SSam Ravnborg# Additional ARCH settings for sparc
347 e69f58c0SNamhyung Kimifeq ($(ARCH),sparc32)
348 e69f58c0SNamhyung Kim       SRCARCH := sparc
349 e69f58c0SNamhyung Kimendif
350 a439fe51SSam Ravnborgifeq ($(ARCH),sparc64)
351 5e538790SSam Ravnborg       SRCARCH := sparc
352 a439fe51SSam Ravnborgendif
353 2fb9b1bdSSam Ravnborg
354 3cc000b5SPaul Mundt# Additional ARCH settings for sh
355 3cc000b5SPaul Mundtifeq ($(ARCH),sh64)
356 3cc000b5SPaul Mundt       SRCARCH := sh
357 3cc000b5SPaul Mundtendif
358 3cc000b5SPaul Mundt
359 14cdd3c4SRoman ZippelKCONFIG_CONFIG	?= .config
360 41263fc6SBen Gardinerexport KCONFIG_CONFIG
361 14cdd3c4SRoman Zippel
362 1da177e4SLinus Torvalds# SHELL used by kbuild
363 1da177e4SLinus TorvaldsCONFIG_SHELL := $(shell if [ -x "$$BASH" ]; then echo $$BASH; \
364 1da177e4SLinus Torvalds	  else if [ -x /bin/bash ]; then echo /bin/bash; \
365 1da177e4SLinus Torvalds	  else echo sh; fi ; fi)
366 1da177e4SLinus Torvalds
367 6d79a7b4SMasahiro YamadaHOST_LFS_CFLAGS := $(shell getconf LFS_CFLAGS 2>/dev/null)
368 6d79a7b4SMasahiro YamadaHOST_LFS_LDFLAGS := $(shell getconf LFS_LDFLAGS 2>/dev/null)
369 6d79a7b4SMasahiro YamadaHOST_LFS_LIBS := $(shell getconf LFS_LIBS 2>/dev/null)
370 d7f14c66SUwe Kleine-König
371 1da177e4SLinus TorvaldsHOSTCC       = gcc
372 1da177e4SLinus TorvaldsHOSTCXX      = g++
373 96f14fe7SLaura AbbottKBUILD_HOSTCFLAGS   := -Wall -Wmissing-prototypes -Wstrict-prototypes -O2 \
374 f92d19e0SLaura Abbott		-fomit-frame-pointer -std=gnu89 $(HOST_LFS_CFLAGS) \
375 f92d19e0SLaura Abbott		$(HOSTCFLAGS)
376 f92d19e0SLaura AbbottKBUILD_HOSTCXXFLAGS := -O2 $(HOST_LFS_CFLAGS) $(HOSTCXXFLAGS)
377 f92d19e0SLaura AbbottKBUILD_HOSTLDFLAGS  := $(HOST_LFS_LDFLAGS) $(HOSTLDFLAGS)
378 f92d19e0SLaura AbbottKBUILD_HOSTLDLIBS   := $(HOST_LFS_LIBS) $(HOSTLDLIBS)
379 1da177e4SLinus Torvalds
380 1da177e4SLinus Torvalds# Make variables (CC, etc...)
381 1da177e4SLinus TorvaldsAS		= $(CROSS_COMPILE)as
382 1da177e4SLinus TorvaldsLD		= $(CROSS_COMPILE)ld
383 1da177e4SLinus TorvaldsCC		= $(CROSS_COMPILE)gcc
384 1da177e4SLinus TorvaldsCPP		= $(CC) -E
385 1da177e4SLinus TorvaldsAR		= $(CROSS_COMPILE)ar
386 1da177e4SLinus TorvaldsNM		= $(CROSS_COMPILE)nm
387 1da177e4SLinus TorvaldsSTRIP		= $(CROSS_COMPILE)strip
388 1da177e4SLinus TorvaldsOBJCOPY		= $(CROSS_COMPILE)objcopy
389 1da177e4SLinus TorvaldsOBJDUMP		= $(CROSS_COMPILE)objdump
390 73a4f6dbSMasahiro YamadaLEX		= flex
391 73a4f6dbSMasahiro YamadaYACC		= bison
392 1da177e4SLinus TorvaldsAWK		= awk
393 1da177e4SLinus TorvaldsGENKSYMS	= scripts/genksyms/genksyms
394 caa27b66SSam RavnborgINSTALLKERNEL  := installkernel
395 1da177e4SLinus TorvaldsDEPMOD		= /sbin/depmod
396 1da177e4SLinus TorvaldsPERL		= perl
397 011bf125SMasahiro YamadaPYTHON		= python
398 e9781b52SMasahiro YamadaPYTHON2		= python2
399 e9781b52SMasahiro YamadaPYTHON3		= python3
400 1da177e4SLinus TorvaldsCHECK		= sparse
401 1da177e4SLinus Torvalds
402 80a7d1d9SHannes EderCHECKFLAGS     := -D__linux__ -Dlinux -D__STDC__ -Dunix -D__unix__ \
403 6c49f359SLuc Van Oostenryck		  -Wbitwise -Wno-return-void -Wno-unknown-attribute $(CF)
404 b36fad65SMichal MarekNOSTDINC_FLAGS  =
405 6588169dSSam RavnborgCFLAGS_MODULE   =
406 6588169dSSam RavnborgAFLAGS_MODULE   =
407 6588169dSSam RavnborgLDFLAGS_MODULE  =
408 1da177e4SLinus TorvaldsCFLAGS_KERNEL	=
409 1da177e4SLinus TorvaldsAFLAGS_KERNEL	=
410 b36fad65SMichal MarekLDFLAGS_vmlinux =
411 1da177e4SLinus Torvalds
412 abbf1590SDavid Howells# Use USERINCLUDE when you must reference the UAPI directories only.
413 abbf1590SDavid HowellsUSERINCLUDE    := \
414 9d022c54SMasahiro Yamada		-I$(srctree)/arch/$(SRCARCH)/include/uapi \
415 9d022c54SMasahiro Yamada		-I$(objtree)/arch/$(SRCARCH)/include/generated/uapi \
416 abbf1590SDavid Howells		-I$(srctree)/include/uapi \
417 3308b285SArnd Bergmann		-I$(objtree)/include/generated/uapi \
418 abbf1590SDavid Howells                -include $(srctree)/include/linux/kconfig.h
419 abbf1590SDavid Howells
420 1da177e4SLinus Torvalds# Use LINUXINCLUDE when you must reference the include/ directory.
421 1da177e4SLinus Torvalds# Needed to be compatible with the O= option
422 abbf1590SDavid HowellsLINUXINCLUDE    := \
423 9d022c54SMasahiro Yamada		-I$(srctree)/arch/$(SRCARCH)/include \
424 9d022c54SMasahiro Yamada		-I$(objtree)/arch/$(SRCARCH)/include/generated \
425 96f13045SSam Ravnborg		$(if $(KBUILD_SRC), -I$(srctree)/include) \
426 f8224f7fSMasahiro Yamada		-I$(objtree)/include \
427 f8224f7fSMasahiro Yamada		$(USERINCLUDE)
428 1da177e4SLinus Torvalds
429 433dc2ebSMasahiro YamadaKBUILD_AFLAGS   := -D__ASSEMBLY__
430 a0f97e06SSam RavnborgKBUILD_CFLAGS   := -Wall -Wundef -Wstrict-prototypes -Wno-trigraphs \
431 8c97023cSArnd Bergmann		   -fno-strict-aliasing -fno-common -fshort-wchar \
432 a8735821SFloris Kraak		   -Werror-implicit-function-declaration \
433 51b97e35SKirill A. Shutemov		   -Wno-format-security \
434 433dc2ebSMasahiro Yamada		   -std=gnu89
435 433dc2ebSMasahiro YamadaKBUILD_CPPFLAGS := -D__KERNEL__
436 80c00ba9SSam RavnborgKBUILD_AFLAGS_KERNEL :=
437 80c00ba9SSam RavnborgKBUILD_CFLAGS_KERNEL :=
438 6588169dSSam RavnborgKBUILD_AFLAGS_MODULE  := -DMODULE
439 6588169dSSam RavnborgKBUILD_CFLAGS_MODULE  := -DMODULE
440 6588169dSSam RavnborgKBUILD_LDFLAGS_MODULE := -T $(srctree)/scripts/module-common.lds
441 d503ac53SMasahiro YamadaKBUILD_LDFLAGS :=
442 433dc2ebSMasahiro YamadaGCC_PLUGINS_CFLAGS :=
443 1da177e4SLinus Torvalds
444 96f14fe7SLaura Abbottexport ARCH SRCARCH CONFIG_SHELL HOSTCC KBUILD_HOSTCFLAGS CROSS_COMPILE AS LD CC
445 8377bd2bSLaura Abbottexport CPP AR NM STRIP OBJCOPY OBJDUMP KBUILD_HOSTLDFLAGS KBUILD_HOSTLDLIBS
446 e9781b52SMasahiro Yamadaexport MAKE LEX YACC AWK GENKSYMS INSTALLKERNEL PERL PYTHON PYTHON2 PYTHON3 UTS_MACHINE
447 10844aebSLaura Abbottexport HOSTCXX KBUILD_HOSTCXXFLAGS LDFLAGS_MODULE CHECK CHECKFLAGS
448 1da177e4SLinus Torvalds
449 d503ac53SMasahiro Yamadaexport KBUILD_CPPFLAGS NOSTDINC_FLAGS LINUXINCLUDE OBJCOPYFLAGS KBUILD_LDFLAGS
450 0e410e15SAndrey Konovalovexport KBUILD_CFLAGS CFLAGS_KERNEL CFLAGS_MODULE
451 0e410e15SAndrey Konovalovexport CFLAGS_KASAN CFLAGS_KASAN_NOSANITIZE CFLAGS_UBSAN
452 222d394dSSam Ravnborgexport KBUILD_AFLAGS AFLAGS_KERNEL AFLAGS_MODULE
453 6588169dSSam Ravnborgexport KBUILD_AFLAGS_MODULE KBUILD_CFLAGS_MODULE KBUILD_LDFLAGS_MODULE
454 80c00ba9SSam Ravnborgexport KBUILD_AFLAGS_KERNEL KBUILD_CFLAGS_KERNEL
455 40df759eSMichal Marekexport KBUILD_ARFLAGS
456 1da177e4SLinus Torvalds
457 1da177e4SLinus Torvalds# When compiling out-of-tree modules, put MODVERDIR in the module
458 1da177e4SLinus Torvalds# tree rather than in the kernel tree. The kernel tree might
459 1da177e4SLinus Torvalds# even be read-only.
460 1da177e4SLinus Torvaldsexport MODVERDIR := $(if $(KBUILD_EXTMOD),$(firstword $(KBUILD_EXTMOD))/).tmp_versions
461 1da177e4SLinus Torvalds
462 1da177e4SLinus Torvalds# Files to ignore in find ... statements
463 1da177e4SLinus Torvalds
464 ae63b2d7SPrarit Bhargavaexport RCS_FIND_IGNORE := \( -name SCCS -o -name BitKeeper -o -name .svn -o    \
465 ae63b2d7SPrarit Bhargava			  -name CVS -o -name .pc -o -name .hg -o -name .git \) \
466 ae63b2d7SPrarit Bhargava			  -prune -o
467 450c6076SJesper Juhlexport RCS_TAR_IGNORE := --exclude SCCS --exclude BitKeeper --exclude .svn \
468 450c6076SJesper Juhl			 --exclude CVS --exclude .pc --exclude .hg --exclude .git
469 1da177e4SLinus Torvalds
470 1da177e4SLinus Torvalds# ===========================================================================
471 1da177e4SLinus Torvalds# Rules shared between *config targets and build targets
472 1da177e4SLinus Torvalds
473 312a3d09SCao jin# Basic helpers built in scripts/basic/
474 4f193362SPaul SmithPHONY += scripts_basic
475 1da177e4SLinus Torvaldsscripts_basic:
476 1da177e4SLinus Torvalds	$(Q)$(MAKE) $(build)=scripts/basic
477 638adb05SSteven Rostedt	$(Q)rm -f .tmp_quiet_recordmcount
478 1da177e4SLinus Torvalds
479 cd05e6bdSJan Beulich# To avoid any implicit rule to kick in, define an empty command.
480 cd05e6bdSJan Beulichscripts/basic/%: scripts_basic ;
481 cd05e6bdSJan Beulich
482 4f193362SPaul SmithPHONY += outputmakefile
483 fd5f0cd6SJan Beulich# outputmakefile generates a Makefile in the output directory, if using a
484 fd5f0cd6SJan Beulich# separate output directory. This allows convenient use of make in the
485 fd5f0cd6SJan Beulich# output directory.
486 1da177e4SLinus Torvaldsoutputmakefile:
487 fd5f0cd6SJan Beulichifneq ($(KBUILD_SRC),)
488 92979997SAndi Kleen	$(Q)ln -fsn $(srctree) source
489 4fd61277SMasahiro Yamada	$(Q)$(CONFIG_SHELL) $(srctree)/scripts/mkmakefile $(srctree)
490 fd5f0cd6SJan Beulichendif
491 1da177e4SLinus Torvalds
492 99516742SMasahiro Yamadaifneq ($(shell $(CC) --version 2>&1 | head -n 1 | grep clang),)
493 ae6b289aSChris Friesifneq ($(CROSS_COMPILE),)
494 238bcbc4SMasahiro YamadaCLANG_FLAGS	:= --target=$(notdir $(CROSS_COMPILE:%-=%))
495 ef8c4ed9SStefan AgnerGCC_TOOLCHAIN_DIR := $(dir $(shell which $(LD)))
496 238bcbc4SMasahiro YamadaCLANG_FLAGS	+= --prefix=$(GCC_TOOLCHAIN_DIR)
497 ef8c4ed9SStefan AgnerGCC_TOOLCHAIN	:= $(realpath $(GCC_TOOLCHAIN_DIR)/..)
498 ae6b289aSChris Friesendif
499 ae6b289aSChris Friesifneq ($(GCC_TOOLCHAIN),)
500 238bcbc4SMasahiro YamadaCLANG_FLAGS	+= --gcc-toolchain=$(GCC_TOOLCHAIN)
501 ae6b289aSChris Friesendif
502 238bcbc4SMasahiro YamadaCLANG_FLAGS	+= -no-integrated-as
503 238bcbc4SMasahiro YamadaKBUILD_CFLAGS	+= $(CLANG_FLAGS)
504 238bcbc4SMasahiro YamadaKBUILD_AFLAGS	+= $(CLANG_FLAGS)
505 3bd98050SJoel Stanleyexport CLANG_FLAGS
506 ae6b289aSChris Friesendif
507 ae6b289aSChris Fries
508 d5028ba8SPeter ZijlstraRETPOLINE_CFLAGS_GCC := -mindirect-branch=thunk-extern -mindirect-branch-register
509 2e549b2eSAndy LutomirskiRETPOLINE_VDSO_CFLAGS_GCC := -mindirect-branch=thunk-inline -mindirect-branch-register
510 d5028ba8SPeter ZijlstraRETPOLINE_CFLAGS_CLANG := -mretpoline-external-thunk
511 2e549b2eSAndy LutomirskiRETPOLINE_VDSO_CFLAGS_CLANG := -mretpoline
512 d5028ba8SPeter ZijlstraRETPOLINE_CFLAGS := $(call cc-option,$(RETPOLINE_CFLAGS_GCC),$(call cc-option,$(RETPOLINE_CFLAGS_CLANG)))
513 2e549b2eSAndy LutomirskiRETPOLINE_VDSO_CFLAGS := $(call cc-option,$(RETPOLINE_VDSO_CFLAGS_GCC),$(call cc-option,$(RETPOLINE_VDSO_CFLAGS_CLANG)))
514 d5028ba8SPeter Zijlstraexport RETPOLINE_CFLAGS
515 2e549b2eSAndy Lutomirskiexport RETPOLINE_VDSO_CFLAGS
516 d5028ba8SPeter Zijlstra
517 8438ee76SMichal KubecekKBUILD_CFLAGS	+= $(call cc-option,-fno-PIE)
518 8438ee76SMichal KubecekKBUILD_AFLAGS	+= $(call cc-option,-fno-PIE)
519 8438ee76SMichal Kubecek
520 e501ce95SPeter Zijlstra# check for 'asm goto'
521 e08d6de4SMasahiro Yamadaifeq ($(shell $(CONFIG_SHELL) $(srctree)/scripts/gcc-goto.sh $(CC) $(KBUILD_CFLAGS)), y)
522 e501ce95SPeter Zijlstra  CC_HAVE_ASM_GOTO := 1
523 e501ce95SPeter Zijlstra  KBUILD_CFLAGS += -DCC_HAVE_ASM_GOTO
524 e501ce95SPeter Zijlstra  KBUILD_AFLAGS += -DCC_HAVE_ASM_GOTO
525 e501ce95SPeter Zijlstraendif
526 e501ce95SPeter Zijlstra
527 315bab4eSMasahiro Yamada# The expansion should be delayed until arch/$(SRCARCH)/Makefile is included.
528 315bab4eSMasahiro Yamada# Some architectures define CROSS_COMPILE in arch/$(SRCARCH)/Makefile.
529 315bab4eSMasahiro Yamada# CC_VERSION_TEXT is referenced from Kconfig (so it needs export),
530 315bab4eSMasahiro Yamada# and from include/config/auto.conf.cmd to detect the compiler upgrade.
531 315bab4eSMasahiro YamadaCC_VERSION_TEXT = $(shell $(CC) --version | head -n 1)
532 315bab4eSMasahiro Yamada
533 1da177e4SLinus Torvaldsifeq ($(config-targets),1)
534 1da177e4SLinus Torvalds# ===========================================================================
535 1da177e4SLinus Torvalds# *config targets only - make sure prerequisites are updated, and descend
536 1da177e4SLinus Torvalds# in scripts/kconfig to make the *config target
537 1da177e4SLinus Torvalds
538 1da177e4SLinus Torvalds# Read arch specific Makefile to set KBUILD_DEFCONFIG as needed.
539 1da177e4SLinus Torvalds# KBUILD_DEFCONFIG may point out an alternative default configuration
540 1da177e4SLinus Torvalds# used for 'make defconfig'
541 a436bb7bSMasahiro Yamadainclude arch/$(SRCARCH)/Makefile
542 315bab4eSMasahiro Yamadaexport KBUILD_DEFCONFIG KBUILD_KCONFIG CC_VERSION_TEXT
543 1da177e4SLinus Torvalds
544 31110ebbSSam Ravnborgconfig: scripts_basic outputmakefile FORCE
545 31110ebbSSam Ravnborg	$(Q)$(MAKE) $(build)=scripts/kconfig $@
546 31110ebbSSam Ravnborg
547 31110ebbSSam Ravnborg%config: scripts_basic outputmakefile FORCE
548 1da177e4SLinus Torvalds	$(Q)$(MAKE) $(build)=scripts/kconfig $@
549 1da177e4SLinus Torvalds
550 1da177e4SLinus Torvaldselse
551 1da177e4SLinus Torvalds# ===========================================================================
552 1da177e4SLinus Torvalds# Build targets only - this includes vmlinux, arch specific targets, clean
553 1da177e4SLinus Torvalds# targets and others. In general all targets except *config targets.
554 1da177e4SLinus Torvalds
555 2c1f4f12SMasahiro Yamada# If building an external module we do not care about the all: rule
556 2c1f4f12SMasahiro Yamada# but instead _all depend on modules
557 2c1f4f12SMasahiro YamadaPHONY += all
558 2c1f4f12SMasahiro Yamadaifeq ($(KBUILD_EXTMOD),)
559 2c1f4f12SMasahiro Yamada_all: all
560 2c1f4f12SMasahiro Yamadaelse
561 2c1f4f12SMasahiro Yamada_all: modules
562 2c1f4f12SMasahiro Yamadaendif
563 2c1f4f12SMasahiro Yamada
564 2c1f4f12SMasahiro Yamada# Decide whether to build built-in, modular, or both.
565 2c1f4f12SMasahiro Yamada# Normally, just do built-in.
566 2c1f4f12SMasahiro Yamada
567 2c1f4f12SMasahiro YamadaKBUILD_MODULES :=
568 2c1f4f12SMasahiro YamadaKBUILD_BUILTIN := 1
569 2c1f4f12SMasahiro Yamada
570 2c1f4f12SMasahiro Yamada# If we have only "make modules", don't compile built-in objects.
571 2c1f4f12SMasahiro Yamada# When we're building modules with modversions, we need to consider
572 2c1f4f12SMasahiro Yamada# the built-in objects during the descend as well, in order to
573 2c1f4f12SMasahiro Yamada# make sure the checksums are up to date before we record them.
574 2c1f4f12SMasahiro Yamada
575 2c1f4f12SMasahiro Yamadaifeq ($(MAKECMDGOALS),modules)
576 2c1f4f12SMasahiro Yamada  KBUILD_BUILTIN := $(if $(CONFIG_MODVERSIONS),1)
577 2c1f4f12SMasahiro Yamadaendif
578 2c1f4f12SMasahiro Yamada
579 2c1f4f12SMasahiro Yamada# If we have "make <whatever> modules", compile modules
580 2c1f4f12SMasahiro Yamada# in addition to whatever we do anyway.
581 2c1f4f12SMasahiro Yamada# Just "make" or "make all" shall build modules as well
582 2c1f4f12SMasahiro Yamada
583 2c1f4f12SMasahiro Yamadaifneq ($(filter all _all modules,$(MAKECMDGOALS)),)
584 2c1f4f12SMasahiro Yamada  KBUILD_MODULES := 1
585 2c1f4f12SMasahiro Yamadaendif
586 2c1f4f12SMasahiro Yamada
587 2c1f4f12SMasahiro Yamadaifeq ($(MAKECMDGOALS),)
588 2c1f4f12SMasahiro Yamada  KBUILD_MODULES := 1
589 2c1f4f12SMasahiro Yamadaendif
590 2c1f4f12SMasahiro Yamada
591 2c1f4f12SMasahiro Yamadaexport KBUILD_MODULES KBUILD_BUILTIN
592 2c1f4f12SMasahiro Yamada
593 1da177e4SLinus Torvaldsifeq ($(KBUILD_EXTMOD),)
594 1da177e4SLinus Torvalds# Objects we will link into vmlinux / subdirs we need to visit
595 1da177e4SLinus Torvaldsinit-y		:= init/
596 df85b2d7SMarkus Trippelsdorfdrivers-y	:= drivers/ sound/ firmware/
597 1da177e4SLinus Torvaldsnet-y		:= net/
598 1da177e4SLinus Torvaldslibs-y		:= lib/
599 1da177e4SLinus Torvaldscore-y		:= usr/
600 37d9fe47SFeng Wuvirt-y		:= virt/
601 1da177e4SLinus Torvaldsendif # KBUILD_EXTMOD
602 1da177e4SLinus Torvalds
603 1da177e4SLinus Torvaldsifeq ($(dot-config),1)
604 0a16d2e8SMasahiro Yamadainclude include/config/auto.conf
605 315bab4eSMasahiro Yamadaendif
606 1da177e4SLinus Torvalds
607 315bab4eSMasahiro Yamada# The all: target is the default when no target is given on the
608 315bab4eSMasahiro Yamada# command line.
609 315bab4eSMasahiro Yamada# This allow a user to issue only 'make' to build a kernel including modules
610 315bab4eSMasahiro Yamada# Defaults to vmlinux, but the arch makefile usually adds further targets
611 315bab4eSMasahiro Yamadaall: vmlinux
612 315bab4eSMasahiro Yamada
613 315bab4eSMasahiro YamadaCFLAGS_GCOV	:= -fprofile-arcs -ftest-coverage \
614 315bab4eSMasahiro Yamada	$(call cc-option,-fno-tree-loop-im) \
615 315bab4eSMasahiro Yamada	$(call cc-disable-warning,maybe-uninitialized,)
616 5aadfdebSMasahiro Yamadaexport CFLAGS_GCOV
617 315bab4eSMasahiro Yamada
618 b1f4ff74SPaulo Zanoni# The arch Makefiles can override CC_FLAGS_FTRACE. We may also append it later.
619 b1f4ff74SPaulo Zanoniifdef CONFIG_FUNCTION_TRACER
620 b1f4ff74SPaulo Zanoni  CC_FLAGS_FTRACE := -pg
621 b1f4ff74SPaulo Zanoniendif
622 b1f4ff74SPaulo Zanoni
623 315bab4eSMasahiro Yamada# The arch Makefile can set ARCH_{CPP,A,C}FLAGS to override the default
624 315bab4eSMasahiro Yamada# values of the respective KBUILD_* variables
625 315bab4eSMasahiro YamadaARCH_CPPFLAGS :=
626 315bab4eSMasahiro YamadaARCH_AFLAGS :=
627 315bab4eSMasahiro YamadaARCH_CFLAGS :=
628 315bab4eSMasahiro Yamadainclude arch/$(SRCARCH)/Makefile
629 315bab4eSMasahiro Yamada
630 315bab4eSMasahiro Yamadaifeq ($(dot-config),1)
631 d7942413SMasahiro Yamadaifeq ($(may-sync-config),1)
632 315bab4eSMasahiro Yamada# Read in dependencies to all Kconfig* files, make sure to run syncconfig if
633 315bab4eSMasahiro Yamada# changes are detected. This should be included after arch/$(SRCARCH)/Makefile
634 315bab4eSMasahiro Yamada# because some architectures define CROSS_COMPILE there.
635 c955ccafSRoman Zippel-include include/config/auto.conf.cmd
636 1da177e4SLinus Torvalds
637 1da177e4SLinus Torvalds# To avoid any implicit rule to kick in, define an empty command
638 14cdd3c4SRoman Zippel$(KCONFIG_CONFIG) include/config/auto.conf.cmd: ;
639 1da177e4SLinus Torvalds
640 61277981SUlf Magnusson# The actual configuration files used during the build are stored in
641 61277981SUlf Magnusson# include/generated/ and include/config/. Update them if .config is newer than
642 61277981SUlf Magnusson# include/config/auto.conf (which mirrors .config).
643 bc081dd6SMichal Marekinclude/config/%.conf: $(KCONFIG_CONFIG) include/config/auto.conf.cmd
644 911a91c3SMasahiro Yamada	$(Q)$(MAKE) -f $(srctree)/Makefile syncconfig
645 1da177e4SLinus Torvaldselse
646 d7942413SMasahiro Yamada# External modules and some install targets need include/generated/autoconf.h
647 d7942413SMasahiro Yamada# and include/config/auto.conf but do not care if they are up-to-date.
648 d7942413SMasahiro Yamada# Use auto.conf to trigger the test
649 9ee4e336SSam RavnborgPHONY += include/config/auto.conf
650 9ee4e336SSam Ravnborg
651 9ee4e336SSam Ravnborginclude/config/auto.conf:
652 264a2683SSam Ravnborg	$(Q)test -e include/generated/autoconf.h -a -e $@ || (		\
653 5369f550SMichal Marek	echo >&2;							\
654 5369f550SMichal Marek	echo >&2 "  ERROR: Kernel configuration is invalid.";		\
655 5369f550SMichal Marek	echo >&2 "         include/generated/autoconf.h or $@ are missing.";\
656 5369f550SMichal Marek	echo >&2 "         Run 'make oldconfig && make prepare' on kernel src to fix it.";	\
657 5369f550SMichal Marek	echo >&2 ;							\
658 9ee4e336SSam Ravnborg	/bin/false)
659 9ee4e336SSam Ravnborg
660 d7942413SMasahiro Yamadaendif # may-sync-config
661 9ee4e336SSam Ravnborgendif # $(dot-config)
662 1da177e4SLinus Torvalds
663 a1c48bb1SGeert UytterhoevenKBUILD_CFLAGS	+= $(call cc-option,-fno-delete-null-pointer-checks,)
664 ef6000b4SLinus TorvaldsKBUILD_CFLAGS	+= $(call cc-disable-warning,frame-address,)
665 bd664f6bSLinus TorvaldsKBUILD_CFLAGS	+= $(call cc-disable-warning, format-truncation)
666 bd664f6bSLinus TorvaldsKBUILD_CFLAGS	+= $(call cc-disable-warning, format-overflow)
667 bd664f6bSLinus TorvaldsKBUILD_CFLAGS	+= $(call cc-disable-warning, int-in-bool-context)
668 a1c48bb1SGeert Uytterhoeven
669 1da177e4SLinus Torvaldsifdef CONFIG_CC_OPTIMIZE_FOR_SIZE
670 6748cb3cSBehan WebsterKBUILD_CFLAGS	+= $(call cc-option,-Oz,-Os)
671 6748cb3cSBehan WebsterKBUILD_CFLAGS	+= $(call cc-disable-warning,maybe-uninitialized,)
672 1da177e4SLinus Torvaldselse
673 815eb71eSArnd Bergmannifdef CONFIG_PROFILE_ALL_BRANCHES
674 a76bcf55SArnd BergmannKBUILD_CFLAGS	+= -O2 $(call cc-disable-warning,maybe-uninitialized,)
675 815eb71eSArnd Bergmannelse
676 a0f97e06SSam RavnborgKBUILD_CFLAGS   += -O2
677 1da177e4SLinus Torvaldsendif
678 815eb71eSArnd Bergmannendif
679 1da177e4SLinus Torvalds
680 a76bcf55SArnd BergmannKBUILD_CFLAGS += $(call cc-ifversion, -lt, 0409, \
681 a76bcf55SArnd Bergmann			$(call cc-disable-warning,maybe-uninitialized,))
682 a76bcf55SArnd Bergmann
683 69102311SJiri Kosina# Tell gcc to never replace conditional load with a non-conditional one
684 69102311SJiri KosinaKBUILD_CFLAGS	+= $(call cc-option,--param=allow-store-data-races=0)
685 69102311SJiri Kosina
686 d677a4d6SVictor Chibotaruinclude scripts/Makefile.kcov
687 6b90bd4bSEmese Revfyinclude scripts/Makefile.gcc-plugins
688 6b90bd4bSEmese Revfy
689 1873e870SAndi Kleenifdef CONFIG_READABLE_ASM
690 1873e870SAndi Kleen# Disable optimizations that make assembler listings hard to read.
691 1873e870SAndi Kleen# reorder blocks reorders the control in the function
692 1873e870SAndi Kleen# ipa clone creates specialized cloned functions
693 1873e870SAndi Kleen# partial inlining inlines only parts of functions
694 1873e870SAndi KleenKBUILD_CFLAGS += $(call cc-option,-fno-reorder-blocks,) \
695 1873e870SAndi Kleen                 $(call cc-option,-fno-ipa-cp-clone,) \
696 1873e870SAndi Kleen                 $(call cc-option,-fno-partial-inlining)
697 1873e870SAndi Kleenendif
698 1873e870SAndi Kleen
699 08f67461SMike Frysingerifneq ($(CONFIG_FRAME_WARN),0)
700 35bb5b1eSAndi KleenKBUILD_CFLAGS += $(call cc-option,-Wframe-larger-than=${CONFIG_FRAME_WARN})
701 35bb5b1eSAndi Kleenendif
702 35bb5b1eSAndi Kleen
703 2a61f474SMasahiro Yamadastackp-flags-$(CONFIG_CC_HAS_STACKPROTECTOR_NONE) := -fno-stack-protector
704 050e9baaSLinus Torvaldsstackp-flags-$(CONFIG_STACKPROTECTOR)             := -fstack-protector
705 050e9baaSLinus Torvaldsstackp-flags-$(CONFIG_STACKPROTECTOR_STRONG)      := -fstack-protector-strong
706 2a61f474SMasahiro Yamada
707 2a61f474SMasahiro YamadaKBUILD_CFLAGS += $(stackp-flags-y)
708 e06b8b98SSam Ravnborg
709 076f421dSMasahiro Yamadaifdef CONFIG_CC_IS_CLANG
710 cfe17c9bSMasahiro YamadaKBUILD_CPPFLAGS += $(call cc-option,-Qunused-arguments,)
711 cfe17c9bSMasahiro YamadaKBUILD_CFLAGS += $(call cc-disable-warning, format-invalid-specifier)
712 cfe17c9bSMasahiro YamadaKBUILD_CFLAGS += $(call cc-disable-warning, gnu)
713 cfe17c9bSMasahiro YamadaKBUILD_CFLAGS += $(call cc-disable-warning, address-of-packed-member)
714 cfe17c9bSMasahiro Yamada# Quiet clang warning: comparison of unsigned expression < 0 is always false
715 cfe17c9bSMasahiro YamadaKBUILD_CFLAGS += $(call cc-disable-warning, tautological-compare)
716 cfe17c9bSMasahiro Yamada# CLANG uses a _MergedGlobals as optimization, but this breaks modpost, as the
717 cfe17c9bSMasahiro Yamada# source of a reference will be _MergedGlobals and not on of the whitelisted names.
718 cfe17c9bSMasahiro Yamada# See modpost pattern 2
719 cfe17c9bSMasahiro YamadaKBUILD_CFLAGS += $(call cc-option, -mno-global-merge,)
720 cfe17c9bSMasahiro YamadaKBUILD_CFLAGS += $(call cc-option, -fcatch-undefined-behavior)
721 cfe17c9bSMasahiro Yamadaelse
722 cfe17c9bSMasahiro Yamada
723 cfe17c9bSMasahiro Yamada# These warnings generated too much noise in a regular build.
724 cfe17c9bSMasahiro Yamada# Use make W=1 to enable them (see scripts/Makefile.extrawarn)
725 9df3e7a7SMasahiro YamadaKBUILD_CFLAGS += -Wno-unused-but-set-variable
726 cfe17c9bSMasahiro Yamadaendif
727 cfe17c9bSMasahiro Yamada
728 0a5f4176SSodagudi PrasadKBUILD_CFLAGS += $(call cc-disable-warning, unused-const-variable)
729 1da177e4SLinus Torvaldsifdef CONFIG_FRAME_POINTER
730 a0f97e06SSam RavnborgKBUILD_CFLAGS	+= -fno-omit-frame-pointer -fno-optimize-sibling-calls
731 1da177e4SLinus Torvaldselse
732 7e9501fdSRabin Vincent# Some targets (ARM with Thumb2, for example), can't be built with frame
733 7e9501fdSRabin Vincent# pointers.  For those, we don't have FUNCTION_TRACER automatically
734 7e9501fdSRabin Vincent# select FRAME_POINTER.  However, FUNCTION_TRACER adds -pg, and this is
735 7e9501fdSRabin Vincent# incompatible with -fomit-frame-pointer with current GCC, so we don't use
736 7e9501fdSRabin Vincent# -fomit-frame-pointer with FUNCTION_TRACER.
737 7e9501fdSRabin Vincentifndef CONFIG_FUNCTION_TRACER
738 a0f97e06SSam RavnborgKBUILD_CFLAGS	+= -fomit-frame-pointer
739 1da177e4SLinus Torvaldsendif
740 7e9501fdSRabin Vincentendif
741 1da177e4SLinus Torvalds
742 2062afb4SLinus TorvaldsKBUILD_CFLAGS   += $(call cc-option, -fno-var-tracking-assignments)
743 2062afb4SLinus Torvalds
744 1da177e4SLinus Torvaldsifdef CONFIG_DEBUG_INFO
745 866ced95SAndi Kleenifdef CONFIG_DEBUG_INFO_SPLIT
746 866ced95SAndi KleenKBUILD_CFLAGS   += $(call cc-option, -gsplit-dwarf, -g)
747 866ced95SAndi Kleenelse
748 a0f97e06SSam RavnborgKBUILD_CFLAGS	+= -g
749 866ced95SAndi Kleenendif
750 2288328cSBehan WebsterKBUILD_AFLAGS	+= -Wa,-gdwarf-2
751 1da177e4SLinus Torvaldsendif
752 bfaf2dd3SAndi Kleenifdef CONFIG_DEBUG_INFO_DWARF4
753 bfaf2dd3SAndi KleenKBUILD_CFLAGS	+= $(call cc-option, -gdwarf-4,)
754 bfaf2dd3SAndi Kleenendif
755 1da177e4SLinus Torvalds
756 d6f4ceb7SAndi Kleenifdef CONFIG_DEBUG_INFO_REDUCED
757 e82c4bb8SAndi KleenKBUILD_CFLAGS 	+= $(call cc-option, -femit-struct-debug-baseonly) \
758 e82c4bb8SAndi Kleen		   $(call cc-option,-fno-var-tracking)
759 d6f4ceb7SAndi Kleenendif
760 d6f4ceb7SAndi Kleen
761 606576ceSSteven Rostedtifdef CONFIG_FUNCTION_TRACER
762 07d04081SVasily Gorbikifdef CONFIG_FTRACE_MCOUNT_RECORD
763 07d04081SVasily Gorbik  # gcc 5 supports generating the mcount tables directly
764 07d04081SVasily Gorbik  ifeq ($(call cc-option-yn,-mrecord-mcount),y)
765 07d04081SVasily Gorbik    CC_FLAGS_FTRACE	+= -mrecord-mcount
766 07d04081SVasily Gorbik    export CC_USING_RECORD_MCOUNT := 1
767 a2546faeSSteven Rostedt  endif
768 2f4df001SVasily Gorbik  ifdef CONFIG_HAVE_NOP_MCOUNT
769 2f4df001SVasily Gorbik    ifeq ($(call cc-option-yn, -mnop-mcount),y)
770 2f4df001SVasily Gorbik      CC_FLAGS_FTRACE	+= -mnop-mcount
771 2f4df001SVasily Gorbik      CC_FLAGS_USING	+= -DCC_USING_NOP_MCOUNT
772 2f4df001SVasily Gorbik    endif
773 2f4df001SVasily Gorbik  endif
774 07d04081SVasily Gorbikendif
775 a2546faeSSteven Rostedtifdef CONFIG_HAVE_FENTRY
776 f28bc3c3SVasily Gorbik  ifeq ($(call cc-option-yn, -mfentry),y)
777 f28bc3c3SVasily Gorbik    CC_FLAGS_FTRACE	+= -mfentry
778 f28bc3c3SVasily Gorbik    CC_FLAGS_USING	+= -DCC_USING_FENTRY
779 a2546faeSSteven Rostedt  endif
780 f28bc3c3SVasily Gorbikendif
781 f28bc3c3SVasily Gorbikexport CC_FLAGS_FTRACE
782 f28bc3c3SVasily GorbikKBUILD_CFLAGS	+= $(CC_FLAGS_FTRACE) $(CC_FLAGS_USING)
783 f28bc3c3SVasily GorbikKBUILD_AFLAGS	+= $(CC_FLAGS_USING)
784 72441cb1SSteven Rostedtifdef CONFIG_DYNAMIC_FTRACE
785 cf4db259SSteven Rostedt	ifdef CONFIG_HAVE_C_RECORDMCOUNT
786 72441cb1SSteven Rostedt		BUILD_C_RECORDMCOUNT := y
787 72441cb1SSteven Rostedt		export BUILD_C_RECORDMCOUNT
788 72441cb1SSteven Rostedt	endif
789 72441cb1SSteven Rostedtendif
790 16444a8aSArnaldo Carvalho de Meloendif
791 16444a8aSArnaldo Carvalho de Melo
792 91341d4bSSam Ravnborg# We trigger additional mismatches with less inlining
793 91341d4bSSam Ravnborgifdef CONFIG_DEBUG_SECTION_MISMATCH
794 91341d4bSSam RavnborgKBUILD_CFLAGS += $(call cc-option, -fno-inline-functions-called-once)
795 91341d4bSSam Ravnborgendif
796 91341d4bSSam Ravnborg
797 90ad4052SMasahiro Yamadaifdef CONFIG_LD_DEAD_CODE_DATA_ELIMINATION
798 e85d1d65SMasahiro YamadaKBUILD_CFLAGS_KERNEL += -ffunction-sections -fdata-sections
799 e85d1d65SMasahiro YamadaLDFLAGS_vmlinux += --gc-sections
800 90ad4052SMasahiro Yamadaendif
801 90ad4052SMasahiro Yamada
802 e8e69931SSam Ravnborg# arch Makefile may override CC so keep this after arch Makefile is included
803 e08d6de4SMasahiro YamadaNOSTDINC_FLAGS += -nostdinc -isystem $(shell $(CC) -print-file-name=include)
804 e8e69931SSam Ravnborg
805 1da177e4SLinus Torvalds# warn about C99 declaration after statement
806 a33e7ae2SMasahiro YamadaKBUILD_CFLAGS += -Wdeclaration-after-statement
807 1da177e4SLinus Torvalds
808 0bb95f80SKees Cook# Variable Length Arrays (VLAs) should not be used anywhere in the kernel
809 0bb95f80SKees CookKBUILD_CFLAGS += $(call cc-option,-Wvla)
810 0bb95f80SKees Cook
811 070b98bfSSam Ravnborg# disable pointer signed / unsigned warnings in gcc 4.0
812 fb073a4bSMasahiro YamadaKBUILD_CFLAGS += -Wno-pointer-sign
813 1da177e4SLinus Torvalds
814 217c3e01SStephen Rothwell# disable stringop warnings in gcc 8+
815 217c3e01SStephen RothwellKBUILD_CFLAGS += $(call cc-disable-warning, stringop-truncation)
816 217c3e01SStephen Rothwell
817 fe8d0a41SKirill Smelkov# disable invalid "can't wrap" optimizations for signed / pointers
818 a137802eSLinus TorvaldsKBUILD_CFLAGS	+= $(call cc-option,-fno-strict-overflow)
819 d0115552SLinus Torvalds
820 87e0d4f0SDaniel Borkmann# clang sets -fmerge-all-constants by default as optimization, but this
821 87e0d4f0SDaniel Borkmann# is non-conforming behavior for C and in fact breaks the kernel, so we
822 87e0d4f0SDaniel Borkmann# need to disable it here generally.
823 87e0d4f0SDaniel BorkmannKBUILD_CFLAGS	+= $(call cc-option,-fno-merge-all-constants)
824 87e0d4f0SDaniel Borkmann
825 87e0d4f0SDaniel Borkmann# for gcc -fno-merge-all-constants disables everything, but it is fine
826 87e0d4f0SDaniel Borkmann# to have actual conforming behavior enabled.
827 87e0d4f0SDaniel BorkmannKBUILD_CFLAGS	+= $(call cc-option,-fmerge-constants)
828 87e0d4f0SDaniel Borkmann
829 3ce120b1SLinus Torvalds# Make sure -fstack-check isn't enabled (like gentoo apparently did)
830 3ce120b1SLinus TorvaldsKBUILD_CFLAGS  += $(call cc-option,-fno-stack-check,)
831 3ce120b1SLinus Torvalds
832 8f7f5c9fSAndi Kleen# conserve stack if available
833 8f7f5c9fSAndi KleenKBUILD_CFLAGS   += $(call cc-option,-fconserve-stack)
834 8f7f5c9fSAndi Kleen
835 80970472SSergei Trofimovich# disallow errors like 'EXPORT_GPL(foo);' with missing header
836 80970472SSergei TrofimovichKBUILD_CFLAGS   += $(call cc-option,-Werror=implicit-int)
837 80970472SSergei Trofimovich
838 80970472SSergei Trofimovich# require functions to have arguments in prototypes, not empty 'int foo()'
839 80970472SSergei TrofimovichKBUILD_CFLAGS   += $(call cc-option,-Werror=strict-prototypes)
840 80970472SSergei Trofimovich
841 fe7c36c7SJosh Triplett# Prohibit date/time macros, which would make the build non-deterministic
842 fe7c36c7SJosh TriplettKBUILD_CFLAGS   += $(call cc-option,-Werror=date-time)
843 fe7c36c7SJosh Triplett
844 ea8daa7bSDaniel Wagner# enforce correct pointer usage
845 ea8daa7bSDaniel WagnerKBUILD_CFLAGS   += $(call cc-option,-Werror=incompatible-pointer-types)
846 ea8daa7bSDaniel Wagner
847 c834f0e8SKees Cook# Require designated initializers for all marked structures
848 c834f0e8SKees CookKBUILD_CFLAGS   += $(call cc-option,-Werror=designated-init)
849 c834f0e8SKees Cook
850 a73619a8SMasahiro Yamada# change __FILE__ to the relative path from the srctree
851 a73619a8SMasahiro YamadaKBUILD_CFLAGS	+= $(call cc-option,-fmacro-prefix-map=$(srctree)/=)
852 a73619a8SMasahiro Yamada
853 40df759eSMichal Marek# use the deterministic mode of AR if available
854 40df759eSMichal MarekKBUILD_ARFLAGS := $(call ar-option,D)
855 40df759eSMichal Marek
856 a436bb7bSMasahiro Yamadainclude scripts/Makefile.kasan
857 a436bb7bSMasahiro Yamadainclude scripts/Makefile.extrawarn
858 c6d30853SAndrey Ryabinininclude scripts/Makefile.ubsan
859 a86fe353SMasahiro Yamada
860 61754c18SMichal Marek# Add any arch overrides and user supplied CPPFLAGS, AFLAGS and CFLAGS as the
861 61754c18SMichal Marek# last assignments
862 61754c18SMichal MarekKBUILD_CPPFLAGS += $(ARCH_CPPFLAGS) $(KCPPFLAGS)
863 61754c18SMichal MarekKBUILD_AFLAGS   += $(ARCH_AFLAGS)   $(KAFLAGS)
864 61754c18SMichal MarekKBUILD_CFLAGS   += $(ARCH_CFLAGS)   $(KCFLAGS)
865 52bcc330SSam Ravnborg
866 18991197SRoland McGrath# Use --build-id when available.
867 0da4fabdSMasahiro YamadaLDFLAGS_BUILD_ID := $(call ld-option, --build-id)
868 6588169dSSam RavnborgKBUILD_LDFLAGS_MODULE += $(LDFLAGS_BUILD_ID)
869 18991197SRoland McGrathLDFLAGS_vmlinux += $(LDFLAGS_BUILD_ID)
870 18991197SRoland McGrath
871 5d7d18f5SDavid Howellsifeq ($(CONFIG_STRIP_ASM_SYMS),y)
872 d79a2719SAndi KleenLDFLAGS_vmlinux	+= $(call ld-option, -X,)
873 5d7d18f5SDavid Howellsendif
874 5d7d18f5SDavid Howells
875 14516765SLuc Van Oostenryck# insure the checker run with the right endianness
876 14516765SLuc Van OostenryckCHECKFLAGS += $(if $(CONFIG_CPU_BIG_ENDIAN),-mbig-endian,-mlittle-endian)
877 14516765SLuc Van Oostenryck
878 1f2f01b1SLuc Van Oostenryck# the checker needs the correct machine size
879 1f2f01b1SLuc Van OostenryckCHECKFLAGS += $(if $(CONFIG_64BIT),-m64,-m32)
880 1f2f01b1SLuc Van Oostenryck
881 1da177e4SLinus Torvalds# Default kernel image to build when no specific target is given.
882 1da177e4SLinus Torvalds# KBUILD_IMAGE may be overruled on the command line or
883 1da177e4SLinus Torvalds# set in the environment
884 1da177e4SLinus Torvalds# Also any assignments in arch/$(ARCH)/Makefile take precedence over
885 1da177e4SLinus Torvalds# this default value
886 1da177e4SLinus Torvaldsexport KBUILD_IMAGE ?= vmlinux
887 1da177e4SLinus Torvalds
888 1da177e4SLinus Torvalds#
889 1da177e4SLinus Torvalds# INSTALL_PATH specifies where to place the updated kernel and system map
890 1da177e4SLinus Torvalds# images. Default is /boot, but you can set it to other values
891 1da177e4SLinus Torvaldsexport	INSTALL_PATH ?= /boot
892 1da177e4SLinus Torvalds
893 1da177e4SLinus Torvalds#
894 f4d4ffc0SJason Cooper# INSTALL_DTBS_PATH specifies a prefix for relocations required by build roots.
895 f4d4ffc0SJason Cooper# Like INSTALL_MOD_PATH, it isn't defined in the Makefile, but can be passed as
896 f4d4ffc0SJason Cooper# an argument if needed. Otherwise it defaults to the kernel install path
897 f4d4ffc0SJason Cooper#
898 f4d4ffc0SJason Cooperexport INSTALL_DTBS_PATH ?= $(INSTALL_PATH)/dtbs/$(KERNELRELEASE)
899 f4d4ffc0SJason Cooper
900 f4d4ffc0SJason Cooper#
901 1da177e4SLinus Torvalds# INSTALL_MOD_PATH specifies a prefix to MODLIB for module directory
902 1da177e4SLinus Torvalds# relocations required by build roots.  This is not defined in the
903 070b98bfSSam Ravnborg# makefile but the argument can be passed to make if needed.
904 1da177e4SLinus Torvalds#
905 1da177e4SLinus Torvalds
906 df9df036SSam RavnborgMODLIB	= $(INSTALL_MOD_PATH)/lib/modules/$(KERNELRELEASE)
907 1da177e4SLinus Torvaldsexport MODLIB
908 1da177e4SLinus Torvalds
909 ac031f26STheodore Ts'o#
910 2ea03891SSam Ravnborg# INSTALL_MOD_STRIP, if defined, will cause modules to be
911 2ea03891SSam Ravnborg# stripped after they are installed.  If INSTALL_MOD_STRIP is '1', then
912 2ea03891SSam Ravnborg# the default option --strip-debug will be used.  Otherwise,
913 177b241dSGilles Espinasse# INSTALL_MOD_STRIP value will be used as the options to the strip command.
914 2ea03891SSam Ravnborg
915 ac031f26STheodore Ts'oifdef INSTALL_MOD_STRIP
916 ac031f26STheodore Ts'oifeq ($(INSTALL_MOD_STRIP),1)
917 2ea03891SSam Ravnborgmod_strip_cmd = $(STRIP) --strip-debug
918 ac031f26STheodore Ts'oelse
919 2ea03891SSam Ravnborgmod_strip_cmd = $(STRIP) $(INSTALL_MOD_STRIP)
920 ac031f26STheodore Ts'oendif # INSTALL_MOD_STRIP=1
921 ac031f26STheodore Ts'oelse
922 2ea03891SSam Ravnborgmod_strip_cmd = true
923 ac031f26STheodore Ts'oendif # INSTALL_MOD_STRIP
924 ac031f26STheodore Ts'oexport mod_strip_cmd
925 ac031f26STheodore Ts'o
926 beb50df3SBertrand Jacquin# CONFIG_MODULE_COMPRESS, if defined, will cause module to be compressed
927 beb50df3SBertrand Jacquin# after they are installed in agreement with CONFIG_MODULE_COMPRESS_GZIP
928 beb50df3SBertrand Jacquin# or CONFIG_MODULE_COMPRESS_XZ.
929 beb50df3SBertrand Jacquin
930 beb50df3SBertrand Jacquinmod_compress_cmd = true
931 beb50df3SBertrand Jacquinifdef CONFIG_MODULE_COMPRESS
932 beb50df3SBertrand Jacquin  ifdef CONFIG_MODULE_COMPRESS_GZIP
933 3d1450d5SJason A. Donenfeld    mod_compress_cmd = gzip -n -f
934 beb50df3SBertrand Jacquin  endif # CONFIG_MODULE_COMPRESS_GZIP
935 beb50df3SBertrand Jacquin  ifdef CONFIG_MODULE_COMPRESS_XZ
936 3d1450d5SJason A. Donenfeld    mod_compress_cmd = xz -f
937 beb50df3SBertrand Jacquin  endif # CONFIG_MODULE_COMPRESS_XZ
938 beb50df3SBertrand Jacquinendif # CONFIG_MODULE_COMPRESS
939 beb50df3SBertrand Jacquinexport mod_compress_cmd
940 beb50df3SBertrand Jacquin
941 1bf49dd4SP J P# Select initial ramdisk compression format, default is gzip(1).
942 1bf49dd4SP J P# This shall be used by the dracut(8) tool while creating an initramfs image.
943 1bf49dd4SP J P#
944 7ac18156SJan BeulichINITRD_COMPRESS-y                  := gzip
945 7ac18156SJan BeulichINITRD_COMPRESS-$(CONFIG_RD_BZIP2) := bzip2
946 7ac18156SJan BeulichINITRD_COMPRESS-$(CONFIG_RD_LZMA)  := lzma
947 7ac18156SJan BeulichINITRD_COMPRESS-$(CONFIG_RD_XZ)    := xz
948 7ac18156SJan BeulichINITRD_COMPRESS-$(CONFIG_RD_LZO)   := lzo
949 7ac18156SJan BeulichINITRD_COMPRESS-$(CONFIG_RD_LZ4)   := lz4
950 b7000adeSLinus Torvalds# do not export INITRD_COMPRESS, since we didn't actually
951 b7000adeSLinus Torvalds# choose a sane default compression above.
952 b7000adeSLinus Torvalds# export INITRD_COMPRESS := $(INITRD_COMPRESS-y)
953 1da177e4SLinus Torvalds
954 d9d8d7edSMichal Marekifdef CONFIG_MODULE_SIG_ALL
955 3ee550f1SDavid Woodhouse$(eval $(call config_filename,MODULE_SIG_KEY))
956 3ee550f1SDavid Woodhouse
957 3ee550f1SDavid Woodhousemod_sign_cmd = scripts/sign-file $(CONFIG_MODULE_SIG_HASH) $(MODULE_SIG_KEY_SRCPREFIX)$(CONFIG_MODULE_SIG_KEY) certs/signing_key.x509
958 e2a666d5SRusty Russellelse
959 e2a666d5SRusty Russellmod_sign_cmd = true
960 e2a666d5SRusty Russellendif
961 e2a666d5SRusty Russellexport mod_sign_cmd
962 e2a666d5SRusty Russell
963 9f0c18aeSJosh Poimboeufifdef CONFIG_STACK_VALIDATION
964 9f0c18aeSJosh Poimboeuf  has_libelf := $(call try-run,\
965 9f0c18aeSJosh Poimboeuf		echo "int main() {}" | $(HOSTCC) -xc -o /dev/null -lelf -,1,0)
966 9f0c18aeSJosh Poimboeuf  ifeq ($(has_libelf),1)
967 9f0c18aeSJosh Poimboeuf    objtool_target := tools/objtool FORCE
968 9f0c18aeSJosh Poimboeuf  else
969 11af8474SJosh Poimboeuf    ifdef CONFIG_UNWINDER_ORC
970 11af8474SJosh Poimboeuf      $(error "Cannot generate ORC metadata for CONFIG_UNWINDER_ORC=y, please install libelf-dev, libelf-devel or elfutils-libelf-devel")
971 3dd40cb3SJosh Poimboeuf    else
972 3dd40cb3SJosh Poimboeuf      $(warning "Cannot use CONFIG_STACK_VALIDATION=y, please install libelf-dev, libelf-devel or elfutils-libelf-devel")
973 3dd40cb3SJosh Poimboeuf    endif
974 9f0c18aeSJosh Poimboeuf    SKIP_STACK_VALIDATION := 1
975 9f0c18aeSJosh Poimboeuf    export SKIP_STACK_VALIDATION
976 9f0c18aeSJosh Poimboeuf  endif
977 9f0c18aeSJosh Poimboeufendif
978 9f0c18aeSJosh Poimboeuf
979 e2a666d5SRusty Russell
980 1da177e4SLinus Torvaldsifeq ($(KBUILD_EXTMOD),)
981 cfc411e7SDavid Howellscore-y		+= kernel/ certs/ mm/ fs/ ipc/ security/ crypto/ block/
982 1da177e4SLinus Torvalds
983 1da177e4SLinus Torvaldsvmlinux-dirs	:= $(patsubst %/,%,$(filter %/, $(init-y) $(init-m) \
984 1da177e4SLinus Torvalds		     $(core-y) $(core-m) $(drivers-y) $(drivers-m) \
985 37d9fe47SFeng Wu		     $(net-y) $(net-m) $(libs-y) $(libs-m) $(virt-y)))
986 1da177e4SLinus Torvalds
987 1da177e4SLinus Torvaldsvmlinux-alldirs	:= $(sort $(vmlinux-dirs) $(patsubst %/,%,$(filter %/, \
988 37d9fe47SFeng Wu		     $(init-) $(core-) $(drivers-) $(net-) $(libs-) $(virt-))))
989 1da177e4SLinus Torvalds
990 f49821eeSNicholas Piggininit-y		:= $(patsubst %/, %/built-in.a, $(init-y))
991 f49821eeSNicholas Piggincore-y		:= $(patsubst %/, %/built-in.a, $(core-y))
992 f49821eeSNicholas Piggindrivers-y	:= $(patsubst %/, %/built-in.a, $(drivers-y))
993 f49821eeSNicholas Pigginnet-y		:= $(patsubst %/, %/built-in.a, $(net-y))
994 1da177e4SLinus Torvaldslibs-y1		:= $(patsubst %/, %/lib.a, $(libs-y))
995 f49821eeSNicholas Pigginlibs-y2		:= $(patsubst %/, %/built-in.a, $(filter-out %.a, $(libs-y)))
996 f49821eeSNicholas Pigginvirt-y		:= $(patsubst %/, %/built-in.a, $(virt-y))
997 1da177e4SLinus Torvalds
998 1f2bfbd0SSam Ravnborg# Externally visible symbols (used by link-vmlinux.sh)
999 95698570SSam Ravnborgexport KBUILD_VMLINUX_INIT := $(head-y) $(init-y)
1000 3a166fc2SNicholas Pigginexport KBUILD_VMLINUX_MAIN := $(core-y) $(libs-y2) $(drivers-y) $(net-y) $(virt-y)
1001 3a166fc2SNicholas Pigginexport KBUILD_VMLINUX_LIBS := $(libs-y1)
1002 95698570SSam Ravnborgexport KBUILD_LDS          := arch/$(SRCARCH)/kernel/vmlinux.lds
1003 1f2bfbd0SSam Ravnborgexport LDFLAGS_vmlinux
1004 312a3d09SCao jin# used by scripts/package/Makefile
1005 37d9fe47SFeng Wuexport KBUILD_ALLDIRS := $(sort $(filter-out arch/%,$(vmlinux-alldirs)) arch Documentation include samples scripts tools)
1006 1da177e4SLinus Torvalds
1007 3a166fc2SNicholas Pigginvmlinux-deps := $(KBUILD_LDS) $(KBUILD_VMLINUX_INIT) $(KBUILD_VMLINUX_MAIN) $(KBUILD_VMLINUX_LIBS)
1008 1da177e4SLinus Torvalds
1009 3fdc7d3fSMasahiro Yamada# Recurse until adjust_autoksyms.sh is satisfied
1010 3fdc7d3fSMasahiro YamadaPHONY += autoksyms_recursive
1011 3fdc7d3fSMasahiro Yamadaautoksyms_recursive: $(vmlinux-deps)
1012 2441e78bSNicolas Pitreifdef CONFIG_TRIM_UNUSED_KSYMS
1013 ba79d401SNicolas Ferre	$(Q)$(CONFIG_SHELL) $(srctree)/scripts/adjust_autoksyms.sh \
1014 86556392SNicolas Pitre	  "$(MAKE) -f $(srctree)/Makefile vmlinux"
1015 2441e78bSNicolas Pitreendif
1016 23121ca2SNicolas Pitre
1017 1f50b80aSMasahiro Yamada# For the kernel to actually contain only the needed exported symbols,
1018 1f50b80aSMasahiro Yamada# we have to build modules as well to determine what those symbols are.
1019 1f50b80aSMasahiro Yamada# (this can be evaluated only once include/config/auto.conf has been included)
1020 1f50b80aSMasahiro Yamadaifdef CONFIG_TRIM_UNUSED_KSYMS
1021 1f50b80aSMasahiro Yamada  KBUILD_MODULES := 1
1022 1f50b80aSMasahiro Yamadaendif
1023 1f50b80aSMasahiro Yamada
1024 07a422bbSMasahiro Yamadaautoksyms_h := $(if $(CONFIG_TRIM_UNUSED_KSYMS), include/generated/autoksyms.h)
1025 07a422bbSMasahiro Yamada
1026 07a422bbSMasahiro Yamada$(autoksyms_h):
1027 07a422bbSMasahiro Yamada	$(Q)mkdir -p $(dir $@)
1028 07a422bbSMasahiro Yamada	$(Q)touch $@
1029 23121ca2SNicolas Pitre
1030 fbe6e37dSNicholas PigginARCH_POSTLINK := $(wildcard $(srctree)/arch/$(SRCARCH)/Makefile.postlink)
1031 fbe6e37dSNicholas Piggin
1032 fbe6e37dSNicholas Piggin# Final link of vmlinux with optional arch pass after final link
1033 fbe6e37dSNicholas Piggincmd_link-vmlinux =                                                 \
1034 d503ac53SMasahiro Yamada	$(CONFIG_SHELL) $< $(LD) $(KBUILD_LDFLAGS) $(LDFLAGS_vmlinux) ;    \
1035 fbe6e37dSNicholas Piggin	$(if $(ARCH_POSTLINK), $(MAKE) -f $(ARCH_POSTLINK) $@, true)
1036 2441e78bSNicolas Pitre
1037 3fdc7d3fSMasahiro Yamadavmlinux: scripts/link-vmlinux.sh autoksyms_recursive $(vmlinux-deps) FORCE
1038 3fdc7d3fSMasahiro Yamadaifdef CONFIG_HEADERS_CHECK
1039 3fdc7d3fSMasahiro Yamada	$(Q)$(MAKE) -f $(srctree)/Makefile headers_check
1040 3fdc7d3fSMasahiro Yamadaendif
1041 3fdc7d3fSMasahiro Yamadaifdef CONFIG_GDB_SCRIPTS
1042 3fdc7d3fSMasahiro Yamada	$(Q)ln -fsn $(abspath $(srctree)/scripts/gdb/vmlinux-gdb.py)
1043 3fdc7d3fSMasahiro Yamadaendif
1044 1f2bfbd0SSam Ravnborg	+$(call if_changed,link-vmlinux)
1045 741f98feSSam Ravnborg
1046 3fca1700SMasahiro Yamada# Build samples along the rest of the kernel. This needs headers_install.
1047 dd92478aSNicolas Pitreifdef CONFIG_SAMPLES
1048 dd92478aSNicolas Pitrevmlinux-dirs += samples
1049 3fca1700SMasahiro Yamadasamples: headers_install
1050 dd92478aSNicolas Pitreendif
1051 dd92478aSNicolas Pitre
1052 1da177e4SLinus Torvalds# The actual objects are generated when descending,
1053 1da177e4SLinus Torvalds# make sure no implicit rule kicks in
1054 1f2bfbd0SSam Ravnborg$(sort $(vmlinux-deps)): $(vmlinux-dirs) ;
1055 1da177e4SLinus Torvalds
1056 1da177e4SLinus Torvalds# Handle descending into subdirectories listed in $(vmlinux-dirs)
1057 1da177e4SLinus Torvalds# Preset locale variables to speed up the build process. Limit locale
1058 1da177e4SLinus Torvalds# tweaks to this spot to avoid wrong language settings when running
1059 1da177e4SLinus Torvalds# make menuconfig etc.
1060 1da177e4SLinus Torvalds# Error messages still appears in the original language
1061 1da177e4SLinus Torvalds
1062 4f193362SPaul SmithPHONY += $(vmlinux-dirs)
1063 5bb78269SSam Ravnborg$(vmlinux-dirs): prepare scripts
1064 f7adc312SMasahiro Yamada	$(Q)$(MAKE) $(build)=$@ need-builtin=1
1065 1da177e4SLinus Torvalds
1066 0d0e7718SMichal Marekdefine filechk_kernel.release
1067 0d0e7718SMichal Marek	echo "$(KERNELVERSION)$$($(CONFIG_SHELL) $(srctree)/scripts/setlocalversion $(srctree))"
1068 0d0e7718SMichal Marekendef
1069 0d0e7718SMichal Marek
1070 83a35e36SGeert Uytterhoeven# Store (new) KERNELRELEASE string in include/config/kernel.release
1071 2063945fSMasahiro Yamadainclude/config/kernel.release: $(srctree)/Makefile FORCE
1072 0d0e7718SMichal Marek	$(call filechk,kernel.release)
1073 cb58455cSSam Ravnborg
1074 d8821622SMasahiro Yamada# Additional helpers built in scripts/
1075 d8821622SMasahiro Yamada# Carefully list dependencies so we do not try to build scripts twice
1076 d8821622SMasahiro Yamada# in parallel
1077 d8821622SMasahiro YamadaPHONY += scripts
1078 37c8a5faSRob Herringscripts: scripts_basic scripts_dtc asm-generic gcc-plugins $(autoksyms_h)
1079 d8821622SMasahiro Yamada	$(Q)$(MAKE) $(build)=$(@)
1080 cb58455cSSam Ravnborg
1081 1da177e4SLinus Torvalds# Things we need to do before we recursively start building the kernel
1082 5bb78269SSam Ravnborg# or the modules are listed in "prepare".
1083 5bb78269SSam Ravnborg# A multi level approach is used. prepareN is processed before prepareN-1.
1084 5bb78269SSam Ravnborg# archprepare is used in arch Makefiles and when processed asm symlink,
1085 5bb78269SSam Ravnborg# version.h and scripts_basic is processed / created.
1086 1da177e4SLinus Torvalds
1087 5bb78269SSam Ravnborg# Listed in dependency order
1088 77b0bf55SNadav AmitPHONY += prepare archprepare macroprepare prepare0 prepare1 prepare2 prepare3
1089 5bb78269SSam Ravnborg
1090 86feeaa8SSam Ravnborg# prepare3 is used to check if we are building in a separate output directory,
1091 1da177e4SLinus Torvalds# and if so do:
1092 1da177e4SLinus Torvalds# 1) Check that make has not been executed in the kernel src $(srctree)
1093 f1d28fb0SRoman Zippelprepare3: include/config/kernel.release
1094 1da177e4SLinus Torvaldsifneq ($(KBUILD_SRC),)
1095 fd54f502SMike Frysinger	@$(kecho) '  Using $(srctree) as source for kernel'
1096 c955ccafSRoman Zippel	$(Q)if [ -f $(srctree)/.config -o -d $(srctree)/include/config ]; then \
1097 5369f550SMichal Marek		echo >&2 "  $(srctree) is not clean, please run 'make mrproper'"; \
1098 5369f550SMichal Marek		echo >&2 "  in the '$(srctree)' directory.";\
1099 1da177e4SLinus Torvalds		/bin/false; \
1100 1da177e4SLinus Torvalds	fi;
1101 1da177e4SLinus Torvaldsendif
1102 1da177e4SLinus Torvalds
1103 c965b105SKees Cook# prepare2 creates a makefile if using a separate output directory.
1104 c965b105SKees Cook# From this point forward, .config has been reprocessed, so any rules
1105 c965b105SKees Cook# that need to depend on updated CONFIG_* values can be checked here.
1106 2a61f474SMasahiro Yamadaprepare2: prepare3 outputmakefile asm-generic
1107 1da177e4SLinus Torvalds
1108 2063945fSMasahiro Yamadaprepare1: prepare2 $(version_h) $(autoksyms_h) include/generated/utsrelease.h
1109 7bb9d092SSam Ravnborg	$(cmd_crmodverdir)
1110 1da177e4SLinus Torvalds
1111 77b0bf55SNadav Amitmacroprepare: prepare1 archmacros
1112 77b0bf55SNadav Amit
1113 77b0bf55SNadav Amitarchprepare: archheaders archscripts macroprepare scripts_basic
1114 5bb78269SSam Ravnborg
1115 6b90bd4bSEmese Revfyprepare0: archprepare gcc-plugins
1116 8d36a623SSam Ravnborg	$(Q)$(MAKE) $(build)=.
1117 86feeaa8SSam Ravnborg
1118 1da177e4SLinus Torvalds# All the preparing..
1119 b9ab5ebbSJosh Poimboeufprepare: prepare0 prepare-objtool
1120 b9ab5ebbSJosh Poimboeuf
1121 2c1f4f12SMasahiro Yamada# Support for using generic headers in asm-generic
1122 2c1f4f12SMasahiro YamadaPHONY += asm-generic uapi-asm-generic
1123 2c1f4f12SMasahiro Yamadaasm-generic: uapi-asm-generic
1124 2c1f4f12SMasahiro Yamada	$(Q)$(MAKE) -f $(srctree)/scripts/Makefile.asm-generic \
1125 2c1f4f12SMasahiro Yamada	            src=asm obj=arch/$(SRCARCH)/include/generated/asm
1126 2c1f4f12SMasahiro Yamadauapi-asm-generic:
1127 2c1f4f12SMasahiro Yamada	$(Q)$(MAKE) -f $(srctree)/scripts/Makefile.asm-generic \
1128 2c1f4f12SMasahiro Yamada	            src=uapi/asm obj=arch/$(SRCARCH)/include/generated/uapi/asm
1129 2c1f4f12SMasahiro Yamada
1130 b9ab5ebbSJosh PoimboeufPHONY += prepare-objtool
1131 3b27a0c8SJosh Poimboeufprepare-objtool: $(objtool_target)
1132 1da177e4SLinus Torvalds
1133 1da177e4SLinus Torvalds# Generate some files
1134 1da177e4SLinus Torvalds# ---------------------------------------------------------------------------
1135 1da177e4SLinus Torvalds
1136 1da177e4SLinus Torvalds# KERNELRELEASE can change from a few different places, meaning version.h
1137 1da177e4SLinus Torvalds# needs to be updated, so this check is forced on all builds
1138 1da177e4SLinus Torvalds
1139 1da177e4SLinus Torvaldsuts_len := 64
1140 63104eecSSam Ravnborgdefine filechk_utsrelease.h
1141 1da177e4SLinus Torvalds	if [ `echo -n "$(KERNELRELEASE)" | wc -c ` -gt $(uts_len) ]; then \
1142 1da177e4SLinus Torvalds	  echo '"$(KERNELRELEASE)" exceeds $(uts_len) characters' >&2;    \
1143 1da177e4SLinus Torvalds	  exit 1;                                                         \
1144 1da177e4SLinus Torvalds	fi;                                                               \
1145 63104eecSSam Ravnborg	(echo \#define UTS_RELEASE \"$(KERNELRELEASE)\";)
1146 1da177e4SLinus Torvaldsendef
1147 1da177e4SLinus Torvalds
1148 63104eecSSam Ravnborgdefine filechk_version.h
1149 63104eecSSam Ravnborg	(echo \#define LINUX_VERSION_CODE $(shell                         \
1150 78d3bb44SMichal Marek	expr $(VERSION) \* 65536 + 0$(PATCHLEVEL) \* 256 + 0$(SUBLEVEL)); \
1151 63104eecSSam Ravnborg	echo '#define KERNEL_VERSION(a,b,c) (((a) << 16) + ((b) << 8) + (c))';)
1152 63104eecSSam Ravnborgendef
1153 63104eecSSam Ravnborg
1154 43fee2b2SMasahiro Yamada$(version_h): FORCE
1155 1da177e4SLinus Torvalds	$(call filechk,version.h)
1156 223c24a7SMichal Marek	$(Q)rm -f $(old_version_h)
1157 1da177e4SLinus Torvalds
1158 273b281fSSam Ravnborginclude/generated/utsrelease.h: include/config/kernel.release FORCE
1159 63104eecSSam Ravnborg	$(call filechk,utsrelease.h)
1160 63104eecSSam Ravnborg
1161 179efcb4SVegard NossumPHONY += headerdep
1162 179efcb4SVegard Nossumheaderdep:
1163 9663d989SPeter Foley	$(Q)find $(srctree)/include/ -name '*.h' | xargs --max-args 1 \
1164 9663d989SPeter Foley	$(srctree)/scripts/headerdep.pl -I$(srctree)/include
1165 179efcb4SVegard Nossum
1166 1da177e4SLinus Torvalds# ---------------------------------------------------------------------------
1167 8d730cfbSDavid Woodhouse# Kernel headers
1168 8d730cfbSDavid Woodhouse
1169 e6883b18SSam Ravnborg#Default location for installed headers
1170 e6883b18SSam Ravnborgexport INSTALL_HDR_PATH = $(objtree)/usr
1171 e6883b18SSam Ravnborg
1172 9d022c54SMasahiro Yamada# If we do an all arch process set dst to include/arch-$(SRCARCH)
1173 9d022c54SMasahiro Yamadahdr-dst = $(if $(KBUILD_HEADERS), dst=include/arch-$(SRCARCH), dst=include)
1174 e6883b18SSam Ravnborg
1175 052ad274SH. Peter AnvinPHONY += archheaders
1176 052ad274SH. Peter Anvinarchheaders:
1177 052ad274SH. Peter Anvin
1178 6520fe55SH. Peter AnvinPHONY += archscripts
1179 6520fe55SH. Peter Anvinarchscripts:
1180 6520fe55SH. Peter Anvin
1181 77b0bf55SNadav AmitPHONY += archmacros
1182 77b0bf55SNadav Amitarchmacros:
1183 77b0bf55SNadav Amit
1184 e6883b18SSam RavnborgPHONY += __headers
1185 a9d9a400SMasahiro Yamada__headers: $(version_h) scripts_basic uapi-asm-generic archheaders archscripts
1186 e1b702cfSMike Waychison	$(Q)$(MAKE) $(build)=scripts build_unifdef
1187 6d716275SDavid Woodhouse
1188 6d716275SDavid WoodhousePHONY += headers_install_all
1189 2fb9b1bdSSam Ravnborgheaders_install_all:
1190 2fb9b1bdSSam Ravnborg	$(Q)$(CONFIG_SHELL) $(srctree)/scripts/headers.sh install
1191 6d716275SDavid Woodhouse
1192 8d730cfbSDavid WoodhousePHONY += headers_install
1193 e6883b18SSam Ravnborgheaders_install: __headers
1194 9d022c54SMasahiro Yamada	$(if $(wildcard $(srctree)/arch/$(SRCARCH)/include/uapi/asm/Kbuild),, \
1195 2fb9b1bdSSam Ravnborg	  $(error Headers not exportable for the $(SRCARCH) architecture))
1196 a8ff49a1SMasahiro Yamada	$(Q)$(MAKE) $(hdr-inst)=include/uapi dst=include
1197 9d022c54SMasahiro Yamada	$(Q)$(MAKE) $(hdr-inst)=arch/$(SRCARCH)/include/uapi $(hdr-dst)
1198 8d730cfbSDavid Woodhouse
1199 1f85712eSMike FrysingerPHONY += headers_check_all
1200 1f85712eSMike Frysingerheaders_check_all: headers_install_all
1201 2fb9b1bdSSam Ravnborg	$(Q)$(CONFIG_SHELL) $(srctree)/scripts/headers.sh check
1202 1f85712eSMike Frysinger
1203 68475359SDavid WoodhousePHONY += headers_check
1204 68475359SDavid Woodhouseheaders_check: headers_install
1205 a8ff49a1SMasahiro Yamada	$(Q)$(MAKE) $(hdr-inst)=include/uapi dst=include HDRCHECK=1
1206 9d022c54SMasahiro Yamada	$(Q)$(MAKE) $(hdr-inst)=arch/$(SRCARCH)/include/uapi $(hdr-dst) HDRCHECK=1
1207 68475359SDavid Woodhouse
1208 8d730cfbSDavid Woodhouse# ---------------------------------------------------------------------------
1209 5a5da78bSShuah Khan# Kernel selftest
1210 5a5da78bSShuah Khan
1211 5a5da78bSShuah KhanPHONY += kselftest
1212 5a5da78bSShuah Khankselftest:
1213 2bc84526SShuah Khan	$(Q)$(MAKE) -C $(srctree)/tools/testing/selftests run_tests
1214 5a5da78bSShuah Khan
1215 801d2e9fSShuah KhanPHONY += kselftest-clean
1216 dcb825a9SWang Longkselftest-clean:
1217 2bc84526SShuah Khan	$(Q)$(MAKE) -C $(srctree)/tools/testing/selftests clean
1218 dcb825a9SWang Long
1219 3d6dee7aSBamvor Jian ZhangPHONY += kselftest-merge
1220 3d6dee7aSBamvor Jian Zhangkselftest-merge:
1221 3d6dee7aSBamvor Jian Zhang	$(if $(wildcard $(objtree)/.config),, $(error No .config exists, config your kernel first!))
1222 3d6dee7aSBamvor Jian Zhang	$(Q)$(CONFIG_SHELL) $(srctree)/scripts/kconfig/merge_config.sh \
1223 3d6dee7aSBamvor Jian Zhang		-m $(objtree)/.config \
1224 3d6dee7aSBamvor Jian Zhang		$(srctree)/tools/testing/selftests/*/config
1225 3d6dee7aSBamvor Jian Zhang	+$(Q)$(MAKE) -f $(srctree)/Makefile olddefconfig
1226 3d6dee7aSBamvor Jian Zhang
1227 5a5da78bSShuah Khan# ---------------------------------------------------------------------------
1228 37c8a5faSRob Herring# Devicetree files
1229 37c8a5faSRob Herring
1230 37c8a5faSRob Herringifneq ($(wildcard $(srctree)/arch/$(SRCARCH)/boot/dts/),)
1231 37c8a5faSRob Herringdtstree := arch/$(SRCARCH)/boot/dts
1232 37c8a5faSRob Herringendif
1233 37c8a5faSRob Herring
1234 37c8a5faSRob Herringifneq ($(dtstree),)
1235 37c8a5faSRob Herring
1236 37c8a5faSRob Herring%.dtb: prepare3 scripts_dtc
1237 37c8a5faSRob Herring	$(Q)$(MAKE) $(build)=$(dtstree) $(dtstree)/$@
1238 37c8a5faSRob Herring
1239 37c8a5faSRob HerringPHONY += dtbs dtbs_install
1240 37c8a5faSRob Herringdtbs: prepare3 scripts_dtc
1241 37c8a5faSRob Herring	$(Q)$(MAKE) $(build)=$(dtstree)
1242 37c8a5faSRob Herring
1243 37c8a5faSRob Herringdtbs_install:
1244 37c8a5faSRob Herring	$(Q)$(MAKE) $(dtbinst)=$(dtstree)
1245 37c8a5faSRob Herring
1246 37c8a5faSRob Herringifdef CONFIG_OF_EARLY_FLATTREE
1247 37c8a5faSRob Herringall: dtbs
1248 37c8a5faSRob Herringendif
1249 37c8a5faSRob Herring
1250 37c8a5faSRob Herringendif
1251 37c8a5faSRob Herring
1252 37c8a5faSRob HerringPHONY += scripts_dtc
1253 37c8a5faSRob Herringscripts_dtc: scripts_basic
1254 37c8a5faSRob Herring	$(Q)$(MAKE) $(build)=scripts/dtc
1255 37c8a5faSRob Herring
1256 37c8a5faSRob Herring# ---------------------------------------------------------------------------
1257 1da177e4SLinus Torvalds# Modules
1258 1da177e4SLinus Torvalds
1259 1da177e4SLinus Torvaldsifdef CONFIG_MODULES
1260 1da177e4SLinus Torvalds
1261 1da177e4SLinus Torvalds# By default, build modules as well
1262 1da177e4SLinus Torvalds
1263 73d1393eSMichal Marekall: modules
1264 1da177e4SLinus Torvalds
1265 1da177e4SLinus Torvalds# Build modules
1266 551559e1STejun Heo#
1267 551559e1STejun Heo# A module can be listed more than once in obj-m resulting in
1268 551559e1STejun Heo# duplicate lines in modules.order files.  Those are removed
1269 551559e1STejun Heo# using awk while concatenating to the final file.
1270 1da177e4SLinus Torvalds
1271 4f193362SPaul SmithPHONY += modules
1272 2da30e70SMichal Marekmodules: $(vmlinux-dirs) $(if $(KBUILD_BUILTIN),vmlinux) modules.builtin
1273 551559e1STejun Heo	$(Q)$(AWK) '!x[$$0]++' $(vmlinux-dirs:%=$(objtree)/%/modules.order) > $(objtree)/modules.order
1274 fd54f502SMike Frysinger	@$(kecho) '  Building modules, stage 2.';
1275 b805aa0eSSam Ravnborg	$(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modpost
1276 1da177e4SLinus Torvalds
1277 a6c36632SMichal Marekmodules.builtin: $(vmlinux-dirs:%=%/modules.builtin)
1278 a6c36632SMichal Marek	$(Q)$(AWK) '!x[$$0]++' $^ > $(objtree)/modules.builtin
1279 a6c36632SMichal Marek
1280 2063945fSMasahiro Yamada%/modules.builtin: include/config/auto.conf include/config/tristate.conf
1281 a6c36632SMichal Marek	$(Q)$(MAKE) $(modbuiltin)=$*
1282 a6c36632SMichal Marek
1283 1da177e4SLinus Torvalds
1284 1da177e4SLinus Torvalds# Target to prepare building external modules
1285 4f193362SPaul SmithPHONY += modules_prepare
1286 5bb78269SSam Ravnborgmodules_prepare: prepare scripts
1287 1da177e4SLinus Torvalds
1288 1da177e4SLinus Torvalds# Target to install modules
1289 4f193362SPaul SmithPHONY += modules_install
1290 1da177e4SLinus Torvaldsmodules_install: _modinst_ _modinst_post
1291 1da177e4SLinus Torvalds
1292 4f193362SPaul SmithPHONY += _modinst_
1293 2da30e70SMichal Marek_modinst_:
1294 1da177e4SLinus Torvalds	@rm -rf $(MODLIB)/kernel
1295 1da177e4SLinus Torvalds	@rm -f $(MODLIB)/source
1296 1da177e4SLinus Torvalds	@mkdir -p $(MODLIB)/kernel
1297 8e9b4667SMasahiro Yamada	@ln -s $(abspath $(srctree)) $(MODLIB)/source
1298 1da177e4SLinus Torvalds	@if [ ! $(objtree) -ef  $(MODLIB)/build ]; then \
1299 1da177e4SLinus Torvalds		rm -f $(MODLIB)/build ; \
1300 7e1c0477SMichal Marek		ln -s $(CURDIR) $(MODLIB)/build ; \
1301 1da177e4SLinus Torvalds	fi
1302 551559e1STejun Heo	@cp -f $(objtree)/modules.order $(MODLIB)/
1303 bc081dd6SMichal Marek	@cp -f $(objtree)/modules.builtin $(MODLIB)/
1304 b805aa0eSSam Ravnborg	$(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modinst
1305 1da177e4SLinus Torvalds
1306 50a8ec31SSam Ravnborg# This depmod is only for convenience to give the initial
1307 1da177e4SLinus Torvalds# boot a modules.dep even before / is mounted read-write.  However the
1308 1da177e4SLinus Torvalds# boot script depmod is the master version.
1309 4f193362SPaul SmithPHONY += _modinst_post
1310 6d128e1eSLinus Torvalds_modinst_post: _modinst_
1311 50a8ec31SSam Ravnborg	$(call cmd,depmod)
1312 1da177e4SLinus Torvalds
1313 d890f510SJosh Boyerifeq ($(CONFIG_MODULE_SIG), y)
1314 d890f510SJosh BoyerPHONY += modules_sign
1315 d890f510SJosh Boyermodules_sign:
1316 d890f510SJosh Boyer	$(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modsign
1317 d890f510SJosh Boyerendif
1318 d890f510SJosh Boyer
1319 1da177e4SLinus Torvaldselse # CONFIG_MODULES
1320 1da177e4SLinus Torvalds
1321 1da177e4SLinus Torvalds# Modules not configured
1322 1da177e4SLinus Torvalds# ---------------------------------------------------------------------------
1323 1da177e4SLinus Torvalds
1324 612e47ceSMasahiro YamadaPHONY += modules modules_install
1325 612e47ceSMasahiro Yamadamodules modules_install:
1326 5369f550SMichal Marek	@echo >&2
1327 5369f550SMichal Marek	@echo >&2 "The present kernel configuration has modules disabled."
1328 5369f550SMichal Marek	@echo >&2 "Type 'make config' and enable loadable module support."
1329 5369f550SMichal Marek	@echo >&2 "Then build a kernel with module support enabled."
1330 5369f550SMichal Marek	@echo >&2
1331 1da177e4SLinus Torvalds	@exit 1
1332 1da177e4SLinus Torvalds
1333 1da177e4SLinus Torvaldsendif # CONFIG_MODULES
1334 1da177e4SLinus Torvalds
1335 1da177e4SLinus Torvalds###
1336 1da177e4SLinus Torvalds# Cleaning is done on three levels.
1337 1da177e4SLinus Torvalds# make clean     Delete most generated files
1338 1da177e4SLinus Torvalds#                Leave enough to build external modules
1339 1da177e4SLinus Torvalds# make mrproper  Delete the current configuration, and all generated files
1340 1da177e4SLinus Torvalds# make distclean Remove editor backup files, patch leftover files and the like
1341 1da177e4SLinus Torvalds
1342 1da177e4SLinus Torvalds# Directories & files removed with 'make clean'
1343 fbfa9be9SMasahiro YamadaCLEAN_DIRS  += $(MODVERDIR) include/ksym
1344 1da177e4SLinus Torvalds
1345 1da177e4SLinus Torvalds# Directories & files removed with 'make mrproper'
1346 d8ecc5cdSSam RavnborgMRPROPER_DIRS  += include/config usr/include include/generated          \
1347 79192ca8SJason Cooper		  arch/*/include/generated .tmp_objdiff
1348 278ae604SMasahiro YamadaMRPROPER_FILES += .config .config.old .version \
1349 d5b71936SRusty Russell		  Module.symvers tags TAGS cscope* GPATH GTAGS GRTAGS GSYMS \
1350 fb117949SDavid Woodhouse		  signing_key.pem signing_key.priv signing_key.x509	\
1351 fb117949SDavid Woodhouse		  x509.genkey extra_certificates signing_key.x509.keyid	\
1352 3ee7b3faSJan Kiszka		  signing_key.x509.signer vmlinux-gdb.py
1353 1da177e4SLinus Torvalds
1354 1da177e4SLinus Torvalds# clean - Delete most, but leave enough to build external modules
1355 1da177e4SLinus Torvalds#
1356 1da177e4SLinus Torvaldsclean: rm-dirs  := $(CLEAN_DIRS)
1357 1da177e4SLinus Torvaldsclean: rm-files := $(CLEAN_FILES)
1358 fb68d4beSGerard Snitselaarclean-dirs      := $(addprefix _clean_, . $(vmlinux-alldirs) Documentation samples)
1359 1da177e4SLinus Torvalds
1360 bd1ee804SPawel MollPHONY += $(clean-dirs) clean archclean vmlinuxclean
1361 1da177e4SLinus Torvalds$(clean-dirs):
1362 1da177e4SLinus Torvalds	$(Q)$(MAKE) $(clean)=$(patsubst _clean_%,%,$@)
1363 1da177e4SLinus Torvalds
1364 bd1ee804SPawel Mollvmlinuxclean:
1365 bd1ee804SPawel Moll	$(Q)$(CONFIG_SHELL) $(srctree)/scripts/link-vmlinux.sh clean
1366 fbe6e37dSNicholas Piggin	$(Q)$(if $(ARCH_POSTLINK), $(MAKE) -f $(ARCH_POSTLINK) clean)
1367 bd1ee804SPawel Moll
1368 bd1ee804SPawel Mollclean: archclean vmlinuxclean
1369 1da177e4SLinus Torvalds
1370 1da177e4SLinus Torvalds# mrproper - Delete all generated files, including .config
1371 1da177e4SLinus Torvalds#
1372 1da177e4SLinus Torvaldsmrproper: rm-dirs  := $(wildcard $(MRPROPER_DIRS))
1373 1da177e4SLinus Torvaldsmrproper: rm-files := $(wildcard $(MRPROPER_FILES))
1374 cb43fb57SMauro Carvalho Chehabmrproper-dirs      := $(addprefix _mrproper_,scripts)
1375 1da177e4SLinus Torvalds
1376 4f193362SPaul SmithPHONY += $(mrproper-dirs) mrproper archmrproper
1377 1da177e4SLinus Torvalds$(mrproper-dirs):
1378 1da177e4SLinus Torvalds	$(Q)$(MAKE) $(clean)=$(patsubst _mrproper_%,%,$@)
1379 1da177e4SLinus Torvalds
1380 1da177e4SLinus Torvaldsmrproper: clean archmrproper $(mrproper-dirs)
1381 1da177e4SLinus Torvalds	$(call cmd,rmdirs)
1382 1da177e4SLinus Torvalds	$(call cmd,rmfiles)
1383 1da177e4SLinus Torvalds
1384 1da177e4SLinus Torvalds# distclean
1385 1da177e4SLinus Torvalds#
1386 4f193362SPaul SmithPHONY += distclean
1387 1da177e4SLinus Torvalds
1388 1da177e4SLinus Torvaldsdistclean: mrproper
1389 1da177e4SLinus Torvalds	@find $(srctree) $(RCS_FIND_IGNORE) \
1390 1da177e4SLinus Torvalds		\( -name '*.orig' -o -name '*.rej' -o -name '*~' \
1391 f78271dfSMasahiro Yamada		-o -name '*.bak' -o -name '#*#' -o -name '*%' \
1392 f78271dfSMasahiro Yamada		-o -name 'core' \) \
1393 1da177e4SLinus Torvalds		-type f -print | xargs rm -f
1394 1da177e4SLinus Torvalds
1395 1da177e4SLinus Torvalds
1396 1da177e4SLinus Torvalds# Packaging of the kernel to various formats
1397 1da177e4SLinus Torvalds# ---------------------------------------------------------------------------
1398 c79624c1SMichal Marekpackage-dir	:= scripts/package
1399 1da177e4SLinus Torvalds
1400 bafb6747SArnaldo Carvalho de Melo%src-pkg: FORCE
1401 bafb6747SArnaldo Carvalho de Melo	$(Q)$(MAKE) $(build)=$(package-dir) $@
1402 031ecc6dSZach Brown%pkg: include/config/kernel.release FORCE
1403 6c2133e1SSam Ravnborg	$(Q)$(MAKE) $(build)=$(package-dir) $@
1404 1da177e4SLinus Torvalds
1405 1da177e4SLinus Torvalds
1406 1da177e4SLinus Torvalds# Brief documentation of the typical targets used
1407 1da177e4SLinus Torvalds# ---------------------------------------------------------------------------
1408 1da177e4SLinus Torvalds
1409 5dffbe81SSegher Boessenkoolboards := $(wildcard $(srctree)/arch/$(SRCARCH)/configs/*_defconfig)
1410 a1e7b7bbSKonstantin Khlebnikovboards := $(sort $(notdir $(boards)))
1411 5dffbe81SSegher Boessenkoolboard-dirs := $(dir $(wildcard $(srctree)/arch/$(SRCARCH)/configs/*/*_defconfig))
1412 5dffbe81SSegher Boessenkoolboard-dirs := $(sort $(notdir $(board-dirs:/=)))
1413 1da177e4SLinus Torvalds
1414 fe69b420SMasahiro YamadaPHONY += help
1415 1da177e4SLinus Torvaldshelp:
1416 1da177e4SLinus Torvalds	@echo  'Cleaning targets:'
1417 5ea084efSSamuel Tardieu	@echo  '  clean		  - Remove most generated files but keep the config and'
1418 5cc8d246SJesper Juhl	@echo  '                    enough build support to build external modules'
1419 5ea084efSSamuel Tardieu	@echo  '  mrproper	  - Remove all generated files + config + various backup files'
1420 5cc8d246SJesper Juhl	@echo  '  distclean	  - mrproper + remove editor backup and patch files'
1421 1da177e4SLinus Torvalds	@echo  ''
1422 1da177e4SLinus Torvalds	@echo  'Configuration targets:'
1423 1da177e4SLinus Torvalds	@$(MAKE) -f $(srctree)/scripts/kconfig/Makefile help
1424 1da177e4SLinus Torvalds	@echo  ''
1425 1da177e4SLinus Torvalds	@echo  'Other generic targets:'
1426 1da177e4SLinus Torvalds	@echo  '  all		  - Build all targets marked with [*]'
1427 1da177e4SLinus Torvalds	@echo  '* vmlinux	  - Build the bare kernel'
1428 1da177e4SLinus Torvalds	@echo  '* modules	  - Build all modules'
1429 9cc5d74cSBodo Eggert	@echo  '  modules_install - Install all modules to INSTALL_MOD_PATH (default: /)'
1430 1da177e4SLinus Torvalds	@echo  '  dir/            - Build all files in dir and below'
1431 40ab87a4SWang YanQing	@echo  '  dir/file.[ois]  - Build specified target only'
1432 433db3e2SVinícius Tinti	@echo  '  dir/file.ll     - Build the LLVM assembly file'
1433 433db3e2SVinícius Tinti	@echo  '                    (requires compiler support for LLVM assembly generation)'
1434 62718979SJoe Perches	@echo  '  dir/file.lst    - Build specified mixed source/assembly target only'
1435 62718979SJoe Perches	@echo  '                    (requires a recent binutils and recent build (System.map))'
1436 155ad605SSam Ravnborg	@echo  '  dir/file.ko     - Build module including final link'
1437 c4d5ee67SRobert P. J. Day	@echo  '  modules_prepare - Set up for building external modules'
1438 1da177e4SLinus Torvalds	@echo  '  tags/TAGS	  - Generate tags file for editors'
1439 1da177e4SLinus Torvalds	@echo  '  cscope	  - Generate cscope index'
1440 f4ed1009SJianbin Kang	@echo  '  gtags           - Generate GNU GLOBAL index'
1441 3f1d9a6cSMichal Marek	@echo  '  kernelrelease	  - Output the release version string (use with make -s)'
1442 3f1d9a6cSMichal Marek	@echo  '  kernelversion	  - Output the version stored in Makefile (use with make -s)'
1443 3f1d9a6cSMichal Marek	@echo  '  image_name	  - Output the image name (use with make -s)'
1444 2fb9b1bdSSam Ravnborg	@echo  '  headers_install - Install sanitised kernel headers to INSTALL_HDR_PATH'; \
1445 59df3230SGeert Uytterhoeven	 echo  '                    (default: $(INSTALL_HDR_PATH))'; \
1446 2fb9b1bdSSam Ravnborg	 echo  ''
1447 31b8cc80SRandy Dunlap	@echo  'Static analysers:'
1448 1da177e4SLinus Torvalds	@echo  '  checkstack      - Generate a list of stack hogs'
1449 1da177e4SLinus Torvalds	@echo  '  namespacecheck  - Name space analysis on compiled kernel'
1450 aa025e7dSSam Ravnborg	@echo  '  versioncheck    - Sanity check on version.h usage'
1451 ec2d987fSRandy Dunlap	@echo  '  includecheck    - Check for duplicate included header files'
1452 295ac051SAdrian Bunk	@echo  '  export_report   - List the usages of all exported symbols'
1453 179efcb4SVegard Nossum	@echo  '  headers_check   - Sanity check on exported headers'
1454 74425eeeSNicolas Palix	@echo  '  headerdep       - Detect inclusion cycles in headers'
1455 7f855fc8SMasahiro Yamada	@echo  '  coccicheck      - Check with Coccinelle'
1456 74425eeeSNicolas Palix	@echo  ''
1457 31b8cc80SRandy Dunlap	@echo  'Kernel selftest:'
1458 5a5da78bSShuah Khan	@echo  '  kselftest       - Build and run kernel selftest (run as root)'
1459 5a5da78bSShuah Khan	@echo  '                    Build, install, and boot kernel before'
1460 5a5da78bSShuah Khan	@echo  '                    running kselftest on it'
1461 dcb825a9SWang Long	@echo  '  kselftest-clean - Remove all generated kselftest files'
1462 bbfe63b6SRandy Dunlap	@echo  '  kselftest-merge - Merge all the config dependencies of kselftest to existing'
1463 3d6dee7aSBamvor Jian Zhang	@echo  '                    .config.'
1464 5a5da78bSShuah Khan	@echo  ''
1465 37c8a5faSRob Herring	@$(if $(dtstree), \
1466 37c8a5faSRob Herring		echo 'Devicetree:'; \
1467 37c8a5faSRob Herring		echo '* dtbs            - Build device tree blobs for enabled boards'; \
1468 37c8a5faSRob Herring		echo '  dtbs_install    - Install dtbs to $(INSTALL_DTBS_PATH)'; \
1469 37c8a5faSRob Herring		echo '')
1470 37c8a5faSRob Herring
1471 31b8cc80SRandy Dunlap	@echo 'Userspace tools targets:'
1472 31b8cc80SRandy Dunlap	@echo '  use "make tools/help"'
1473 31b8cc80SRandy Dunlap	@echo '  or  "cd tools; make help"'
1474 31b8cc80SRandy Dunlap	@echo  ''
1475 1da177e4SLinus Torvalds	@echo  'Kernel packaging:'
1476 6c2133e1SSam Ravnborg	@$(MAKE) $(build)=$(package-dir) help
1477 1da177e4SLinus Torvalds	@echo  ''
1478 1da177e4SLinus Torvalds	@echo  'Documentation targets:'
1479 cb43fb57SMauro Carvalho Chehab	@$(MAKE) -f $(srctree)/Documentation/Makefile dochelp
1480 1da177e4SLinus Torvalds	@echo  ''
1481 01dee188SAndres Salomon	@echo  'Architecture specific targets ($(SRCARCH)):'
1482 1da177e4SLinus Torvalds	@$(if $(archhelp),$(archhelp),\
1483 01dee188SAndres Salomon		echo '  No architecture specific help defined for $(SRCARCH)')
1484 1da177e4SLinus Torvalds	@echo  ''
1485 1da177e4SLinus Torvalds	@$(if $(boards), \
1486 1da177e4SLinus Torvalds		$(foreach b, $(boards), \
1487 1da177e4SLinus Torvalds		printf "  %-24s - Build for %s\\n" $(b) $(subst _defconfig,,$(b));) \
1488 1da177e4SLinus Torvalds		echo '')
1489 5dffbe81SSegher Boessenkool	@$(if $(board-dirs), \
1490 5dffbe81SSegher Boessenkool		$(foreach b, $(board-dirs), \
1491 5dffbe81SSegher Boessenkool		printf "  %-16s - Show %s-specific targets\\n" help-$(b) $(b);) \
1492 5dffbe81SSegher Boessenkool		printf "  %-16s - Show all of the above\\n" help-boards; \
1493 5dffbe81SSegher Boessenkool		echo '')
1494 1da177e4SLinus Torvalds
1495 1da177e4SLinus Torvalds	@echo  '  make V=0|1 [targets] 0 => quiet build (default), 1 => verbose build'
1496 45d506bdSSam Ravnborg	@echo  '  make V=2   [targets] 2 => give reason for rebuild of target'
1497 1da177e4SLinus Torvalds	@echo  '  make O=dir [targets] Locate all output files in "dir", including .config'
1498 9ba26a72SCao jin	@echo  '  make C=1   [targets] Check re-compiled c source with $$CHECK (sparse by default)'
1499 701842e3SDustin Kirkland	@echo  '  make C=2   [targets] Force check of all c source with $$CHECK'
1500 af07ce3eSIngo Molnar	@echo  '  make RECORDMCOUNT_WARN=1 [targets] Warn about ignored mcount sections'
1501 28bc20dcSSam Ravnborg	@echo  '  make W=n   [targets] Enable extra gcc checks, n=1,2,3 where'
1502 28bc20dcSSam Ravnborg	@echo  '		1: warnings which may be relevant and do not occur too often'
1503 28bc20dcSSam Ravnborg	@echo  '		2: warnings which occur quite often but may still be relevant'
1504 28bc20dcSSam Ravnborg	@echo  '		3: more obscure warnings, can most likely be ignored'
1505 a6de553dSMichal Marek	@echo  '		Multiple levels can be combined with W=12 or W=123'
1506 1da177e4SLinus Torvalds	@echo  ''
1507 1da177e4SLinus Torvalds	@echo  'Execute "make" or "make all" to build all targets marked with [*] '
1508 1da177e4SLinus Torvalds	@echo  'For further info see the ./README file'
1509 1da177e4SLinus Torvalds
1510 1da177e4SLinus Torvalds
1511 5dffbe81SSegher Boessenkoolhelp-board-dirs := $(addprefix help-,$(board-dirs))
1512 5dffbe81SSegher Boessenkool
1513 5dffbe81SSegher Boessenkoolhelp-boards: $(help-board-dirs)
1514 5dffbe81SSegher Boessenkool
1515 fbae4d58SMichal Marekboards-per-dir = $(sort $(notdir $(wildcard $(srctree)/arch/$(SRCARCH)/configs/$*/*_defconfig)))
1516 5dffbe81SSegher Boessenkool
1517 5dffbe81SSegher Boessenkool$(help-board-dirs): help-%:
1518 5dffbe81SSegher Boessenkool	@echo  'Architecture specific targets ($(SRCARCH) $*):'
1519 5dffbe81SSegher Boessenkool	@$(if $(boards-per-dir), \
1520 5dffbe81SSegher Boessenkool		$(foreach b, $(boards-per-dir), \
1521 5dffbe81SSegher Boessenkool		printf "  %-24s - Build for %s\\n" $*/$(b) $(subst _defconfig,,$(b));) \
1522 5dffbe81SSegher Boessenkool		echo '')
1523 5dffbe81SSegher Boessenkool
1524 5dffbe81SSegher Boessenkool
1525 1da177e4SLinus Torvalds# Documentation targets
1526 1da177e4SLinus Torvalds# ---------------------------------------------------------------------------
1527 e8939222SJani NikulaDOC_TARGETS := xmldocs latexdocs pdfdocs htmldocs epubdocs cleandocs \
1528 e8939222SJani Nikula	       linkcheckdocs dochelp refcheckdocs
1529 22cba31bSJani NikulaPHONY += $(DOC_TARGETS)
1530 22cba31bSJani Nikula$(DOC_TARGETS): scripts_basic FORCE
1531 cb43fb57SMauro Carvalho Chehab	$(Q)$(MAKE) $(build)=Documentation $@
1532 1da177e4SLinus Torvalds
1533 1da177e4SLinus Torvaldselse # KBUILD_EXTMOD
1534 1da177e4SLinus Torvalds
1535 1da177e4SLinus Torvalds###
1536 1da177e4SLinus Torvalds# External module support.
1537 1da177e4SLinus Torvalds# When building external modules the kernel used as basis is considered
1538 1da177e4SLinus Torvalds# read-only, and no consistency checks are made and the make
1539 1da177e4SLinus Torvalds# system is not used on the basis kernel. If updates are required
1540 1da177e4SLinus Torvalds# in the basis kernel ordinary make commands (without M=...) must
1541 1da177e4SLinus Torvalds# be used.
1542 1da177e4SLinus Torvalds#
1543 1da177e4SLinus Torvalds# The following are the only valid targets when building external
1544 1da177e4SLinus Torvalds# modules.
1545 1da177e4SLinus Torvalds# make M=dir clean     Delete all automatically generated files
1546 1da177e4SLinus Torvalds# make M=dir modules   Make all modules in specified dir
1547 1da177e4SLinus Torvalds# make M=dir	       Same as 'make M=dir modules'
1548 1da177e4SLinus Torvalds# make M=dir modules_install
1549 070b98bfSSam Ravnborg#                      Install the modules built in the module directory
1550 1da177e4SLinus Torvalds#                      Assumes install directory is already created
1551 1da177e4SLinus Torvalds
1552 1da177e4SLinus Torvalds# We are always building modules
1553 1da177e4SLinus TorvaldsKBUILD_MODULES := 1
1554 1da177e4SLinus Torvalds
1555 4f193362SPaul SmithPHONY += $(objtree)/Module.symvers
1556 1da177e4SLinus Torvalds$(objtree)/Module.symvers:
1557 1da177e4SLinus Torvalds	@test -e $(objtree)/Module.symvers || ( \
1558 1da177e4SLinus Torvalds	echo; \
1559 1da177e4SLinus Torvalds	echo "  WARNING: Symbol version dump $(objtree)/Module.symvers"; \
1560 1da177e4SLinus Torvalds	echo "           is missing; modules will have no dependencies and modversions."; \
1561 1da177e4SLinus Torvalds	echo )
1562 1da177e4SLinus Torvalds
1563 1da177e4SLinus Torvaldsmodule-dirs := $(addprefix _module_,$(KBUILD_EXTMOD))
1564 4f193362SPaul SmithPHONY += $(module-dirs) modules
1565 *e07db28eSMasahiro Yamada$(module-dirs): prepare $(objtree)/Module.symvers
1566 1da177e4SLinus Torvalds	$(Q)$(MAKE) $(build)=$(patsubst _module_%,%,$@)
1567 1da177e4SLinus Torvalds
1568 1da177e4SLinus Torvaldsmodules: $(module-dirs)
1569 fd54f502SMike Frysinger	@$(kecho) '  Building modules, stage 2.';
1570 b805aa0eSSam Ravnborg	$(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modpost
1571 1da177e4SLinus Torvalds
1572 4f193362SPaul SmithPHONY += modules_install
1573 a67dc21aSSam Ravnborgmodules_install: _emodinst_ _emodinst_post
1574 a67dc21aSSam Ravnborg
1575 a67dc21aSSam Ravnborginstall-dir := $(if $(INSTALL_MOD_DIR),$(INSTALL_MOD_DIR),extra)
1576 4f193362SPaul SmithPHONY += _emodinst_
1577 a67dc21aSSam Ravnborg_emodinst_:
1578 a67dc21aSSam Ravnborg	$(Q)mkdir -p $(MODLIB)/$(install-dir)
1579 b805aa0eSSam Ravnborg	$(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modinst
1580 1da177e4SLinus Torvalds
1581 4f193362SPaul SmithPHONY += _emodinst_post
1582 a67dc21aSSam Ravnborg_emodinst_post: _emodinst_
1583 a67dc21aSSam Ravnborg	$(call cmd,depmod)
1584 a67dc21aSSam Ravnborg
1585 1da177e4SLinus Torvaldsclean-dirs := $(addprefix _clean_,$(KBUILD_EXTMOD))
1586 1da177e4SLinus Torvalds
1587 4f193362SPaul SmithPHONY += $(clean-dirs) clean
1588 1da177e4SLinus Torvalds$(clean-dirs):
1589 1da177e4SLinus Torvalds	$(Q)$(MAKE) $(clean)=$(patsubst _clean_%,%,$@)
1590 1da177e4SLinus Torvalds
1591 1da177e4SLinus Torvaldsclean:	rm-dirs := $(MODVERDIR)
1592 88d7be03SMichal Marekclean: rm-files := $(KBUILD_EXTMOD)/Module.symvers
1593 1da177e4SLinus Torvalds
1594 fe69b420SMasahiro YamadaPHONY += help
1595 1da177e4SLinus Torvaldshelp:
1596 1da177e4SLinus Torvalds	@echo  '  Building external modules.'
1597 1da177e4SLinus Torvalds	@echo  '  Syntax: make -C path/to/kernel/src M=$$PWD target'
1598 1da177e4SLinus Torvalds	@echo  ''
1599 1da177e4SLinus Torvalds	@echo  '  modules         - default target, build the module(s)'
1600 1da177e4SLinus Torvalds	@echo  '  modules_install - install the module'
1601 1da177e4SLinus Torvalds	@echo  '  clean           - remove generated files in module directory only'
1602 1da177e4SLinus Torvalds	@echo  ''
1603 06300b21SSam Ravnborg
1604 06300b21SSam Ravnborg# Dummies...
1605 4f193362SPaul SmithPHONY += prepare scripts
1606 *e07db28eSMasahiro Yamadaprepare:
1607 *e07db28eSMasahiro Yamada	$(cmd_crmodverdir)
1608 06300b21SSam Ravnborgscripts: ;
1609 1da177e4SLinus Torvaldsendif # KBUILD_EXTMOD
1610 1da177e4SLinus Torvalds
1611 88d7be03SMichal Marekclean: $(clean-dirs)
1612 88d7be03SMichal Marek	$(call cmd,rmdirs)
1613 88d7be03SMichal Marek	$(call cmd,rmfiles)
1614 43f67c98SKevin Cernekee	@find $(if $(KBUILD_EXTMOD), $(KBUILD_EXTMOD), .) $(RCS_FIND_IGNORE) \
1615 ef46d9b3SMasahiro Yamada		\( -name '*.[aios]' -o -name '*.ko' -o -name '.*.cmd' \
1616 74ce1896SMasahiro Yamada		-o -name '*.ko.*' -o -name '*.dtb' -o -name '*.dtb.S' \
1617 ef46d9b3SMasahiro Yamada		-o -name '*.dwo' -o -name '*.lst' \
1618 d523b255SRasmus Villemoes		-o -name '*.su'  \
1619 88d7be03SMichal Marek		-o -name '.*.d' -o -name '.*.tmp' -o -name '*.mod.c' \
1620 9a8dfb39SMasahiro Yamada		-o -name '*.lex.c' -o -name '*.tab.[ch]' \
1621 4fa8bc94SMasahiro Yamada		-o -name '*.asn1.[ch]' \
1622 88d7be03SMichal Marek		-o -name '*.symtypes' -o -name 'modules.order' \
1623 88d7be03SMichal Marek		-o -name modules.builtin -o -name '.tmp_*.o.*' \
1624 6b90bd4bSEmese Revfy		-o -name '*.c.[012]*.*' \
1625 433db3e2SVinícius Tinti		-o -name '*.ll' \
1626 88d7be03SMichal Marek		-o -name '*.gcno' \) -type f -print | xargs rm -f
1627 88d7be03SMichal Marek
1628 1da177e4SLinus Torvalds# Generate tags for editors
1629 1da177e4SLinus Torvalds# ---------------------------------------------------------------------------
1630 a680eedcSSam Ravnborgquiet_cmd_tags = GEN     $@
1631 a680eedcSSam Ravnborg      cmd_tags = $(CONFIG_SHELL) $(srctree)/scripts/tags.sh $@
1632 1da177e4SLinus Torvalds
1633 f4ed1009SJianbin Kangtags TAGS cscope gtags: FORCE
1634 1da177e4SLinus Torvalds	$(call cmd,tags)
1635 1da177e4SLinus Torvalds
1636 1da177e4SLinus Torvalds# Scripts to check various things for consistency
1637 1da177e4SLinus Torvalds# ---------------------------------------------------------------------------
1638 1da177e4SLinus Torvalds
1639 279f3dd3SPeter FoleyPHONY += includecheck versioncheck coccicheck namespacecheck export_report
1640 279f3dd3SPeter Foley
1641 1da177e4SLinus Torvaldsincludecheck:
1642 436f876cSPeter Foley	find $(srctree)/* $(RCS_FIND_IGNORE) \
1643 1da177e4SLinus Torvalds		-name '*.[hcS]' -type f -print | sort \
1644 80007434SGeert Uytterhoeven		| xargs $(PERL) -w $(srctree)/scripts/checkincludes.pl
1645 1da177e4SLinus Torvalds
1646 1da177e4SLinus Torvaldsversioncheck:
1647 2ee2d292SPeter Foley	find $(srctree)/* $(RCS_FIND_IGNORE) \
1648 1da177e4SLinus Torvalds		-name '*.[hcS]' -type f -print | sort \
1649 80007434SGeert Uytterhoeven		| xargs $(PERL) -w $(srctree)/scripts/checkversion.pl
1650 1da177e4SLinus Torvalds
1651 74425eeeSNicolas Palixcoccicheck:
1652 74425eeeSNicolas Palix	$(Q)$(CONFIG_SHELL) $(srctree)/scripts/$@
1653 74425eeeSNicolas Palix
1654 1da177e4SLinus Torvaldsnamespacecheck:
1655 1da177e4SLinus Torvalds	$(PERL) $(srctree)/scripts/namespace.pl
1656 1da177e4SLinus Torvalds
1657 295ac051SAdrian Bunkexport_report:
1658 295ac051SAdrian Bunk	$(PERL) $(srctree)/scripts/export_report.pl
1659 295ac051SAdrian Bunk
1660 c398ff00SMike MarciniszynPHONY += checkstack kernelrelease kernelversion image_name
1661 e3ccf6e3SJeff Dike
1662 011e3a9aSJeff Dike# UML needs a little special treatment here.  It wants to use the host
1663 011e3a9aSJeff Dike# toolchain, so needs $(SUBARCH) passed to checkstack.pl.  Everyone
1664 011e3a9aSJeff Dike# else wants $(ARCH), including people doing cross-builds, which means
1665 011e3a9aSJeff Dike# that $(SUBARCH) doesn't work here.
1666 011e3a9aSJeff Dikeifeq ($(ARCH), um)
1667 011e3a9aSJeff DikeCHECKSTACK_ARCH := $(SUBARCH)
1668 011e3a9aSJeff Dikeelse
1669 011e3a9aSJeff DikeCHECKSTACK_ARCH := $(ARCH)
1670 011e3a9aSJeff Dikeendif
1671 1da177e4SLinus Torvaldscheckstack:
1672 1da177e4SLinus Torvalds	$(OBJDUMP) -d vmlinux $$(find . -name '*.ko') | \
1673 011e3a9aSJeff Dike	$(PERL) $(src)/scripts/checkstack.pl $(CHECKSTACK_ARCH)
1674 1da177e4SLinus Torvalds
1675 7b8ea53dSAmerigo Wangkernelrelease:
1676 7b8ea53dSAmerigo Wang	@echo "$(KERNELVERSION)$$($(CONFIG_SHELL) $(srctree)/scripts/setlocalversion $(srctree))"
1677 01ab1788SAmerigo Wang
1678 cb58455cSSam Ravnborgkernelversion:
1679 2244cbd8SSam Ravnborg	@echo $(KERNELVERSION)
1680 1da177e4SLinus Torvalds
1681 c398ff00SMike Marciniszynimage_name:
1682 c398ff00SMike Marciniszyn	@echo $(KBUILD_IMAGE)
1683 c398ff00SMike Marciniszyn
1684 ea01fa9fSBorislav Petkov# Clear a bunch of variables before executing the submake
1685 ea01fa9fSBorislav Petkovtools/: FORCE
1686 bf35182fSDavid Howells	$(Q)mkdir -p $(objtree)/tools
1687 8e9b4667SMasahiro Yamada	$(Q)$(MAKE) LDFLAGS= MAKEFLAGS="$(tools_silent) $(filter --j% -j,$(MAKEFLAGS))" O=$(abspath $(objtree)) subdir=tools -C $(src)/tools/
1688 ea01fa9fSBorislav Petkov
1689 ea01fa9fSBorislav Petkovtools/%: FORCE
1690 bf35182fSDavid Howells	$(Q)mkdir -p $(objtree)/tools
1691 8e9b4667SMasahiro Yamada	$(Q)$(MAKE) LDFLAGS= MAKEFLAGS="$(tools_silent) $(filter --j% -j,$(MAKEFLAGS))" O=$(abspath $(objtree)) subdir=tools -C $(src)/tools/ $*
1692 ea01fa9fSBorislav Petkov
1693 06300b21SSam Ravnborg# Single targets
1694 06300b21SSam Ravnborg# ---------------------------------------------------------------------------
1695 bc2546a6SSam Ravnborg# Single targets are compatible with:
1696 e1b8513dSRobert P. J. Day# - build with mixed source and output
1697 bc2546a6SSam Ravnborg# - build with separate output dir 'make O=...'
1698 bc2546a6SSam Ravnborg# - external modules
1699 bc2546a6SSam Ravnborg#
1700 bc2546a6SSam Ravnborg#  target-dir => where to store outputfile
1701 bc2546a6SSam Ravnborg#  build-dir  => directory in kernel source tree to use
1702 06300b21SSam Ravnborg
1703 06300b21SSam Ravnborgifeq ($(KBUILD_EXTMOD),)
1704 aa360879SSam Ravnborg        build-dir  = $(patsubst %/,%,$(dir $@))
1705 bc2546a6SSam Ravnborg        target-dir = $(dir $@)
1706 06300b21SSam Ravnborgelse
1707 06300b21SSam Ravnborg        zap-slash=$(filter-out .,$(patsubst %/,%,$(dir $@)))
1708 bc2546a6SSam Ravnborg        build-dir  = $(KBUILD_EXTMOD)$(if $(zap-slash),/$(zap-slash))
1709 bc2546a6SSam Ravnborg        target-dir = $(if $(KBUILD_EXTMOD),$(dir $<),$(dir $@))
1710 06300b21SSam Ravnborgendif
1711 06300b21SSam Ravnborg
1712 bc2546a6SSam Ravnborg%.s: %.c prepare scripts FORCE
1713 bc2546a6SSam Ravnborg	$(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
1714 bc2546a6SSam Ravnborg%.i: %.c prepare scripts FORCE
1715 bc2546a6SSam Ravnborg	$(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
1716 bc2546a6SSam Ravnborg%.o: %.c prepare scripts FORCE
1717 bc2546a6SSam Ravnborg	$(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
1718 bc2546a6SSam Ravnborg%.lst: %.c prepare scripts FORCE
1719 bc2546a6SSam Ravnborg	$(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
1720 bc2546a6SSam Ravnborg%.s: %.S prepare scripts FORCE
1721 bc2546a6SSam Ravnborg	$(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
1722 bc2546a6SSam Ravnborg%.o: %.S prepare scripts FORCE
1723 bc2546a6SSam Ravnborg	$(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
1724 15fde675SAndreas Gruenbacher%.symtypes: %.c prepare scripts FORCE
1725 15fde675SAndreas Gruenbacher	$(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
1726 433db3e2SVinícius Tinti%.ll: %.c prepare scripts FORCE
1727 433db3e2SVinícius Tinti	$(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
1728 bc2546a6SSam Ravnborg
1729 bc2546a6SSam Ravnborg# Modules
1730 31110ebbSSam Ravnborg/: prepare scripts FORCE
1731 31110ebbSSam Ravnborg	$(Q)$(MAKE) KBUILD_MODULES=$(if $(CONFIG_MODULES),1) \
1732 31110ebbSSam Ravnborg	$(build)=$(build-dir)
1733 8e2faea8SPeter Foley# Make sure the latest headers are built for Documentation
1734 ddea05faSArnd BergmannDocumentation/ samples/: headers_install
1735 31110ebbSSam Ravnborg%/: prepare scripts FORCE
1736 06300b21SSam Ravnborg	$(Q)$(MAKE) KBUILD_MODULES=$(if $(CONFIG_MODULES),1) \
1737 bc2546a6SSam Ravnborg	$(build)=$(build-dir)
1738 bc2546a6SSam Ravnborg%.ko: prepare scripts FORCE
1739 06300b21SSam Ravnborg	$(Q)$(MAKE) KBUILD_MODULES=$(if $(CONFIG_MODULES),1)   \
1740 bc2546a6SSam Ravnborg	$(build)=$(build-dir) $(@:.ko=.o)
1741 b805aa0eSSam Ravnborg	$(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modpost
1742 06300b21SSam Ravnborg
1743 1da177e4SLinus Torvalds# FIXME Should go into a make.lib or something
1744 1da177e4SLinus Torvalds# ===========================================================================
1745 1da177e4SLinus Torvalds
1746 1da177e4SLinus Torvaldsquiet_cmd_rmdirs = $(if $(wildcard $(rm-dirs)),CLEAN   $(wildcard $(rm-dirs)))
1747 1da177e4SLinus Torvalds      cmd_rmdirs = rm -rf $(rm-dirs)
1748 1da177e4SLinus Torvalds
1749 1da177e4SLinus Torvaldsquiet_cmd_rmfiles = $(if $(wildcard $(rm-files)),CLEAN   $(wildcard $(rm-files)))
1750 1da177e4SLinus Torvalds      cmd_rmfiles = rm -f $(rm-files)
1751 1da177e4SLinus Torvalds
1752 bc3c26feSUwe Kleine-König# Run depmod only if we have System.map and depmod is executable
1753 50a8ec31SSam Ravnborgquiet_cmd_depmod = DEPMOD  $(KERNELRELEASE)
1754 569658ddSMichal Marek      cmd_depmod = $(CONFIG_SHELL) $(srctree)/scripts/depmod.sh $(DEPMOD) \
1755 5a144a1aSMasahiro Yamada                   $(KERNELRELEASE)
1756 50a8ec31SSam Ravnborg
1757 7bb9d092SSam Ravnborg# Create temporary dir for module support files
1758 ab19f879SSam Ravnborg# clean it up only when building all modules
1759 ab19f879SSam Ravnborgcmd_crmodverdir = $(Q)mkdir -p $(MODVERDIR) \
1760 ab19f879SSam Ravnborg                  $(if $(KBUILD_MODULES),; rm -f $(MODVERDIR)/*)
1761 1da177e4SLinus Torvalds
1762 1da177e4SLinus Torvalds# read all saved command lines
1763 00d78ab2SMasahiro Yamadacmd_files := $(wildcard .*.cmd)
1764 1da177e4SLinus Torvalds
1765 1da177e4SLinus Torvaldsifneq ($(cmd_files),)
1766 1da177e4SLinus Torvalds  $(cmd_files): ;	# Do not try to update included dependency files
1767 1da177e4SLinus Torvalds  include $(cmd_files)
1768 1da177e4SLinus Torvaldsendif
1769 1da177e4SLinus Torvalds
1770 25815cf5SMasahiro Yamadaendif   # ifeq ($(config-targets),1)
1771 25815cf5SMasahiro Yamadaendif   # ifeq ($(mixed-targets),1)
1772 1da177e4SLinus Torvaldsendif	# skip-makefile
1773 1da177e4SLinus Torvalds
1774 4f193362SPaul SmithPHONY += FORCE
1775 1da177e4SLinus TorvaldsFORCE:
1776 4f193362SPaul Smith
1777 bd412d81SUlf Magnusson# Declare the contents of the PHONY variable as phony.  We keep that
1778 fe8d0a41SKirill Smelkov# information in a variable so we can use it in if_changed and friends.
1779 4f193362SPaul Smith.PHONY: $(PHONY)
1780