]> rtime.felk.cvut.cz Git - coffee/buildroot.git/blob - Makefile
Globally replace $(HOST_DIR)/usr/bin with $(HOST_DIR)/bin
[coffee/buildroot.git] / Makefile
1 # Makefile for buildroot
2 #
3 # Copyright (C) 1999-2005 by Erik Andersen <andersen@codepoet.org>
4 # Copyright (C) 2006-2014 by the Buildroot developers <buildroot@uclibc.org>
5 # Copyright (C) 2014-2017 by the Buildroot developers <buildroot@buildroot.org>
6 #
7 # This program is free software; you can redistribute it and/or modify
8 # it under the terms of the GNU General Public License as published by
9 # the Free Software Foundation; either version 2 of the License, or
10 # (at your option) any later version.
11 #
12 # This program is distributed in the hope that it will be useful,
13 # but WITHOUT ANY WARRANTY; without even the implied warranty of
14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 # General Public License for more details.
16 #
17 # You should have received a copy of the GNU General Public License
18 # along with this program; if not, write to the Free Software
19 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
20 #
21
22 #--------------------------------------------------------------
23 # Just run 'make menuconfig', configure stuff, then run 'make'.
24 # You shouldn't need to mess with anything beyond this point...
25 #--------------------------------------------------------------
26
27 # Delete default rules. We don't use them. This saves a bit of time.
28 .SUFFIXES:
29
30 # we want bash as shell
31 SHELL := $(shell if [ -x "$$BASH" ]; then echo $$BASH; \
32          else if [ -x /bin/bash ]; then echo /bin/bash; \
33          else echo sh; fi; fi)
34
35 # Set O variable if not already done on the command line;
36 # or avoid confusing packages that can use the O=<dir> syntax for out-of-tree
37 # build by preventing it from being forwarded to sub-make calls.
38 ifneq ("$(origin O)", "command line")
39 O := $(CURDIR)/output
40 endif
41
42 # Check if the current Buildroot execution meets all the pre-requisites.
43 # If they are not met, Buildroot will actually do its job in a sub-make meeting
44 # its pre-requisites, which are:
45 #  1- Permissive enough umask:
46 #       Wrong or too restrictive umask will prevent Buildroot and packages from
47 #       creating files and directories.
48 #  2- Absolute canonical CWD (i.e. $(CURDIR)):
49 #       Otherwise, some packages will use CWD as-is, others will compute its
50 #       absolute canonical path. This makes harder tracking and fixing host
51 #       machine path leaks.
52 #  3- Absolute canonical output location (i.e. $(O)):
53 #       For the same reason as the one for CWD.
54
55 # Remove the trailing '/.' from $(O) as it can be added by the makefile wrapper
56 # installed in the $(O) directory.
57 # Also remove the trailing '/' the user can set when on the command line.
58 override O := $(patsubst %/,%,$(patsubst %.,%,$(O)))
59 # Make sure $(O) actually exists before calling realpath on it; this is to
60 # avoid empty CANONICAL_O in case on non-existing entry.
61 CANONICAL_O := $(shell mkdir -p $(O) >/dev/null 2>&1)$(realpath $(O))
62
63 CANONICAL_CURDIR = $(realpath $(CURDIR))
64
65 REQ_UMASK = 0022
66
67 # Make sure O= is passed (with its absolute canonical path) everywhere the
68 # toplevel makefile is called back.
69 EXTRAMAKEARGS := O=$(CANONICAL_O)
70
71 # Check Buildroot execution pre-requisites here.
72 ifneq ($(shell umask):$(CURDIR):$(O),$(REQ_UMASK):$(CANONICAL_CURDIR):$(CANONICAL_O))
73 .PHONY: _all $(MAKECMDGOALS)
74
75 $(MAKECMDGOALS): _all
76         @:
77
78 _all:
79         @umask $(REQ_UMASK) && \
80                 $(MAKE) -C $(CANONICAL_CURDIR) --no-print-directory \
81                         $(MAKECMDGOALS) $(EXTRAMAKEARGS)
82
83 else # umask / $(CURDIR) / $(O)
84
85 # This is our default rule, so must come first
86 all:
87 .PHONY: all
88
89 # Set and export the version string
90 export BR2_VERSION := 2017.08-git
91 # Actual time the release is cut (for reproducible builds)
92 BR2_VERSION_EPOCH = 1496267000
93
94 # Save running make version since it's clobbered by the make package
95 RUNNING_MAKE_VERSION := $(MAKE_VERSION)
96
97 # Check for minimal make version (note: this check will break at make 10.x)
98 MIN_MAKE_VERSION = 3.81
99 ifneq ($(firstword $(sort $(RUNNING_MAKE_VERSION) $(MIN_MAKE_VERSION))),$(MIN_MAKE_VERSION))
100 $(error You have make '$(RUNNING_MAKE_VERSION)' installed. GNU make >= $(MIN_MAKE_VERSION) is required)
101 endif
102
103 # Parallel execution of this Makefile is disabled because it changes
104 # the packages building order, that can be a problem for two reasons:
105 # - If a package has an unspecified optional dependency and that
106 #   dependency is present when the package is built, it is used,
107 #   otherwise it isn't (but compilation happily proceeds) so the end
108 #   result will differ if the order is swapped due to parallel
109 #   building.
110 # - Also changing the building order can be a problem if two packages
111 #   manipulate the same file in the target directory.
112 #
113 # Taking into account the above considerations, if you still want to execute
114 # this top-level Makefile in parallel comment the ".NOTPARALLEL" line and
115 # use the -j<jobs> option when building, e.g:
116 #      make -j$((`getconf _NPROCESSORS_ONLN`+1))
117 .NOTPARALLEL:
118
119 # absolute path
120 TOPDIR := $(CURDIR)
121 CONFIG_CONFIG_IN = Config.in
122 CONFIG = support/kconfig
123 DATE := $(shell date +%Y%m%d)
124
125 # Compute the full local version string so packages can use it as-is
126 # Need to export it, so it can be got from environment in children (eg. mconf)
127 export BR2_VERSION_FULL := $(BR2_VERSION)$(shell $(TOPDIR)/support/scripts/setlocalversion)
128
129 # List of targets and target patterns for which .config doesn't need to be read in
130 noconfig_targets := menuconfig nconfig gconfig xconfig config oldconfig randconfig \
131         defconfig %_defconfig allyesconfig allnoconfig silentoldconfig release \
132         randpackageconfig allyespackageconfig allnopackageconfig \
133         print-version olddefconfig distclean manual manual-%
134
135 # Some global targets do not trigger a build, but are used to collect
136 # metadata, or do various checks. When such targets are triggered,
137 # some packages should not do their configuration sanity
138 # checks. Provide them a BR_BUILDING variable set to 'y' when we're
139 # actually building and they should do their sanity checks.
140 #
141 # We're building in two situations: when MAKECMDGOALS is empty
142 # (default target is to build), or when MAKECMDGOALS contains
143 # something else than one of the nobuild_targets.
144 nobuild_targets := source %-source source-check \
145         legal-info %-legal-info external-deps _external-deps \
146         clean distclean help show-targets graph-depends \
147         %-graph-depends %-show-depends %-show-version \
148         graph-build graph-size list-defconfigs \
149         savedefconfig printvars
150 ifeq ($(MAKECMDGOALS),)
151 BR_BUILDING = y
152 else ifneq ($(filter-out $(nobuild_targets),$(MAKECMDGOALS)),)
153 BR_BUILDING = y
154 endif
155
156 # We call make recursively to build packages. The command-line overrides that
157 # are passed to Buildroot don't apply to those package build systems. In
158 # particular, we don't want to pass down the O=<dir> option for out-of-tree
159 # builds, because the value specified on the command line will not be correct
160 # for packages.
161 MAKEOVERRIDES :=
162
163 # Include some helper macros and variables
164 include support/misc/utils.mk
165
166 # Set variables related to in-tree or out-of-tree build.
167 # Here, both $(O) and $(CURDIR) are absolute canonical paths.
168 ifeq ($(O),$(CURDIR)/output)
169 CONFIG_DIR := $(CURDIR)
170 NEED_WRAPPER =
171 else
172 CONFIG_DIR := $(O)
173 NEED_WRAPPER = y
174 endif
175
176 # bash prints the name of the directory on 'cd <dir>' if CDPATH is
177 # set, so unset it here to not cause problems. Notice that the export
178 # line doesn't affect the environment of $(shell ..) calls.
179 export CDPATH :=
180
181 BASE_DIR := $(CANONICAL_O)
182 $(if $(BASE_DIR),, $(error output directory "$(O)" does not exist))
183
184
185 # Handling of BR2_EXTERNAL.
186 #
187 # The value of BR2_EXTERNAL is stored in .br-external in the output directory.
188 # The location of the external.mk makefile fragments is computed in that file.
189 # On subsequent invocations of make, this file is read in. BR2_EXTERNAL can
190 # still be overridden on the command line, therefore the file is re-created
191 # every time make is run.
192
193 BR2_EXTERNAL_FILE = $(BASE_DIR)/.br-external.mk
194 -include $(BR2_EXTERNAL_FILE)
195 $(shell support/scripts/br2-external \
196         -m -o '$(BR2_EXTERNAL_FILE)' $(BR2_EXTERNAL))
197 BR2_EXTERNAL_ERROR =
198 include $(BR2_EXTERNAL_FILE)
199 ifneq ($(BR2_EXTERNAL_ERROR),)
200 $(error $(BR2_EXTERNAL_ERROR))
201 endif
202
203 # To make sure that the environment variable overrides the .config option,
204 # set this before including .config.
205 ifneq ($(BR2_DL_DIR),)
206 DL_DIR := $(BR2_DL_DIR)
207 endif
208 ifneq ($(BR2_CCACHE_DIR),)
209 BR_CACHE_DIR := $(BR2_CCACHE_DIR)
210 endif
211
212 # Need that early, before we scan packages
213 # Avoids doing the $(or...) everytime
214 BR_GRAPH_OUT := $(or $(BR2_GRAPH_OUT),pdf)
215
216 BUILD_DIR := $(BASE_DIR)/build
217 BINARIES_DIR := $(BASE_DIR)/images
218 TARGET_DIR := $(BASE_DIR)/target
219 # initial definition so that 'make clean' works for most users, even without
220 # .config. HOST_DIR will be overwritten later when .config is included.
221 HOST_DIR := $(BASE_DIR)/host
222 GRAPHS_DIR := $(BASE_DIR)/graphs
223
224 LEGAL_INFO_DIR = $(BASE_DIR)/legal-info
225 REDIST_SOURCES_DIR_TARGET = $(LEGAL_INFO_DIR)/sources
226 REDIST_SOURCES_DIR_HOST = $(LEGAL_INFO_DIR)/host-sources
227 LICENSE_FILES_DIR_TARGET = $(LEGAL_INFO_DIR)/licenses
228 LICENSE_FILES_DIR_HOST = $(LEGAL_INFO_DIR)/host-licenses
229 LEGAL_MANIFEST_CSV_TARGET = $(LEGAL_INFO_DIR)/manifest.csv
230 LEGAL_MANIFEST_CSV_HOST = $(LEGAL_INFO_DIR)/host-manifest.csv
231 LEGAL_WARNINGS = $(LEGAL_INFO_DIR)/.warnings
232 LEGAL_REPORT = $(LEGAL_INFO_DIR)/README
233
234 ################################################################################
235 #
236 # staging and target directories do NOT list these as
237 # dependencies anywhere else
238 #
239 ################################################################################
240 $(BUILD_DIR) $(TARGET_DIR) $(BINARIES_DIR) $(LEGAL_INFO_DIR) $(REDIST_SOURCES_DIR_TARGET) $(REDIST_SOURCES_DIR_HOST):
241         @mkdir -p $@
242
243 BR2_CONFIG = $(CONFIG_DIR)/.config
244
245 # Pull in the user's configuration file
246 ifeq ($(filter $(noconfig_targets),$(MAKECMDGOALS)),)
247 -include $(BR2_CONFIG)
248 endif
249
250 # timezone and locale may affect build output
251 ifeq ($(BR2_REPRODUCIBLE),y)
252 export TZ = UTC
253 export LANG = C
254 export LC_ALL = C
255 export GZIP = -n
256 BR2_VERSION_GIT_EPOCH = $(shell GIT_DIR=$(TOPDIR)/.git $(GIT) log -1 --format=%at)
257 export SOURCE_DATE_EPOCH = $(if $(wildcard $(TOPDIR)/.git),$(BR2_VERSION_GIT_EPOCH),$(BR2_VERSION_EPOCH))
258 DEPENDENCIES_HOST_PREREQ += host-fakedate
259 endif
260
261 # To put more focus on warnings, be less verbose as default
262 # Use 'make V=1' to see the full commands
263 ifeq ("$(origin V)", "command line")
264   KBUILD_VERBOSE = $(V)
265 endif
266 ifndef KBUILD_VERBOSE
267   KBUILD_VERBOSE = 0
268 endif
269
270 ifeq ($(KBUILD_VERBOSE),1)
271   Q =
272 ifndef VERBOSE
273   VERBOSE = 1
274 endif
275 export VERBOSE
276 else
277   Q = @
278 endif
279
280 # kconfig uses CONFIG_SHELL
281 CONFIG_SHELL := $(SHELL)
282
283 export SHELL CONFIG_SHELL Q KBUILD_VERBOSE
284
285 ifndef HOSTAR
286 HOSTAR := ar
287 endif
288 ifndef HOSTAS
289 HOSTAS := as
290 endif
291 ifndef HOSTCC
292 HOSTCC := gcc
293 HOSTCC := $(shell which $(HOSTCC) || type -p $(HOSTCC) || echo gcc)
294 endif
295 HOSTCC_NOCCACHE := $(HOSTCC)
296 ifndef HOSTCXX
297 HOSTCXX := g++
298 HOSTCXX := $(shell which $(HOSTCXX) || type -p $(HOSTCXX) || echo g++)
299 endif
300 HOSTCXX_NOCCACHE := $(HOSTCXX)
301 ifndef HOSTCPP
302 HOSTCPP := cpp
303 endif
304 ifndef HOSTLD
305 HOSTLD := ld
306 endif
307 ifndef HOSTLN
308 HOSTLN := ln
309 endif
310 ifndef HOSTNM
311 HOSTNM := nm
312 endif
313 ifndef HOSTOBJCOPY
314 HOSTOBJCOPY := objcopy
315 endif
316 ifndef HOSTRANLIB
317 HOSTRANLIB := ranlib
318 endif
319 HOSTAR := $(shell which $(HOSTAR) || type -p $(HOSTAR) || echo ar)
320 HOSTAS := $(shell which $(HOSTAS) || type -p $(HOSTAS) || echo as)
321 HOSTCPP := $(shell which $(HOSTCPP) || type -p $(HOSTCPP) || echo cpp)
322 HOSTLD := $(shell which $(HOSTLD) || type -p $(HOSTLD) || echo ld)
323 HOSTLN := $(shell which $(HOSTLN) || type -p $(HOSTLN) || echo ln)
324 HOSTNM := $(shell which $(HOSTNM) || type -p $(HOSTNM) || echo nm)
325 HOSTOBJCOPY := $(shell which $(HOSTOBJCOPY) || type -p $(HOSTOBJCOPY) || echo objcopy)
326 HOSTRANLIB := $(shell which $(HOSTRANLIB) || type -p $(HOSTRANLIB) || echo ranlib)
327 SED := $(shell which sed || type -p sed) -i -e
328
329 export HOSTAR HOSTAS HOSTCC HOSTCXX HOSTLD
330 export HOSTCC_NOCCACHE HOSTCXX_NOCCACHE
331
332 # Determine the userland we are running on.
333 #
334 # Note that, despite its name, we are not interested in the actual
335 # architecture name. This is mostly used to determine whether some
336 # of the binary tools (e.g. pre-built external toolchains) can run
337 # on the current host. So we need to know if the userland we're
338 # running on can actually run those toolchains.
339 #
340 # For example, a 64-bit prebuilt toolchain will not run on a 64-bit
341 # kernel if the userland is 32-bit (e.g. in a chroot for example).
342 #
343 # So, we extract the first part of the tuple the host gcc was
344 # configured to generate code for; we assume this is our userland.
345 #
346 export HOSTARCH := $(shell LC_ALL=C $(HOSTCC_NOCCACHE) -v 2>&1 | \
347         sed -e '/^Target: \([^-]*\).*/!d' \
348             -e 's//\1/' \
349             -e 's/i.86/x86/' \
350             -e 's/sun4u/sparc64/' \
351             -e 's/arm.*/arm/' \
352             -e 's/sa110/arm/' \
353             -e 's/ppc64/powerpc64/' \
354             -e 's/ppc/powerpc/' \
355             -e 's/macppc/powerpc/' \
356             -e 's/sh.*/sh/' )
357
358 HOSTCC_VERSION := $(shell $(HOSTCC_NOCCACHE) --version | \
359         sed -n -r 's/^.* ([0-9]*)\.([0-9]*)\.([0-9]*)[ ]*.*/\1 \2/p')
360
361 # For gcc >= 5.x, we only need the major version.
362 ifneq ($(firstword $(HOSTCC_VERSION)),4)
363 HOSTCC_VERSION := $(firstword $(HOSTCC_VERSION))
364 endif
365
366 # Make sure pkg-config doesn't look outside the buildroot tree
367 HOST_PKG_CONFIG_PATH := $(PKG_CONFIG_PATH)
368 unexport PKG_CONFIG_PATH
369 unexport PKG_CONFIG_SYSROOT_DIR
370 unexport PKG_CONFIG_LIBDIR
371
372 # Having DESTDIR set in the environment confuses the installation
373 # steps of some packages.
374 unexport DESTDIR
375
376 # Causes breakage with packages that needs host-ruby
377 unexport RUBYOPT
378
379 include package/pkg-utils.mk
380 include package/doc-asciidoc.mk
381
382 ifeq ($(BR2_HAVE_DOT_CONFIG),y)
383
384 ################################################################################
385 #
386 # Hide troublesome environment variables from sub processes
387 #
388 ################################################################################
389 unexport CROSS_COMPILE
390 unexport ARCH
391 unexport CC
392 unexport LD
393 unexport AR
394 unexport CXX
395 unexport CPP
396 unexport RANLIB
397 unexport CFLAGS
398 unexport CXXFLAGS
399 unexport GREP_OPTIONS
400 unexport TAR_OPTIONS
401 unexport CONFIG_SITE
402 unexport QMAKESPEC
403 unexport TERMINFO
404 unexport MACHINE
405 unexport O
406 unexport GCC_COLORS
407
408 GNU_HOST_NAME := $(shell support/gnuconfig/config.guess)
409
410 PACKAGES :=
411 PACKAGES_ALL :=
412
413 # silent mode requested?
414 QUIET := $(if $(findstring s,$(filter-out --%,$(MAKEFLAGS))),-q)
415
416 # Strip off the annoying quoting
417 ARCH := $(call qstrip,$(BR2_ARCH))
418
419 KERNEL_ARCH := $(shell echo "$(ARCH)" | sed -e "s/-.*//" \
420         -e s/i.86/i386/ -e s/sun4u/sparc64/ \
421         -e s/arcle/arc/ \
422         -e s/arceb/arc/ \
423         -e s/arm.*/arm/ -e s/sa110/arm/ \
424         -e s/aarch64.*/arm64/ \
425         -e s/bfin/blackfin/ \
426         -e s/or1k/openrisc/ \
427         -e s/parisc64/parisc/ \
428         -e s/powerpc64.*/powerpc/ \
429         -e s/ppc.*/powerpc/ -e s/mips.*/mips/ \
430         -e s/sh.*/sh/ \
431         -e s/microblazeel/microblaze/)
432
433 ZCAT := $(call qstrip,$(BR2_ZCAT))
434 BZCAT := $(call qstrip,$(BR2_BZCAT))
435 XZCAT := $(call qstrip,$(BR2_XZCAT))
436 LZCAT := $(call qstrip,$(BR2_LZCAT))
437 TAR_OPTIONS = $(call qstrip,$(BR2_TAR_OPTIONS)) -xf
438
439 # packages compiled for the host go here
440 HOST_DIR := $(call qstrip,$(BR2_HOST_DIR))
441
442 # Quotes are needed for spaces and all in the original PATH content.
443 BR_PATH = "$(HOST_DIR)/bin:$(HOST_DIR)/sbin:$(PATH)"
444
445 # Location of a file giving a big fat warning that output/target
446 # should not be used as the root filesystem.
447 TARGET_DIR_WARNING_FILE = $(TARGET_DIR)/THIS_IS_NOT_YOUR_ROOT_FILESYSTEM
448
449 ifeq ($(BR2_CCACHE),y)
450 CCACHE := $(HOST_DIR)/bin/ccache
451 BR_CACHE_DIR ?= $(call qstrip,$(BR2_CCACHE_DIR))
452 export BR_CACHE_DIR
453 HOSTCC := $(CCACHE) $(HOSTCC)
454 HOSTCXX := $(CCACHE) $(HOSTCXX)
455 else
456 export BR_NO_CCACHE
457 endif
458
459 # Scripts in support/ or post-build scripts may need to reference
460 # these locations, so export them so it is easier to use
461 export BR2_CONFIG
462 export BR2_REPRODUCIBLE
463 export TARGET_DIR
464 export STAGING_DIR
465 export HOST_DIR
466 export BINARIES_DIR
467 export BASE_DIR
468
469 ################################################################################
470 #
471 # You should probably leave this stuff alone unless you know
472 # what you are doing.
473 #
474 ################################################################################
475
476 all: world
477
478 # Include legacy before the other things, because package .mk files
479 # may rely on it.
480 include Makefile.legacy
481
482 include package/Makefile.in
483 # arch/arch.mk.* must be after package/Makefile.in because it may need to
484 # complement variables defined therein, like BR_NO_CHECK_HASH_FOR.
485 -include $(wildcard arch/arch.mk.*)
486 include support/dependencies/dependencies.mk
487
488 include toolchain/*.mk
489 include toolchain/*/*.mk
490
491 # Include the package override file if one has been provided in the
492 # configuration.
493 PACKAGE_OVERRIDE_FILE = $(call qstrip,$(BR2_PACKAGE_OVERRIDE_FILE))
494 ifneq ($(PACKAGE_OVERRIDE_FILE),)
495 -include $(PACKAGE_OVERRIDE_FILE)
496 endif
497
498 include $(sort $(wildcard package/*/*.mk))
499
500 include boot/common.mk
501 include linux/linux.mk
502 include fs/common.mk
503
504 # If using a br2-external tree, the BR2_EXTERNAL_$(NAME)_PATH variables
505 # are also present in the .config file. Since .config is included after
506 # we defined them in the Makefile, the values for those variables are
507 # quoted. We just include the generated Makefile fragment .br2-external.mk
508 # a third time, which will set those variables to the un-quoted values.
509 include $(BR2_EXTERNAL_FILE)
510
511 # Nothing to include if no BR2_EXTERNAL tree in use
512 include $(BR2_EXTERNAL_MKS)
513
514 # Now we are sure we have all the packages scanned and defined. We now
515 # check for each package in the list of enabled packages, that all its
516 # dependencies are indeed enabled.
517 #
518 # Only trigger the check for default builds. If the user forces building
519 # a package, even if not enabled in the configuration, we want to accept
520 # it.
521 #
522 ifeq ($(MAKECMDGOALS),)
523
524 define CHECK_ONE_DEPENDENCY
525 ifeq ($$($(2)_TYPE),target)
526 ifeq ($$($(2)_IS_VIRTUAL),)
527 ifneq ($$($$($(2)_KCONFIG_VAR)),y)
528 $$(error $$($(2)_NAME) is in the dependency chain of $$($(1)_NAME) that \
529 has added it to its _DEPENDENCIES variable without selecting it or \
530 depending on it from Config.in)
531 endif
532 endif
533 endif
534 endef
535
536 $(foreach pkg,$(call UPPERCASE,$(PACKAGES)),\
537         $(foreach dep,$(call UPPERCASE,$($(pkg)_FINAL_ALL_DEPENDENCIES)),\
538                 $(eval $(call CHECK_ONE_DEPENDENCY,$(pkg),$(dep))$(sep))))
539
540 endif
541
542 .PHONY: dirs
543 dirs: $(BUILD_DIR) $(STAGING_DIR) $(TARGET_DIR) \
544         $(HOST_DIR) $(BINARIES_DIR)
545
546 $(BUILD_DIR)/buildroot-config/auto.conf: $(BR2_CONFIG)
547         $(MAKE1) $(EXTRAMAKEARGS) HOSTCC="$(HOSTCC_NOCCACHE)" HOSTCXX="$(HOSTCXX_NOCCACHE)" silentoldconfig
548
549 .PHONY: prepare
550 prepare: $(BUILD_DIR)/buildroot-config/auto.conf
551
552 .PHONY: world
553 world: target-post-image
554
555 # When creating HOST_DIR, also symlink usr -> .
556 $(HOST_DIR):
557         @mkdir -p $@
558         @ln -snf . $@/usr
559
560 # Populating the staging with the base directories is handled by the skeleton package
561 $(STAGING_DIR): | $(HOST_DIR)
562         @mkdir -p $(STAGING_DIR)
563         @ln -snf $(STAGING_DIR) $(BASE_DIR)/staging
564
565 RSYNC_VCS_EXCLUSIONS = \
566         --exclude .svn --exclude .git --exclude .hg --exclude .bzr \
567         --exclude CVS
568
569 STRIP_FIND_CMD = find $(TARGET_DIR)
570 ifneq (,$(call qstrip,$(BR2_STRIP_EXCLUDE_DIRS)))
571 STRIP_FIND_CMD += \( $(call finddirclauses,$(TARGET_DIR),$(call qstrip,$(BR2_STRIP_EXCLUDE_DIRS))) \) -prune -o
572 endif
573 STRIP_FIND_CMD += -type f \( -perm /111 -o -name '*.so*' \)
574 # file exclusions:
575 # - libpthread.so: a non-stripped libpthread shared library is needed for
576 #   proper debugging of pthread programs using gdb.
577 # - ld.so: a non-stripped dynamic linker library is needed for valgrind
578 # - kernel modules (*.ko): do not function properly when stripped like normal
579 #   applications and libraries. Normally kernel modules are already excluded
580 #   by the executable permission check above, so the explicit exclusion is only
581 #   done for kernel modules with incorrect permissions.
582 STRIP_FIND_CMD += -not \( $(call findfileclauses,libpthread*.so* ld-*.so* *.ko $(call qstrip,$(BR2_STRIP_EXCLUDE_FILES))) \) -print0
583
584 ifeq ($(BR2_ECLIPSE_REGISTER),y)
585 define TOOLCHAIN_ECLIPSE_REGISTER
586         ./support/scripts/eclipse-register-toolchain `readlink -f $(O)` \
587                 $(notdir $(TARGET_CROSS)) $(BR2_ARCH)
588 endef
589 TARGET_FINALIZE_HOOKS += TOOLCHAIN_ECLIPSE_REGISTER
590 endif
591
592 # Generate locale data. Basically, we call the localedef program
593 # (built by the host-localedef package) for each locale. The input
594 # data comes preferably from the toolchain, or if the toolchain does
595 # not have them (Linaro toolchains), we use the ones available on the
596 # host machine.
597 ifeq ($(BR2_TOOLCHAIN_USES_GLIBC),y)
598 GLIBC_GENERATE_LOCALES = $(call qstrip,$(BR2_GENERATE_LOCALE))
599 ifneq ($(GLIBC_GENERATE_LOCALES),)
600 PACKAGES += host-localedef
601
602 define GENERATE_GLIBC_LOCALES
603         $(Q)mkdir -p $(TARGET_DIR)/usr/lib/locale/
604         $(Q)for locale in $(GLIBC_GENERATE_LOCALES) ; do \
605                 inputfile=`echo $${locale} | cut -f1 -d'.'` ; \
606                 charmap=`echo $${locale} | cut -f2 -d'.' -s` ; \
607                 if test -z "$${charmap}" ; then \
608                         charmap="UTF-8" ; \
609                 fi ; \
610                 echo "Generating locale $${inputfile}.$${charmap}" ; \
611                 I18NPATH=$(STAGING_DIR)/usr/share/i18n:/usr/share/i18n \
612                 $(HOST_DIR)/bin/localedef \
613                         --prefix=$(TARGET_DIR) \
614                         --$(call LOWERCASE,$(BR2_ENDIAN))-endian \
615                         -i $${inputfile} -f $${charmap} \
616                         $${locale} ; \
617         done
618 endef
619 TARGET_FINALIZE_HOOKS += GENERATE_GLIBC_LOCALES
620 endif
621 endif
622
623 ifeq ($(BR2_ENABLE_LOCALE_PURGE),y)
624 LOCALE_WHITELIST = $(BUILD_DIR)/locales.nopurge
625 LOCALE_NOPURGE = $(call qstrip,$(BR2_ENABLE_LOCALE_WHITELIST))
626
627 # This piece of junk does the following:
628 # First collect the whitelist in a file.
629 # Then go over all the locale dirs and for each subdir, check if it exists
630 # in the whitelist file. If it doesn't, kill it.
631 # Finally, specifically for X11, regenerate locale.dir from the whitelist.
632 define PURGE_LOCALES
633         rm -f $(LOCALE_WHITELIST)
634         for i in $(LOCALE_NOPURGE) locale-archive; do echo $$i >> $(LOCALE_WHITELIST); done
635
636         for dir in $(wildcard $(addprefix $(TARGET_DIR),/usr/share/locale /usr/share/X11/locale /usr/lib/locale)); \
637         do \
638                 for langdir in $$dir/*; \
639                 do \
640                         if [ -e "$${langdir}" ]; \
641                         then \
642                                 grep -qx "$${langdir##*/}" $(LOCALE_WHITELIST) || rm -rf $$langdir; \
643                         fi \
644                 done; \
645         done
646         if [ -d $(TARGET_DIR)/usr/share/X11/locale ]; \
647         then \
648                 for lang in $(LOCALE_NOPURGE); \
649                 do \
650                         if [ -f $(TARGET_DIR)/usr/share/X11/locale/$$lang/XLC_LOCALE ]; \
651                         then \
652                                 echo "$$lang/XLC_LOCALE: $$lang"; \
653                         fi \
654                 done > $(TARGET_DIR)/usr/share/X11/locale/locale.dir; \
655         fi
656 endef
657 TARGET_FINALIZE_HOOKS += PURGE_LOCALES
658 endif
659
660 $(TARGETS_ROOTFS): target-finalize
661
662 .PHONY: target-finalize
663 target-finalize: $(PACKAGES)
664         @$(call MESSAGE,"Finalizing target directory")
665         $(foreach hook,$(TARGET_FINALIZE_HOOKS),$($(hook))$(sep))
666         rm -rf $(TARGET_DIR)/usr/include $(TARGET_DIR)/usr/share/aclocal \
667                 $(TARGET_DIR)/usr/lib/pkgconfig $(TARGET_DIR)/usr/share/pkgconfig \
668                 $(TARGET_DIR)/usr/lib/cmake $(TARGET_DIR)/usr/share/cmake
669         find $(TARGET_DIR)/usr/{lib,share}/ -name '*.cmake' -print0 | xargs -0 rm -f
670         find $(TARGET_DIR)/lib/ $(TARGET_DIR)/usr/lib/ $(TARGET_DIR)/usr/libexec/ \
671                 \( -name '*.a' -o -name '*.la' \) -print0 | xargs -0 rm -f
672 ifneq ($(BR2_PACKAGE_GDB),y)
673         rm -rf $(TARGET_DIR)/usr/share/gdb
674 endif
675 ifneq ($(BR2_PACKAGE_BASH),y)
676         rm -rf $(TARGET_DIR)/usr/share/bash-completion
677 endif
678 ifneq ($(BR2_PACKAGE_ZSH),y)
679         rm -rf $(TARGET_DIR)/usr/share/zsh
680 endif
681         rm -rf $(TARGET_DIR)/usr/man $(TARGET_DIR)/usr/share/man
682         rm -rf $(TARGET_DIR)/usr/info $(TARGET_DIR)/usr/share/info
683         rm -rf $(TARGET_DIR)/usr/doc $(TARGET_DIR)/usr/share/doc
684         rm -rf $(TARGET_DIR)/usr/share/gtk-doc
685         rmdir $(TARGET_DIR)/usr/share 2>/dev/null || true
686         $(STRIP_FIND_CMD) | xargs -0 $(STRIPCMD) 2>/dev/null || true
687
688 # See http://sourceware.org/gdb/wiki/FAQ, "GDB does not see any threads
689 # besides the one in which crash occurred; or SIGTRAP kills my program when
690 # I set a breakpoint"
691 ifeq ($(BR2_TOOLCHAIN_HAS_THREADS),y)
692         find $(TARGET_DIR)/lib/ -type f -name 'libpthread*.so*' | \
693                 xargs -r $(STRIPCMD) $(STRIP_STRIP_DEBUG)
694 endif
695
696 # Valgrind needs ld.so with enough information, so only strip
697 # debugging symbols.
698         find $(TARGET_DIR)/lib/ -type f -name 'ld-*.so*' | \
699                 xargs -r $(STRIPCMD) $(STRIP_STRIP_DEBUG)
700         test -f $(TARGET_DIR)/etc/ld.so.conf && \
701                 { echo "ERROR: we shouldn't have a /etc/ld.so.conf file"; exit 1; } || true
702         test -d $(TARGET_DIR)/etc/ld.so.conf.d && \
703                 { echo "ERROR: we shouldn't have a /etc/ld.so.conf.d directory"; exit 1; } || true
704         mkdir -p $(TARGET_DIR)/etc
705         ( \
706                 echo "NAME=Buildroot"; \
707                 echo "VERSION=$(BR2_VERSION_FULL)"; \
708                 echo "ID=buildroot"; \
709                 echo "VERSION_ID=$(BR2_VERSION)"; \
710                 echo "PRETTY_NAME=\"Buildroot $(BR2_VERSION)\"" \
711         ) >  $(TARGET_DIR)/etc/os-release
712
713         @$(foreach d, $(call qstrip,$(BR2_ROOTFS_OVERLAY)), \
714                 $(call MESSAGE,"Copying overlay $(d)"); \
715                 rsync -a --ignore-times --keep-dirlinks $(RSYNC_VCS_EXCLUSIONS) \
716                         --chmod=u=rwX,go=rX --exclude .empty --exclude '*~' \
717                         $(d)/ $(TARGET_DIR)$(sep))
718
719         @$(foreach s, $(call qstrip,$(BR2_ROOTFS_POST_BUILD_SCRIPT)), \
720                 $(call MESSAGE,"Executing post-build script $(s)"); \
721                 $(EXTRA_ENV) $(s) $(TARGET_DIR) $(call qstrip,$(BR2_ROOTFS_POST_SCRIPT_ARGS))$(sep))
722
723 .PHONY: target-post-image
724 target-post-image: $(TARGETS_ROOTFS) target-finalize
725         @$(foreach s, $(call qstrip,$(BR2_ROOTFS_POST_IMAGE_SCRIPT)), \
726                 $(call MESSAGE,"Executing post-image script $(s)"); \
727                 $(EXTRA_ENV) $(s) $(BINARIES_DIR) $(call qstrip,$(BR2_ROOTFS_POST_SCRIPT_ARGS))$(sep))
728
729 .PHONY: source
730 source: $(foreach p,$(PACKAGES),$(p)-all-source)
731
732 .PHONY: _external-deps external-deps
733 _external-deps: $(foreach p,$(PACKAGES),$(p)-all-external-deps)
734 external-deps:
735         @$(MAKE1) -Bs $(EXTRAMAKEARGS) _external-deps | sort -u
736
737 # check if download URLs are outdated
738 .PHONY: source-check
739 source-check: $(foreach p,$(PACKAGES),$(p)-all-source-check)
740
741 .PHONY: legal-info-clean
742 legal-info-clean:
743         @rm -fr $(LEGAL_INFO_DIR)
744
745 .PHONY: legal-info-prepare
746 legal-info-prepare: $(LEGAL_INFO_DIR)
747         @$(call MESSAGE,"Collecting legal info")
748         @$(call legal-license-file,buildroot,buildroot,.,COPYING,COPYING,HOST)
749         @$(call legal-manifest,PACKAGE,VERSION,LICENSE,LICENSE FILES,SOURCE ARCHIVE,SOURCE SITE,TARGET)
750         @$(call legal-manifest,PACKAGE,VERSION,LICENSE,LICENSE FILES,SOURCE ARCHIVE,SOURCE SITE,HOST)
751         @$(call legal-manifest,buildroot,$(BR2_VERSION_FULL),GPL-2.0+,COPYING,not saved,not saved,HOST)
752         @$(call legal-warning,the Buildroot source code has not been saved)
753         @cp $(BR2_CONFIG) $(LEGAL_INFO_DIR)/buildroot.config
754
755 .PHONY: legal-info
756 legal-info: dirs legal-info-clean legal-info-prepare $(foreach p,$(PACKAGES),$(p)-all-legal-info) \
757                 $(REDIST_SOURCES_DIR_TARGET) $(REDIST_SOURCES_DIR_HOST)
758         @cat support/legal-info/README.header >>$(LEGAL_REPORT)
759         @if [ -r $(LEGAL_WARNINGS) ]; then \
760                 cat support/legal-info/README.warnings-header \
761                         $(LEGAL_WARNINGS) >>$(LEGAL_REPORT); \
762                 cat $(LEGAL_WARNINGS); fi
763         @rm -f $(LEGAL_WARNINGS)
764         @(cd $(LEGAL_INFO_DIR); \
765                 find * -type f -exec sha256sum {} + | LC_ALL=C sort -k2 \
766                         >.legal-info.sha256; \
767                 mv .legal-info.sha256 legal-info.sha256)
768         @echo "Legal info produced in $(LEGAL_INFO_DIR)"
769
770 .PHONY: show-targets
771 show-targets:
772         @echo $(PACKAGES) $(TARGETS_ROOTFS)
773
774 .PHONY: show-build-order
775 show-build-order: $(patsubst %,%-show-build-order,$(PACKAGES))
776
777 .PHONY: graph-build
778 graph-build: $(O)/build/build-time.log
779         @install -d $(GRAPHS_DIR)
780         $(foreach o,name build duration,./support/scripts/graph-build-time \
781                                         --type=histogram --order=$(o) --input=$(<) \
782                                         --output=$(GRAPHS_DIR)/build.hist-$(o).$(BR_GRAPH_OUT) \
783                                         $(if $(BR2_GRAPH_ALT),--alternate-colors)$(sep))
784         $(foreach t,packages steps,./support/scripts/graph-build-time \
785                                    --type=pie-$(t) --input=$(<) \
786                                    --output=$(GRAPHS_DIR)/build.pie-$(t).$(BR_GRAPH_OUT) \
787                                    $(if $(BR2_GRAPH_ALT),--alternate-colors)$(sep))
788
789 .PHONY: graph-depends-requirements
790 graph-depends-requirements:
791         @dot -? >/dev/null 2>&1 || \
792                 { echo "ERROR: The 'dot' program from Graphviz is needed for graph-depends" >&2; exit 1; }
793
794 .PHONY: graph-depends
795 graph-depends: graph-depends-requirements
796         @$(INSTALL) -d $(GRAPHS_DIR)
797         @cd "$(CONFIG_DIR)"; \
798         $(TOPDIR)/support/scripts/graph-depends $(BR2_GRAPH_DEPS_OPTS) \
799                 --direct -o $(GRAPHS_DIR)/$(@).dot
800         dot $(BR2_GRAPH_DOT_OPTS) -T$(BR_GRAPH_OUT) \
801                 -o $(GRAPHS_DIR)/$(@).$(BR_GRAPH_OUT) \
802                 $(GRAPHS_DIR)/$(@).dot
803
804 .PHONY: graph-size
805 graph-size:
806         $(Q)mkdir -p $(GRAPHS_DIR)
807         $(Q)$(TOPDIR)/support/scripts/size-stats --builddir $(BASE_DIR) \
808                 --graph $(GRAPHS_DIR)/graph-size.$(BR_GRAPH_OUT) \
809                 --file-size-csv $(GRAPHS_DIR)/file-size-stats.csv \
810                 --package-size-csv $(GRAPHS_DIR)/package-size-stats.csv
811
812 .PHONY: check-dependencies
813 check-dependencies:
814         @cd "$(CONFIG_DIR)"; \
815         $(TOPDIR)/support/scripts/graph-depends -C
816
817 else # ifeq ($(BR2_HAVE_DOT_CONFIG),y)
818
819 # Some subdirectories are also package names. To avoid that "make linux"
820 # on an unconfigured tree produces "Nothing to be done", add an explicit
821 # rule for it.
822 # Also for 'all' we error out and ask the user to configure first.
823 .PHONY: linux toolchain
824 linux toolchain all: outputmakefile
825         $(error Please configure Buildroot first (e.g. "make menuconfig"))
826         @exit 1
827
828 endif # ifeq ($(BR2_HAVE_DOT_CONFIG),y)
829
830 # configuration
831 # ---------------------------------------------------------------------------
832
833 HOSTCFLAGS = $(CFLAGS_FOR_BUILD)
834 export HOSTCFLAGS
835
836 .PHONY: prepare-kconfig
837 prepare-kconfig: outputmakefile $(BUILD_DIR)/.br2-external.in
838
839 $(BUILD_DIR)/buildroot-config/%onf:
840         mkdir -p $(@D)/lxdialog
841         PKG_CONFIG_PATH="$(HOST_PKG_CONFIG_PATH)" $(MAKE) CC="$(HOSTCC_NOCCACHE)" HOSTCC="$(HOSTCC_NOCCACHE)" \
842             obj=$(@D) -C $(CONFIG) -f Makefile.br $(@F)
843
844 DEFCONFIG = $(call qstrip,$(BR2_DEFCONFIG))
845
846 # We don't want to fully expand BR2_DEFCONFIG here, so Kconfig will
847 # recognize that if it's still at its default $(CONFIG_DIR)/defconfig
848 COMMON_CONFIG_ENV = \
849         BR2_DEFCONFIG='$(call qstrip,$(value BR2_DEFCONFIG))' \
850         KCONFIG_AUTOCONFIG=$(BUILD_DIR)/buildroot-config/auto.conf \
851         KCONFIG_AUTOHEADER=$(BUILD_DIR)/buildroot-config/autoconf.h \
852         KCONFIG_TRISTATE=$(BUILD_DIR)/buildroot-config/tristate.config \
853         BR2_CONFIG=$(BR2_CONFIG) \
854         HOST_GCC_VERSION="$(HOSTCC_VERSION)" \
855         BUILD_DIR=$(BUILD_DIR) \
856         SKIP_LEGACY=
857
858 xconfig: $(BUILD_DIR)/buildroot-config/qconf prepare-kconfig
859         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
860
861 gconfig: $(BUILD_DIR)/buildroot-config/gconf prepare-kconfig
862         @$(COMMON_CONFIG_ENV) srctree=$(TOPDIR) $< $(CONFIG_CONFIG_IN)
863
864 menuconfig: $(BUILD_DIR)/buildroot-config/mconf prepare-kconfig
865         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
866
867 nconfig: $(BUILD_DIR)/buildroot-config/nconf prepare-kconfig
868         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
869
870 config: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
871         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
872
873 # For the config targets that automatically select options, we pass
874 # SKIP_LEGACY=y to disable the legacy options. However, in that case
875 # no values are set for the legacy options so a subsequent oldconfig
876 # will query them. Therefore, run an additional olddefconfig.
877
878 oldconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
879         @$(COMMON_CONFIG_ENV) $< --oldconfig $(CONFIG_CONFIG_IN)
880
881 randconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
882         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y $< --randconfig $(CONFIG_CONFIG_IN)
883         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
884
885 allyesconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
886         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y $< --allyesconfig $(CONFIG_CONFIG_IN)
887         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
888
889 allnoconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
890         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y $< --allnoconfig $(CONFIG_CONFIG_IN)
891         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
892
893 randpackageconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
894         @grep -v BR2_PACKAGE_ $(BR2_CONFIG) > $(CONFIG_DIR)/.config.nopkg
895         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y \
896                 KCONFIG_ALLCONFIG=$(CONFIG_DIR)/.config.nopkg \
897                 $< --randconfig $(CONFIG_CONFIG_IN)
898         @rm -f $(CONFIG_DIR)/.config.nopkg
899         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
900
901 allyespackageconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
902         @grep -v BR2_PACKAGE_ $(BR2_CONFIG) > $(CONFIG_DIR)/.config.nopkg
903         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y \
904                 KCONFIG_ALLCONFIG=$(CONFIG_DIR)/.config.nopkg \
905                 $< --allyesconfig $(CONFIG_CONFIG_IN)
906         @rm -f $(CONFIG_DIR)/.config.nopkg
907         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
908
909 allnopackageconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
910         @grep -v BR2_PACKAGE_ $(BR2_CONFIG) > $(CONFIG_DIR)/.config.nopkg
911         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y \
912                 KCONFIG_ALLCONFIG=$(CONFIG_DIR)/.config.nopkg \
913                 $< --allnoconfig $(CONFIG_CONFIG_IN)
914         @rm -f $(CONFIG_DIR)/.config.nopkg
915         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
916
917 silentoldconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
918         $(COMMON_CONFIG_ENV) $< --silentoldconfig $(CONFIG_CONFIG_IN)
919
920 olddefconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
921         $(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN)
922
923 defconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
924         @$(COMMON_CONFIG_ENV) $< --defconfig$(if $(DEFCONFIG),=$(DEFCONFIG)) $(CONFIG_CONFIG_IN)
925
926 define percent_defconfig
927 # Override the BR2_DEFCONFIG from COMMON_CONFIG_ENV with the new defconfig
928 %_defconfig: $(BUILD_DIR)/buildroot-config/conf $(1)/configs/%_defconfig prepare-kconfig
929         @$$(COMMON_CONFIG_ENV) BR2_DEFCONFIG=$(1)/configs/$$@ \
930                 $$< --defconfig=$(1)/configs/$$@ $$(CONFIG_CONFIG_IN)
931 endef
932 $(eval $(foreach d,$(call reverse,$(TOPDIR) $(BR2_EXTERNAL_DIRS)),$(call percent_defconfig,$(d))$(sep)))
933
934 savedefconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
935         @$(COMMON_CONFIG_ENV) $< \
936                 --savedefconfig=$(if $(DEFCONFIG),$(DEFCONFIG),$(CONFIG_DIR)/defconfig) \
937                 $(CONFIG_CONFIG_IN)
938         @$(SED) '/BR2_DEFCONFIG=/d' $(if $(DEFCONFIG),$(DEFCONFIG),$(CONFIG_DIR)/defconfig)
939
940 .PHONY: defconfig savedefconfig
941
942 ################################################################################
943 #
944 # Cleanup and misc junk
945 #
946 ################################################################################
947
948 # outputmakefile generates a Makefile in the output directory, if using a
949 # separate output directory. This allows convenient use of make in the
950 # output directory.
951 .PHONY: outputmakefile
952 outputmakefile:
953 ifeq ($(NEED_WRAPPER),y)
954         $(Q)$(TOPDIR)/support/scripts/mkmakefile $(TOPDIR) $(O)
955 endif
956
957 # Even though the target is a real file, we mark it as PHONY as we
958 # want it to be re-generated each time make is invoked, in case the
959 # value of BR2_EXTERNAL is changed.
960 .PHONY: $(BUILD_DIR)/.br2-external.in
961 $(BUILD_DIR)/.br2-external.in: $(BUILD_DIR)
962         $(Q)support/scripts/br2-external -k -o "$(@)" $(BR2_EXTERNAL)
963
964 # printvars prints all the variables currently defined in our
965 # Makefiles. Alternatively, if a non-empty VARS variable is passed,
966 # only the variables matching the make pattern passed in VARS are
967 # displayed.
968 .PHONY: printvars
969 printvars:
970         @:$(foreach V, \
971                 $(sort $(if $(VARS),$(filter $(VARS),$(.VARIABLES)),$(.VARIABLES))), \
972                 $(if $(filter-out environment% default automatic, \
973                                 $(origin $V)), \
974                 $(if $(QUOTED_VARS),\
975                         $(info $V='$(subst ','\'',$(if $(RAW_VARS),$(value $V),$($V)))'), \
976                         $(info $V=$(if $(RAW_VARS),$(value $V),$($V))))))
977 # ' Syntax colouring...
978
979 .PHONY: clean
980 clean:
981         rm -rf $(TARGET_DIR) $(BINARIES_DIR) $(HOST_DIR) \
982                 $(BUILD_DIR) $(BASE_DIR)/staging \
983                 $(LEGAL_INFO_DIR) $(GRAPHS_DIR)
984
985 .PHONY: distclean
986 distclean: clean
987 ifeq ($(O),$(CURDIR)/output)
988         rm -rf $(O)
989 endif
990         rm -rf $(TOPDIR)/dl $(BR2_CONFIG) $(CONFIG_DIR)/.config.old $(CONFIG_DIR)/..config.tmp \
991                 $(CONFIG_DIR)/.auto.deps $(BR2_EXTERNAL_FILE)
992
993 .PHONY: help
994 help:
995         @echo 'Cleaning:'
996         @echo '  clean                  - delete all files created by build'
997         @echo '  distclean              - delete all non-source files (including .config)'
998         @echo
999         @echo 'Build:'
1000         @echo '  all                    - make world'
1001         @echo '  toolchain              - build toolchain'
1002         @echo
1003         @echo 'Configuration:'
1004         @echo '  menuconfig             - interactive curses-based configurator'
1005         @echo '  nconfig                - interactive ncurses-based configurator'
1006         @echo '  xconfig                - interactive Qt-based configurator'
1007         @echo '  gconfig                - interactive GTK-based configurator'
1008         @echo '  oldconfig              - resolve any unresolved symbols in .config'
1009         @echo '  silentoldconfig        - Same as oldconfig, but quietly, additionally update deps'
1010         @echo '  olddefconfig           - Same as silentoldconfig but sets new symbols to their default value'
1011         @echo '  randconfig             - New config with random answer to all options'
1012         @echo '  defconfig              - New config with default answer to all options'
1013         @echo '                             BR2_DEFCONFIG, if set, is used as input'
1014         @echo '  savedefconfig          - Save current config to BR2_DEFCONFIG (minimal config)'
1015         @echo '  allyesconfig           - New config where all options are accepted with yes'
1016         @echo '  allnoconfig            - New config where all options are answered with no'
1017         @echo '  randpackageconfig      - New config with random answer to package options'
1018         @echo '  allyespackageconfig    - New config where pkg options are accepted with yes'
1019         @echo '  allnopackageconfig     - New config where package options are answered with no'
1020         @echo
1021         @echo 'Package-specific:'
1022         @echo '  <pkg>                  - Build and install <pkg> and all its dependencies'
1023         @echo '  <pkg>-source           - Only download the source files for <pkg>'
1024         @echo '  <pkg>-extract          - Extract <pkg> sources'
1025         @echo '  <pkg>-patch            - Apply patches to <pkg>'
1026         @echo '  <pkg>-depends          - Build <pkg>'\''s dependencies'
1027         @echo '  <pkg>-configure        - Build <pkg> up to the configure step'
1028         @echo '  <pkg>-build            - Build <pkg> up to the build step'
1029         @echo '  <pkg>-show-depends     - List packages on which <pkg> depends'
1030         @echo '  <pkg>-show-rdepends    - List packages which have <pkg> as a dependency'
1031         @echo '  <pkg>-graph-depends    - Generate a graph of <pkg>'\''s dependencies'
1032         @echo '  <pkg>-graph-rdepends   - Generate a graph of <pkg>'\''s reverse dependencies'
1033         @echo '  <pkg>-dirclean         - Remove <pkg> build directory'
1034         @echo '  <pkg>-reconfigure      - Restart the build from the configure step'
1035         @echo '  <pkg>-rebuild          - Restart the build from the build step'
1036         $(foreach p,$(HELP_PACKAGES), \
1037                 @echo $(sep) \
1038                 @echo '$($(p)_NAME):' $(sep) \
1039                 $($(p)_HELP_CMDS)$(sep))
1040         @echo
1041         @echo 'Documentation:'
1042         @echo '  manual                 - build manual in all formats'
1043         @echo '  manual-html            - build manual in HTML'
1044         @echo '  manual-split-html      - build manual in split HTML'
1045         @echo '  manual-pdf             - build manual in PDF'
1046         @echo '  manual-text            - build manual in text'
1047         @echo '  manual-epub            - build manual in ePub'
1048         @echo '  graph-build            - generate graphs of the build times'
1049         @echo '  graph-depends          - generate graph of the dependency tree'
1050         @echo '  graph-size             - generate stats of the filesystem size'
1051         @echo '  list-defconfigs        - list all defconfigs (pre-configured minimal systems)'
1052         @echo
1053         @echo 'Miscellaneous:'
1054         @echo '  source                 - download all sources needed for offline-build'
1055         @echo '  source-check           - check selected packages for valid download URLs'
1056         @echo '  external-deps          - list external packages used'
1057         @echo '  legal-info             - generate info about license compliance'
1058         @echo '  printvars              - dump all the internal variables'
1059         @echo
1060         @echo '  make V=0|1             - 0 => quiet build (default), 1 => verbose build'
1061         @echo '  make O=dir             - Locate all output files in "dir", including .config'
1062         @echo
1063         @echo 'For further details, see README, generate the Buildroot manual, or consult'
1064         @echo 'it on-line at http://buildroot.org/docs.html'
1065         @echo
1066
1067 # List the defconfig files
1068 # $(1): base directory
1069 # $(2): br2-external name, empty for bundled
1070 define list-defconfigs
1071         @first=true; \
1072         for defconfig in $(1)/configs/*_defconfig; do \
1073                 [ -f "$${defconfig}" ] || continue; \
1074                 if $${first}; then \
1075                         if [ "$(2)" ]; then \
1076                                 printf 'External configs in "$(call qstrip,$(2))":\n'; \
1077                         else \
1078                                 printf "Built-in configs:\n"; \
1079                         fi; \
1080                         first=false; \
1081                 fi; \
1082                 defconfig="$${defconfig##*/}"; \
1083                 printf "  %-35s - Build for %s\n" "$${defconfig}" "$${defconfig%_defconfig}"; \
1084         done; \
1085         $${first} || printf "\n"
1086 endef
1087
1088 # We iterate over BR2_EXTERNAL_NAMES rather than BR2_EXTERNAL_DIRS,
1089 # because we want to display the name of the br2-external tree.
1090 .PHONY: list-defconfigs
1091 list-defconfigs:
1092         $(call list-defconfigs,$(TOPDIR))
1093         $(foreach name,$(BR2_EXTERNAL_NAMES),\
1094                 $(call list-defconfigs,$(BR2_EXTERNAL_$(name)_PATH),\
1095                         $(BR2_EXTERNAL_$(name)_DESC))$(sep))
1096
1097 release: OUT = buildroot-$(BR2_VERSION)
1098
1099 # Create release tarballs. We need to fiddle a bit to add the generated
1100 # documentation to the git output
1101 release:
1102         git archive --format=tar --prefix=$(OUT)/ HEAD > $(OUT).tar
1103         $(MAKE) O=$(OUT) manual-html manual-text manual-pdf
1104         $(MAKE) O=$(OUT) manual-clean
1105         tar rf $(OUT).tar $(OUT)
1106         gzip -9 -c < $(OUT).tar > $(OUT).tar.gz
1107         bzip2 -9 -c < $(OUT).tar > $(OUT).tar.bz2
1108         rm -rf $(OUT) $(OUT).tar
1109
1110 print-version:
1111         @echo $(BR2_VERSION_FULL)
1112
1113 .PHONY: .gitlab-ci.yml
1114 .gitlab-ci.yml: .gitlab-ci.yml.in
1115         cp $< $@
1116         (cd configs; LC_ALL=C ls -1 *_defconfig) | sed 's/$$/: *defconfig/' >> $@
1117         ./support/testing/run-tests -l 2>&1 | sed -r -e '/^test_run \((.*)\).*/!d; s//\1: *runtime_test/' | LC_ALL=C sort >> $@
1118
1119 include docs/manual/manual.mk
1120 -include $(foreach dir,$(BR2_EXTERNAL_DIRS),$(dir)/docs/*/*.mk)
1121
1122 .PHONY: $(noconfig_targets)
1123
1124 endif #umask / $(CURDIR) / $(O)