Makefile

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