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