Makefile 58 KB

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