]> rtime.felk.cvut.cz Git - coffee/buildroot.git/blob - Makefile
Makefile: properly create $(HOST_DIR)/usr compatibility symlink
[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) $(HOST_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) $(HOST_DIR)/usr $(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 # Compatibility symlink in case a post-build script still uses $(HOST_DIR)/usr
556 $(HOST_DIR)/usr: $(HOST_DIR)
557         @ln -snf . $@
558
559 # Populating the staging with the base directories is handled by the skeleton package
560 $(STAGING_DIR):
561         @mkdir -p $(STAGING_DIR)
562         @ln -snf $(STAGING_DIR) $(BASE_DIR)/staging
563
564 RSYNC_VCS_EXCLUSIONS = \
565         --exclude .svn --exclude .git --exclude .hg --exclude .bzr \
566         --exclude CVS
567
568 STRIP_FIND_CMD = find $(TARGET_DIR)
569 ifneq (,$(call qstrip,$(BR2_STRIP_EXCLUDE_DIRS)))
570 STRIP_FIND_CMD += \( $(call finddirclauses,$(TARGET_DIR),$(call qstrip,$(BR2_STRIP_EXCLUDE_DIRS))) \) -prune -o
571 endif
572 STRIP_FIND_CMD += -type f \( -perm /111 -o -name '*.so*' \)
573 # file exclusions:
574 # - libpthread.so: a non-stripped libpthread shared library is needed for
575 #   proper debugging of pthread programs using gdb.
576 # - ld.so: a non-stripped dynamic linker library is needed for valgrind
577 # - kernel modules (*.ko): do not function properly when stripped like normal
578 #   applications and libraries. Normally kernel modules are already excluded
579 #   by the executable permission check above, so the explicit exclusion is only
580 #   done for kernel modules with incorrect permissions.
581 STRIP_FIND_CMD += -not \( $(call findfileclauses,libpthread*.so* ld-*.so* *.ko $(call qstrip,$(BR2_STRIP_EXCLUDE_FILES))) \) -print0
582
583 ifeq ($(BR2_ECLIPSE_REGISTER),y)
584 define TOOLCHAIN_ECLIPSE_REGISTER
585         ./support/scripts/eclipse-register-toolchain `readlink -f $(O)` \
586                 $(notdir $(TARGET_CROSS)) $(BR2_ARCH)
587 endef
588 TARGET_FINALIZE_HOOKS += TOOLCHAIN_ECLIPSE_REGISTER
589 endif
590
591 # Generate locale data. Basically, we call the localedef program
592 # (built by the host-localedef package) for each locale. The input
593 # data comes preferably from the toolchain, or if the toolchain does
594 # not have them (Linaro toolchains), we use the ones available on the
595 # host machine.
596 ifeq ($(BR2_TOOLCHAIN_USES_GLIBC),y)
597 GLIBC_GENERATE_LOCALES = $(call qstrip,$(BR2_GENERATE_LOCALE))
598 ifneq ($(GLIBC_GENERATE_LOCALES),)
599 PACKAGES += host-localedef
600
601 define GENERATE_GLIBC_LOCALES
602         $(Q)mkdir -p $(TARGET_DIR)/usr/lib/locale/
603         $(Q)for locale in $(GLIBC_GENERATE_LOCALES) ; do \
604                 inputfile=`echo $${locale} | cut -f1 -d'.'` ; \
605                 charmap=`echo $${locale} | cut -f2 -d'.' -s` ; \
606                 if test -z "$${charmap}" ; then \
607                         charmap="UTF-8" ; \
608                 fi ; \
609                 echo "Generating locale $${inputfile}.$${charmap}" ; \
610                 I18NPATH=$(STAGING_DIR)/usr/share/i18n:/usr/share/i18n \
611                 $(HOST_DIR)/bin/localedef \
612                         --prefix=$(TARGET_DIR) \
613                         --$(call LOWERCASE,$(BR2_ENDIAN))-endian \
614                         -i $${inputfile} -f $${charmap} \
615                         $${locale} ; \
616         done
617 endef
618 TARGET_FINALIZE_HOOKS += GENERATE_GLIBC_LOCALES
619 endif
620 endif
621
622 ifeq ($(BR2_ENABLE_LOCALE_PURGE),y)
623 LOCALE_WHITELIST = $(BUILD_DIR)/locales.nopurge
624 LOCALE_NOPURGE = $(call qstrip,$(BR2_ENABLE_LOCALE_WHITELIST))
625
626 # This piece of junk does the following:
627 # First collect the whitelist in a file.
628 # Then go over all the locale dirs and for each subdir, check if it exists
629 # in the whitelist file. If it doesn't, kill it.
630 # Finally, specifically for X11, regenerate locale.dir from the whitelist.
631 define PURGE_LOCALES
632         rm -f $(LOCALE_WHITELIST)
633         for i in $(LOCALE_NOPURGE) locale-archive; do echo $$i >> $(LOCALE_WHITELIST); done
634
635         for dir in $(wildcard $(addprefix $(TARGET_DIR),/usr/share/locale /usr/share/X11/locale /usr/lib/locale)); \
636         do \
637                 for langdir in $$dir/*; \
638                 do \
639                         if [ -e "$${langdir}" ]; \
640                         then \
641                                 grep -qx "$${langdir##*/}" $(LOCALE_WHITELIST) || rm -rf $$langdir; \
642                         fi \
643                 done; \
644         done
645         if [ -d $(TARGET_DIR)/usr/share/X11/locale ]; \
646         then \
647                 for lang in $(LOCALE_NOPURGE); \
648                 do \
649                         if [ -f $(TARGET_DIR)/usr/share/X11/locale/$$lang/XLC_LOCALE ]; \
650                         then \
651                                 echo "$$lang/XLC_LOCALE: $$lang"; \
652                         fi \
653                 done > $(TARGET_DIR)/usr/share/X11/locale/locale.dir; \
654         fi
655 endef
656 TARGET_FINALIZE_HOOKS += PURGE_LOCALES
657 endif
658
659 $(TARGETS_ROOTFS): target-finalize
660
661 .PHONY: target-finalize
662 target-finalize: $(PACKAGES)
663         @$(call MESSAGE,"Finalizing target directory")
664         $(foreach hook,$(TARGET_FINALIZE_HOOKS),$($(hook))$(sep))
665         rm -rf $(TARGET_DIR)/usr/include $(TARGET_DIR)/usr/share/aclocal \
666                 $(TARGET_DIR)/usr/lib/pkgconfig $(TARGET_DIR)/usr/share/pkgconfig \
667                 $(TARGET_DIR)/usr/lib/cmake $(TARGET_DIR)/usr/share/cmake
668         find $(TARGET_DIR)/usr/{lib,share}/ -name '*.cmake' -print0 | xargs -0 rm -f
669         find $(TARGET_DIR)/lib/ $(TARGET_DIR)/usr/lib/ $(TARGET_DIR)/usr/libexec/ \
670                 \( -name '*.a' -o -name '*.la' \) -print0 | xargs -0 rm -f
671 ifneq ($(BR2_PACKAGE_GDB),y)
672         rm -rf $(TARGET_DIR)/usr/share/gdb
673 endif
674 ifneq ($(BR2_PACKAGE_BASH),y)
675         rm -rf $(TARGET_DIR)/usr/share/bash-completion
676 endif
677 ifneq ($(BR2_PACKAGE_ZSH),y)
678         rm -rf $(TARGET_DIR)/usr/share/zsh
679 endif
680         rm -rf $(TARGET_DIR)/usr/man $(TARGET_DIR)/usr/share/man
681         rm -rf $(TARGET_DIR)/usr/info $(TARGET_DIR)/usr/share/info
682         rm -rf $(TARGET_DIR)/usr/doc $(TARGET_DIR)/usr/share/doc
683         rm -rf $(TARGET_DIR)/usr/share/gtk-doc
684         rmdir $(TARGET_DIR)/usr/share 2>/dev/null || true
685         $(STRIP_FIND_CMD) | xargs -0 $(STRIPCMD) 2>/dev/null || true
686
687 # See http://sourceware.org/gdb/wiki/FAQ, "GDB does not see any threads
688 # besides the one in which crash occurred; or SIGTRAP kills my program when
689 # I set a breakpoint"
690 ifeq ($(BR2_TOOLCHAIN_HAS_THREADS),y)
691         find $(TARGET_DIR)/lib/ -type f -name 'libpthread*.so*' | \
692                 xargs -r $(STRIPCMD) $(STRIP_STRIP_DEBUG)
693 endif
694
695 # Valgrind needs ld.so with enough information, so only strip
696 # debugging symbols.
697         find $(TARGET_DIR)/lib/ -type f -name 'ld-*.so*' | \
698                 xargs -r $(STRIPCMD) $(STRIP_STRIP_DEBUG)
699         test -f $(TARGET_DIR)/etc/ld.so.conf && \
700                 { echo "ERROR: we shouldn't have a /etc/ld.so.conf file"; exit 1; } || true
701         test -d $(TARGET_DIR)/etc/ld.so.conf.d && \
702                 { echo "ERROR: we shouldn't have a /etc/ld.so.conf.d directory"; exit 1; } || true
703         mkdir -p $(TARGET_DIR)/etc
704         ( \
705                 echo "NAME=Buildroot"; \
706                 echo "VERSION=$(BR2_VERSION_FULL)"; \
707                 echo "ID=buildroot"; \
708                 echo "VERSION_ID=$(BR2_VERSION)"; \
709                 echo "PRETTY_NAME=\"Buildroot $(BR2_VERSION)\"" \
710         ) >  $(TARGET_DIR)/etc/os-release
711
712         @$(foreach d, $(call qstrip,$(BR2_ROOTFS_OVERLAY)), \
713                 $(call MESSAGE,"Copying overlay $(d)"); \
714                 rsync -a --ignore-times --keep-dirlinks $(RSYNC_VCS_EXCLUSIONS) \
715                         --chmod=u=rwX,go=rX --exclude .empty --exclude '*~' \
716                         $(d)/ $(TARGET_DIR)$(sep))
717
718         @$(foreach s, $(call qstrip,$(BR2_ROOTFS_POST_BUILD_SCRIPT)), \
719                 $(call MESSAGE,"Executing post-build script $(s)"); \
720                 $(EXTRA_ENV) $(s) $(TARGET_DIR) $(call qstrip,$(BR2_ROOTFS_POST_SCRIPT_ARGS))$(sep))
721
722 .PHONY: target-post-image
723 target-post-image: $(TARGETS_ROOTFS) target-finalize
724         @$(foreach s, $(call qstrip,$(BR2_ROOTFS_POST_IMAGE_SCRIPT)), \
725                 $(call MESSAGE,"Executing post-image script $(s)"); \
726                 $(EXTRA_ENV) $(s) $(BINARIES_DIR) $(call qstrip,$(BR2_ROOTFS_POST_SCRIPT_ARGS))$(sep))
727
728 .PHONY: source
729 source: $(foreach p,$(PACKAGES),$(p)-all-source)
730
731 .PHONY: _external-deps external-deps
732 _external-deps: $(foreach p,$(PACKAGES),$(p)-all-external-deps)
733 external-deps:
734         @$(MAKE1) -Bs $(EXTRAMAKEARGS) _external-deps | sort -u
735
736 # check if download URLs are outdated
737 .PHONY: source-check
738 source-check: $(foreach p,$(PACKAGES),$(p)-all-source-check)
739
740 .PHONY: legal-info-clean
741 legal-info-clean:
742         @rm -fr $(LEGAL_INFO_DIR)
743
744 .PHONY: legal-info-prepare
745 legal-info-prepare: $(LEGAL_INFO_DIR)
746         @$(call MESSAGE,"Buildroot $(BR2_VERSION_FULL) Collecting legal info")
747         @$(call legal-license-file,buildroot,buildroot,support/legal-info,COPYING,COPYING,HOST)
748         @$(call legal-manifest,PACKAGE,VERSION,LICENSE,LICENSE FILES,SOURCE ARCHIVE,SOURCE SITE,TARGET)
749         @$(call legal-manifest,PACKAGE,VERSION,LICENSE,LICENSE FILES,SOURCE ARCHIVE,SOURCE SITE,HOST)
750         @$(call legal-manifest,buildroot,$(BR2_VERSION_FULL),GPL-2.0+,COPYING,not saved,not saved,HOST)
751         @$(call legal-warning,the Buildroot source code has not been saved)
752         @cp $(BR2_CONFIG) $(LEGAL_INFO_DIR)/buildroot.config
753
754 .PHONY: legal-info
755 legal-info: dirs legal-info-clean legal-info-prepare $(foreach p,$(PACKAGES),$(p)-all-legal-info) \
756                 $(REDIST_SOURCES_DIR_TARGET) $(REDIST_SOURCES_DIR_HOST)
757         @cat support/legal-info/README.header >>$(LEGAL_REPORT)
758         @if [ -r $(LEGAL_WARNINGS) ]; then \
759                 cat support/legal-info/README.warnings-header \
760                         $(LEGAL_WARNINGS) >>$(LEGAL_REPORT); \
761                 cat $(LEGAL_WARNINGS); fi
762         @rm -f $(LEGAL_WARNINGS)
763         @(cd $(LEGAL_INFO_DIR); \
764                 find * -type f -exec sha256sum {} + | LC_ALL=C sort -k2 \
765                         >.legal-info.sha256; \
766                 mv .legal-info.sha256 legal-info.sha256)
767         @echo "Legal info produced in $(LEGAL_INFO_DIR)"
768
769 .PHONY: show-targets
770 show-targets:
771         @echo $(PACKAGES) $(TARGETS_ROOTFS)
772
773 .PHONY: show-build-order
774 show-build-order: $(patsubst %,%-show-build-order,$(PACKAGES))
775
776 .PHONY: graph-build
777 graph-build: $(O)/build/build-time.log
778         @install -d $(GRAPHS_DIR)
779         $(foreach o,name build duration,./support/scripts/graph-build-time \
780                                         --type=histogram --order=$(o) --input=$(<) \
781                                         --output=$(GRAPHS_DIR)/build.hist-$(o).$(BR_GRAPH_OUT) \
782                                         $(if $(BR2_GRAPH_ALT),--alternate-colors)$(sep))
783         $(foreach t,packages steps,./support/scripts/graph-build-time \
784                                    --type=pie-$(t) --input=$(<) \
785                                    --output=$(GRAPHS_DIR)/build.pie-$(t).$(BR_GRAPH_OUT) \
786                                    $(if $(BR2_GRAPH_ALT),--alternate-colors)$(sep))
787
788 .PHONY: graph-depends-requirements
789 graph-depends-requirements:
790         @dot -? >/dev/null 2>&1 || \
791                 { echo "ERROR: The 'dot' program from Graphviz is needed for graph-depends" >&2; exit 1; }
792
793 .PHONY: graph-depends
794 graph-depends: graph-depends-requirements
795         @$(INSTALL) -d $(GRAPHS_DIR)
796         @cd "$(CONFIG_DIR)"; \
797         $(TOPDIR)/support/scripts/graph-depends $(BR2_GRAPH_DEPS_OPTS) \
798                 --direct -o $(GRAPHS_DIR)/$(@).dot
799         dot $(BR2_GRAPH_DOT_OPTS) -T$(BR_GRAPH_OUT) \
800                 -o $(GRAPHS_DIR)/$(@).$(BR_GRAPH_OUT) \
801                 $(GRAPHS_DIR)/$(@).dot
802
803 .PHONY: graph-size
804 graph-size:
805         $(Q)mkdir -p $(GRAPHS_DIR)
806         $(Q)$(TOPDIR)/support/scripts/size-stats --builddir $(BASE_DIR) \
807                 --graph $(GRAPHS_DIR)/graph-size.$(BR_GRAPH_OUT) \
808                 --file-size-csv $(GRAPHS_DIR)/file-size-stats.csv \
809                 --package-size-csv $(GRAPHS_DIR)/package-size-stats.csv
810
811 .PHONY: check-dependencies
812 check-dependencies:
813         @cd "$(CONFIG_DIR)"; \
814         $(TOPDIR)/support/scripts/graph-depends -C
815
816 else # ifeq ($(BR2_HAVE_DOT_CONFIG),y)
817
818 # Some subdirectories are also package names. To avoid that "make linux"
819 # on an unconfigured tree produces "Nothing to be done", add an explicit
820 # rule for it.
821 # Also for 'all' we error out and ask the user to configure first.
822 .PHONY: linux toolchain
823 linux toolchain all: outputmakefile
824         $(error Please configure Buildroot first (e.g. "make menuconfig"))
825         @exit 1
826
827 endif # ifeq ($(BR2_HAVE_DOT_CONFIG),y)
828
829 # configuration
830 # ---------------------------------------------------------------------------
831
832 HOSTCFLAGS = $(CFLAGS_FOR_BUILD)
833 export HOSTCFLAGS
834
835 .PHONY: prepare-kconfig
836 prepare-kconfig: outputmakefile $(BUILD_DIR)/.br2-external.in
837
838 $(BUILD_DIR)/buildroot-config/%onf:
839         mkdir -p $(@D)/lxdialog
840         PKG_CONFIG_PATH="$(HOST_PKG_CONFIG_PATH)" $(MAKE) CC="$(HOSTCC_NOCCACHE)" HOSTCC="$(HOSTCC_NOCCACHE)" \
841             obj=$(@D) -C $(CONFIG) -f Makefile.br $(@F)
842
843 DEFCONFIG = $(call qstrip,$(BR2_DEFCONFIG))
844
845 # We don't want to fully expand BR2_DEFCONFIG here, so Kconfig will
846 # recognize that if it's still at its default $(CONFIG_DIR)/defconfig
847 COMMON_CONFIG_ENV = \
848         BR2_DEFCONFIG='$(call qstrip,$(value BR2_DEFCONFIG))' \
849         KCONFIG_AUTOCONFIG=$(BUILD_DIR)/buildroot-config/auto.conf \
850         KCONFIG_AUTOHEADER=$(BUILD_DIR)/buildroot-config/autoconf.h \
851         KCONFIG_TRISTATE=$(BUILD_DIR)/buildroot-config/tristate.config \
852         BR2_CONFIG=$(BR2_CONFIG) \
853         HOST_GCC_VERSION="$(HOSTCC_VERSION)" \
854         BUILD_DIR=$(BUILD_DIR) \
855         SKIP_LEGACY=
856
857 xconfig: $(BUILD_DIR)/buildroot-config/qconf prepare-kconfig
858         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
859
860 gconfig: $(BUILD_DIR)/buildroot-config/gconf prepare-kconfig
861         @$(COMMON_CONFIG_ENV) srctree=$(TOPDIR) $< $(CONFIG_CONFIG_IN)
862
863 menuconfig: $(BUILD_DIR)/buildroot-config/mconf prepare-kconfig
864         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
865
866 nconfig: $(BUILD_DIR)/buildroot-config/nconf prepare-kconfig
867         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
868
869 config: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
870         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
871
872 # For the config targets that automatically select options, we pass
873 # SKIP_LEGACY=y to disable the legacy options. However, in that case
874 # no values are set for the legacy options so a subsequent oldconfig
875 # will query them. Therefore, run an additional olddefconfig.
876
877 oldconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
878         @$(COMMON_CONFIG_ENV) $< --oldconfig $(CONFIG_CONFIG_IN)
879
880 randconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
881         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y $< --randconfig $(CONFIG_CONFIG_IN)
882         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
883
884 allyesconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
885         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y $< --allyesconfig $(CONFIG_CONFIG_IN)
886         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
887
888 allnoconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
889         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y $< --allnoconfig $(CONFIG_CONFIG_IN)
890         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
891
892 randpackageconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
893         @grep -v BR2_PACKAGE_ $(BR2_CONFIG) > $(CONFIG_DIR)/.config.nopkg
894         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y \
895                 KCONFIG_ALLCONFIG=$(CONFIG_DIR)/.config.nopkg \
896                 $< --randconfig $(CONFIG_CONFIG_IN)
897         @rm -f $(CONFIG_DIR)/.config.nopkg
898         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
899
900 allyespackageconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
901         @grep -v BR2_PACKAGE_ $(BR2_CONFIG) > $(CONFIG_DIR)/.config.nopkg
902         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y \
903                 KCONFIG_ALLCONFIG=$(CONFIG_DIR)/.config.nopkg \
904                 $< --allyesconfig $(CONFIG_CONFIG_IN)
905         @rm -f $(CONFIG_DIR)/.config.nopkg
906         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
907
908 allnopackageconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
909         @grep -v BR2_PACKAGE_ $(BR2_CONFIG) > $(CONFIG_DIR)/.config.nopkg
910         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y \
911                 KCONFIG_ALLCONFIG=$(CONFIG_DIR)/.config.nopkg \
912                 $< --allnoconfig $(CONFIG_CONFIG_IN)
913         @rm -f $(CONFIG_DIR)/.config.nopkg
914         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
915
916 silentoldconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
917         $(COMMON_CONFIG_ENV) $< --silentoldconfig $(CONFIG_CONFIG_IN)
918
919 olddefconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
920         $(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN)
921
922 defconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
923         @$(COMMON_CONFIG_ENV) $< --defconfig$(if $(DEFCONFIG),=$(DEFCONFIG)) $(CONFIG_CONFIG_IN)
924
925 define percent_defconfig
926 # Override the BR2_DEFCONFIG from COMMON_CONFIG_ENV with the new defconfig
927 %_defconfig: $(BUILD_DIR)/buildroot-config/conf $(1)/configs/%_defconfig prepare-kconfig
928         @$$(COMMON_CONFIG_ENV) BR2_DEFCONFIG=$(1)/configs/$$@ \
929                 $$< --defconfig=$(1)/configs/$$@ $$(CONFIG_CONFIG_IN)
930 endef
931 $(eval $(foreach d,$(call reverse,$(TOPDIR) $(BR2_EXTERNAL_DIRS)),$(call percent_defconfig,$(d))$(sep)))
932
933 savedefconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
934         @$(COMMON_CONFIG_ENV) $< \
935                 --savedefconfig=$(if $(DEFCONFIG),$(DEFCONFIG),$(CONFIG_DIR)/defconfig) \
936                 $(CONFIG_CONFIG_IN)
937         @$(SED) '/BR2_DEFCONFIG=/d' $(if $(DEFCONFIG),$(DEFCONFIG),$(CONFIG_DIR)/defconfig)
938
939 .PHONY: defconfig savedefconfig
940
941 ################################################################################
942 #
943 # Cleanup and misc junk
944 #
945 ################################################################################
946
947 # outputmakefile generates a Makefile in the output directory, if using a
948 # separate output directory. This allows convenient use of make in the
949 # output directory.
950 .PHONY: outputmakefile
951 outputmakefile:
952 ifeq ($(NEED_WRAPPER),y)
953         $(Q)$(TOPDIR)/support/scripts/mkmakefile $(TOPDIR) $(O)
954 endif
955
956 # Even though the target is a real file, we mark it as PHONY as we
957 # want it to be re-generated each time make is invoked, in case the
958 # value of BR2_EXTERNAL is changed.
959 .PHONY: $(BUILD_DIR)/.br2-external.in
960 $(BUILD_DIR)/.br2-external.in: $(BUILD_DIR)
961         $(Q)support/scripts/br2-external -k -o "$(@)" $(BR2_EXTERNAL)
962
963 # printvars prints all the variables currently defined in our
964 # Makefiles. Alternatively, if a non-empty VARS variable is passed,
965 # only the variables matching the make pattern passed in VARS are
966 # displayed.
967 .PHONY: printvars
968 printvars:
969         @:$(foreach V, \
970                 $(sort $(if $(VARS),$(filter $(VARS),$(.VARIABLES)),$(.VARIABLES))), \
971                 $(if $(filter-out environment% default automatic, \
972                                 $(origin $V)), \
973                 $(if $(QUOTED_VARS),\
974                         $(info $V='$(subst ','\'',$(if $(RAW_VARS),$(value $V),$($V)))'), \
975                         $(info $V=$(if $(RAW_VARS),$(value $V),$($V))))))
976 # ' Syntax colouring...
977
978 .PHONY: clean
979 clean:
980         rm -rf $(TARGET_DIR) $(BINARIES_DIR) $(HOST_DIR) \
981                 $(BUILD_DIR) $(BASE_DIR)/staging \
982                 $(LEGAL_INFO_DIR) $(GRAPHS_DIR)
983
984 .PHONY: distclean
985 distclean: clean
986 ifeq ($(O),$(CURDIR)/output)
987         rm -rf $(O)
988 endif
989         rm -rf $(TOPDIR)/dl $(BR2_CONFIG) $(CONFIG_DIR)/.config.old $(CONFIG_DIR)/..config.tmp \
990                 $(CONFIG_DIR)/.auto.deps $(BR2_EXTERNAL_FILE)
991
992 .PHONY: help
993 help:
994         @echo 'Cleaning:'
995         @echo '  clean                  - delete all files created by build'
996         @echo '  distclean              - delete all non-source files (including .config)'
997         @echo
998         @echo 'Build:'
999         @echo '  all                    - make world'
1000         @echo '  toolchain              - build toolchain'
1001         @echo
1002         @echo 'Configuration:'
1003         @echo '  menuconfig             - interactive curses-based configurator'
1004         @echo '  nconfig                - interactive ncurses-based configurator'
1005         @echo '  xconfig                - interactive Qt-based configurator'
1006         @echo '  gconfig                - interactive GTK-based configurator'
1007         @echo '  oldconfig              - resolve any unresolved symbols in .config'
1008         @echo '  silentoldconfig        - Same as oldconfig, but quietly, additionally update deps'
1009         @echo '  olddefconfig           - Same as silentoldconfig but sets new symbols to their default value'
1010         @echo '  randconfig             - New config with random answer to all options'
1011         @echo '  defconfig              - New config with default answer to all options'
1012         @echo '                             BR2_DEFCONFIG, if set, is used as input'
1013         @echo '  savedefconfig          - Save current config to BR2_DEFCONFIG (minimal config)'
1014         @echo '  allyesconfig           - New config where all options are accepted with yes'
1015         @echo '  allnoconfig            - New config where all options are answered with no'
1016         @echo '  randpackageconfig      - New config with random answer to package options'
1017         @echo '  allyespackageconfig    - New config where pkg options are accepted with yes'
1018         @echo '  allnopackageconfig     - New config where package options are answered with no'
1019         @echo
1020         @echo 'Package-specific:'
1021         @echo '  <pkg>                  - Build and install <pkg> and all its dependencies'
1022         @echo '  <pkg>-source           - Only download the source files for <pkg>'
1023         @echo '  <pkg>-extract          - Extract <pkg> sources'
1024         @echo '  <pkg>-patch            - Apply patches to <pkg>'
1025         @echo '  <pkg>-depends          - Build <pkg>'\''s dependencies'
1026         @echo '  <pkg>-configure        - Build <pkg> up to the configure step'
1027         @echo '  <pkg>-build            - Build <pkg> up to the build step'
1028         @echo '  <pkg>-show-depends     - List packages on which <pkg> depends'
1029         @echo '  <pkg>-show-rdepends    - List packages which have <pkg> as a dependency'
1030         @echo '  <pkg>-graph-depends    - Generate a graph of <pkg>'\''s dependencies'
1031         @echo '  <pkg>-graph-rdepends   - Generate a graph of <pkg>'\''s reverse dependencies'
1032         @echo '  <pkg>-dirclean         - Remove <pkg> build directory'
1033         @echo '  <pkg>-reconfigure      - Restart the build from the configure step'
1034         @echo '  <pkg>-rebuild          - Restart the build from the build step'
1035         $(foreach p,$(HELP_PACKAGES), \
1036                 @echo $(sep) \
1037                 @echo '$($(p)_NAME):' $(sep) \
1038                 $($(p)_HELP_CMDS)$(sep))
1039         @echo
1040         @echo 'Documentation:'
1041         @echo '  manual                 - build manual in all formats'
1042         @echo '  manual-html            - build manual in HTML'
1043         @echo '  manual-split-html      - build manual in split HTML'
1044         @echo '  manual-pdf             - build manual in PDF'
1045         @echo '  manual-text            - build manual in text'
1046         @echo '  manual-epub            - build manual in ePub'
1047         @echo '  graph-build            - generate graphs of the build times'
1048         @echo '  graph-depends          - generate graph of the dependency tree'
1049         @echo '  graph-size             - generate stats of the filesystem size'
1050         @echo '  list-defconfigs        - list all defconfigs (pre-configured minimal systems)'
1051         @echo
1052         @echo 'Miscellaneous:'
1053         @echo '  source                 - download all sources needed for offline-build'
1054         @echo '  source-check           - check selected packages for valid download URLs'
1055         @echo '  external-deps          - list external packages used'
1056         @echo '  legal-info             - generate info about license compliance'
1057         @echo '  printvars              - dump all the internal variables'
1058         @echo
1059         @echo '  make V=0|1             - 0 => quiet build (default), 1 => verbose build'
1060         @echo '  make O=dir             - Locate all output files in "dir", including .config'
1061         @echo
1062         @echo 'For further details, see README, generate the Buildroot manual, or consult'
1063         @echo 'it on-line at http://buildroot.org/docs.html'
1064         @echo
1065
1066 # List the defconfig files
1067 # $(1): base directory
1068 # $(2): br2-external name, empty for bundled
1069 define list-defconfigs
1070         @first=true; \
1071         for defconfig in $(1)/configs/*_defconfig; do \
1072                 [ -f "$${defconfig}" ] || continue; \
1073                 if $${first}; then \
1074                         if [ "$(2)" ]; then \
1075                                 printf 'External configs in "$(call qstrip,$(2))":\n'; \
1076                         else \
1077                                 printf "Built-in configs:\n"; \
1078                         fi; \
1079                         first=false; \
1080                 fi; \
1081                 defconfig="$${defconfig##*/}"; \
1082                 printf "  %-35s - Build for %s\n" "$${defconfig}" "$${defconfig%_defconfig}"; \
1083         done; \
1084         $${first} || printf "\n"
1085 endef
1086
1087 # We iterate over BR2_EXTERNAL_NAMES rather than BR2_EXTERNAL_DIRS,
1088 # because we want to display the name of the br2-external tree.
1089 .PHONY: list-defconfigs
1090 list-defconfigs:
1091         $(call list-defconfigs,$(TOPDIR))
1092         $(foreach name,$(BR2_EXTERNAL_NAMES),\
1093                 $(call list-defconfigs,$(BR2_EXTERNAL_$(name)_PATH),\
1094                         $(BR2_EXTERNAL_$(name)_DESC))$(sep))
1095
1096 release: OUT = buildroot-$(BR2_VERSION)
1097
1098 # Create release tarballs. We need to fiddle a bit to add the generated
1099 # documentation to the git output
1100 release:
1101         git archive --format=tar --prefix=$(OUT)/ HEAD > $(OUT).tar
1102         $(MAKE) O=$(OUT) manual-html manual-text manual-pdf
1103         $(MAKE) O=$(OUT) manual-clean
1104         tar rf $(OUT).tar $(OUT)
1105         gzip -9 -c < $(OUT).tar > $(OUT).tar.gz
1106         bzip2 -9 -c < $(OUT).tar > $(OUT).tar.bz2
1107         rm -rf $(OUT) $(OUT).tar
1108
1109 print-version:
1110         @echo $(BR2_VERSION_FULL)
1111
1112 .PHONY: .gitlab-ci.yml
1113 .gitlab-ci.yml: .gitlab-ci.yml.in
1114         cp $< $@
1115         (cd configs; LC_ALL=C ls -1 *_defconfig) | sed 's/$$/: *defconfig/' >> $@
1116         ./support/testing/run-tests -l 2>&1 | sed -r -e '/^test_run \((.*)\).*/!d; s//\1: *runtime_test/' | LC_ALL=C sort >> $@
1117
1118 include docs/manual/manual.mk
1119 -include $(foreach dir,$(BR2_EXTERNAL_DIRS),$(dir)/docs/*/*.mk)
1120
1121 .PHONY: $(noconfig_targets)
1122
1123 endif #umask / $(CURDIR) / $(O)