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