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