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