API tools faq
paste
Advertisement
Guest User

Untitled

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