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