Makefile

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