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