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 LD
 347 unexport AR
 348 unexport CXX
 349 unexport CPP
 350 unexport RANLIB
 351 unexport CFLAGS
 352 unexport CXXFLAGS
 353 unexport GREP_OPTIONS
 354 unexport TAR_OPTIONS
 355 unexport CONFIG_SITE
 356 unexport QMAKESPEC
 357 unexport TERMINFO
 358 unexport MACHINE
 359 unexport O
 360
 361 GNU_HOST_NAME := $(shell support/gnuconfig/config.guess)
 362
 363 PACKAGES :=
 364 PACKAGES_ALL :=
 365
 366 # silent mode requested?
 367 QUIET := $(if $(findstring s,$(filter-out --%,$(MAKEFLAGS))),-q)
 368
 369 # Strip off the annoying quoting
 370 ARCH := $(call qstrip,$(BR2_ARCH))
 371
 372 KERNEL_ARCH := $(shell echo "$(ARCH)" | sed -e "s/-.*//" \
 373         -e s/i.86/i386/ -e s/sun4u/sparc64/ \
 374         -e s/arcle/arc/ \
 375         -e s/arceb/arc/ \
 376         -e s/arm.*/arm/ -e s/sa110/arm/ \
 377         -e s/aarch64.*/arm64/ \
 378         -e s/bfin/blackfin/ \
 379         -e s/parisc64/parisc/ \
 380         -e s/powerpc64.*/powerpc/ \
 381         -e s/ppc.*/powerpc/ -e s/mips.*/mips/ \
 382         -e s/sh.*/sh/ \
 383         -e s/microblazeel/microblaze/)
 384
 385 ZCAT := $(call qstrip,$(BR2_ZCAT))
 386 BZCAT := $(call qstrip,$(BR2_BZCAT))
 387 XZCAT := $(call qstrip,$(BR2_XZCAT))
 388 TAR_OPTIONS = $(call qstrip,$(BR2_TAR_OPTIONS)) -xf
 389
 390 # packages compiled for the host go here
 391 HOST_DIR := $(call qstrip,$(BR2_HOST_DIR))
 392
 393 # Quotes are needed for spaces and all in the original PATH content.
 394 BR_PATH = "$(HOST_DIR)/bin:$(HOST_DIR)/sbin:$(HOST_DIR)/usr/bin:$(HOST_DIR)/usr/sbin:$(PATH)"
 395
 396 # Location of a file giving a big fat warning that output/target
 397 # should not be used as the root filesystem.
 398 TARGET_DIR_WARNING_FILE = $(TARGET_DIR)/THIS_IS_NOT_YOUR_ROOT_FILESYSTEM
 399
 400 ifeq ($(BR2_CCACHE),y)
 401 CCACHE := $(HOST_DIR)/usr/bin/ccache
 402 BR_CACHE_DIR ?= $(call qstrip,$(BR2_CCACHE_DIR))
 403 export BR_CACHE_DIR
 404 HOSTCC := $(CCACHE) $(HOSTCC)
 405 HOSTCXX := $(CCACHE) $(HOSTCXX)
 406 else
 407 export BR_NO_CCACHE
 408 endif
 409
 410 # Scripts in support/ or post-build scripts may need to reference
 411 # these locations, so export them so it is easier to use
 412 export BR2_CONFIG
 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 ifneq ($(BR2_DEPRECATED),y)
 431 include Makefile.legacy
 432 endif
 433
 434 include package/Makefile.in
 435 include support/dependencies/dependencies.mk
 436
 437 include toolchain/*.mk
 438 include toolchain/*/*.mk
 439
 440 # Include the package override file if one has been provided in the
 441 # configuration.
 442 PACKAGE_OVERRIDE_FILE = $(call qstrip,$(BR2_PACKAGE_OVERRIDE_FILE))
 443 ifneq ($(PACKAGE_OVERRIDE_FILE),)
 444 -include $(PACKAGE_OVERRIDE_FILE)
 445 endif
 446
 447 include $(sort $(wildcard package/*/*.mk))
 448
 449 include boot/common.mk
 450 include linux/linux.mk
 451 include fs/common.mk
 452
 453 include $(BR2_EXTERNAL)/external.mk
 454
 455 # Now we are sure we have all the packages scanned and defined. We now
 456 # check for each package in the list of enabled packages, that all its
 457 # dependencies are indeed enabled.
 458 #
 459 # Only trigger the check for default builds. If the user forces building
 460 # a package, even if not enabled in the configuration, we want to accept
 461 # it.
 462 #
 463 ifeq ($(MAKECMDGOALS),)
 464
 465 define CHECK_ONE_DEPENDENCY
 466 ifeq ($$($(2)_TYPE),target)
 467 ifeq ($$($(2)_IS_VIRTUAL),)
 468 ifneq ($$($$($(2)_KCONFIG_VAR)),y)
 469 $$(error $$($(2)_NAME) is in the dependency chain of $$($(1)_NAME) that \
 470 has added it to its _DEPENDENCIES variable without selecting it or \
 471 depending on it from Config.in)
 472 endif
 473 endif
 474 endif
 475 endef
 476
 477 $(foreach pkg,$(call UPPERCASE,$(PACKAGES)),\
 478         $(foreach dep,$(call UPPERCASE,$($(pkg)_FINAL_ALL_DEPENDENCIES)),\
 479                 $(eval $(call CHECK_ONE_DEPENDENCY,$(pkg),$(dep))$(sep))))
 480
 481 endif
 482
 483 dirs: $(BUILD_DIR) $(STAGING_DIR) $(TARGET_DIR) \
 484         $(HOST_DIR) $(BINARIES_DIR)
 485
 486 $(BUILD_DIR)/buildroot-config/auto.conf: $(BR2_CONFIG)
 487         $(MAKE1) $(EXTRAMAKEARGS) HOSTCC="$(HOSTCC_NOCCACHE)" HOSTCXX="$(HOSTCXX_NOCCACHE)" silentoldconfig
 488
 489 prepare: $(BUILD_DIR)/buildroot-config/auto.conf
 490
 491 world: target-post-image
 492
 493 .PHONY: all world toolchain dirs clean distclean source outputmakefile \
 494         legal-info legal-info-prepare legal-info-clean printvars help \
 495         list-defconfigs target-finalize target-post-image source-check
 496
 497 ################################################################################
 498 #
 499 # staging and target directories do NOT list these as
 500 # dependencies anywhere else
 501 #
 502 ################################################################################
 503 $(BUILD_DIR) $(TARGET_DIR) $(HOST_DIR) $(BINARIES_DIR) $(LEGAL_INFO_DIR) $(REDIST_SOURCES_DIR_TARGET) $(REDIST_SOURCES_DIR_HOST):
 504         @mkdir -p $@
 505
 506 # Populating the staging with the base directories is handled by the skeleton package
 507 $(STAGING_DIR):
 508         @mkdir -p $(STAGING_DIR)
 509         @ln -snf $(STAGING_DIR) $(BASE_DIR)/staging
 510
 511 RSYNC_VCS_EXCLUSIONS = \
 512         --exclude .svn --exclude .git --exclude .hg --exclude .bzr \
 513         --exclude CVS
 514
 515 STRIP_FIND_CMD = find $(TARGET_DIR)
 516 ifneq (,$(call qstrip,$(BR2_STRIP_EXCLUDE_DIRS)))
 517 STRIP_FIND_CMD += \( $(call finddirclauses,$(TARGET_DIR),$(call qstrip,$(BR2_STRIP_EXCLUDE_DIRS))) \) -prune -o
 518 endif
 519 STRIP_FIND_CMD += -type f \( -perm /111 -o -name '*.so*' \)
 520 # file exclusions:
 521 # - libpthread.so: a non-stripped libpthread shared library is needed for
 522 #   proper debugging of pthread programs using gdb.
 523 # - ld.so: a non-stripped dynamic linker library is needed for valgrind
 524 # - kernel modules (*.ko): do not function properly when stripped like normal
 525 #   applications and libraries. Normally kernel modules are already excluded
 526 #   by the executable permission check above, so the explicit exclusion is only
 527 #   done for kernel modules with incorrect permissions.
 528 STRIP_FIND_CMD += -not \( $(call findfileclauses,libpthread*.so* ld-*.so* *.ko $(call qstrip,$(BR2_STRIP_EXCLUDE_FILES))) \) -print0
 529
 530 ifeq ($(BR2_ECLIPSE_REGISTER),y)
 531 define TOOLCHAIN_ECLIPSE_REGISTER
 532         ./support/scripts/eclipse-register-toolchain `readlink -f $(O)` \
 533                 $(notdir $(TARGET_CROSS)) $(BR2_ARCH)
 534 endef
 535 TARGET_FINALIZE_HOOKS += TOOLCHAIN_ECLIPSE_REGISTER
 536 endif
 537
 538 # Generate locale data. Basically, we call the localedef program
 539 # (built by the host-localedef package) for each locale. The input
 540 # data comes preferably from the toolchain, or if the toolchain does
 541 # not have them (Linaro toolchains), we use the ones available on the
 542 # host machine.
 543 ifeq ($(BR2_TOOLCHAIN_USES_GLIBC),y)
 544 GLIBC_GENERATE_LOCALES = $(call qstrip,$(BR2_GENERATE_LOCALE))
 545 ifneq ($(GLIBC_GENERATE_LOCALES),)
 546 PACKAGES += host-localedef
 547
 548 define GENERATE_GLIBC_LOCALES
 549         $(Q)mkdir -p $(TARGET_DIR)/usr/lib/locale/
 550         $(Q)for locale in $(GLIBC_GENERATE_LOCALES) ; do \
 551                 inputfile=`echo $${locale} | cut -f1 -d'.'` ; \
 552                 charmap=`echo $${locale} | cut -f2 -d'.' -s` ; \
 553                 if test -z "$${charmap}" ; then \
 554                         charmap="UTF-8" ; \
 555                 fi ; \
 556                 echo "Generating locale $${inputfile}.$${charmap}" ; \
 557                 I18NPATH=$(STAGING_DIR)/usr/share/i18n:/usr/share/i18n \
 558                 $(HOST_DIR)/usr/bin/localedef \
 559                         --prefix=$(TARGET_DIR) \
 560                         --$(call LOWERCASE,$(BR2_ENDIAN))-endian \
 561                         -i $${inputfile} -f $${charmap} \
 562                         $${locale} ; \
 563         done
 564 endef
 565 TARGET_FINALIZE_HOOKS += GENERATE_GLIBC_LOCALES
 566 endif
 567 endif
 568
 569 ifeq ($(BR2_ENABLE_LOCALE_PURGE),y)
 570 LOCALE_WHITELIST = $(BUILD_DIR)/locales.nopurge
 571 LOCALE_NOPURGE = $(call qstrip,$(BR2_ENABLE_LOCALE_WHITELIST))
 572
 573 # This piece of junk does the following:
 574 # First collect the whitelist in a file.
 575 # Then go over all the locale dirs and for each subdir, check if it exists
 576 # in the whitelist file. If it doesn't, kill it.
 577 # Finally, specifically for X11, regenerate locale.dir from the whitelist.
 578 define PURGE_LOCALES
 579         rm -f $(LOCALE_WHITELIST)
 580         for i in $(LOCALE_NOPURGE) locale-archive; do echo $$i >> $(LOCALE_WHITELIST); done
 581
 582         for dir in $(wildcard $(addprefix $(TARGET_DIR),/usr/share/locale /usr/share/X11/locale /usr/lib/locale)); \
 583         do \
 584                 for langdir in $$dir/*; \
 585                 do \
 586                         grep -qx $${langdir##*/} $(LOCALE_WHITELIST) || rm -rf $$langdir; \
 587                 done; \
 588         done
 589         if [ -d $(TARGET_DIR)/usr/share/X11/locale ]; \
 590         then \
 591                 for lang in $(LOCALE_NOPURGE); \
 592                 do \
 593                         if [ -f $(TARGET_DIR)/usr/share/X11/locale/$$lang/XLC_LOCALE ]; \
 594                         then \
 595                                 echo "$$lang/XLC_LOCALE: $$lang"; \
 596                         fi \
 597                 done > $(TARGET_DIR)/usr/share/X11/locale/locale.dir; \
 598         fi
 599 endef
 600 TARGET_FINALIZE_HOOKS += PURGE_LOCALES
 601 endif
 602
 603 $(TARGETS_ROOTFS): target-finalize
 604
 605 target-finalize: $(PACKAGES)
 606         @$(call MESSAGE,"Finalizing target directory")
 607         $(foreach hook,$(TARGET_FINALIZE_HOOKS),$($(hook))$(sep))
 608         rm -rf $(TARGET_DIR)/usr/include $(TARGET_DIR)/usr/share/aclocal \
 609                 $(TARGET_DIR)/usr/lib/pkgconfig $(TARGET_DIR)/usr/share/pkgconfig \
 610                 $(TARGET_DIR)/usr/lib/cmake $(TARGET_DIR)/usr/share/cmake
 611         find $(TARGET_DIR)/usr/{lib,share}/ -name '*.cmake' -print0 | xargs -0 rm -f
 612         find $(TARGET_DIR)/lib $(TARGET_DIR)/usr/lib $(TARGET_DIR)/usr/libexec \
 613                 \( -name '*.a' -o -name '*.la' \) -print0 | xargs -0 rm -f
 614 ifneq ($(BR2_PACKAGE_GDB),y)
 615         rm -rf $(TARGET_DIR)/usr/share/gdb
 616 endif
 617 ifneq ($(BR2_PACKAGE_BASH),y)
 618         rm -rf $(TARGET_DIR)/usr/share/bash-completion
 619 endif
 620 ifneq ($(BR2_PACKAGE_ZSH),y)
 621         rm -rf $(TARGET_DIR)/usr/share/zsh
 622 endif
 623         rm -rf $(TARGET_DIR)/usr/man $(TARGET_DIR)/usr/share/man
 624         rm -rf $(TARGET_DIR)/usr/info $(TARGET_DIR)/usr/share/info
 625         rm -rf $(TARGET_DIR)/usr/doc $(TARGET_DIR)/usr/share/doc
 626         rm -rf $(TARGET_DIR)/usr/share/gtk-doc
 627         -rmdir $(TARGET_DIR)/usr/share 2>/dev/null
 628         $(STRIP_FIND_CMD) | xargs -0 $(STRIPCMD) 2>/dev/null || true
 629         if test -d $(TARGET_DIR)/lib/modules; then \
 630                 find $(TARGET_DIR)/lib/modules -type f -name '*.ko' -print0 | \
 631                 xargs -0 -r $(KSTRIPCMD); fi
 632
 633 # See http://sourceware.org/gdb/wiki/FAQ, "GDB does not see any threads
 634 # besides the one in which crash occurred; or SIGTRAP kills my program when
 635 # I set a breakpoint"
 636 ifeq ($(BR2_TOOLCHAIN_HAS_THREADS),y)
 637         find $(TARGET_DIR)/lib -type f -name 'libpthread*.so*' | \
 638                 xargs -r $(STRIPCMD) $(STRIP_STRIP_DEBUG)
 639 endif
 640
 641 # Valgrind needs ld.so with enough information, so only strip
 642 # debugging symbols.
 643         find $(TARGET_DIR)/lib -type f -name 'ld-*.so*' | \
 644                 xargs -r $(STRIPCMD) $(STRIP_STRIP_DEBUG)
 645         test -f $(TARGET_DIR)/etc/ld.so.conf && \
 646                 { echo "ERROR: we shouldn't have a /etc/ld.so.conf file"; exit 1; } || true
 647         test -d $(TARGET_DIR)/etc/ld.so.conf.d && \
 648                 { echo "ERROR: we shouldn't have a /etc/ld.so.conf.d directory"; exit 1; } || true
 649         mkdir -p $(TARGET_DIR)/etc
 650         ( \
 651                 echo "NAME=Buildroot"; \
 652                 echo "VERSION=$(BR2_VERSION_FULL)"; \
 653                 echo "ID=buildroot"; \
 654                 echo "VERSION_ID=$(BR2_VERSION)"; \
 655                 echo "PRETTY_NAME=\"Buildroot $(BR2_VERSION)\"" \
 656         ) >  $(TARGET_DIR)/etc/os-release
 657
 658         @$(foreach d, $(call qstrip,$(BR2_ROOTFS_OVERLAY)), \
 659                 $(call MESSAGE,"Copying overlay $(d)"); \
 660                 rsync -a --ignore-times $(RSYNC_VCS_EXCLUSIONS) \
 661                         --chmod=u=rwX,go=rX --exclude .empty --exclude '*~' \
 662                         $(d)/ $(TARGET_DIR)$(sep))
 663
 664         @$(foreach s, $(call qstrip,$(BR2_ROOTFS_POST_BUILD_SCRIPT)), \
 665                 $(call MESSAGE,"Executing post-build script $(s)"); \
 666                 $(EXTRA_ENV) $(s) $(TARGET_DIR) $(call qstrip,$(BR2_ROOTFS_POST_SCRIPT_ARGS))$(sep))
 667
 668 target-post-image: $(TARGETS_ROOTFS) target-finalize
 669         @$(foreach s, $(call qstrip,$(BR2_ROOTFS_POST_IMAGE_SCRIPT)), \
 670                 $(call MESSAGE,"Executing post-image script $(s)"); \
 671                 $(EXTRA_ENV) $(s) $(BINARIES_DIR) $(call qstrip,$(BR2_ROOTFS_POST_SCRIPT_ARGS))$(sep))
 672
 673 source: $(foreach p,$(PACKAGES),$(p)-all-source)
 674
 675 _external-deps: $(foreach p,$(PACKAGES),$(p)-all-external-deps)
 676 external-deps:
 677         @$(MAKE1) -Bs $(EXTRAMAKEARGS) _external-deps | sort -u
 678
 679 # check if download URLs are outdated
 680 source-check: $(foreach p,$(PACKAGES),$(p)-all-source-check)
 681
 682 legal-info-clean:
 683         @rm -fr $(LEGAL_INFO_DIR)
 684
 685 legal-info-prepare: $(LEGAL_INFO_DIR)
 686         @$(call MESSAGE,"Collecting legal info")
 687         @$(call legal-license-file,buildroot,COPYING,COPYING,HOST)
 688         @$(call legal-manifest,PACKAGE,VERSION,LICENSE,LICENSE FILES,SOURCE ARCHIVE,SOURCE SITE,TARGET)
 689         @$(call legal-manifest,PACKAGE,VERSION,LICENSE,LICENSE FILES,SOURCE ARCHIVE,SOURCE SITE,HOST)
 690         @$(call legal-manifest,buildroot,$(BR2_VERSION_FULL),GPLv2+,COPYING,not saved,not saved,HOST)
 691         @$(call legal-warning,the Buildroot source code has not been saved)
 692         @cp $(BR2_CONFIG) $(LEGAL_INFO_DIR)/buildroot.config
 693
 694 legal-info: dirs legal-info-clean legal-info-prepare $(foreach p,$(PACKAGES),$(p)-all-legal-info) \
 695                 $(REDIST_SOURCES_DIR_TARGET) $(REDIST_SOURCES_DIR_HOST)
 696         @cat support/legal-info/README.header >>$(LEGAL_REPORT)
 697         @if [ -r $(LEGAL_WARNINGS) ]; then \
 698                 cat support/legal-info/README.warnings-header \
 699                         $(LEGAL_WARNINGS) >>$(LEGAL_REPORT); \
 700                 cat $(LEGAL_WARNINGS); fi
 701         @echo "Legal info produced in $(LEGAL_INFO_DIR)"
 702         @rm -f $(LEGAL_WARNINGS)
 703
 704 show-targets:
 705         @echo $(PACKAGES) $(TARGETS_ROOTFS)
 706
 707 graph-build: $(O)/build/build-time.log
 708         @install -d $(GRAPHS_DIR)
 709         $(foreach o,name build duration,./support/scripts/graph-build-time \
 710                                         --type=histogram --order=$(o) --input=$(<) \
 711                                         --output=$(GRAPHS_DIR)/build.hist-$(o).$(BR_GRAPH_OUT) \
 712                                         $(if $(BR2_GRAPH_ALT),--alternate-colors)$(sep))
 713         $(foreach t,packages steps,./support/scripts/graph-build-time \
 714                                    --type=pie-$(t) --input=$(<) \
 715                                    --output=$(GRAPHS_DIR)/build.pie-$(t).$(BR_GRAPH_OUT) \
 716                                    $(if $(BR2_GRAPH_ALT),--alternate-colors)$(sep))
 717
 718 graph-depends-requirements:
 719         @dot -? >/dev/null 2>&1 || \
 720                 { echo "ERROR: The 'dot' program from Graphviz is needed for graph-depends" >&2; exit 1; }
 721
 722 graph-depends: graph-depends-requirements
 723         @$(INSTALL) -d $(GRAPHS_DIR)
 724         @cd "$(CONFIG_DIR)"; \
 725         $(TOPDIR)/support/scripts/graph-depends $(BR2_GRAPH_DEPS_OPTS) \
 726                 -o $(GRAPHS_DIR)/$(@).dot
 727         dot $(BR2_GRAPH_DOT_OPTS) -T$(BR_GRAPH_OUT) \
 728                 -o $(GRAPHS_DIR)/$(@).$(BR_GRAPH_OUT) \
 729                 $(GRAPHS_DIR)/$(@).dot
 730
 731 graph-size:
 732         $(Q)mkdir -p $(GRAPHS_DIR)
 733         $(Q)$(TOPDIR)/support/scripts/size-stats --builddir $(BASE_DIR) \
 734                 --graph $(GRAPHS_DIR)/graph-size.$(BR_GRAPH_OUT) \
 735                 --file-size-csv $(GRAPHS_DIR)/file-size-stats.csv \
 736                 --package-size-csv $(GRAPHS_DIR)/package-size-stats.csv
 737
 738 check-dependencies:
 739         @cd "$(CONFIG_DIR)"; \
 740         $(TOPDIR)/support/scripts/graph-depends -C
 741
 742 else # ifeq ($(BR2_HAVE_DOT_CONFIG),y)
 743
 744 all: menuconfig
 745
 746 endif # ifeq ($(BR2_HAVE_DOT_CONFIG),y)
 747
 748 # configuration
 749 # ---------------------------------------------------------------------------
 750
 751 HOSTCFLAGS = $(CFLAGS_FOR_BUILD)
 752 export HOSTCFLAGS
 753
 754 $(BUILD_DIR)/buildroot-config/%onf:
 755         mkdir -p $(@D)/lxdialog
 756         PKG_CONFIG_PATH="$(HOST_PKG_CONFIG_PATH)" $(MAKE) CC="$(HOSTCC_NOCCACHE)" HOSTCC="$(HOSTCC_NOCCACHE)" \
 757             obj=$(@D) -C $(CONFIG) -f Makefile.br $(@F)
 758
 759 DEFCONFIG = $(call qstrip,$(BR2_DEFCONFIG))
 760
 761 # We don't want to fully expand BR2_DEFCONFIG here, so Kconfig will
 762 # recognize that if it's still at its default $(CONFIG_DIR)/defconfig
 763 COMMON_CONFIG_ENV = \
 764         BR2_DEFCONFIG='$(call qstrip,$(value BR2_DEFCONFIG))' \
 765         KCONFIG_AUTOCONFIG=$(BUILD_DIR)/buildroot-config/auto.conf \
 766         KCONFIG_AUTOHEADER=$(BUILD_DIR)/buildroot-config/autoconf.h \
 767         KCONFIG_TRISTATE=$(BUILD_DIR)/buildroot-config/tristate.config \
 768         BR2_CONFIG=$(BR2_CONFIG) \
 769         BR2_EXTERNAL=$(BR2_EXTERNAL) \
 770         HOST_GCC_VERSION="$(HOSTCC_VERSION)" \
 771         SKIP_LEGACY=
 772
 773 xconfig: $(BUILD_DIR)/buildroot-config/qconf outputmakefile
 774         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
 775
 776 gconfig: $(BUILD_DIR)/buildroot-config/gconf outputmakefile
 777         @$(COMMON_CONFIG_ENV) srctree=$(TOPDIR) $< $(CONFIG_CONFIG_IN)
 778
 779 menuconfig: $(BUILD_DIR)/buildroot-config/mconf outputmakefile
 780         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
 781
 782 nconfig: $(BUILD_DIR)/buildroot-config/nconf outputmakefile
 783         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
 784
 785 config: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 786         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
 787
 788 # For the config targets that automatically select options, we pass
 789 # SKIP_LEGACY=y to disable the legacy options. However, in that case
 790 # no values are set for the legacy options so a subsequent oldconfig
 791 # will query them. Therefore, run an additional olddefconfig.
 792
 793 oldconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 794         @$(COMMON_CONFIG_ENV) $< --oldconfig $(CONFIG_CONFIG_IN)
 795
 796 randconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 797         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y $< --randconfig $(CONFIG_CONFIG_IN)
 798         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
 799
 800 allyesconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 801         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y $< --allyesconfig $(CONFIG_CONFIG_IN)
 802         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
 803
 804 allnoconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 805         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y $< --allnoconfig $(CONFIG_CONFIG_IN)
 806         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
 807
 808 randpackageconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 809         @grep -v BR2_PACKAGE_ $(BR2_CONFIG) > $(CONFIG_DIR)/.config.nopkg
 810         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y \
 811                 KCONFIG_ALLCONFIG=$(CONFIG_DIR)/.config.nopkg \
 812                 $< --randconfig $(CONFIG_CONFIG_IN)
 813         @rm -f $(CONFIG_DIR)/.config.nopkg
 814         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
 815
 816 allyespackageconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 817         @grep -v BR2_PACKAGE_ $(BR2_CONFIG) > $(CONFIG_DIR)/.config.nopkg
 818         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y \
 819                 KCONFIG_ALLCONFIG=$(CONFIG_DIR)/.config.nopkg \
 820                 $< --allyesconfig $(CONFIG_CONFIG_IN)
 821         @rm -f $(CONFIG_DIR)/.config.nopkg
 822         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
 823
 824 allnopackageconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 825         @grep -v BR2_PACKAGE_ $(BR2_CONFIG) > $(CONFIG_DIR)/.config.nopkg
 826         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y \
 827                 KCONFIG_ALLCONFIG=$(CONFIG_DIR)/.config.nopkg \
 828                 $< --allnoconfig $(CONFIG_CONFIG_IN)
 829         @rm -f $(CONFIG_DIR)/.config.nopkg
 830         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
 831
 832 silentoldconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 833         $(COMMON_CONFIG_ENV) $< --silentoldconfig $(CONFIG_CONFIG_IN)
 834
 835 olddefconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 836         $(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN)
 837
 838 defconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 839         @$(COMMON_CONFIG_ENV) $< --defconfig$(if $(DEFCONFIG),=$(DEFCONFIG)) $(CONFIG_CONFIG_IN)
 840
 841 # Override the BR2_DEFCONFIG from COMMON_CONFIG_ENV with the new defconfig
 842 %_defconfig: $(BUILD_DIR)/buildroot-config/conf $(TOPDIR)/configs/%_defconfig outputmakefile
 843         @$(COMMON_CONFIG_ENV) BR2_DEFCONFIG=$(TOPDIR)/configs/$@ \
 844                 $< --defconfig=$(TOPDIR)/configs/$@ $(CONFIG_CONFIG_IN)
 845
 846 %_defconfig: $(BUILD_DIR)/buildroot-config/conf $(BR2_EXTERNAL)/configs/%_defconfig outputmakefile
 847         @$(COMMON_CONFIG_ENV) BR2_DEFCONFIG=$(BR2_EXTERNAL)/configs/$@ \
 848                 $< --defconfig=$(BR2_EXTERNAL)/configs/$@ $(CONFIG_CONFIG_IN)
 849
 850 savedefconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 851         @$(COMMON_CONFIG_ENV) $< \
 852                 --savedefconfig=$(if $(DEFCONFIG),$(DEFCONFIG),$(CONFIG_DIR)/defconfig) \
 853                 $(CONFIG_CONFIG_IN)
 854         @$(SED) '/BR2_DEFCONFIG=/d' $(if $(DEFCONFIG),$(DEFCONFIG),$(CONFIG_DIR)/defconfig)
 855
 856 .PHONY: defconfig savedefconfig
 857
 858 ################################################################################
 859 #
 860 # Cleanup and misc junk
 861 #
 862 ################################################################################
 863
 864 # outputmakefile generates a Makefile in the output directory, if using a
 865 # separate output directory. This allows convenient use of make in the
 866 # output directory.
 867 outputmakefile:
 868 ifeq ($(NEED_WRAPPER),y)
 869         $(Q)$(TOPDIR)/support/scripts/mkmakefile $(TOPDIR) $(O)
 870 endif
 871
 872 # printvars prints all the variables currently defined in our
 873 # Makefiles. Alternatively, if a non-empty VARS variable is passed,
 874 # only the variables matching the make pattern passed in VARS are
 875 # displayed.
 876 printvars:
 877         @$(foreach V, \
 878                 $(sort $(if $(VARS),$(filter $(VARS),$(.VARIABLES)),$(.VARIABLES))), \
 879                 $(if $(filter-out environment% default automatic, \
 880                                 $(origin $V)), \
 881                 $(info $V=$($V) ($(value $V)))))
 882
 883 clean:
 884         rm -rf $(TARGET_DIR) $(BINARIES_DIR) $(HOST_DIR) \
 885                 $(BUILD_DIR) $(BASE_DIR)/staging \
 886                 $(LEGAL_INFO_DIR) $(GRAPHS_DIR)
 887
 888 distclean: clean
 889 ifeq ($(DL_DIR),$(TOPDIR)/dl)
 890         rm -rf $(DL_DIR)
 891 endif
 892 ifeq ($(O),output)
 893         rm -rf $(O)
 894 endif
 895         rm -rf $(BR2_CONFIG) $(CONFIG_DIR)/.config.old $(CONFIG_DIR)/..config.tmp \
 896                 $(CONFIG_DIR)/.auto.deps $(BR2_EXTERNAL_FILE)
 897
 898 help: help-internal help-custom
 899
 900 help-internal:
 901         @echo 'Cleaning:'
 902         @echo '  clean                  - delete all files created by build'
 903         @echo '  distclean              - delete all non-source files (including .config)'
 904         @echo
 905         @echo 'Build:'
 906         @echo '  all                    - make world'
 907         @echo '  toolchain              - build toolchain'
 908         @echo
 909         @echo 'Configuration:'
 910         @echo '  menuconfig             - interactive curses-based configurator'
 911         @echo '  nconfig                - interactive ncurses-based configurator'
 912         @echo '  xconfig                - interactive Qt-based configurator'
 913         @echo '  gconfig                - interactive GTK-based configurator'
 914         @echo '  oldconfig              - resolve any unresolved symbols in .config'
 915         @echo '  silentoldconfig        - Same as oldconfig, but quietly, additionally update deps'
 916         @echo '  olddefconfig           - Same as silentoldconfig but sets new symbols to their default value'
 917         @echo '  randconfig             - New config with random answer to all options'
 918         @echo '  defconfig              - New config with default answer to all options'
 919         @echo '                             BR2_DEFCONFIG, if set, is used as input'
 920         @echo '  savedefconfig          - Save current config to BR2_DEFCONFIG (minimal config)'
 921         @echo '  allyesconfig           - New config where all options are accepted with yes'
 922         @echo '  allnoconfig            - New config where all options are answered with no'
 923         @echo '  randpackageconfig      - New config with random answer to package options'
 924         @echo '  allyespackageconfig    - New config where pkg options are accepted with yes'
 925         @echo '  allnopackageconfig     - New config where package options are answered with no'
 926         @echo
 927         @echo 'Package-specific:'
 928         @echo '  <pkg>                  - Build and install <pkg> and all its dependencies'
 929         @echo '  <pkg>-source           - Only download the source files for <pkg>'
 930         @echo '  <pkg>-extract          - Extract <pkg> sources'
 931         @echo '  <pkg>-patch            - Apply patches to <pkg>'
 932         @echo '  <pkg>-depends          - Build <pkg>'\''s dependencies'
 933         @echo '  <pkg>-configure        - Build <pkg> up to the configure step'
 934         @echo '  <pkg>-build            - Build <pkg> up to the build step'
 935         @echo '  <pkg>-graph-depends    - Generate a graph of <pkg>'\''s dependencies'
 936         @echo '  <pkg>-dirclean         - Remove <pkg> build directory'
 937         @echo '  <pkg>-reconfigure      - Restart the build from the configure step'
 938         @echo '  <pkg>-rebuild          - Restart the build from the build step'
 939 ifeq ($(BR2_PACKAGE_BUSYBOX),y)
 940         @echo '  busybox-menuconfig     - Run BusyBox menuconfig'
 941 endif
 942 ifeq ($(BR2_LINUX_KERNEL),y)
 943         @echo '  linux-menuconfig       - Run Linux kernel menuconfig'
 944         @echo '  linux-savedefconfig    - Run Linux kernel savedefconfig'
 945         @echo '  linux-update-defconfig - Save the Linux configuration to the path specified'
 946         @echo '                             by BR2_LINUX_KERNEL_CUSTOM_CONFIG_FILE'
 947 endif
 948 ifeq ($(BR2_TOOLCHAIN_BUILDROOT),y)
 949         @echo '  uclibc-menuconfig      - Run uClibc menuconfig'
 950 endif
 951 ifeq ($(BR2_TARGET_BAREBOX),y)
 952         @echo '  barebox-menuconfig     - Run barebox menuconfig'
 953         @echo '  barebox-savedefconfig  - Run barebox savedefconfig'
 954 endif
 955         @echo
 956         @echo 'Documentation:'
 957         @echo '  manual                 - build manual in all formats'
 958         @echo '  manual-html            - build manual in HTML'
 959         @echo '  manual-split-html      - build manual in split HTML'
 960         @echo '  manual-pdf             - build manual in PDF'
 961         @echo '  manual-text            - build manual in text'
 962         @echo '  manual-epub            - build manual in ePub'
 963         @echo '  graph-build            - generate graphs of the build times'
 964         @echo '  graph-depends          - generate graph of the dependency tree'
 965         @echo '  graph-size             - generate stats of the filesystem size'
 966         @echo '  list-defconfigs        - list all defconfigs (pre-configured minimal systems)'
 967         @echo
 968         @echo 'Miscellaneous:'
 969         @echo '  source                 - download all sources needed for offline-build'
 970         @echo '  source-check           - check selected packages for valid download URLs'
 971         @echo '  external-deps          - list external packages used'
 972         @echo '  legal-info             - generate info about license compliance'
 973         @echo
 974         @echo '  make V=0|1             - 0 => quiet build (default), 1 => verbose build'
 975         @echo '  make O=dir             - Locate all output files in "dir", including .config'
 976         @echo
 977         @echo 'For further details, see README, generate the Buildroot manual, or consult'
 978         @echo 'it on-line at http://buildroot.org/docs.html'
 979         @echo
 980
 981 # This rule does nothing, it is expected to be overloaded by
 982 # a br2-external tree or a local.mk . However, it must exist,
 983 # as we reference it in the main help, above. Making the rule
 984 # .PHONY does not work.
 985 help-custom:
 986
 987 list-defconfigs:
 988         @echo 'Built-in configs:'
 989         @$(foreach b, $(sort $(notdir $(wildcard $(TOPDIR)/configs/*_defconfig))), \
 990           printf "  %-35s - Build for %s\\n" $(b) $(b:_defconfig=);)
 991 ifneq ($(wildcard $(BR2_EXTERNAL)/configs/*_defconfig),)
 992         @echo
 993         @echo 'User-provided configs:'
 994         @$(foreach b, $(sort $(notdir $(wildcard $(BR2_EXTERNAL)/configs/*_defconfig))), \
 995           printf "  %-35s - Build for %s\\n" $(b) $(b:_defconfig=);)
 996 endif
 997         @echo
 998
 999 release: OUT = buildroot-$(BR2_VERSION)
1000
1001 # Create release tarballs. We need to fiddle a bit to add the generated
1002 # documentation to the git output
1003 release:
1004         git archive --format=tar --prefix=$(OUT)/ HEAD > $(OUT).tar
1005         $(MAKE) O=$(OUT) manual-html manual-text manual-pdf
1006         $(MAKE) O=$(OUT) manual-clean
1007         tar rf $(OUT).tar $(OUT)
1008         gzip -9 -c < $(OUT).tar > $(OUT).tar.gz
1009         bzip2 -9 -c < $(OUT).tar > $(OUT).tar.bz2
1010         rm -rf $(OUT) $(OUT).tar
1011
1012 print-version:
1013         @echo $(BR2_VERSION_FULL)
1014
1015 include docs/manual/manual.mk
1016 -include $(BR2_EXTERNAL)/docs/*/*.mk
1017
1018 .PHONY: $(noconfig_targets)
1019
1020 endif #umask