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