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