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