Makefile

   1 # SPDX-License-Identifier: GPL-2.0+
   2
   3 VERSION = 2019
   4 PATCHLEVEL = 01
   5 SUBLEVEL =
   6 EXTRAVERSION = -rc1
   7 NAME =
   8
   9 # *DOCUMENTATION*
  10 # To see a list of typical targets execute "make help"
  11 # More info can be located in ./README
  12 # Comments in this file are targeted only to the developer, do not
  13 # expect to learn how to build the kernel reading this file.
  14
  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
  20 # Avoid funny character set dependencies
  21 unexport LC_ALL
  22 LC_COLLATE=C
  23 LC_NUMERIC=C
  24 export LC_COLLATE LC_NUMERIC
  25
  26 # Avoid interference with shell env settings
  27 unexport GREP_OPTIONS
  28
  29 # We are using a recursive build, so we need to do a little thinking
  30 # to get the ordering right.
  31 #
  32 # Most importantly: sub-Makefiles should only ever modify files in
  33 # their own directory. If in some directory we have a dependency on
  34 # a file in another dir (which doesn't happen often, but it's often
  35 # unavoidable when linking the built-in.o targets which finally
  36 # turn into vmlinux), we will call a sub make in that other dir, and
  37 # after that we are sure that everything which is in that other dir
  38 # is now up to date.
  39 #
  40 # The only cases where we need to modify files which have global
  41 # effects are thus separated out and done before the recursive
  42 # descending is started. They are now explicitly listed as the
  43 # prepare rule.
  44
  45 # Beautify output
  46 # ---------------------------------------------------------------------------
  47 #
  48 # Normally, we echo the whole command before executing it. By making
  49 # that echo $($(quiet)$(cmd)), we now have the possibility to set
  50 # $(quiet) to choose other forms of output instead, e.g.
  51 #
  52 #         quiet_cmd_cc_o_c = Compiling $(RELDIR)/$@
  53 #         cmd_cc_o_c       = $(CC) $(c_flags) -c -o $@ $<
  54 #
  55 # If $(quiet) is empty, the whole command will be printed.
  56 # If it is set to "quiet_", only the short version will be printed.
  57 # If it is set to "silent_", nothing will be printed at all, since
  58 # the variable $(silent_cmd_cc_o_c) doesn't exist.
  59 #
  60 # A simple variant is to prefix commands with $(Q) - that's useful
  61 # for commands that shall be hidden in non-verbose mode.
  62 #
  63 #       $(Q)ln $@ :<
  64 #
  65 # If KBUILD_VERBOSE equals 0 then the above command will be hidden.
  66 # If KBUILD_VERBOSE equals 1 then the above command is displayed.
  67 #
  68 # To put more focus on warnings, be less verbose as default
  69 # Use 'make V=1' to see the full commands
  70
  71 ifeq ("$(origin V)", "command line")
  72   KBUILD_VERBOSE = $(V)
  73 endif
  74 ifndef KBUILD_VERBOSE
  75   KBUILD_VERBOSE = 0
  76 endif
  77
  78 ifeq ($(KBUILD_VERBOSE),1)
  79   quiet =
  80   Q =
  81 else
  82   quiet=quiet_
  83   Q = @
  84 endif
  85
  86 # If the user is running make -s (silent mode), suppress echoing of
  87 # commands
  88
  89 ifneq ($(filter 4.%,$(MAKE_VERSION)),)  # make-4
  90 ifneq ($(filter %s ,$(firstword x$(MAKEFLAGS))),)
  91   quiet=silent_
  92 endif
  93 else                                    # make-3.8x
  94 ifneq ($(filter s% -s%,$(MAKEFLAGS)),)
  95   quiet=silent_
  96 endif
  97 endif
  98
  99 export quiet Q KBUILD_VERBOSE
 100
 101 # kbuild supports saving output files in a separate directory.
 102 # To locate output files in a separate directory two syntaxes are supported.
 103 # In both cases the working directory must be the root of the kernel src.
 104 # 1) O=
 105 # Use "make O=dir/to/store/output/files/"
 106 #
 107 # 2) Set KBUILD_OUTPUT
 108 # Set the environment variable KBUILD_OUTPUT to point to the directory
 109 # where the output files shall be placed.
 110 # export KBUILD_OUTPUT=dir/to/store/output/files/
 111 # make
 112 #
 113 # The O= assignment takes precedence over the KBUILD_OUTPUT environment
 114 # variable.
 115
 116 # KBUILD_SRC is set on invocation of make in OBJ directory
 117 # KBUILD_SRC is not intended to be used by the regular user (for now)
 118 ifeq ($(KBUILD_SRC),)
 119
 120 # OK, Make called in directory where kernel src resides
 121 # Do we want to locate output files in a separate directory?
 122 ifeq ("$(origin O)", "command line")
 123   KBUILD_OUTPUT := $(O)
 124 endif
 125
 126 # That's our default target when none is given on the command line
 127 PHONY := _all
 128 _all:
 129
 130 # Cancel implicit rules on top Makefile
 131 $(CURDIR)/Makefile Makefile: ;
 132
 133 ifneq ($(KBUILD_OUTPUT),)
 134 # Invoke a second make in the output directory, passing relevant variables
 135 # check that the output directory actually exists
 136 saved-output := $(KBUILD_OUTPUT)
 137 KBUILD_OUTPUT := $(shell mkdir -p $(KBUILD_OUTPUT) && cd $(KBUILD_OUTPUT) \
 138                                                                 && /bin/pwd)
 139 $(if $(KBUILD_OUTPUT),, \
 140      $(error failed to create output directory "$(saved-output)"))
 141
 142 PHONY += $(MAKECMDGOALS) sub-make
 143
 144 $(filter-out _all sub-make $(CURDIR)/Makefile, $(MAKECMDGOALS)) _all: sub-make
 145         @:
 146
 147 sub-make: FORCE
 148         $(Q)$(MAKE) -C $(KBUILD_OUTPUT) KBUILD_SRC=$(CURDIR) \
 149         -f $(CURDIR)/Makefile $(filter-out _all sub-make,$(MAKECMDGOALS))
 150
 151 # Leave processing to above invocation of make
 152 skip-makefile := 1
 153 endif # ifneq ($(KBUILD_OUTPUT),)
 154 endif # ifeq ($(KBUILD_SRC),)
 155
 156 # We process the rest of the Makefile if this is the final invocation of make
 157 ifeq ($(skip-makefile),)
 158
 159 # Do not print "Entering directory ...",
 160 # but we want to display it when entering to the output directory
 161 # so that IDEs/editors are able to understand relative filenames.
 162 MAKEFLAGS += --no-print-directory
 163
 164 # Call a source code checker (by default, "sparse") as part of the
 165 # C compilation.
 166 #
 167 # Use 'make C=1' to enable checking of only re-compiled files.
 168 # Use 'make C=2' to enable checking of *all* source files, regardless
 169 # of whether they are re-compiled or not.
 170 #
 171 # See the file "Documentation/sparse.txt" for more details, including
 172 # where to get the "sparse" utility.
 173
 174 ifeq ("$(origin C)", "command line")
 175   KBUILD_CHECKSRC = $(C)
 176 endif
 177 ifndef KBUILD_CHECKSRC
 178   KBUILD_CHECKSRC = 0
 179 endif
 180
 181 # Use make M=dir to specify directory of external module to build
 182 # Old syntax make ... SUBDIRS=$PWD is still supported
 183 # Setting the environment variable KBUILD_EXTMOD take precedence
 184 ifdef SUBDIRS
 185   KBUILD_EXTMOD ?= $(SUBDIRS)
 186 endif
 187
 188 ifeq ("$(origin M)", "command line")
 189   KBUILD_EXTMOD := $(M)
 190 endif
 191
 192 # If building an external module we do not care about the all: rule
 193 # but instead _all depend on modules
 194 PHONY += all
 195 ifeq ($(KBUILD_EXTMOD),)
 196 _all: all
 197 else
 198 _all: modules
 199 endif
 200
 201 ifeq ($(KBUILD_SRC),)
 202         # building in the source tree
 203         srctree := .
 204 else
 205         ifeq ($(KBUILD_SRC)/,$(dir $(CURDIR)))
 206                 # building in a subdirectory of the source tree
 207                 srctree := ..
 208         else
 209                 srctree := $(KBUILD_SRC)
 210         endif
 211 endif
 212 objtree         := .
 213 src             := $(srctree)
 214 obj             := $(objtree)
 215
 216 VPATH           := $(srctree)$(if $(KBUILD_EXTMOD),:$(KBUILD_EXTMOD))
 217
 218 export srctree objtree VPATH
 219
 220 # Make sure CDPATH settings don't interfere
 221 unexport CDPATH
 222
 223 #########################################################################
 224
 225 HOSTARCH := $(shell uname -m | \
 226         sed -e s/i.86/x86/ \
 227             -e s/sun4u/sparc64/ \
 228             -e s/arm.*/arm/ \
 229             -e s/sa110/arm/ \
 230             -e s/ppc64/powerpc/ \
 231             -e s/ppc/powerpc/ \
 232             -e s/macppc/powerpc/\
 233             -e s/sh.*/sh/)
 234
 235 HOSTOS := $(shell uname -s | tr '[:upper:]' '[:lower:]' | \
 236             sed -e 's/\(cygwin\).*/cygwin/')
 237
 238 export  HOSTARCH HOSTOS
 239
 240 #########################################################################
 241
 242 # set default to nothing for native builds
 243 ifeq ($(HOSTARCH),$(ARCH))
 244 CROSS_COMPILE ?=
 245 endif
 246
 247 KCONFIG_CONFIG  ?= .config
 248 export KCONFIG_CONFIG
 249
 250 # SHELL used by kbuild
 251 CONFIG_SHELL := $(shell if [ -x "$$BASH" ]; then echo $$BASH; \
 252           else if [ -x /bin/bash ]; then echo /bin/bash; \
 253           else echo sh; fi ; fi)
 254
 255 HOSTCC       = cc
 256 HOSTCXX      = c++
 257 HOSTCFLAGS   = -Wall -Wstrict-prototypes -O2 -fomit-frame-pointer \
 258                 $(if $(CONFIG_TOOLS_DEBUG),-g)
 259 HOSTCXXFLAGS = -O2
 260
 261 # With the move to GCC 6, we have implicitly upgraded our language
 262 # standard to GNU11 (see https://gcc.gnu.org/gcc-5/porting_to.html).
 263 # Some Linux distributions (including RHEL7, SLES13, Debian 8) still
 264 # have older compilers as their default, so we make it explicit for
 265 # these that our host tools are GNU11 (i.e. C11 w/ GNU extensions).
 266 CSTD_FLAG := -std=gnu11
 267 ifeq ($(HOSTOS),linux)
 268 HOSTCFLAGS += $(CSTD_FLAG)
 269 endif
 270
 271 ifeq ($(HOSTOS),cygwin)
 272 HOSTCFLAGS      += -ansi
 273 endif
 274
 275 # Mac OS X / Darwin's C preprocessor is Apple specific.  It
 276 # generates numerous errors and warnings.  We want to bypass it
 277 # and use GNU C's cpp.  To do this we pass the -traditional-cpp
 278 # option to the compiler.  Note that the -traditional-cpp flag
 279 # DOES NOT have the same semantics as GNU C's flag, all it does
 280 # is invoke the GNU preprocessor in stock ANSI/ISO C fashion.
 281 #
 282 # Apple's linker is similar, thanks to the new 2 stage linking
 283 # multiple symbol definitions are treated as errors, hence the
 284 # -multiply_defined suppress option to turn off this error.
 285 #
 286 ifeq ($(HOSTOS),darwin)
 287 # get major and minor product version (e.g. '10' and '6' for Snow Leopard)
 288 DARWIN_MAJOR_VERSION    = $(shell sw_vers -productVersion | cut -f 1 -d '.')
 289 DARWIN_MINOR_VERSION    = $(shell sw_vers -productVersion | cut -f 2 -d '.')
 290
 291 os_x_before     = $(shell if [ $(DARWIN_MAJOR_VERSION) -le $(1) -a \
 292         $(DARWIN_MINOR_VERSION) -le $(2) ] ; then echo "$(3)"; else echo "$(4)"; fi ;)
 293
 294 # Snow Leopards build environment has no longer restrictions as described above
 295 HOSTCC       = $(call os_x_before, 10, 5, "cc", "gcc")
 296 HOSTCFLAGS  += $(call os_x_before, 10, 4, "-traditional-cpp")
 297 HOSTLDFLAGS += $(call os_x_before, 10, 5, "-multiply_defined suppress")
 298
 299 # since Lion (10.7) ASLR is on by default, but we use linker generated lists
 300 # in some host tools which is a problem then ... so disable ASLR for these
 301 # tools
 302 HOSTLDFLAGS += $(call os_x_before, 10, 7, "", "-Xlinker -no_pie")
 303 endif
 304
 305 # Decide whether to build built-in, modular, or both.
 306 # Normally, just do built-in.
 307
 308 KBUILD_MODULES :=
 309 KBUILD_BUILTIN := 1
 310
 311 # If we have only "make modules", don't compile built-in objects.
 312 # When we're building modules with modversions, we need to consider
 313 # the built-in objects during the descend as well, in order to
 314 # make sure the checksums are up to date before we record them.
 315
 316 ifeq ($(MAKECMDGOALS),modules)
 317   KBUILD_BUILTIN := $(if $(CONFIG_MODVERSIONS),1)
 318 endif
 319
 320 # If we have "make <whatever> modules", compile modules
 321 # in addition to whatever we do anyway.
 322 # Just "make" or "make all" shall build modules as well
 323
 324 # U-Boot does not need modules
 325 #ifneq ($(filter all _all modules,$(MAKECMDGOALS)),)
 326 #  KBUILD_MODULES := 1
 327 #endif
 328
 329 #ifeq ($(MAKECMDGOALS),)
 330 #  KBUILD_MODULES := 1
 331 #endif
 332
 333 export KBUILD_MODULES KBUILD_BUILTIN
 334 export KBUILD_CHECKSRC KBUILD_SRC KBUILD_EXTMOD
 335
 336 # We need some generic definitions (do not try to remake the file).
 337 scripts/Kbuild.include: ;
 338 include scripts/Kbuild.include
 339
 340 # Make variables (CC, etc...)
 341
 342 AS              = $(CROSS_COMPILE)as
 343 # Always use GNU ld
 344 ifneq ($(shell $(CROSS_COMPILE)ld.bfd -v 2> /dev/null),)
 345 LD              = $(CROSS_COMPILE)ld.bfd
 346 else
 347 LD              = $(CROSS_COMPILE)ld
 348 endif
 349 CC              = $(CROSS_COMPILE)gcc
 350 CPP             = $(CC) -E
 351 AR              = $(CROSS_COMPILE)ar
 352 NM              = $(CROSS_COMPILE)nm
 353 LDR             = $(CROSS_COMPILE)ldr
 354 STRIP           = $(CROSS_COMPILE)strip
 355 OBJCOPY         = $(CROSS_COMPILE)objcopy
 356 OBJDUMP         = $(CROSS_COMPILE)objdump
 357 LEX             = flex
 358 YACC            = bison
 359 AWK             = awk
 360 PERL            = perl
 361 PYTHON          ?= python
 362 PYTHON2         = python2
 363 PYTHON3         = python3
 364 DTC             ?= $(objtree)/scripts/dtc/dtc
 365 CHECK           = sparse
 366
 367 CHECKFLAGS     := -D__linux__ -Dlinux -D__STDC__ -Dunix -D__unix__ \
 368                   -Wbitwise -Wno-return-void -D__CHECK_ENDIAN__ $(CF)
 369
 370 KBUILD_CPPFLAGS := -D__KERNEL__ -D__UBOOT__
 371
 372 KBUILD_CFLAGS   := -Wall -Wstrict-prototypes \
 373                    -Wno-format-security \
 374                    -fno-builtin -ffreestanding $(CSTD_FLAG)
 375 KBUILD_CFLAGS   += -fshort-wchar -fno-strict-aliasing
 376 KBUILD_AFLAGS   := -D__ASSEMBLY__
 377
 378 # Don't generate position independent code
 379 KBUILD_CFLAGS   += $(call cc-option,-fno-PIE)
 380 KBUILD_AFLAGS   += $(call cc-option,-fno-PIE)
 381
 382 # Read UBOOTRELEASE from include/config/uboot.release (if it exists)
 383 UBOOTRELEASE = $(shell cat include/config/uboot.release 2> /dev/null)
 384 UBOOTVERSION = $(VERSION)$(if $(PATCHLEVEL),.$(PATCHLEVEL)$(if $(SUBLEVEL),.$(SUBLEVEL)))$(EXTRAVERSION)
 385
 386 export VERSION PATCHLEVEL SUBLEVEL UBOOTRELEASE UBOOTVERSION
 387 export ARCH CPU BOARD VENDOR SOC CPUDIR BOARDDIR
 388 export CONFIG_SHELL HOSTCC HOSTCFLAGS HOSTLDFLAGS CROSS_COMPILE AS LD CC
 389 export CPP AR NM LDR STRIP OBJCOPY OBJDUMP
 390 export MAKE LEX YACC AWK PERL PYTHON PYTHON2 PYTHON3
 391 export HOSTCXX HOSTCXXFLAGS CHECK CHECKFLAGS DTC DTC_FLAGS
 392
 393 export KBUILD_CPPFLAGS NOSTDINC_FLAGS UBOOTINCLUDE OBJCOPYFLAGS LDFLAGS
 394 export KBUILD_CFLAGS KBUILD_AFLAGS
 395
 396 # When compiling out-of-tree modules, put MODVERDIR in the module
 397 # tree rather than in the kernel tree. The kernel tree might
 398 # even be read-only.
 399 export MODVERDIR := $(if $(KBUILD_EXTMOD),$(firstword $(KBUILD_EXTMOD))/).tmp_versions
 400
 401 # Files to ignore in find ... statements
 402
 403 export RCS_FIND_IGNORE := \( -name SCCS -o -name BitKeeper -o -name .svn -o    \
 404                           -name CVS -o -name .pc -o -name .hg -o -name .git \) \
 405                           -prune -o
 406 export RCS_TAR_IGNORE := --exclude SCCS --exclude BitKeeper --exclude .svn \
 407                          --exclude CVS --exclude .pc --exclude .hg --exclude .git
 408
 409 # ===========================================================================
 410 # Rules shared between *config targets and build targets
 411
 412 # Basic helpers built in scripts/
 413 PHONY += scripts_basic
 414 scripts_basic:
 415         $(Q)$(MAKE) $(build)=scripts/basic
 416         $(Q)rm -f .tmp_quiet_recordmcount
 417
 418 # To avoid any implicit rule to kick in, define an empty command.
 419 scripts/basic/%: scripts_basic ;
 420
 421 PHONY += outputmakefile
 422 # outputmakefile generates a Makefile in the output directory, if using a
 423 # separate output directory. This allows convenient use of make in the
 424 # output directory.
 425 outputmakefile:
 426 ifneq ($(KBUILD_SRC),)
 427         $(Q)ln -fsn $(srctree) source
 428         $(Q)$(CONFIG_SHELL) $(srctree)/scripts/mkmakefile \
 429             $(srctree) $(objtree) $(VERSION) $(PATCHLEVEL)
 430 endif
 431
 432 # To make sure we do not include .config for any of the *config targets
 433 # catch them early, and hand them over to scripts/kconfig/Makefile
 434 # It is allowed to specify more targets when calling make, including
 435 # mixing *config targets and build targets.
 436 # For example 'make oldconfig all'.
 437 # Detect when mixed targets is specified, and make a second invocation
 438 # of make so .config is not included in this case either (for *config).
 439
 440 version_h := include/generated/version_autogenerated.h
 441 timestamp_h := include/generated/timestamp_autogenerated.h
 442 defaultenv_h := include/generated/defaultenv_autogenerated.h
 443
 444 no-dot-config-targets := clean clobber mrproper distclean \
 445                          help %docs check% coccicheck \
 446                          ubootversion backup tests check qcheck
 447
 448 config-targets := 0
 449 mixed-targets  := 0
 450 dot-config     := 1
 451
 452 ifneq ($(filter $(no-dot-config-targets), $(MAKECMDGOALS)),)
 453         ifeq ($(filter-out $(no-dot-config-targets), $(MAKECMDGOALS)),)
 454                 dot-config := 0
 455         endif
 456 endif
 457
 458 ifeq ($(KBUILD_EXTMOD),)
 459         ifneq ($(filter config %config,$(MAKECMDGOALS)),)
 460                 config-targets := 1
 461                 ifneq ($(words $(MAKECMDGOALS)),1)
 462                         mixed-targets := 1
 463                 endif
 464         endif
 465 endif
 466
 467 ifeq ($(mixed-targets),1)
 468 # ===========================================================================
 469 # We're called with mixed targets (*config and build targets).
 470 # Handle them one by one.
 471
 472 PHONY += $(MAKECMDGOALS) __build_one_by_one
 473
 474 $(filter-out __build_one_by_one, $(MAKECMDGOALS)): __build_one_by_one
 475         @:
 476
 477 __build_one_by_one:
 478         $(Q)set -e; \
 479         for i in $(MAKECMDGOALS); do \
 480                 $(MAKE) -f $(srctree)/Makefile $$i; \
 481         done
 482
 483 else
 484 ifeq ($(config-targets),1)
 485 # ===========================================================================
 486 # *config targets only - make sure prerequisites are updated, and descend
 487 # in scripts/kconfig to make the *config target
 488
 489 KBUILD_DEFCONFIG := sandbox_defconfig
 490 export KBUILD_DEFCONFIG KBUILD_KCONFIG
 491
 492 config: scripts_basic outputmakefile FORCE
 493         $(Q)$(MAKE) $(build)=scripts/kconfig $@
 494
 495 %config: scripts_basic outputmakefile FORCE
 496         $(Q)$(MAKE) $(build)=scripts/kconfig $@
 497
 498 else
 499 # ===========================================================================
 500 # Build targets only - this includes vmlinux, arch specific targets, clean
 501 # targets and others. In general all targets except *config targets.
 502
 503 # Additional helpers built in scripts/
 504 # Carefully list dependencies so we do not try to build scripts twice
 505 # in parallel
 506 PHONY += scripts
 507 scripts: scripts_basic include/config/auto.conf
 508         $(Q)$(MAKE) $(build)=$(@)
 509
 510 ifeq ($(dot-config),1)
 511 # Read in config
 512 -include include/config/auto.conf
 513
 514 # Read in dependencies to all Kconfig* files, make sure to run
 515 # oldconfig if changes are detected.
 516 -include include/config/auto.conf.cmd
 517
 518 # To avoid any implicit rule to kick in, define an empty command
 519 $(KCONFIG_CONFIG) include/config/auto.conf.cmd: ;
 520
 521 # If .config is newer than include/config/auto.conf, someone tinkered
 522 # with it and forgot to run make oldconfig.
 523 # if auto.conf.cmd is missing then we are probably in a cleaned tree so
 524 # we execute the config step to be sure to catch updated Kconfig files
 525 include/config/%.conf: $(KCONFIG_CONFIG) include/config/auto.conf.cmd
 526         $(Q)$(MAKE) -f $(srctree)/Makefile syncconfig
 527         @# If the following part fails, include/config/auto.conf should be
 528         @# deleted so "make silentoldconfig" will be re-run on the next build.
 529         $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.autoconf || \
 530                 { rm -f include/config/auto.conf; false; }
 531         @# include/config.h has been updated after "make silentoldconfig".
 532         @# We need to touch include/config/auto.conf so it gets newer
 533         @# than include/config.h.
 534         @# Otherwise, 'make silentoldconfig' would be invoked twice.
 535         $(Q)touch include/config/auto.conf
 536
 537 u-boot.cfg spl/u-boot.cfg tpl/u-boot.cfg: include/config.h FORCE
 538         $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.autoconf $(@)
 539
 540 -include include/autoconf.mk
 541 -include include/autoconf.mk.dep
 542
 543 # We want to include arch/$(ARCH)/config.mk only when include/config/auto.conf
 544 # is up-to-date. When we switch to a different board configuration, old CONFIG
 545 # macros are still remaining in include/config/auto.conf. Without the following
 546 # gimmick, wrong config.mk would be included leading nasty warnings/errors.
 547 ifneq ($(wildcard $(KCONFIG_CONFIG)),)
 548 ifneq ($(wildcard include/config/auto.conf),)
 549 autoconf_is_old := $(shell find . -path ./$(KCONFIG_CONFIG) -newer \
 550                                                 include/config/auto.conf)
 551 ifeq ($(autoconf_is_old),)
 552 include config.mk
 553 include arch/$(ARCH)/Makefile
 554 endif
 555 endif
 556 endif
 557
 558 # These are set by the arch-specific config.mk. Make sure they are exported
 559 # so they can be used when building an EFI application.
 560 export EFI_LDS          # Filename of EFI link script in arch/$(ARCH)/lib
 561 export EFI_CRT0         # Filename of EFI CRT0 in arch/$(ARCH)/lib
 562 export EFI_RELOC        # Filename of EFU relocation code in arch/$(ARCH)/lib
 563 export CFLAGS_EFI       # Compiler flags to add when building EFI app
 564 export CFLAGS_NON_EFI   # Compiler flags to remove when building EFI app
 565 export EFI_TARGET       # binutils target if EFI is natively supported
 566
 567 # If board code explicitly specified LDSCRIPT or CONFIG_SYS_LDSCRIPT, use
 568 # that (or fail if absent).  Otherwise, search for a linker script in a
 569 # standard location.
 570
 571 ifndef LDSCRIPT
 572         #LDSCRIPT := $(srctree)/board/$(BOARDDIR)/u-boot.lds.debug
 573         ifdef CONFIG_SYS_LDSCRIPT
 574                 # need to strip off double quotes
 575                 LDSCRIPT := $(srctree)/$(CONFIG_SYS_LDSCRIPT:"%"=%)
 576         endif
 577 endif
 578
 579 # If there is no specified link script, we look in a number of places for it
 580 ifndef LDSCRIPT
 581         ifeq ($(wildcard $(LDSCRIPT)),)
 582                 LDSCRIPT := $(srctree)/board/$(BOARDDIR)/u-boot.lds
 583         endif
 584         ifeq ($(wildcard $(LDSCRIPT)),)
 585                 LDSCRIPT := $(srctree)/$(CPUDIR)/u-boot.lds
 586         endif
 587         ifeq ($(wildcard $(LDSCRIPT)),)
 588                 LDSCRIPT := $(srctree)/arch/$(ARCH)/cpu/u-boot.lds
 589         endif
 590 endif
 591
 592 else
 593 # Dummy target needed, because used as prerequisite
 594 include/config/auto.conf: ;
 595 endif # $(dot-config)
 596
 597 #
 598 # Xtensa linker script cannot be preprocessed with -ansi because of
 599 # preprocessor operations on strings that don't make C identifiers.
 600 #
 601 ifeq ($(CONFIG_XTENSA),)
 602 LDPPFLAGS       += -ansi
 603 endif
 604
 605 ifdef CONFIG_CC_OPTIMIZE_FOR_SIZE
 606 KBUILD_CFLAGS   += -Os
 607 else
 608 KBUILD_CFLAGS   += -O2
 609 endif
 610
 611 KBUILD_CFLAGS += $(call cc-option,-fno-stack-protector)
 612 KBUILD_CFLAGS += $(call cc-option,-fno-delete-null-pointer-checks)
 613
 614 # change __FILE__ to the relative path from the srctree
 615 KBUILD_CFLAGS   += $(call cc-option,-fmacro-prefix-map=$(srctree)/=)
 616
 617 KBUILD_CFLAGS   += -g
 618 # $(KBUILD_AFLAGS) sets -g, which causes gcc to pass a suitable -g<format>
 619 # option to the assembler.
 620 KBUILD_AFLAGS   += -g
 621
 622 # Report stack usage if supported
 623 # ARC tools based on GCC 7.1 has an issue with stack usage
 624 # with naked functions, see commit message for more details
 625 ifndef CONFIG_ARC
 626 ifeq ($(shell $(CONFIG_SHELL) $(srctree)/scripts/gcc-stack-usage.sh $(CC)),y)
 627         KBUILD_CFLAGS += -fstack-usage
 628 endif
 629 endif
 630
 631 KBUILD_CFLAGS += $(call cc-option,-Wno-format-nonliteral)
 632 ifeq ($(cc-name),clang)
 633 KBUILD_CPPFLAGS += $(call cc-option,-Qunused-arguments,)
 634 KBUILD_CFLAGS += $(call cc-disable-warning, format-invalid-specifier)
 635 KBUILD_CFLAGS += $(call cc-disable-warning, gnu)
 636 KBUILD_CFLAGS += $(call cc-disable-warning, address-of-packed-member)
 637 KBUILD_CFLAGS += $(call cc-option, -fcatch-undefined-behavior)
 638 endif
 639
 640 # turn jbsr into jsr for m68k
 641 ifeq ($(ARCH),m68k)
 642 ifeq ($(findstring 3.4,$(shell $(CC) --version)),3.4)
 643 KBUILD_AFLAGS += -Wa,-gstabs,-S
 644 endif
 645 endif
 646
 647 # Prohibit date/time macros, which would make the build non-deterministic
 648 KBUILD_CFLAGS   += $(call cc-option,-Werror=date-time)
 649
 650 include scripts/Makefile.extrawarn
 651
 652 # Add user supplied CPPFLAGS, AFLAGS and CFLAGS as the last assignments
 653 KBUILD_CPPFLAGS += $(KCPPFLAGS)
 654 KBUILD_AFLAGS += $(KAFLAGS)
 655 KBUILD_CFLAGS += $(KCFLAGS)
 656
 657 # Use UBOOTINCLUDE when you must reference the include/ directory.
 658 # Needed to be compatible with the O= option
 659 UBOOTINCLUDE    := \
 660                 -Iinclude \
 661                 $(if $(KBUILD_SRC), -I$(srctree)/include) \
 662                 $(if $(CONFIG_$(SPL_)SYS_THUMB_BUILD), \
 663                         $(if $(CONFIG_HAS_THUMB2),, \
 664                                 -I$(srctree)/arch/$(ARCH)/thumb1/include),) \
 665                 -I$(srctree)/arch/$(ARCH)/include \
 666                 -include $(srctree)/include/linux/kconfig.h
 667
 668 NOSTDINC_FLAGS += -nostdinc -isystem $(shell $(CC) -print-file-name=include)
 669 CHECKFLAGS     += $(NOSTDINC_FLAGS)
 670
 671 # FIX ME
 672 cpp_flags := $(KBUILD_CPPFLAGS) $(PLATFORM_CPPFLAGS) $(UBOOTINCLUDE) \
 673                                                         $(NOSTDINC_FLAGS)
 674 c_flags := $(KBUILD_CFLAGS) $(cpp_flags)
 675
 676 #########################################################################
 677 # U-Boot objects....order is important (i.e. start must be first)
 678
 679 HAVE_VENDOR_COMMON_LIB = $(if $(wildcard $(srctree)/board/$(VENDOR)/common/Makefile),y,n)
 680
 681 libs-y += lib/
 682 libs-$(HAVE_VENDOR_COMMON_LIB) += board/$(VENDOR)/common/
 683 libs-$(CONFIG_OF_EMBED) += dts/
 684 libs-y += fs/
 685 libs-y += net/
 686 libs-y += disk/
 687 libs-y += drivers/
 688 libs-y += drivers/dma/
 689 libs-y += drivers/gpio/
 690 libs-y += drivers/i2c/
 691 libs-y += drivers/mtd/
 692 libs-$(CONFIG_CMD_NAND) += drivers/mtd/nand/raw/
 693 libs-y += drivers/mtd/onenand/
 694 libs-$(CONFIG_CMD_UBI) += drivers/mtd/ubi/
 695 libs-y += drivers/mtd/spi/
 696 libs-y += drivers/net/
 697 libs-y += drivers/net/phy/
 698 libs-y += drivers/power/ \
 699         drivers/power/domain/ \
 700         drivers/power/fuel_gauge/ \
 701         drivers/power/mfd/ \
 702         drivers/power/pmic/ \
 703         drivers/power/battery/ \
 704         drivers/power/regulator/
 705 libs-y += drivers/spi/
 706 libs-$(CONFIG_FMAN_ENET) += drivers/net/fm/
 707 libs-$(CONFIG_SYS_FSL_DDR) += drivers/ddr/fsl/
 708 libs-$(CONFIG_SYS_FSL_MMDC) += drivers/ddr/fsl/
 709 libs-$(CONFIG_ALTERA_SDRAM) += drivers/ddr/altera/
 710 libs-y += drivers/serial/
 711 libs-y += drivers/usb/dwc3/
 712 libs-y += drivers/usb/common/
 713 libs-y += drivers/usb/emul/
 714 libs-y += drivers/usb/eth/
 715 libs-y += drivers/usb/gadget/
 716 libs-y += drivers/usb/gadget/udc/
 717 libs-y += drivers/usb/host/
 718 libs-y += drivers/usb/musb/
 719 libs-y += drivers/usb/musb-new/
 720 libs-y += drivers/usb/phy/
 721 libs-y += drivers/usb/ulpi/
 722 libs-y += cmd/
 723 libs-y += common/
 724 libs-y += env/
 725 libs-$(CONFIG_API) += api/
 726 libs-$(CONFIG_HAS_POST) += post/
 727 libs-y += test/
 728 libs-y += test/dm/
 729 libs-$(CONFIG_UT_ENV) += test/env/
 730 libs-$(CONFIG_UT_OVERLAY) += test/overlay/
 731
 732 libs-y += $(if $(BOARDDIR),board/$(BOARDDIR)/)
 733
 734 libs-y := $(sort $(libs-y))
 735
 736 u-boot-dirs     := $(patsubst %/,%,$(filter %/, $(libs-y))) tools examples
 737
 738 u-boot-alldirs  := $(sort $(u-boot-dirs) $(patsubst %/,%,$(filter %/, $(libs-))))
 739
 740 libs-y          := $(patsubst %/, %/built-in.o, $(libs-y))
 741
 742 u-boot-init := $(head-y)
 743 u-boot-main := $(libs-y)
 744
 745
 746 # Add GCC lib
 747 ifeq ($(CONFIG_USE_PRIVATE_LIBGCC),y)
 748 PLATFORM_LIBGCC = arch/$(ARCH)/lib/lib.a
 749 else
 750 PLATFORM_LIBGCC := -L $(shell dirname `$(CC) $(c_flags) -print-libgcc-file-name`) -lgcc
 751 endif
 752 PLATFORM_LIBS += $(PLATFORM_LIBGCC)
 753
 754 ifdef CONFIG_CC_COVERAGE
 755 KBUILD_CFLAGS += --coverage
 756 PLATFORM_LIBGCC += -lgcov
 757 endif
 758
 759 export PLATFORM_LIBS
 760 export PLATFORM_LIBGCC
 761
 762 # Special flags for CPP when processing the linker script.
 763 # Pass the version down so we can handle backwards compatibility
 764 # on the fly.
 765 LDPPFLAGS += \
 766         -include $(srctree)/include/u-boot/u-boot.lds.h \
 767         -DCPUDIR=$(CPUDIR) \
 768         $(shell $(LD) --version | \
 769           sed -ne 's/GNU ld version \([0-9][0-9]*\)\.\([0-9][0-9]*\).*/-DLD_MAJOR=\1 -DLD_MINOR=\2/p')
 770
 771 #########################################################################
 772 #########################################################################
 773
 774 ifneq ($(CONFIG_BOARD_SIZE_LIMIT),)
 775 BOARD_SIZE_CHECK = \
 776         @actual=`wc -c $@ | awk '{print $$1}'`; \
 777         limit=`printf "%d" $(CONFIG_BOARD_SIZE_LIMIT)`; \
 778         if test $$actual -gt $$limit; then \
 779                 echo "$@ exceeds file size limit:" >&2 ; \
 780                 echo "  limit:  $$limit bytes" >&2 ; \
 781                 echo "  actual: $$actual bytes" >&2 ; \
 782                 echo "  excess: $$((actual - limit)) bytes" >&2; \
 783                 exit 1; \
 784         fi
 785 else
 786 BOARD_SIZE_CHECK =
 787 endif
 788
 789 # Statically apply RELA-style relocations (currently arm64 only)
 790 # This is useful for arm64 where static relocation needs to be performed on
 791 # the raw binary, but certain simulators only accept an ELF file (but don't
 792 # do the relocation).
 793 ifneq ($(CONFIG_STATIC_RELA),)
 794 # $(1) is u-boot ELF, $(2) is u-boot bin, $(3) is text base
 795 DO_STATIC_RELA = \
 796         start=$$($(NM) $(1) | grep __rel_dyn_start | cut -f 1 -d ' '); \
 797         end=$$($(NM) $(1) | grep __rel_dyn_end | cut -f 1 -d ' '); \
 798         tools/relocate-rela $(2) $(3) $$start $$end
 799 else
 800 DO_STATIC_RELA =
 801 endif
 802
 803 # Always append ALL so that arch config.mk's can add custom ones
 804 ALL-y += u-boot.srec u-boot.bin u-boot.sym System.map binary_size_check
 805
 806 ALL-$(CONFIG_ONENAND_U_BOOT) += u-boot-onenand.bin
 807 ifeq ($(CONFIG_SPL_FSL_PBL),y)
 808 ALL-$(CONFIG_RAMBOOT_PBL) += u-boot-with-spl-pbl.bin
 809 else
 810 ifneq ($(CONFIG_SECURE_BOOT), y)
 811 # For Secure Boot The Image needs to be signed and Header must also
 812 # be included. So The image has to be built explicitly
 813 ALL-$(CONFIG_RAMBOOT_PBL) += u-boot.pbl
 814 endif
 815 endif
 816 ALL-$(CONFIG_SPL) += spl/u-boot-spl.bin
 817 ifeq ($(CONFIG_MX6)$(CONFIG_SECURE_BOOT), yy)
 818 ALL-$(CONFIG_SPL_FRAMEWORK) += u-boot-ivt.img
 819 else
 820 ifeq ($(CONFIG_MX7)$(CONFIG_SECURE_BOOT), yy)
 821 ALL-$(CONFIG_SPL_FRAMEWORK) += u-boot-ivt.img
 822 else
 823 ALL-$(CONFIG_SPL_FRAMEWORK) += u-boot.img
 824 endif
 825 endif
 826 ALL-$(CONFIG_TPL) += tpl/u-boot-tpl.bin
 827 ALL-$(CONFIG_OF_SEPARATE) += u-boot.dtb
 828 ifeq ($(CONFIG_SPL_FRAMEWORK),y)
 829 ALL-$(CONFIG_OF_SEPARATE) += u-boot-dtb.img
 830 endif
 831 ALL-$(CONFIG_OF_HOSTFILE) += u-boot.dtb
 832 ifneq ($(CONFIG_SPL_TARGET),)
 833 ALL-$(CONFIG_SPL) += $(CONFIG_SPL_TARGET:"%"=%)
 834 endif
 835 ALL-$(CONFIG_REMAKE_ELF) += u-boot.elf
 836 ALL-$(CONFIG_EFI_APP) += u-boot-app.efi
 837 ALL-$(CONFIG_EFI_STUB) += u-boot-payload.efi
 838
 839 ifneq ($(BUILD_ROM)$(CONFIG_BUILD_ROM),)
 840 ALL-$(CONFIG_X86_RESET_VECTOR) += u-boot.rom
 841 endif
 842
 843 # Build a combined spl + u-boot image for sunxi
 844 ifeq ($(CONFIG_ARCH_SUNXI)$(CONFIG_SPL),yy)
 845 ALL-y += u-boot-sunxi-with-spl.bin
 846 endif
 847
 848 # enable combined SPL/u-boot/dtb rules for tegra
 849 ifeq ($(CONFIG_TEGRA)$(CONFIG_SPL),yy)
 850 ALL-y += u-boot-tegra.bin u-boot-nodtb-tegra.bin
 851 ALL-$(CONFIG_OF_SEPARATE) += u-boot-dtb-tegra.bin
 852 endif
 853
 854 ALL-$(CONFIG_ARCH_MEDIATEK) += u-boot-mtk.bin
 855
 856 # Add optional build target if defined in board/cpu/soc headers
 857 ifneq ($(CONFIG_BUILD_TARGET),)
 858 ALL-y += $(CONFIG_BUILD_TARGET:"%"=%)
 859 endif
 860
 861 ifneq ($(CONFIG_SYS_INIT_SP_BSS_OFFSET),)
 862 ALL-y += init_sp_bss_offset_check
 863 endif
 864
 865 ifeq ($(CONFIG_MPC85xx)$(CONFIG_OF_SEPARATE),yy)
 866 ALL-y += u-boot-with-dtb.bin
 867 endif
 868
 869 LDFLAGS_u-boot += $(LDFLAGS_FINAL)
 870
 871 # Avoid 'Not enough room for program headers' error on binutils 2.28 onwards.
 872 LDFLAGS_u-boot += $(call ld-option, --no-dynamic-linker)
 873
 874 ifeq ($(CONFIG_ARC)$(CONFIG_NIOS2)$(CONFIG_X86)$(CONFIG_XTENSA),)
 875 LDFLAGS_u-boot += -Ttext $(CONFIG_SYS_TEXT_BASE)
 876 endif
 877
 878 # Normally we fill empty space with 0xff
 879 quiet_cmd_objcopy = OBJCOPY $@
 880 cmd_objcopy = $(OBJCOPY) --gap-fill=0xff $(OBJCOPYFLAGS) \
 881         $(OBJCOPYFLAGS_$(@F)) $< $@
 882
 883 # Provide a version which does not do this, for use by EFI
 884 quiet_cmd_zobjcopy = OBJCOPY $@
 885 cmd_zobjcopy = $(OBJCOPY) $(OBJCOPYFLAGS) $(OBJCOPYFLAGS_$(@F)) $< $@
 886
 887 quiet_cmd_efipayload = OBJCOPY $@
 888 cmd_efipayload = $(OBJCOPY) -I binary -O $(EFIPAYLOAD_BFDTARGET) -B $(EFIPAYLOAD_BFDARCH) $< $@
 889
 890 MKIMAGEOUTPUT ?= /dev/null
 891
 892 quiet_cmd_mkimage = MKIMAGE $@
 893 cmd_mkimage = $(objtree)/tools/mkimage $(MKIMAGEFLAGS_$(@F)) -d $< $@ \
 894         >$(MKIMAGEOUTPUT) $(if $(KBUILD_VERBOSE:0=), && cat $(MKIMAGEOUTPUT))
 895
 896 quiet_cmd_mkfitimage = MKIMAGE $@
 897 cmd_mkfitimage = $(objtree)/tools/mkimage $(MKIMAGEFLAGS_$(@F)) -f $(U_BOOT_ITS) -E $@ -p $(CONFIG_FIT_EXTERNAL_OFFSET)\
 898         >$(MKIMAGEOUTPUT) $(if $(KBUILD_VERBOSE:0=), && cat $(MKIMAGEOUTPUT))
 899
 900 quiet_cmd_cat = CAT     $@
 901 cmd_cat = cat $(filter-out $(PHONY), $^) > $@
 902
 903 append = cat $(filter-out $< $(PHONY), $^) >> $@
 904
 905 quiet_cmd_pad_cat = CAT     $@
 906 cmd_pad_cat = $(cmd_objcopy) && $(append) || rm -f $@
 907
 908 cfg: u-boot.cfg
 909
 910 quiet_cmd_cfgcheck = CFGCHK  $2
 911 cmd_cfgcheck = $(srctree)/scripts/check-config.sh $2 \
 912                 $(srctree)/scripts/config_whitelist.txt $(srctree)
 913
 914 all:            $(ALL-y) cfg
 915 ifeq ($(CONFIG_DM_I2C_COMPAT)$(CONFIG_SANDBOX),y)
 916         @echo "===================== WARNING ======================"
 917         @echo "This board uses CONFIG_DM_I2C_COMPAT. Please remove"
 918         @echo "(possibly in a subsequent patch in your series)"
 919         @echo "before sending patches to the mailing list."
 920         @echo "===================================================="
 921 endif
 922 ifeq ($(CONFIG_MMC),y)
 923 ifneq ($(CONFIG_DM_MMC)$(CONFIG_OF_CONTROL)$(CONFIG_BLK),yyy)
 924         @echo "===================== WARNING ======================"
 925         @echo "This board does not use CONFIG_DM_MMC. Please update"
 926         @echo "the board to use CONFIG_DM_MMC before the v2019.04 release."
 927         @echo "Failure to update by the deadline may result in board removal."
 928         @echo "See doc/driver-model/MIGRATION.txt for more info."
 929         @echo "===================================================="
 930 endif
 931 endif
 932 ifeq ($(CONFIG_USB),y)
 933 ifneq ($(CONFIG_DM_USB)$(CONFIG_OF_CONTROL)$(CONFIG_BLK),yyy)
 934         @echo "===================== WARNING ======================"
 935         @echo "This board does not use CONFIG_DM_USB. Please update"
 936         @echo "the board to use CONFIG_DM_USB before the v2019.07 release."
 937         @echo "Failure to update by the deadline may result in board removal."
 938         @echo "See doc/driver-model/MIGRATION.txt for more info."
 939         @echo "===================================================="
 940 endif
 941 endif
 942 ifeq ($(CONFIG_LIBATA)$(CONFIG_DM_SCSI)$(CONFIG_MVSATA_IDE),y)
 943         @echo "===================== WARNING ======================"
 944         @echo "This board does not use CONFIG_DM_SCSI. Please update"
 945         @echo "the storage controller to use CONFIG_DM_SCSI before the v2019.07 release."
 946         @echo "Failure to update by the deadline may result in board removal."
 947         @echo "See doc/driver-model/MIGRATION.txt for more info."
 948         @echo "===================================================="
 949 endif
 950 ifeq ($(CONFIG_OF_EMBED),y)
 951         @echo "===================== WARNING ======================"
 952         @echo "CONFIG_OF_EMBED is enabled. This option should only"
 953         @echo "be used for debugging purposes. Please use"
 954         @echo "CONFIG_OF_SEPARATE for boards in mainline."
 955         @echo "See doc/README.fdt-control for more info."
 956         @echo "===================================================="
 957 endif
 958         @# Check that this build does not use CONFIG options that we do not
 959         @# know about unless they are in Kconfig. All the existing CONFIG
 960         @# options are whitelisted, so new ones should not be added.
 961         $(call cmd,cfgcheck,u-boot.cfg)
 962
 963 PHONY += dtbs
 964 dtbs: dts/dt.dtb
 965         @:
 966 dts/dt.dtb: u-boot
 967         $(Q)$(MAKE) $(build)=dts dtbs
 968
 969 quiet_cmd_copy = COPY    $@
 970       cmd_copy = cp $< $@
 971
 972 ifeq ($(CONFIG_MULTI_DTB_FIT),y)
 973
 974 fit-dtb.blob: dts/dt.dtb FORCE
 975         $(call if_changed,mkimage)
 976
 977 MKIMAGEFLAGS_fit-dtb.blob = -f auto -A $(ARCH) -T firmware -C none -O u-boot \
 978         -a 0 -e 0 -E \
 979         $(patsubst %,-b arch/$(ARCH)/dts/%.dtb,$(subst ",,$(CONFIG_OF_LIST))) -d /dev/null
 980
 981 u-boot-fit-dtb.bin: u-boot-nodtb.bin fit-dtb.blob
 982         $(call if_changed,cat)
 983
 984 u-boot.bin: u-boot-fit-dtb.bin FORCE
 985         $(call if_changed,copy)
 986 else ifeq ($(CONFIG_OF_SEPARATE),y)
 987 u-boot-dtb.bin: u-boot-nodtb.bin dts/dt.dtb FORCE
 988         $(call if_changed,cat)
 989
 990 u-boot.bin: u-boot-dtb.bin FORCE
 991         $(call if_changed,copy)
 992 else
 993 u-boot.bin: u-boot-nodtb.bin FORCE
 994         $(call if_changed,copy)
 995 endif
 996
 997 %.imx: %.bin
 998         $(Q)$(MAKE) $(build)=arch/arm/mach-imx $@
 999
1000 %.vyb: %.imx
1001         $(Q)$(MAKE) $(build)=arch/arm/cpu/armv7/vf610 $@
1002
1003 quiet_cmd_copy = COPY    $@
1004       cmd_copy = cp $< $@
1005
1006 u-boot.dtb: dts/dt.dtb
1007         $(call cmd,copy)
1008
1009 OBJCOPYFLAGS_u-boot.hex := -O ihex
1010
1011 OBJCOPYFLAGS_u-boot.srec := -O srec
1012
1013 u-boot.hex u-boot.srec: u-boot FORCE
1014         $(call if_changed,objcopy)
1015
1016 OBJCOPYFLAGS_u-boot-elf.srec := $(OBJCOPYFLAGS_u-boot.srec)
1017
1018 u-boot-elf.srec: u-boot.elf FORCE
1019         $(call if_changed,objcopy)
1020
1021 OBJCOPYFLAGS_u-boot-spl.srec = $(OBJCOPYFLAGS_u-boot.srec)
1022
1023 spl/u-boot-spl.srec: spl/u-boot-spl FORCE
1024         $(call if_changed,objcopy)
1025
1026 OBJCOPYFLAGS_u-boot-nodtb.bin := -O binary \
1027                 $(if $(CONFIG_X86_16BIT_INIT),-R .start16 -R .resetvec) \
1028                 $(if $(CONFIG_MPC85XX_HAVE_RESET_VECTOR),-R .bootpg -R .resetvec)
1029
1030 OBJCOPYFLAGS_u-boot-spl.hex = $(OBJCOPYFLAGS_u-boot.hex)
1031
1032 spl/u-boot-spl.hex: spl/u-boot-spl FORCE
1033         $(call if_changed,objcopy)
1034
1035 binary_size_check: u-boot-nodtb.bin FORCE
1036         @file_size=$(shell wc -c u-boot-nodtb.bin | awk '{print $$1}') ; \
1037         map_size=$(shell cat u-boot.map | \
1038                 awk '/_image_copy_start/ {start = $$1} /_image_binary_end/ {end = $$1} END {if (start != "" && end != "") print "ibase=16; " toupper(end) " - " toupper(start)}' \
1039                 | sed 's/0X//g' \
1040                 | bc); \
1041         if [ "" != "$$map_size" ]; then \
1042                 if test $$map_size -ne $$file_size; then \
1043                         echo "u-boot.map shows a binary size of $$map_size" >&2 ; \
1044                         echo "  but u-boot-nodtb.bin shows $$file_size" >&2 ; \
1045                         exit 1; \
1046                 fi \
1047         fi
1048
1049 ifneq ($(CONFIG_SYS_INIT_SP_BSS_OFFSET),)
1050 ifneq ($(CONFIG_SYS_MALLOC_F_LEN),)
1051 subtract_sys_malloc_f_len = space=$$(($${space} - $(CONFIG_SYS_MALLOC_F_LEN)))
1052 else
1053 subtract_sys_malloc_f_len = true
1054 endif
1055 # The 1/4 margin below is somewhat arbitrary. The likely initial SP usage is
1056 # so low that the DTB could probably use 90%+ of the available space, for
1057 # current values of CONFIG_SYS_INIT_SP_BSS_OFFSET at least. However, let's be
1058 # safe for now and tweak this later if space becomes tight.
1059 # A rejected alternative would be to check that some absolute minimum stack
1060 # space was available. However, since CONFIG_SYS_INIT_SP_BSS_OFFSET is
1061 # deliberately build-specific, to take account of build-to-build stack usage
1062 # differences due to different feature sets, there is no common absolute value
1063 # to check against.
1064 init_sp_bss_offset_check: u-boot.dtb FORCE
1065         @dtb_size=$(shell wc -c u-boot.dtb | awk '{print $$1}') ; \
1066         space=$(CONFIG_SYS_INIT_SP_BSS_OFFSET) ; \
1067         $(subtract_sys_malloc_f_len) ; \
1068         quarter_space=$$(($${space} / 4)) ; \
1069         if [ $${dtb_size} -gt $${quarter_space} ]; then \
1070                 echo "u-boot.dtb is larger than 1 quarter of " >&2 ; \
1071                 echo "(CONFIG_SYS_INIT_SP_BSS_OFFSET - CONFIG_SYS_MALLOC_F_LEN)" >&2 ; \
1072                 exit 1 ; \
1073         fi
1074 endif
1075
1076 u-boot-nodtb.bin: u-boot FORCE
1077         $(call if_changed,objcopy)
1078         $(call DO_STATIC_RELA,$<,$@,$(CONFIG_SYS_TEXT_BASE))
1079         $(BOARD_SIZE_CHECK)
1080
1081 u-boot.ldr:     u-boot
1082                 $(CREATE_LDR_ENV)
1083                 $(LDR) -T $(CONFIG_CPU) -c $@ $< $(LDR_FLAGS)
1084                 $(BOARD_SIZE_CHECK)
1085
1086 # binman
1087 # ---------------------------------------------------------------------------
1088 # Use 'make BINMAN_DEBUG=1' to enable debugging
1089 quiet_cmd_binman = BINMAN  $@
1090 cmd_binman = $(srctree)/tools/binman/binman -u -d u-boot.dtb -O . -m \
1091                 -I . -I $(srctree) -I $(srctree)/board/$(BOARDDIR) \
1092                 $(if $(BINMAN_DEBUG),-D) $(BINMAN_$(@F)) $<
1093
1094 OBJCOPYFLAGS_u-boot.ldr.hex := -I binary -O ihex
1095
1096 OBJCOPYFLAGS_u-boot.ldr.srec := -I binary -O srec
1097
1098 u-boot.ldr.hex u-boot.ldr.srec: u-boot.ldr FORCE
1099         $(call if_changed,objcopy)
1100
1101 #
1102 # U-Boot entry point, needed for booting of full-blown U-Boot
1103 # from the SPL U-Boot version.
1104 #
1105 ifndef CONFIG_SYS_UBOOT_START
1106 CONFIG_SYS_UBOOT_START := 0
1107 endif
1108
1109 # Boards with more complex image requirments can provide an .its source file
1110 # or a generator script
1111 ifneq ($(CONFIG_SPL_FIT_SOURCE),"")
1112 U_BOOT_ITS = $(subst ",,$(CONFIG_SPL_FIT_SOURCE))
1113 else
1114 ifneq ($(CONFIG_SPL_FIT_GENERATOR),"")
1115 U_BOOT_ITS := u-boot.its
1116 ifeq ($(CONFIG_SPL_FIT_GENERATOR),"arch/arm/mach-rockchip/make_fit_atf.py")
1117 U_BOOT_ITS_DEPS += u-boot
1118 endif
1119 $(U_BOOT_ITS): $(U_BOOT_ITS_DEPS) FORCE
1120         $(srctree)/$(CONFIG_SPL_FIT_GENERATOR) \
1121         $(patsubst %,arch/$(ARCH)/dts/%.dtb,$(subst ",,$(CONFIG_OF_LIST))) > $@
1122 endif
1123 endif
1124
1125 ifdef CONFIG_SPL_LOAD_FIT
1126 MKIMAGEFLAGS_u-boot.img = -f auto -A $(ARCH) -T firmware -C none -O u-boot \
1127         -a $(CONFIG_SYS_TEXT_BASE) -e $(CONFIG_SYS_UBOOT_START) \
1128         -n "U-Boot $(UBOOTRELEASE) for $(BOARD) board" -E \
1129         $(patsubst %,-b arch/$(ARCH)/dts/%.dtb,$(subst ",,$(CONFIG_OF_LIST)))
1130 else
1131 MKIMAGEFLAGS_u-boot.img = -A $(ARCH) -T firmware -C none -O u-boot \
1132         -a $(CONFIG_SYS_TEXT_BASE) -e $(CONFIG_SYS_UBOOT_START) \
1133         -n "U-Boot $(UBOOTRELEASE) for $(BOARD) board"
1134 MKIMAGEFLAGS_u-boot-ivt.img = -A $(ARCH) -T firmware_ivt -C none -O u-boot \
1135         -a $(CONFIG_SYS_TEXT_BASE) -e $(CONFIG_SYS_UBOOT_START) \
1136         -n "U-Boot $(UBOOTRELEASE) for $(BOARD) board"
1137 u-boot-ivt.img: MKIMAGEOUTPUT = u-boot-ivt.img.log
1138 CLEAN_FILES += u-boot-ivt.img.log u-boot-dtb.imx.log SPL.log u-boot.imx.log
1139 endif
1140
1141 MKIMAGEFLAGS_u-boot-dtb.img = $(MKIMAGEFLAGS_u-boot.img)
1142
1143 MKIMAGEFLAGS_u-boot.kwb = -n $(srctree)/$(CONFIG_SYS_KWD_CONFIG:"%"=%) \
1144         -T kwbimage -a $(CONFIG_SYS_TEXT_BASE) -e $(CONFIG_SYS_TEXT_BASE)
1145
1146 MKIMAGEFLAGS_u-boot-spl.kwb = -n $(srctree)/$(CONFIG_SYS_KWD_CONFIG:"%"=%) \
1147         -T kwbimage -a $(CONFIG_SYS_TEXT_BASE) -e $(CONFIG_SYS_TEXT_BASE) \
1148         $(if $(KEYDIR),-k $(KEYDIR))
1149
1150 MKIMAGEFLAGS_u-boot.pbl = -n $(srctree)/$(CONFIG_SYS_FSL_PBL_RCW:"%"=%) \
1151                 -R $(srctree)/$(CONFIG_SYS_FSL_PBL_PBI:"%"=%) -T pblimage
1152
1153 u-boot-dtb.img u-boot.img u-boot.kwb u-boot.pbl u-boot-ivt.img: \
1154                 $(if $(CONFIG_SPL_LOAD_FIT),u-boot-nodtb.bin dts/dt.dtb,u-boot.bin) FORCE
1155         $(call if_changed,mkimage)
1156
1157 u-boot.itb: u-boot-nodtb.bin dts/dt.dtb $(U_BOOT_ITS) FORCE
1158         $(call if_changed,mkfitimage)
1159         $(BOARD_SIZE_CHECK)
1160
1161 u-boot-spl.kwb: u-boot.img spl/u-boot-spl.bin FORCE
1162         $(call if_changed,mkimage)
1163
1164 u-boot.sha1:    u-boot.bin
1165                 tools/ubsha1 u-boot.bin
1166
1167 u-boot.dis:     u-boot
1168                 $(OBJDUMP) -d $< > $@
1169
1170 ifneq ($(CONFIG_SPL_PAYLOAD),)
1171 SPL_PAYLOAD := $(CONFIG_SPL_PAYLOAD:"%"=%)
1172 else
1173 SPL_PAYLOAD := u-boot.bin
1174 endif
1175
1176 OBJCOPYFLAGS_u-boot-with-spl.bin = -I binary -O binary \
1177                                    --pad-to=$(CONFIG_SPL_PAD_TO)
1178 u-boot-with-spl.bin: spl/u-boot-spl.bin $(SPL_PAYLOAD) FORCE
1179         $(call if_changed,pad_cat)
1180
1181 ifeq ($(CONFIG_ARCH_LPC32XX)$(CONFIG_SPL),yy)
1182 MKIMAGEFLAGS_lpc32xx-spl.img = -T lpc32xximage -a $(CONFIG_SPL_TEXT_BASE)
1183
1184 lpc32xx-spl.img: spl/u-boot-spl.bin FORCE
1185         $(call if_changed,mkimage)
1186
1187 OBJCOPYFLAGS_lpc32xx-boot-0.bin = -I binary -O binary --pad-to=$(CONFIG_SPL_PAD_TO)
1188
1189 lpc32xx-boot-0.bin: lpc32xx-spl.img FORCE
1190         $(call if_changed,objcopy)
1191
1192 OBJCOPYFLAGS_lpc32xx-boot-1.bin = -I binary -O binary --pad-to=$(CONFIG_SPL_PAD_TO)
1193
1194 lpc32xx-boot-1.bin: lpc32xx-spl.img FORCE
1195         $(call if_changed,objcopy)
1196
1197 lpc32xx-full.bin: lpc32xx-boot-0.bin lpc32xx-boot-1.bin u-boot.img FORCE
1198         $(call if_changed,cat)
1199
1200 CLEAN_FILES += lpc32xx-*
1201 endif
1202
1203 OBJCOPYFLAGS_u-boot-with-tpl.bin = -I binary -O binary \
1204                                    --pad-to=$(CONFIG_TPL_PAD_TO)
1205 tpl/u-boot-with-tpl.bin: tpl/u-boot-tpl.bin u-boot.bin FORCE
1206         $(call if_changed,pad_cat)
1207
1208 SPL: spl/u-boot-spl.bin FORCE
1209         $(Q)$(MAKE) $(build)=arch/arm/mach-imx $@
1210
1211 ifeq ($(CONFIG_ARCH_IMX8M), y)
1212 flash.bin: spl/u-boot-spl.bin u-boot.itb FORCE
1213         $(Q)$(MAKE) $(build)=arch/arm/mach-imx $@
1214 endif
1215
1216 u-boot-with-spl.imx u-boot-with-nand-spl.imx: SPL u-boot.bin FORCE
1217         $(Q)$(MAKE) $(build)=arch/arm/mach-imx $@
1218
1219 MKIMAGEFLAGS_u-boot.ubl = -n $(UBL_CONFIG) -T ublimage -e $(CONFIG_SYS_TEXT_BASE)
1220
1221 u-boot.ubl: u-boot-with-spl.bin FORCE
1222         $(call if_changed,mkimage)
1223
1224 MKIMAGEFLAGS_u-boot-spl.ais = -s -n $(if $(CONFIG_AIS_CONFIG_FILE), \
1225         $(srctree)/$(CONFIG_AIS_CONFIG_FILE:"%"=%),"/dev/null") \
1226         -T aisimage -e $(CONFIG_SPL_TEXT_BASE)
1227 spl/u-boot-spl.ais: spl/u-boot-spl.bin FORCE
1228         $(call if_changed,mkimage)
1229
1230 OBJCOPYFLAGS_u-boot.ais = -I binary -O binary --pad-to=$(CONFIG_SPL_PAD_TO)
1231 u-boot.ais: spl/u-boot-spl.ais u-boot.img FORCE
1232         $(call if_changed,pad_cat)
1233
1234 u-boot-signed.sb: u-boot.bin spl/u-boot-spl.bin
1235         $(Q)$(MAKE) $(build)=arch/arm/cpu/arm926ejs/mxs u-boot-signed.sb
1236 u-boot.sb: u-boot.bin spl/u-boot-spl.bin
1237         $(Q)$(MAKE) $(build)=arch/arm/cpu/arm926ejs/mxs u-boot.sb
1238
1239 # On x600 (SPEAr600) U-Boot is appended to U-Boot SPL.
1240 # Both images are created using mkimage (crc etc), so that the ROM
1241 # bootloader can check its integrity. Padding needs to be done to the
1242 # SPL image (with mkimage header) and not the binary. Otherwise the resulting image
1243 # which is loaded/copied by the ROM bootloader to SRAM doesn't fit.
1244 # The resulting image containing both U-Boot images is called u-boot.spr
1245 MKIMAGEFLAGS_u-boot-spl.img = -A $(ARCH) -T firmware -C none \
1246         -a $(CONFIG_SPL_TEXT_BASE) -e $(CONFIG_SPL_TEXT_BASE) -n XLOADER
1247 spl/u-boot-spl.img: spl/u-boot-spl.bin FORCE
1248         $(call if_changed,mkimage)
1249
1250 OBJCOPYFLAGS_u-boot.spr = -I binary -O binary --pad-to=$(CONFIG_SPL_PAD_TO) \
1251                           --gap-fill=0xff
1252 u-boot.spr: spl/u-boot-spl.img u-boot.img FORCE
1253         $(call if_changed,pad_cat)
1254
1255 ifneq ($(CONFIG_ARCH_SOCFPGA),)
1256 quiet_cmd_socboot = SOCBOOT $@
1257 cmd_socboot = cat       spl/u-boot-spl.sfp spl/u-boot-spl.sfp   \
1258                         spl/u-boot-spl.sfp spl/u-boot-spl.sfp   \
1259                         u-boot.img > $@ || rm -f $@
1260 u-boot-with-spl.sfp: spl/u-boot-spl.sfp u-boot.img FORCE
1261         $(call if_changed,socboot)
1262 endif
1263
1264 ifeq ($(CONFIG_MPC85xx)$(CONFIG_OF_SEPARATE),yy)
1265 u-boot-with-dtb.bin: u-boot.bin u-boot.dtb \
1266         $(if $(CONFIG_MPC85XX_HAVE_RESET_VECTOR), u-boot-br.bin) FORCE
1267         $(call if_changed,binman)
1268
1269 ifeq ($(CONFIG_MPC85XX_HAVE_RESET_VECTOR),y)
1270 OBJCOPYFLAGS_u-boot-br.bin := -O binary -j .bootpg -j .resetvec
1271 u-boot-br.bin: u-boot FORCE
1272         $(call if_changed,objcopy)
1273 endif
1274 endif
1275
1276 # x86 uses a large ROM. We fill it with 0xff, put the 16-bit stuff (including
1277 # reset vector) at the top, Intel ME descriptor at the bottom, and U-Boot in
1278 # the middle. This is handled by binman based on an image description in the
1279 # board's device tree.
1280 ifneq ($(CONFIG_X86_RESET_VECTOR),)
1281 rom: u-boot.rom FORCE
1282
1283 refcode.bin: $(srctree)/board/$(BOARDDIR)/refcode.bin FORCE
1284         $(call if_changed,copy)
1285
1286 quiet_cmd_ldr = LD      $@
1287 cmd_ldr = $(LD) $(LDFLAGS_$(@F)) \
1288                $(filter-out FORCE,$^) -o $@
1289
1290 u-boot.rom: u-boot-x86-16bit.bin u-boot.bin \
1291                 $(if $(CONFIG_SPL_X86_16BIT_INIT),spl/u-boot-spl.bin) \
1292                 $(if $(CONFIG_HAVE_REFCODE),refcode.bin) FORCE
1293         $(call if_changed,binman)
1294
1295 OBJCOPYFLAGS_u-boot-x86-16bit.bin := -O binary -j .start16 -j .resetvec
1296 u-boot-x86-16bit.bin: u-boot FORCE
1297         $(call if_changed,objcopy)
1298 endif
1299
1300 ifneq ($(CONFIG_ARCH_SUNXI),)
1301 ifeq ($(CONFIG_ARM64),)
1302 u-boot-sunxi-with-spl.bin: spl/sunxi-spl.bin u-boot.img u-boot.dtb FORCE
1303         $(call if_changed,binman)
1304 else
1305 u-boot-sunxi-with-spl.bin: spl/sunxi-spl.bin u-boot.itb FORCE
1306         $(call if_changed,cat)
1307 endif
1308 endif
1309
1310 ifneq ($(CONFIG_TEGRA),)
1311 ifneq ($(CONFIG_BINMAN),)
1312 # Makes u-boot-dtb-tegra.bin u-boot-tegra.bin u-boot-nodtb-tegra.bin
1313 %-dtb-tegra.bin %-tegra.bin %-nodtb-tegra.bin: \
1314                 spl/%-spl %.bin FORCE
1315         $(call if_changed,binman)
1316 else
1317 OBJCOPYFLAGS_u-boot-nodtb-tegra.bin = -O binary --pad-to=$(CONFIG_SYS_TEXT_BASE)
1318 u-boot-nodtb-tegra.bin: spl/u-boot-spl u-boot-nodtb.bin FORCE
1319         $(call if_changed,pad_cat)
1320
1321 OBJCOPYFLAGS_u-boot-tegra.bin = -O binary --pad-to=$(CONFIG_SYS_TEXT_BASE)
1322 u-boot-tegra.bin: spl/u-boot-spl u-boot.bin FORCE
1323         $(call if_changed,pad_cat)
1324
1325 u-boot-dtb-tegra.bin: u-boot-tegra.bin FORCE
1326         $(call if_changed,copy)
1327 endif  # binman
1328 endif
1329
1330 OBJCOPYFLAGS_u-boot-app.efi := $(OBJCOPYFLAGS_EFI)
1331 u-boot-app.efi: u-boot FORCE
1332         $(call if_changed,zobjcopy)
1333
1334 u-boot.bin.o: u-boot.bin FORCE
1335         $(call if_changed,efipayload)
1336
1337 u-boot-payload.lds: $(LDSCRIPT_EFI) FORCE
1338         $(call if_changed_dep,cpp_lds)
1339
1340 # Rule to link the EFI payload which contains a stub and a U-Boot binary
1341 quiet_cmd_u-boot_payload ?= LD      $@
1342       cmd_u-boot_payload ?= $(LD) $(LDFLAGS_EFI_PAYLOAD) -o $@ \
1343       -T u-boot-payload.lds arch/x86/cpu/call32.o \
1344       lib/efi/efi.o lib/efi/efi_stub.o u-boot.bin.o \
1345       $(addprefix arch/$(ARCH)/lib/,$(EFISTUB))
1346
1347 u-boot-payload: u-boot.bin.o u-boot-payload.lds FORCE
1348         $(call if_changed,u-boot_payload)
1349
1350 OBJCOPYFLAGS_u-boot-payload.efi := $(OBJCOPYFLAGS_EFI)
1351 u-boot-payload.efi: u-boot-payload FORCE
1352         $(call if_changed,zobjcopy)
1353
1354 u-boot-img.bin: spl/u-boot-spl.bin u-boot.img FORCE
1355         $(call if_changed,cat)
1356
1357 #Add a target to create boot binary having SPL binary in PBI format
1358 #concatenated with u-boot binary. It is need by PowerPC SoC having
1359 #internal SRAM <= 512KB.
1360 MKIMAGEFLAGS_u-boot-spl.pbl = -n $(srctree)/$(CONFIG_SYS_FSL_PBL_RCW:"%"=%) \
1361                 -R $(srctree)/$(CONFIG_SYS_FSL_PBL_PBI:"%"=%) -T pblimage \
1362                 -A $(ARCH) -a $(CONFIG_SPL_TEXT_BASE)
1363
1364 spl/u-boot-spl.pbl: spl/u-boot-spl.bin FORCE
1365         $(call if_changed,mkimage)
1366
1367 ifeq ($(ARCH),arm)
1368 UBOOT_BINLOAD := u-boot.img
1369 else
1370 ifeq ($(CONFIG_MPC85xx)$(CONFIG_OF_SEPARATE),yy)
1371 UBOOT_BINLOAD := u-boot-with-dtb.bin
1372 else
1373 UBOOT_BINLOAD := u-boot.bin
1374 endif
1375 endif
1376
1377 OBJCOPYFLAGS_u-boot-with-spl-pbl.bin = -I binary -O binary --pad-to=$(CONFIG_SPL_PAD_TO) \
1378                           --gap-fill=0xff
1379
1380 u-boot-with-spl-pbl.bin: spl/u-boot-spl.pbl $(UBOOT_BINLOAD) FORCE
1381         $(call if_changed,pad_cat)
1382
1383 # PPC4xx needs the SPL at the end of the image, since the reset vector
1384 # is located at 0xfffffffc. So we can't use the "u-boot-img.bin" target
1385 # and need to introduce a new build target with the full blown U-Boot
1386 # at the start padded up to the start of the SPL image. And then concat
1387 # the SPL image to the end.
1388
1389 OBJCOPYFLAGS_u-boot-img-spl-at-end.bin := -I binary -O binary \
1390         --pad-to=$(CONFIG_UBOOT_PAD_TO) --gap-fill=0xff
1391 u-boot-img-spl-at-end.bin: u-boot.img spl/u-boot-spl.bin FORCE
1392         $(call if_changed,pad_cat)
1393
1394 # Create a new ELF from a raw binary file.
1395 ifndef PLATFORM_ELFENTRY
1396   PLATFORM_ELFENTRY = "_start"
1397 endif
1398 quiet_cmd_u-boot-elf ?= LD      $@
1399         cmd_u-boot-elf ?= $(LD) u-boot-elf.o -o $@ \
1400         --defsym=$(PLATFORM_ELFENTRY)=$(CONFIG_SYS_TEXT_BASE) \
1401         -Ttext=$(CONFIG_SYS_TEXT_BASE)
1402 u-boot.elf: u-boot.bin
1403         $(Q)$(OBJCOPY) -I binary $(PLATFORM_ELFFLAGS) $< u-boot-elf.o
1404         $(call if_changed,u-boot-elf)
1405
1406 # MediaTek's ARM-based u-boot needs a header to contains its load address
1407 # which is parsed by the BootROM.
1408 # If the SPL build is enabled, the header will be added to the spl binary,
1409 # and the spl binary and the u-boot.img will be combined into one file.
1410 # Otherwise the header will be added to the u-boot.bin directly.
1411
1412 ifeq ($(CONFIG_SPL),y)
1413 spl/u-boot-spl-mtk.bin: spl/u-boot-spl
1414
1415 u-boot-mtk.bin: u-boot.dtb u-boot.img spl/u-boot-spl-mtk.bin FORCE
1416         $(call if_changed,binman)
1417 else
1418 MKIMAGEFLAGS_u-boot-mtk.bin = -T mtk_image \
1419         -a $(CONFIG_SYS_TEXT_BASE) -e $(CONFIG_SYS_TEXT_BASE) \
1420         -n "$(patsubst "%",%,$(CONFIG_MTK_BROM_HEADER_INFO))"
1421
1422 u-boot-mtk.bin: u-boot.bin FORCE
1423         $(call if_changed,mkimage)
1424 endif
1425
1426 ARCH_POSTLINK := $(wildcard $(srctree)/arch/$(ARCH)/Makefile.postlink)
1427
1428 # Rule to link u-boot
1429 # May be overridden by arch/$(ARCH)/config.mk
1430 quiet_cmd_u-boot__ ?= LD      $@
1431       cmd_u-boot__ ?= $(LD) $(LDFLAGS) $(LDFLAGS_u-boot) -o $@ \
1432       -T u-boot.lds $(u-boot-init)                             \
1433       --start-group $(u-boot-main) --end-group                 \
1434       $(PLATFORM_LIBS) -Map u-boot.map;                        \
1435       $(if $(ARCH_POSTLINK), $(MAKE) -f $(ARCH_POSTLINK) $@, true)
1436
1437 quiet_cmd_smap = GEN     common/system_map.o
1438 cmd_smap = \
1439         smap=`$(call SYSTEM_MAP,u-boot) | \
1440                 awk '$$2 ~ /[tTwW]/ {printf $$1 $$3 "\\\\000"}'` ; \
1441         $(CC) $(c_flags) -DSYSTEM_MAP="\"$${smap}\"" \
1442                 -c $(srctree)/common/system_map.c -o common/system_map.o
1443
1444 u-boot: $(u-boot-init) $(u-boot-main) u-boot.lds FORCE
1445         +$(call if_changed,u-boot__)
1446 ifeq ($(CONFIG_KALLSYMS),y)
1447         $(call cmd,smap)
1448         $(call cmd,u-boot__) common/system_map.o
1449 endif
1450
1451 ifeq ($(CONFIG_RISCV),y)
1452         @tools/prelink-riscv $@ 0
1453 endif
1454
1455 quiet_cmd_sym ?= SYM     $@
1456       cmd_sym ?= $(OBJDUMP) -t $< > $@
1457 u-boot.sym: u-boot FORCE
1458         $(call if_changed,sym)
1459
1460 # The actual objects are generated when descending,
1461 # make sure no implicit rule kicks in
1462 $(sort $(u-boot-init) $(u-boot-main)): $(u-boot-dirs) ;
1463
1464 # Handle descending into subdirectories listed in $(vmlinux-dirs)
1465 # Preset locale variables to speed up the build process. Limit locale
1466 # tweaks to this spot to avoid wrong language settings when running
1467 # make menuconfig etc.
1468 # Error messages still appears in the original language
1469
1470 PHONY += $(u-boot-dirs)
1471 $(u-boot-dirs): prepare scripts
1472         $(Q)$(MAKE) $(build)=$@
1473
1474 tools: prepare
1475 # The "tools" are needed early
1476 $(filter-out tools, $(u-boot-dirs)): tools
1477 # The "examples" conditionally depend on U-Boot (say, when USE_PRIVATE_LIBGCC
1478 # is "yes"), so compile examples after U-Boot is compiled.
1479 examples: $(filter-out examples, $(u-boot-dirs))
1480
1481 define filechk_uboot.release
1482         echo "$(UBOOTVERSION)$$($(CONFIG_SHELL) $(srctree)/scripts/setlocalversion $(srctree))"
1483 endef
1484
1485 # Store (new) UBOOTRELEASE string in include/config/uboot.release
1486 include/config/uboot.release: include/config/auto.conf FORCE
1487         $(call filechk,uboot.release)
1488
1489
1490 # Things we need to do before we recursively start building the kernel
1491 # or the modules are listed in "prepare".
1492 # A multi level approach is used. prepareN is processed before prepareN-1.
1493 # archprepare is used in arch Makefiles and when processed asm symlink,
1494 # version.h and scripts_basic is processed / created.
1495
1496 # Listed in dependency order
1497 PHONY += prepare archprepare prepare0 prepare1 prepare2 prepare3
1498
1499 # prepare3 is used to check if we are building in a separate output directory,
1500 # and if so do:
1501 # 1) Check that make has not been executed in the kernel src $(srctree)
1502 prepare3: include/config/uboot.release
1503 ifneq ($(KBUILD_SRC),)
1504         @$(kecho) '  Using $(srctree) as source for U-Boot'
1505         $(Q)if [ -f $(srctree)/.config -o -d $(srctree)/include/config ]; then \
1506                 echo >&2 "  $(srctree) is not clean, please run 'make mrproper'"; \
1507                 echo >&2 "  in the '$(srctree)' directory.";\
1508                 /bin/false; \
1509         fi;
1510 endif
1511
1512 # prepare2 creates a makefile if using a separate output directory
1513 prepare2: prepare3 outputmakefile
1514
1515 prepare1: prepare2 $(version_h) $(timestamp_h) \
1516                    include/config/auto.conf
1517 ifeq ($(wildcard $(LDSCRIPT)),)
1518         @echo >&2 "  Could not find linker script."
1519         @/bin/false
1520 endif
1521
1522 ifeq ($(CONFIG_USE_DEFAULT_ENV_FILE),y)
1523 prepare1: $(defaultenv_h)
1524 endif
1525
1526 archprepare: prepare1 scripts_basic
1527
1528 prepare0: archprepare FORCE
1529         $(Q)$(MAKE) $(build)=.
1530
1531 # All the preparing..
1532 prepare: prepare0
1533
1534 # Generate some files
1535 # ---------------------------------------------------------------------------
1536
1537 define filechk_version.h
1538         (echo \#define PLAIN_VERSION \"$(UBOOTRELEASE)\"; \
1539         echo \#define U_BOOT_VERSION \"U-Boot \" PLAIN_VERSION; \
1540         echo \#define CC_VERSION_STRING \"$$(LC_ALL=C $(CC) --version | head -n 1)\"; \
1541         echo \#define LD_VERSION_STRING \"$$(LC_ALL=C $(LD) --version | head -n 1)\"; )
1542 endef
1543
1544 # The SOURCE_DATE_EPOCH mechanism requires a date that behaves like GNU date.
1545 # The BSD date on the other hand behaves different and would produce errors
1546 # with the misused '-d' switch.  Respect that and search a working date with
1547 # well known pre- and suffixes for the GNU variant of date.
1548 define filechk_timestamp.h
1549         (if test -n "$${SOURCE_DATE_EPOCH}"; then \
1550                 SOURCE_DATE="@$${SOURCE_DATE_EPOCH}"; \
1551                 DATE=""; \
1552                 for date in gdate date.gnu date; do \
1553                         $${date} -u -d "$${SOURCE_DATE}" >/dev/null 2>&1 && DATE="$${date}"; \
1554                 done; \
1555                 if test -n "$${DATE}"; then \
1556                         LC_ALL=C $${DATE} -u -d "$${SOURCE_DATE}" +'#define U_BOOT_DATE "%b %d %C%y"'; \
1557                         LC_ALL=C $${DATE} -u -d "$${SOURCE_DATE}" +'#define U_BOOT_TIME "%T"'; \
1558                         LC_ALL=C $${DATE} -u -d "$${SOURCE_DATE}" +'#define U_BOOT_TZ "%z"'; \
1559                         LC_ALL=C $${DATE} -u -d "$${SOURCE_DATE}" +'#define U_BOOT_DMI_DATE "%m/%d/%Y"'; \
1560                         LC_ALL=C $${DATE} -u -d "$${SOURCE_DATE}" +'#define U_BOOT_BUILD_DATE 0x%Y%m%d'; \
1561                 else \
1562                         return 42; \
1563                 fi; \
1564         else \
1565                 LC_ALL=C date +'#define U_BOOT_DATE "%b %d %C%y"'; \
1566                 LC_ALL=C date +'#define U_BOOT_TIME "%T"'; \
1567                 LC_ALL=C date +'#define U_BOOT_TZ "%z"'; \
1568                 LC_ALL=C date +'#define U_BOOT_DMI_DATE "%m/%d/%Y"'; \
1569                 LC_ALL=C date +'#define U_BOOT_BUILD_DATE 0x%Y%m%d'; \
1570         fi)
1571 endef
1572
1573 define filechk_defaultenv.h
1574         (grep -v '^#' | \
1575          grep -v '^$$' | \
1576          tr '\n' '\0' | \
1577          sed -e 's/\\\x0/\n/' | \
1578          xxd -i ; echo ", 0x00" ; )
1579 endef
1580
1581 $(version_h): include/config/uboot.release FORCE
1582         $(call filechk,version.h)
1583
1584 $(timestamp_h): $(srctree)/Makefile FORCE
1585         $(call filechk,timestamp.h)
1586
1587 $(defaultenv_h): $(CONFIG_DEFAULT_ENV_FILE:"%"=%) FORCE
1588         $(call filechk,defaultenv.h)
1589
1590 # ---------------------------------------------------------------------------
1591 quiet_cmd_cpp_lds = LDS     $@
1592 cmd_cpp_lds = $(CPP) -Wp,-MD,$(depfile) $(cpp_flags) $(LDPPFLAGS) \
1593                 -D__ASSEMBLY__ -x assembler-with-cpp -std=c99 -P -o $@ $<
1594
1595 u-boot.lds: $(LDSCRIPT) prepare FORCE
1596         $(call if_changed_dep,cpp_lds)
1597
1598 spl/u-boot-spl.bin: spl/u-boot-spl
1599         @:
1600 spl/u-boot-spl: tools prepare \
1601                 $(if $(CONFIG_OF_SEPARATE)$(CONFIG_OF_EMBED)$(CONFIG_SPL_OF_PLATDATA),dts/dt.dtb) \
1602                 $(if $(CONFIG_OF_SEPARATE)$(CONFIG_OF_EMBED)$(CONFIG_TPL_OF_PLATDATA),dts/dt.dtb)
1603         $(Q)$(MAKE) obj=spl -f $(srctree)/scripts/Makefile.spl all
1604
1605 spl/sunxi-spl.bin: spl/u-boot-spl
1606         @:
1607
1608 spl/sunxi-spl-with-ecc.bin: spl/sunxi-spl.bin
1609         @:
1610
1611 spl/u-boot-spl.sfp: spl/u-boot-spl
1612         @:
1613
1614 spl/boot.bin: spl/u-boot-spl
1615         @:
1616
1617 tpl/u-boot-tpl.bin: tools prepare \
1618                 $(if $(CONFIG_OF_SEPARATE)$(CONFIG_OF_EMBED)$(CONFIG_SPL_OF_PLATDATA),dts/dt.dtb)
1619         $(Q)$(MAKE) obj=tpl -f $(srctree)/scripts/Makefile.spl all
1620
1621 TAG_SUBDIRS := $(patsubst %,$(srctree)/%,$(u-boot-dirs) include)
1622
1623 FIND := find
1624 FINDFLAGS := -L
1625
1626 tags ctags:
1627                 ctags -w -o ctags `$(FIND) $(FINDFLAGS) $(TAG_SUBDIRS) \
1628                                                 -name '*.[chS]' -print`
1629                 ln -s ctags tags
1630
1631 etags:
1632                 etags -a -o etags `$(FIND) $(FINDFLAGS) $(TAG_SUBDIRS) \
1633                                                 -name '*.[chS]' -print`
1634 cscope:
1635                 $(FIND) $(FINDFLAGS) $(TAG_SUBDIRS) -name '*.[chS]' -print > \
1636                                                 cscope.files
1637                 cscope -b -q -k
1638
1639 SYSTEM_MAP = \
1640                 $(NM) $1 | \
1641                 grep -v '\(compiled\)\|\(\.o$$\)\|\( [aUw] \)\|\(\.\.ng$$\)\|\(LASH[RL]DI\)' | \
1642                 LC_ALL=C sort
1643 System.map:     u-boot
1644                 @$(call SYSTEM_MAP,$<) > $@
1645
1646 #########################################################################
1647
1648 # ARM relocations should all be R_ARM_RELATIVE (32-bit) or
1649 # R_AARCH64_RELATIVE (64-bit).
1650 checkarmreloc: u-boot
1651         @RELOC="`$(CROSS_COMPILE)readelf -r -W $< | cut -d ' ' -f 4 | \
1652                 grep R_A | sort -u`"; \
1653         if test "$$RELOC" != "R_ARM_RELATIVE" -a \
1654                  "$$RELOC" != "R_AARCH64_RELATIVE"; then \
1655                 echo "$< contains unexpected relocations: $$RELOC"; \
1656                 false; \
1657         fi
1658
1659 envtools: scripts_basic $(version_h) $(timestamp_h)
1660         $(Q)$(MAKE) $(build)=tools/env
1661
1662 tools-only: scripts_basic $(version_h) $(timestamp_h)
1663         $(Q)$(MAKE) $(build)=tools
1664
1665 tools-all: export HOST_TOOLS_ALL=y
1666 tools-all: envtools tools ;
1667
1668 cross_tools: export CROSS_BUILD_TOOLS=y
1669 cross_tools: tools ;
1670
1671 .PHONY : CHANGELOG
1672 CHANGELOG:
1673         git log --no-merges U-Boot-1_1_5.. | \
1674         unexpand -a | sed -e 's/\s\s*$$//' > $@
1675
1676 #########################################################################
1677
1678 ###
1679 # Cleaning is done on three levels.
1680 # make clean     Delete most generated files
1681 #                Leave enough to build external modules
1682 # make mrproper  Delete the current configuration, and all generated files
1683 # make distclean Remove editor backup files, patch leftover files and the like
1684
1685 # Directories & files removed with 'make clean'
1686 CLEAN_DIRS  += $(MODVERDIR) \
1687                $(foreach d, spl tpl, $(patsubst %,$d/%, \
1688                         $(filter-out include, $(shell ls -1 $d 2>/dev/null))))
1689
1690 CLEAN_FILES += include/bmp_logo.h include/bmp_logo_data.h \
1691                boot* u-boot* MLO* SPL System.map fit-dtb.blob
1692
1693 # Directories & files removed with 'make mrproper'
1694 MRPROPER_DIRS  += include/config include/generated spl tpl \
1695                   .tmp_objdiff
1696 MRPROPER_FILES += .config .config.old include/autoconf.mk* include/config.h \
1697                   ctags etags tags TAGS cscope* GPATH GTAGS GRTAGS GSYMS
1698
1699 # clean - Delete most, but leave enough to build external modules
1700 #
1701 clean: rm-dirs  := $(CLEAN_DIRS)
1702 clean: rm-files := $(CLEAN_FILES)
1703
1704 clean-dirs      := $(foreach f,$(u-boot-alldirs),$(if $(wildcard $(srctree)/$f/Makefile),$f))
1705
1706 clean-dirs      := $(addprefix _clean_, $(clean-dirs))
1707
1708 PHONY += $(clean-dirs) clean archclean
1709 $(clean-dirs):
1710         $(Q)$(MAKE) $(clean)=$(patsubst _clean_%,%,$@)
1711
1712 clean: $(clean-dirs)
1713         $(call cmd,rmdirs)
1714         $(call cmd,rmfiles)
1715         @find $(if $(KBUILD_EXTMOD), $(KBUILD_EXTMOD), .) $(RCS_FIND_IGNORE) \
1716                 \( -name '*.[oas]' -o -name '*.ko' -o -name '.*.cmd' \
1717                 -o -name '*.ko.*' -o -name '*.su' \
1718                 -o -name '.*.d' -o -name '.*.tmp' -o -name '*.mod.c' \
1719                 -o -name '*.lex.c' -o -name '*.tab.[ch]' \
1720                 -o -name '*.symtypes' -o -name 'modules.order' \
1721                 -o -name modules.builtin -o -name '.tmp_*.o.*' \
1722                 -o -name 'dsdt.aml' -o -name 'dsdt.asl.tmp' -o -name 'dsdt.c' \
1723                 -o -name '*.efi' -o -name '*.gcno' -o -name '*.so' \) \
1724                 -type f -print | xargs rm -f
1725
1726 # mrproper - Delete all generated files, including .config
1727 #
1728 mrproper: rm-dirs  := $(wildcard $(MRPROPER_DIRS))
1729 mrproper: rm-files := $(wildcard $(MRPROPER_FILES))
1730 mrproper-dirs      := $(addprefix _mrproper_,scripts)
1731
1732 PHONY += $(mrproper-dirs) mrproper archmrproper
1733 $(mrproper-dirs):
1734         $(Q)$(MAKE) $(clean)=$(patsubst _mrproper_%,%,$@)
1735
1736 mrproper: clean $(mrproper-dirs)
1737         $(call cmd,rmdirs)
1738         $(call cmd,rmfiles)
1739         @rm -f arch/*/include/asm/arch
1740
1741 # distclean
1742 #
1743 PHONY += distclean
1744
1745 distclean: mrproper
1746         @find $(srctree) $(RCS_FIND_IGNORE) \
1747                 \( -name '*.orig' -o -name '*.rej' -o -name '*~' \
1748                 -o -name '*.bak' -o -name '#*#' -o -name '.*.orig' \
1749                 -o -name '.*.rej' -o -name '*%' -o -name 'core' \
1750                 -o -name '*.pyc' \) \
1751                 -type f -print | xargs rm -f
1752         @rm -f boards.cfg
1753
1754 backup:
1755         F=`basename $(srctree)` ; cd .. ; \
1756         gtar --force-local -zcvf `LC_ALL=C date "+$$F-%Y-%m-%d-%T.tar.gz"` $$F
1757
1758 help:
1759         @echo  'Cleaning targets:'
1760         @echo  '  clean           - Remove most generated files but keep the config'
1761         @echo  '  mrproper        - Remove all generated files + config + various backup files'
1762         @echo  '  distclean       - mrproper + remove editor backup and patch files'
1763         @echo  ''
1764         @echo  'Configuration targets:'
1765         @$(MAKE) -f $(srctree)/scripts/kconfig/Makefile help
1766         @echo  ''
1767         @echo  'Test targets:'
1768         @echo  ''
1769         @echo  '  check           - Run all automated tests that use sandbox'
1770         @echo  '  qcheck          - Run quick automated tests that use sandbox'
1771         @echo  ''
1772         @echo  'Other generic targets:'
1773         @echo  '  all             - Build all necessary images depending on configuration'
1774         @echo  '  tests           - Build U-Boot for sandbox and run tests'
1775         @echo  '* u-boot          - Build the bare u-boot'
1776         @echo  '  dir/            - Build all files in dir and below'
1777         @echo  '  dir/file.[oisS] - Build specified target only'
1778         @echo  '  dir/file.lst    - Build specified mixed source/assembly target only'
1779         @echo  '                    (requires a recent binutils and recent build (System.map))'
1780         @echo  '  tags/ctags      - Generate ctags file for editors'
1781         @echo  '  etags           - Generate etags file for editors'
1782         @echo  '  cscope          - Generate cscope index'
1783         @echo  '  ubootrelease    - Output the release version string (use with make -s)'
1784         @echo  '  ubootversion    - Output the version stored in Makefile (use with make -s)'
1785         @echo  "  cfg             - Don't build, just create the .cfg files"
1786         @echo  "  envtools        - Build only the target-side environment tools"
1787         @echo  ''
1788         @echo  'Static analysers'
1789         @echo  '  checkstack      - Generate a list of stack hogs'
1790         @echo  '  coccicheck      - Execute static code analysis with Coccinelle'
1791         @echo  ''
1792         @echo  'Documentation targets:'
1793         @$(MAKE) -f $(srctree)/Documentation/Makefile dochelp
1794         @echo  ''
1795         @echo  '  make V=0|1 [targets] 0 => quiet build (default), 1 => verbose build'
1796         @echo  '  make V=2   [targets] 2 => give reason for rebuild of target'
1797         @echo  '  make O=dir [targets] Locate all output files in "dir", including .config'
1798         @echo  '  make C=1   [targets] Check all c source with $$CHECK (sparse by default)'
1799         @echo  '  make C=2   [targets] Force check of all c source with $$CHECK'
1800         @echo  '  make RECORDMCOUNT_WARN=1 [targets] Warn about ignored mcount sections'
1801         @echo  '  make W=n   [targets] Enable extra gcc checks, n=1,2,3 where'
1802         @echo  '                1: warnings which may be relevant and do not occur too often'
1803         @echo  '                2: warnings which occur quite often but may still be relevant'
1804         @echo  '                3: more obscure warnings, can most likely be ignored'
1805         @echo  '                Multiple levels can be combined with W=12 or W=123'
1806         @echo  ''
1807         @echo  'Execute "make" or "make all" to build all targets marked with [*] '
1808         @echo  'For further info see the ./README file'
1809
1810 tests check:
1811         $(srctree)/test/run
1812
1813 qcheck:
1814         $(srctree)/test/run quick
1815
1816 # Documentation targets
1817 # ---------------------------------------------------------------------------
1818 DOC_TARGETS := xmldocs latexdocs pdfdocs htmldocs epubdocs cleandocs \
1819                linkcheckdocs dochelp refcheckdocs
1820 PHONY += $(DOC_TARGETS)
1821 $(DOC_TARGETS): scripts_basic FORCE
1822         $(Q)$(MAKE) $(build)=Documentation $@
1823
1824 endif #ifeq ($(config-targets),1)
1825 endif #ifeq ($(mixed-targets),1)
1826
1827 PHONY += checkstack ubootrelease ubootversion
1828
1829 checkstack:
1830         $(OBJDUMP) -d u-boot $$(find . -name u-boot-spl) | \
1831         $(PERL) $(src)/scripts/checkstack.pl $(ARCH)
1832
1833 ubootrelease:
1834         @echo "$(UBOOTVERSION)$$($(CONFIG_SHELL) $(srctree)/scripts/setlocalversion $(srctree))"
1835
1836 ubootversion:
1837         @echo $(UBOOTVERSION)
1838
1839 # Single targets
1840 # ---------------------------------------------------------------------------
1841 # Single targets are compatible with:
1842 # - build with mixed source and output
1843 # - build with separate output dir 'make O=...'
1844 # - external modules
1845 #
1846 #  target-dir => where to store outputfile
1847 #  build-dir  => directory in kernel source tree to use
1848
1849 ifeq ($(KBUILD_EXTMOD),)
1850         build-dir  = $(patsubst %/,%,$(dir $@))
1851         target-dir = $(dir $@)
1852 else
1853         zap-slash=$(filter-out .,$(patsubst %/,%,$(dir $@)))
1854         build-dir  = $(KBUILD_EXTMOD)$(if $(zap-slash),/$(zap-slash))
1855         target-dir = $(if $(KBUILD_EXTMOD),$(dir $<),$(dir $@))
1856 endif
1857
1858 %.s: %.c prepare scripts FORCE
1859         $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
1860 %.i: %.c prepare scripts FORCE
1861         $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
1862 %.o: %.c prepare scripts FORCE
1863         $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
1864 %.lst: %.c prepare scripts FORCE
1865         $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
1866 %.s: %.S prepare scripts FORCE
1867         $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
1868 %.o: %.S prepare scripts FORCE
1869         $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
1870 %.symtypes: %.c prepare scripts FORCE
1871         $(Q)$(MAKE) $(build)=$(build-dir) $(target-dir)$(notdir $@)
1872
1873 # Modules
1874 /: prepare scripts FORCE
1875         $(cmd_crmodverdir)
1876         $(Q)$(MAKE) KBUILD_MODULES=$(if $(CONFIG_MODULES),1) \
1877         $(build)=$(build-dir)
1878 %/: prepare scripts FORCE
1879         $(cmd_crmodverdir)
1880         $(Q)$(MAKE) KBUILD_MODULES=$(if $(CONFIG_MODULES),1) \
1881         $(build)=$(build-dir)
1882 %.ko: prepare scripts FORCE
1883         $(cmd_crmodverdir)
1884         $(Q)$(MAKE) KBUILD_MODULES=$(if $(CONFIG_MODULES),1)   \
1885         $(build)=$(build-dir) $(@:.ko=.o)
1886         $(Q)$(MAKE) -f $(srctree)/scripts/Makefile.modpost
1887
1888 # Consistency checks
1889 # ---------------------------------------------------------------------------
1890
1891 PHONY += coccicheck
1892
1893 coccicheck:
1894         $(Q)$(CONFIG_SHELL) $(srctree)/scripts/$@
1895
1896 # FIXME Should go into a make.lib or something
1897 # ===========================================================================
1898
1899 quiet_cmd_rmdirs = $(if $(wildcard $(rm-dirs)),CLEAN   $(wildcard $(rm-dirs)))
1900       cmd_rmdirs = rm -rf $(rm-dirs)
1901
1902 quiet_cmd_rmfiles = $(if $(wildcard $(rm-files)),CLEAN   $(wildcard $(rm-files)))
1903       cmd_rmfiles = rm -f $(rm-files)
1904
1905 # read all saved command lines
1906
1907 targets := $(wildcard $(sort $(targets)))
1908 cmd_files := $(wildcard .*.cmd $(foreach f,$(targets),$(dir $(f)).$(notdir $(f)).cmd))
1909
1910 ifneq ($(cmd_files),)
1911   $(cmd_files): ;       # Do not try to update included dependency files
1912   include $(cmd_files)
1913 endif
1914
1915 endif   # skip-makefile
1916
1917 PHONY += FORCE
1918 FORCE:
1919
1920 # Declare the contents of the .PHONY variable as phony.  We keep that
1921 # information in a variable so we can use it in if_changed and friends.
1922 .PHONY: $(PHONY)