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.08-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
  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 # Strip quotes and then whitespaces
 110 qstrip = $(strip $(subst ",,$(1)))
 111 #"))
 112
 113 # Variables for use in Make constructs
 114 comma := ,
 115 empty :=
 116 space := $(empty) $(empty)
 117
 118 ifneq ("$(origin O)", "command line")
 119 O := output
 120 CONFIG_DIR := $(TOPDIR)
 121 NEED_WRAPPER =
 122 else
 123 # other packages might also support Linux-style out of tree builds
 124 # with the O=<dir> syntax (E.G. BusyBox does). As make automatically
 125 # forwards command line variable definitions those packages get very
 126 # confused. Fix this by telling make to not do so
 127 MAKEOVERRIDES =
 128 # strangely enough O is still passed to submakes with MAKEOVERRIDES
 129 # (with make 3.81 atleast), the only thing that changes is the output
 130 # of the origin function (command line -> environment).
 131 # Unfortunately some packages don't look at origin (E.G. uClibc 0.9.31+)
 132 # To really make O go away, we have to override it.
 133 override O := $(O)
 134 CONFIG_DIR := $(O)
 135 # we need to pass O= everywhere we call back into the toplevel makefile
 136 EXTRAMAKEARGS = O=$(O)
 137 NEED_WRAPPER = y
 138 endif
 139
 140 # bash prints the name of the directory on 'cd <dir>' if CDPATH is
 141 # set, so unset it here to not cause problems. Notice that the export
 142 # line doesn't affect the environment of $(shell ..) calls, so
 143 # explictly throw away any output from 'cd' here.
 144 export CDPATH :=
 145 BASE_DIR := $(shell mkdir -p $(O) && cd $(O) >/dev/null && pwd)
 146 $(if $(BASE_DIR),, $(error output directory "$(O)" does not exist))
 147
 148
 149 # Handling of BR2_EXTERNAL.
 150 #
 151 # The value of BR2_EXTERNAL is stored in .br-external in the output directory.
 152 # On subsequent invocations of make, it is read in. It can still be overridden
 153 # on the command line, therefore the file is re-created every time make is run.
 154 #
 155 # When BR2_EXTERNAL is set to an empty value (e.g. explicitly in command
 156 # line), the .br-external file is removed and we point to
 157 # support/dummy-external. This makes sure we can unconditionally include the
 158 # Config.in and external.mk from the BR2_EXTERNAL directory. In this case,
 159 # override is necessary so the user can clear BR2_EXTERNAL from the command
 160 # line, but the dummy path is still used internally.
 161
 162 BR2_EXTERNAL_FILE = $(BASE_DIR)/.br-external
 163 -include $(BR2_EXTERNAL_FILE)
 164 ifeq ($(BR2_EXTERNAL),)
 165   override BR2_EXTERNAL = support/dummy-external
 166   $(shell rm -f $(BR2_EXTERNAL_FILE))
 167 else
 168   _BR2_EXTERNAL = $(shell cd $(BR2_EXTERNAL) >/dev/null 2>&1 && pwd)
 169   ifeq ($(_BR2_EXTERNAL),)
 170     $(error BR2_EXTERNAL='$(BR2_EXTERNAL)' does not exist, relative to $(TOPDIR))
 171   endif
 172   override BR2_EXTERNAL := $(_BR2_EXTERNAL)
 173   $(shell echo BR2_EXTERNAL ?= $(BR2_EXTERNAL) > $(BR2_EXTERNAL_FILE))
 174 endif
 175
 176 # To make sure that the environment variable overrides the .config option,
 177 # set this before including .config.
 178 ifneq ($(BR2_DL_DIR),)
 179 DL_DIR := $(BR2_DL_DIR)
 180 endif
 181 ifneq ($(BR2_CCACHE_DIR),)
 182 BR_CACHE_DIR := $(BR2_CCACHE_DIR)
 183 endif
 184
 185 # Need that early, before we scan packages
 186 # Avoids doing the $(or...) everytime
 187 BR_GRAPH_OUT := $(or $(BR2_GRAPH_OUT),pdf)
 188
 189 BUILD_DIR := $(BASE_DIR)/build
 190 BINARIES_DIR := $(BASE_DIR)/images
 191 TARGET_DIR := $(BASE_DIR)/target
 192 # initial definition so that 'make clean' works for most users, even without
 193 # .config. HOST_DIR will be overwritten later when .config is included.
 194 HOST_DIR := $(BASE_DIR)/host
 195 GRAPHS_DIR := $(BASE_DIR)/graphs
 196
 197 LEGAL_INFO_DIR = $(BASE_DIR)/legal-info
 198 REDIST_SOURCES_DIR_TARGET = $(LEGAL_INFO_DIR)/sources
 199 REDIST_SOURCES_DIR_HOST = $(LEGAL_INFO_DIR)/host-sources
 200 LICENSE_FILES_DIR_TARGET = $(LEGAL_INFO_DIR)/licenses
 201 LICENSE_FILES_DIR_HOST = $(LEGAL_INFO_DIR)/host-licenses
 202 LEGAL_MANIFEST_CSV_TARGET = $(LEGAL_INFO_DIR)/manifest.csv
 203 LEGAL_MANIFEST_CSV_HOST = $(LEGAL_INFO_DIR)/host-manifest.csv
 204 LEGAL_LICENSES_TXT_TARGET = $(LEGAL_INFO_DIR)/licenses.txt
 205 LEGAL_LICENSES_TXT_HOST = $(LEGAL_INFO_DIR)/host-licenses.txt
 206 LEGAL_WARNINGS = $(LEGAL_INFO_DIR)/.warnings
 207 LEGAL_REPORT = $(LEGAL_INFO_DIR)/README
 208
 209 BR2_CONFIG = $(CONFIG_DIR)/.config
 210
 211 # Pull in the user's configuration file
 212 ifeq ($(filter $(noconfig_targets),$(MAKECMDGOALS)),)
 213 -include $(BR2_CONFIG)
 214 endif
 215
 216 # To put more focus on warnings, be less verbose as default
 217 # Use 'make V=1' to see the full commands
 218 ifeq ("$(origin V)", "command line")
 219   KBUILD_VERBOSE = $(V)
 220 endif
 221 ifndef KBUILD_VERBOSE
 222   KBUILD_VERBOSE = 0
 223 endif
 224
 225 ifeq ($(KBUILD_VERBOSE),1)
 226   Q =
 227 ifndef VERBOSE
 228   VERBOSE = 1
 229 endif
 230 export VERBOSE
 231 else
 232   Q = @
 233 endif
 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                         if [ -e "$${langdir}" ]; \
 587                         then \
 588                                 grep -qx "$${langdir##*/}" $(LOCALE_WHITELIST) || rm -rf $$langdir; \
 589                         fi \
 590                 done; \
 591         done
 592         if [ -d $(TARGET_DIR)/usr/share/X11/locale ]; \
 593         then \
 594                 for lang in $(LOCALE_NOPURGE); \
 595                 do \
 596                         if [ -f $(TARGET_DIR)/usr/share/X11/locale/$$lang/XLC_LOCALE ]; \
 597                         then \
 598                                 echo "$$lang/XLC_LOCALE: $$lang"; \
 599                         fi \
 600                 done > $(TARGET_DIR)/usr/share/X11/locale/locale.dir; \
 601         fi
 602 endef
 603 TARGET_FINALIZE_HOOKS += PURGE_LOCALES
 604 endif
 605
 606 $(TARGETS_ROOTFS): target-finalize
 607
 608 target-finalize: $(PACKAGES)
 609         @$(call MESSAGE,"Finalizing target directory")
 610         $(foreach hook,$(TARGET_FINALIZE_HOOKS),$($(hook))$(sep))
 611         rm -rf $(TARGET_DIR)/usr/include $(TARGET_DIR)/usr/share/aclocal \
 612                 $(TARGET_DIR)/usr/lib/pkgconfig $(TARGET_DIR)/usr/share/pkgconfig \
 613                 $(TARGET_DIR)/usr/lib/cmake $(TARGET_DIR)/usr/share/cmake
 614         find $(TARGET_DIR)/usr/{lib,share}/ -name '*.cmake' -print0 | xargs -0 rm -f
 615         find $(TARGET_DIR)/lib $(TARGET_DIR)/usr/lib $(TARGET_DIR)/usr/libexec \
 616                 \( -name '*.a' -o -name '*.la' \) -print0 | xargs -0 rm -f
 617 ifneq ($(BR2_PACKAGE_GDB),y)
 618         rm -rf $(TARGET_DIR)/usr/share/gdb
 619 endif
 620 ifneq ($(BR2_PACKAGE_BASH),y)
 621         rm -rf $(TARGET_DIR)/usr/share/bash-completion
 622 endif
 623 ifneq ($(BR2_PACKAGE_ZSH),y)
 624         rm -rf $(TARGET_DIR)/usr/share/zsh
 625 endif
 626         rm -rf $(TARGET_DIR)/usr/man $(TARGET_DIR)/usr/share/man
 627         rm -rf $(TARGET_DIR)/usr/info $(TARGET_DIR)/usr/share/info
 628         rm -rf $(TARGET_DIR)/usr/doc $(TARGET_DIR)/usr/share/doc
 629         rm -rf $(TARGET_DIR)/usr/share/gtk-doc
 630         -rmdir $(TARGET_DIR)/usr/share 2>/dev/null
 631         $(STRIP_FIND_CMD) | xargs -0 $(STRIPCMD) 2>/dev/null || true
 632         if test -d $(TARGET_DIR)/lib/modules; then \
 633                 find $(TARGET_DIR)/lib/modules -type f -name '*.ko' -print0 | \
 634                 xargs -0 -r $(KSTRIPCMD); fi
 635
 636 # See http://sourceware.org/gdb/wiki/FAQ, "GDB does not see any threads
 637 # besides the one in which crash occurred; or SIGTRAP kills my program when
 638 # I set a breakpoint"
 639 ifeq ($(BR2_TOOLCHAIN_HAS_THREADS),y)
 640         find $(TARGET_DIR)/lib -type f -name 'libpthread*.so*' | \
 641                 xargs -r $(STRIPCMD) $(STRIP_STRIP_DEBUG)
 642 endif
 643
 644 # Valgrind needs ld.so with enough information, so only strip
 645 # debugging symbols.
 646         find $(TARGET_DIR)/lib -type f -name 'ld-*.so*' | \
 647                 xargs -r $(STRIPCMD) $(STRIP_STRIP_DEBUG)
 648         test -f $(TARGET_DIR)/etc/ld.so.conf && \
 649                 { echo "ERROR: we shouldn't have a /etc/ld.so.conf file"; exit 1; } || true
 650         test -d $(TARGET_DIR)/etc/ld.so.conf.d && \
 651                 { echo "ERROR: we shouldn't have a /etc/ld.so.conf.d directory"; exit 1; } || true
 652         mkdir -p $(TARGET_DIR)/etc
 653         ( \
 654                 echo "NAME=Buildroot"; \
 655                 echo "VERSION=$(BR2_VERSION_FULL)"; \
 656                 echo "ID=buildroot"; \
 657                 echo "VERSION_ID=$(BR2_VERSION)"; \
 658                 echo "PRETTY_NAME=\"Buildroot $(BR2_VERSION)\"" \
 659         ) >  $(TARGET_DIR)/etc/os-release
 660
 661         @$(foreach d, $(call qstrip,$(BR2_ROOTFS_OVERLAY)), \
 662                 $(call MESSAGE,"Copying overlay $(d)"); \
 663                 rsync -a --ignore-times --keep-dirlinks $(RSYNC_VCS_EXCLUSIONS) \
 664                         --chmod=u=rwX,go=rX --exclude .empty --exclude '*~' \
 665                         $(d)/ $(TARGET_DIR)$(sep))
 666
 667         @$(foreach s, $(call qstrip,$(BR2_ROOTFS_POST_BUILD_SCRIPT)), \
 668                 $(call MESSAGE,"Executing post-build script $(s)"); \
 669                 $(EXTRA_ENV) $(s) $(TARGET_DIR) $(call qstrip,$(BR2_ROOTFS_POST_SCRIPT_ARGS))$(sep))
 670
 671 target-post-image: $(TARGETS_ROOTFS) target-finalize
 672         @$(foreach s, $(call qstrip,$(BR2_ROOTFS_POST_IMAGE_SCRIPT)), \
 673                 $(call MESSAGE,"Executing post-image script $(s)"); \
 674                 $(EXTRA_ENV) $(s) $(BINARIES_DIR) $(call qstrip,$(BR2_ROOTFS_POST_SCRIPT_ARGS))$(sep))
 675
 676 source: $(foreach p,$(PACKAGES),$(p)-all-source)
 677
 678 _external-deps: $(foreach p,$(PACKAGES),$(p)-all-external-deps)
 679 external-deps:
 680         @$(MAKE1) -Bs $(EXTRAMAKEARGS) _external-deps | sort -u
 681
 682 # check if download URLs are outdated
 683 source-check: $(foreach p,$(PACKAGES),$(p)-all-source-check)
 684
 685 legal-info-clean:
 686         @rm -fr $(LEGAL_INFO_DIR)
 687
 688 legal-info-prepare: $(LEGAL_INFO_DIR)
 689         @$(call MESSAGE,"Collecting legal info")
 690         @$(call legal-license-file,buildroot,COPYING,COPYING,HOST)
 691         @$(call legal-manifest,PACKAGE,VERSION,LICENSE,LICENSE FILES,SOURCE ARCHIVE,SOURCE SITE,TARGET)
 692         @$(call legal-manifest,PACKAGE,VERSION,LICENSE,LICENSE FILES,SOURCE ARCHIVE,SOURCE SITE,HOST)
 693         @$(call legal-manifest,buildroot,$(BR2_VERSION_FULL),GPLv2+,COPYING,not saved,not saved,HOST)
 694         @$(call legal-warning,the Buildroot source code has not been saved)
 695         @cp $(BR2_CONFIG) $(LEGAL_INFO_DIR)/buildroot.config
 696
 697 legal-info: dirs legal-info-clean legal-info-prepare $(foreach p,$(PACKAGES),$(p)-all-legal-info) \
 698                 $(REDIST_SOURCES_DIR_TARGET) $(REDIST_SOURCES_DIR_HOST)
 699         @cat support/legal-info/README.header >>$(LEGAL_REPORT)
 700         @if [ -r $(LEGAL_WARNINGS) ]; then \
 701                 cat support/legal-info/README.warnings-header \
 702                         $(LEGAL_WARNINGS) >>$(LEGAL_REPORT); \
 703                 cat $(LEGAL_WARNINGS); fi
 704         @rm -f $(LEGAL_WARNINGS)
 705         @(cd $(LEGAL_INFO_DIR); \
 706                 find * -type f -exec sha256sum {} + | LC_ALL=C sort -k2 \
 707                         >.legal-info.sha256; \
 708                 mv .legal-info.sha256 legal-info.sha256)
 709         @echo "Legal info produced in $(LEGAL_INFO_DIR)"
 710
 711 show-targets:
 712         @echo $(PACKAGES) $(TARGETS_ROOTFS)
 713
 714 graph-build: $(O)/build/build-time.log
 715         @install -d $(GRAPHS_DIR)
 716         $(foreach o,name build duration,./support/scripts/graph-build-time \
 717                                         --type=histogram --order=$(o) --input=$(<) \
 718                                         --output=$(GRAPHS_DIR)/build.hist-$(o).$(BR_GRAPH_OUT) \
 719                                         $(if $(BR2_GRAPH_ALT),--alternate-colors)$(sep))
 720         $(foreach t,packages steps,./support/scripts/graph-build-time \
 721                                    --type=pie-$(t) --input=$(<) \
 722                                    --output=$(GRAPHS_DIR)/build.pie-$(t).$(BR_GRAPH_OUT) \
 723                                    $(if $(BR2_GRAPH_ALT),--alternate-colors)$(sep))
 724
 725 graph-depends-requirements:
 726         @dot -? >/dev/null 2>&1 || \
 727                 { echo "ERROR: The 'dot' program from Graphviz is needed for graph-depends" >&2; exit 1; }
 728
 729 graph-depends: graph-depends-requirements
 730         @$(INSTALL) -d $(GRAPHS_DIR)
 731         @cd "$(CONFIG_DIR)"; \
 732         $(TOPDIR)/support/scripts/graph-depends $(BR2_GRAPH_DEPS_OPTS) \
 733                 -o $(GRAPHS_DIR)/$(@).dot
 734         dot $(BR2_GRAPH_DOT_OPTS) -T$(BR_GRAPH_OUT) \
 735                 -o $(GRAPHS_DIR)/$(@).$(BR_GRAPH_OUT) \
 736                 $(GRAPHS_DIR)/$(@).dot
 737
 738 graph-size:
 739         $(Q)mkdir -p $(GRAPHS_DIR)
 740         $(Q)$(TOPDIR)/support/scripts/size-stats --builddir $(BASE_DIR) \
 741                 --graph $(GRAPHS_DIR)/graph-size.$(BR_GRAPH_OUT) \
 742                 --file-size-csv $(GRAPHS_DIR)/file-size-stats.csv \
 743                 --package-size-csv $(GRAPHS_DIR)/package-size-stats.csv
 744
 745 check-dependencies:
 746         @cd "$(CONFIG_DIR)"; \
 747         $(TOPDIR)/support/scripts/graph-depends -C
 748
 749 else # ifeq ($(BR2_HAVE_DOT_CONFIG),y)
 750
 751 all: menuconfig
 752
 753 endif # ifeq ($(BR2_HAVE_DOT_CONFIG),y)
 754
 755 # configuration
 756 # ---------------------------------------------------------------------------
 757
 758 HOSTCFLAGS = $(CFLAGS_FOR_BUILD)
 759 export HOSTCFLAGS
 760
 761 $(BUILD_DIR)/buildroot-config/%onf:
 762         mkdir -p $(@D)/lxdialog
 763         PKG_CONFIG_PATH="$(HOST_PKG_CONFIG_PATH)" $(MAKE) CC="$(HOSTCC_NOCCACHE)" HOSTCC="$(HOSTCC_NOCCACHE)" \
 764             obj=$(@D) -C $(CONFIG) -f Makefile.br $(@F)
 765
 766 DEFCONFIG = $(call qstrip,$(BR2_DEFCONFIG))
 767
 768 # We don't want to fully expand BR2_DEFCONFIG here, so Kconfig will
 769 # recognize that if it's still at its default $(CONFIG_DIR)/defconfig
 770 COMMON_CONFIG_ENV = \
 771         BR2_DEFCONFIG='$(call qstrip,$(value BR2_DEFCONFIG))' \
 772         KCONFIG_AUTOCONFIG=$(BUILD_DIR)/buildroot-config/auto.conf \
 773         KCONFIG_AUTOHEADER=$(BUILD_DIR)/buildroot-config/autoconf.h \
 774         KCONFIG_TRISTATE=$(BUILD_DIR)/buildroot-config/tristate.config \
 775         BR2_CONFIG=$(BR2_CONFIG) \
 776         BR2_EXTERNAL=$(BR2_EXTERNAL) \
 777         HOST_GCC_VERSION="$(HOSTCC_VERSION)" \
 778         SKIP_LEGACY=
 779
 780 xconfig: $(BUILD_DIR)/buildroot-config/qconf outputmakefile
 781         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
 782
 783 gconfig: $(BUILD_DIR)/buildroot-config/gconf outputmakefile
 784         @$(COMMON_CONFIG_ENV) srctree=$(TOPDIR) $< $(CONFIG_CONFIG_IN)
 785
 786 menuconfig: $(BUILD_DIR)/buildroot-config/mconf outputmakefile
 787         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
 788
 789 nconfig: $(BUILD_DIR)/buildroot-config/nconf outputmakefile
 790         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
 791
 792 config: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 793         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
 794
 795 # For the config targets that automatically select options, we pass
 796 # SKIP_LEGACY=y to disable the legacy options. However, in that case
 797 # no values are set for the legacy options so a subsequent oldconfig
 798 # will query them. Therefore, run an additional olddefconfig.
 799
 800 oldconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 801         @$(COMMON_CONFIG_ENV) $< --oldconfig $(CONFIG_CONFIG_IN)
 802
 803 randconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 804         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y $< --randconfig $(CONFIG_CONFIG_IN)
 805         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
 806
 807 allyesconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 808         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y $< --allyesconfig $(CONFIG_CONFIG_IN)
 809         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
 810
 811 allnoconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 812         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y $< --allnoconfig $(CONFIG_CONFIG_IN)
 813         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
 814
 815 randpackageconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 816         @grep -v BR2_PACKAGE_ $(BR2_CONFIG) > $(CONFIG_DIR)/.config.nopkg
 817         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y \
 818                 KCONFIG_ALLCONFIG=$(CONFIG_DIR)/.config.nopkg \
 819                 $< --randconfig $(CONFIG_CONFIG_IN)
 820         @rm -f $(CONFIG_DIR)/.config.nopkg
 821         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
 822
 823 allyespackageconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 824         @grep -v BR2_PACKAGE_ $(BR2_CONFIG) > $(CONFIG_DIR)/.config.nopkg
 825         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y \
 826                 KCONFIG_ALLCONFIG=$(CONFIG_DIR)/.config.nopkg \
 827                 $< --allyesconfig $(CONFIG_CONFIG_IN)
 828         @rm -f $(CONFIG_DIR)/.config.nopkg
 829         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
 830
 831 allnopackageconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 832         @grep -v BR2_PACKAGE_ $(BR2_CONFIG) > $(CONFIG_DIR)/.config.nopkg
 833         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y \
 834                 KCONFIG_ALLCONFIG=$(CONFIG_DIR)/.config.nopkg \
 835                 $< --allnoconfig $(CONFIG_CONFIG_IN)
 836         @rm -f $(CONFIG_DIR)/.config.nopkg
 837         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
 838
 839 silentoldconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 840         $(COMMON_CONFIG_ENV) $< --silentoldconfig $(CONFIG_CONFIG_IN)
 841
 842 olddefconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 843         $(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN)
 844
 845 defconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 846         @$(COMMON_CONFIG_ENV) $< --defconfig$(if $(DEFCONFIG),=$(DEFCONFIG)) $(CONFIG_CONFIG_IN)
 847
 848 # Override the BR2_DEFCONFIG from COMMON_CONFIG_ENV with the new defconfig
 849 %_defconfig: $(BUILD_DIR)/buildroot-config/conf $(TOPDIR)/configs/%_defconfig outputmakefile
 850         @$(COMMON_CONFIG_ENV) BR2_DEFCONFIG=$(TOPDIR)/configs/$@ \
 851                 $< --defconfig=$(TOPDIR)/configs/$@ $(CONFIG_CONFIG_IN)
 852
 853 %_defconfig: $(BUILD_DIR)/buildroot-config/conf $(BR2_EXTERNAL)/configs/%_defconfig outputmakefile
 854         @$(COMMON_CONFIG_ENV) BR2_DEFCONFIG=$(BR2_EXTERNAL)/configs/$@ \
 855                 $< --defconfig=$(BR2_EXTERNAL)/configs/$@ $(CONFIG_CONFIG_IN)
 856
 857 savedefconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 858         @$(COMMON_CONFIG_ENV) $< \
 859                 --savedefconfig=$(if $(DEFCONFIG),$(DEFCONFIG),$(CONFIG_DIR)/defconfig) \
 860                 $(CONFIG_CONFIG_IN)
 861         @$(SED) '/BR2_DEFCONFIG=/d' $(if $(DEFCONFIG),$(DEFCONFIG),$(CONFIG_DIR)/defconfig)
 862
 863 .PHONY: defconfig savedefconfig
 864
 865 ################################################################################
 866 #
 867 # Cleanup and misc junk
 868 #
 869 ################################################################################
 870
 871 # outputmakefile generates a Makefile in the output directory, if using a
 872 # separate output directory. This allows convenient use of make in the
 873 # output directory.
 874 outputmakefile:
 875 ifeq ($(NEED_WRAPPER),y)
 876         $(Q)$(TOPDIR)/support/scripts/mkmakefile $(TOPDIR) $(O)
 877 endif
 878
 879 # printvars prints all the variables currently defined in our
 880 # Makefiles. Alternatively, if a non-empty VARS variable is passed,
 881 # only the variables matching the make pattern passed in VARS are
 882 # displayed.
 883 printvars:
 884         @$(foreach V, \
 885                 $(sort $(if $(VARS),$(filter $(VARS),$(.VARIABLES)),$(.VARIABLES))), \
 886                 $(if $(filter-out environment% default automatic, \
 887                                 $(origin $V)), \
 888                 $(info $V=$($V) ($(value $V)))))
 889
 890 clean:
 891         rm -rf $(TARGET_DIR) $(BINARIES_DIR) $(HOST_DIR) \
 892                 $(BUILD_DIR) $(BASE_DIR)/staging \
 893                 $(LEGAL_INFO_DIR) $(GRAPHS_DIR)
 894
 895 distclean: clean
 896 ifeq ($(DL_DIR),$(TOPDIR)/dl)
 897         rm -rf $(DL_DIR)
 898 endif
 899 ifeq ($(O),output)
 900         rm -rf $(O)
 901 endif
 902         rm -rf $(BR2_CONFIG) $(CONFIG_DIR)/.config.old $(CONFIG_DIR)/..config.tmp \
 903                 $(CONFIG_DIR)/.auto.deps $(BR2_EXTERNAL_FILE)
 904
 905 help:
 906         @echo 'Cleaning:'
 907         @echo '  clean                  - delete all files created by build'
 908         @echo '  distclean              - delete all non-source files (including .config)'
 909         @echo
 910         @echo 'Build:'
 911         @echo '  all                    - make world'
 912         @echo '  toolchain              - build toolchain'
 913         @echo
 914         @echo 'Configuration:'
 915         @echo '  menuconfig             - interactive curses-based configurator'
 916         @echo '  nconfig                - interactive ncurses-based configurator'
 917         @echo '  xconfig                - interactive Qt-based configurator'
 918         @echo '  gconfig                - interactive GTK-based configurator'
 919         @echo '  oldconfig              - resolve any unresolved symbols in .config'
 920         @echo '  silentoldconfig        - Same as oldconfig, but quietly, additionally update deps'
 921         @echo '  olddefconfig           - Same as silentoldconfig but sets new symbols to their default value'
 922         @echo '  randconfig             - New config with random answer to all options'
 923         @echo '  defconfig              - New config with default answer to all options'
 924         @echo '                             BR2_DEFCONFIG, if set, is used as input'
 925         @echo '  savedefconfig          - Save current config to BR2_DEFCONFIG (minimal config)'
 926         @echo '  allyesconfig           - New config where all options are accepted with yes'
 927         @echo '  allnoconfig            - New config where all options are answered with no'
 928         @echo '  randpackageconfig      - New config with random answer to package options'
 929         @echo '  allyespackageconfig    - New config where pkg options are accepted with yes'
 930         @echo '  allnopackageconfig     - New config where package options are answered with no'
 931         @echo
 932         @echo 'Package-specific:'
 933         @echo '  <pkg>                  - Build and install <pkg> and all its dependencies'
 934         @echo '  <pkg>-source           - Only download the source files for <pkg>'
 935         @echo '  <pkg>-extract          - Extract <pkg> sources'
 936         @echo '  <pkg>-patch            - Apply patches to <pkg>'
 937         @echo '  <pkg>-depends          - Build <pkg>'\''s dependencies'
 938         @echo '  <pkg>-configure        - Build <pkg> up to the configure step'
 939         @echo '  <pkg>-build            - Build <pkg> up to the build step'
 940         @echo '  <pkg>-graph-depends    - Generate a graph of <pkg>'\''s dependencies'
 941         @echo '  <pkg>-dirclean         - Remove <pkg> build directory'
 942         @echo '  <pkg>-reconfigure      - Restart the build from the configure step'
 943         @echo '  <pkg>-rebuild          - Restart the build from the build step'
 944         $(foreach p,$(HELP_PACKAGES), \
 945                 @echo $(sep) \
 946                 @echo '$($(p)_NAME):' $(sep) \
 947                 $($(p)_HELP_CMDS)$(sep))
 948         @echo
 949         @echo 'Documentation:'
 950         @echo '  manual                 - build manual in all formats'
 951         @echo '  manual-html            - build manual in HTML'
 952         @echo '  manual-split-html      - build manual in split HTML'
 953         @echo '  manual-pdf             - build manual in PDF'
 954         @echo '  manual-text            - build manual in text'
 955         @echo '  manual-epub            - build manual in ePub'
 956         @echo '  graph-build            - generate graphs of the build times'
 957         @echo '  graph-depends          - generate graph of the dependency tree'
 958         @echo '  graph-size             - generate stats of the filesystem size'
 959         @echo '  list-defconfigs        - list all defconfigs (pre-configured minimal systems)'
 960         @echo
 961         @echo 'Miscellaneous:'
 962         @echo '  source                 - download all sources needed for offline-build'
 963         @echo '  source-check           - check selected packages for valid download URLs'
 964         @echo '  external-deps          - list external packages used'
 965         @echo '  legal-info             - generate info about license compliance'
 966         @echo
 967         @echo '  make V=0|1             - 0 => quiet build (default), 1 => verbose build'
 968         @echo '  make O=dir             - Locate all output files in "dir", including .config'
 969         @echo
 970         @echo 'For further details, see README, generate the Buildroot manual, or consult'
 971         @echo 'it on-line at http://buildroot.org/docs.html'
 972         @echo
 973
 974 list-defconfigs:
 975         @echo 'Built-in configs:'
 976         @$(foreach b, $(sort $(notdir $(wildcard $(TOPDIR)/configs/*_defconfig))), \
 977           printf "  %-35s - Build for %s\\n" $(b) $(b:_defconfig=);)
 978 ifneq ($(wildcard $(BR2_EXTERNAL)/configs/*_defconfig),)
 979         @echo
 980         @echo 'User-provided configs:'
 981         @$(foreach b, $(sort $(notdir $(wildcard $(BR2_EXTERNAL)/configs/*_defconfig))), \
 982           printf "  %-35s - Build for %s\\n" $(b) $(b:_defconfig=);)
 983 endif
 984         @echo
 985
 986 release: OUT = buildroot-$(BR2_VERSION)
 987
 988 # Create release tarballs. We need to fiddle a bit to add the generated
 989 # documentation to the git output
 990 release:
 991         git archive --format=tar --prefix=$(OUT)/ HEAD > $(OUT).tar
 992         $(MAKE) O=$(OUT) manual-html manual-text manual-pdf
 993         $(MAKE) O=$(OUT) manual-clean
 994         tar rf $(OUT).tar $(OUT)
 995         gzip -9 -c < $(OUT).tar > $(OUT).tar.gz
 996         bzip2 -9 -c < $(OUT).tar > $(OUT).tar.bz2
 997         rm -rf $(OUT) $(OUT).tar
 998
 999 print-version:
1000         @echo $(BR2_VERSION_FULL)
1001
1002 include docs/manual/manual.mk
1003 -include $(BR2_EXTERNAL)/docs/*/*.mk
1004
1005 .PHONY: $(noconfig_targets)
1006
1007 endif #umask