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