Cross Reference: /linux-master/Makefile

9 # To see a list of typical targets execute "make help"
32 # turn into vmlinux), we will call a sub make in that other dir, and
47 # Do not use make's built-in rules and variables
80 # Use 'make V=1' to see the full commands
94 # If the user is running make -s (silent mode), suppress echoing of
96 # make-4.0 (and later) keep single letter options in the 1st word of MAKEFLAGS.
114 # Use 'make C=1' to enable checking of only re-compiled files.
115 # Use 'make C=2' to enable checking of *all* source files, regardless
132 # Use 'make CLIPPY=1' to enable it.
139 # Use make M=dir or set the environment variable KBUILD_EXTMOD to specify the
172 #  cd /dir/to/store/output/files; make -f /dir/to/kernel/source/Makefile
178 # Use "make O=dir/to/store/output/files/"
182 # export KBUILD_OUTPUT=dir/to/store/output/files/; make
206 # We need to invoke sub-make to avoid implicit rules in the top Makefile.
207 need-sub-make := 1
221 need-sub-make := 1
226 # You may end up recursing into __sub-make twice. This is needed due to the
228 need-sub-make := 1
231 ifeq ($(need-sub-make),1)
233 PHONY += $(MAKECMDGOALS) __sub-make
235 $(filter-out $(this-makefile), $(MAKECMDGOALS)) __all: __sub-make
238 # Invoke a second make in the output directory, passing relevant variables
239 __sub-make:
243 else # need-sub-make
245 # We process the rest of the Makefile if this is the final invocation of make
270 # To make sure we do not include .config for any of the *config targets
272 # It is allowed to specify more targets when calling make, including
274 # For example 'make oldconfig all'.
275 # Detect when mixed targets is specified, and make a second invocation
276 # of make so .config is not included in this case either (for *config).
331 # For "make -j clean all", "make -j mrproper defconfig all", etc.
377 # ARCH can be set during invocation of make:
378 # make ARCH=arm64
380 # The default ARCH is the host where make is executed.
386 # make CROSS_COMPILE=aarch64-linux-gnu-
628 # Before starting out-of-tree build, make sure the source tree is clean.
630 # separate output directory. This allows convenient use of make in the
646 		echo >&2 "*** The source tree is not clean, please run 'make$(if $(findstring command line, $(origin ARCH)), ARCH=$(ARCH)) mrproper'"; \
675 # *config targets only - make sure prerequisites are updated, and descend
676 # in scripts/kconfig to make the *config target
680 # used for 'make defconfig'
712 # If we have only "make modules", don't compile built-in objects.
717 # If we have "make <whatever> modules", compile modules
719 # Just "make" or "make all" shall build modules as well
744 # This allow a user to issue only 'make' to build a kernel including modules
763 # Read in dependencies to all Kconfig* files, make sure to run syncconfig if
772 	@echo >&2 '*** Please run some configurator (e.g. "make oldconfig" or'
773 	@echo >&2 '*** "make menuconfig" or "make xconfig").'
782 # The syncconfig should be executed only once to make all the targets.
801 	echo >&2 "         Run 'make oldconfig && make prepare' on kernel src to fix it.";	\
832 # Disable optimizations that make assembler listings hard to read.
1056 # make the checker run with the right architecture
1087 # makefile but the argument can be passed to make if needed.
1163 # make sure no implicit rule kicks in
1308 # If DKMS is installed, 'make install' will eventually recurse back
1397 # INSTALL_DTBS_PATH contains $(KERNELRELEASE). However, we do not want to make
1447 # make sure the checksums are up to date before we record them.
1472 # make clean     Delete most generated files
1474 # make mrproper  Delete the current configuration, and all generated files
1475 # make distclean Remove editor backup files, patch leftover files and the like
1477 # Directories & files removed with 'make clean'
1483 # Directories & files removed with 'make mrproper'
1578 	@echo  '  kernelrelease	  - Output the release version string (use with make -s)'
1579 	@echo  '  kernelversion	  - Output the version stored in Makefile (use with make -s)'
1580 	@echo  '  image_name	  - Output the image name (use with make -s)'
1636 	@echo '  use "make tools/help"'
1637 	@echo '  or  "cd tools; make help"'
1659 	@echo  '  make V=n   [targets] 1: verbose build'
1662 	@echo  '  make O=dir [targets] Locate all output files in "dir", including .config'
1663 	@echo  '  make C=1   [targets] Check re-compiled c source with $$CHECK'
1665 	@echo  '  make C=2   [targets] Force check of all c source with $$CHECK'
1666 	@echo  '  make RECORDMCOUNT_WARN=1 [targets] Warn about ignored mcount sections'
1667 	@echo  '  make W=n   [targets] Enable extra build checks, n=1,2,3,c,e where'
1675 		echo '  make CHECK_DTBS=1 [targets] Check all generated dtb files against schema'; \
1679 	@echo  'Execute "make" or "make all" to build all targets marked with [*] '
1771 # read-only, and no consistency checks are made and the make
1773 # in the basis kernel ordinary make commands (without M=...) must be used.
1801 	@echo  '  Syntax: make -C path/to/kernel/src M=$$PWD target'
1832 # 'make modules_install modules_sign' is equivalent to 'make modules_install'.
1877 #   make foo/bar/baz.s
1883 #   make foo/bar/baz/
1915 # make menuconfig etc.
2055 endif # need-sub-make