Makefile

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