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 ################################################################################
 235 #
 236 # staging and target directories do NOT list these as
 237 # dependencies anywhere else
 238 #
 239 ################################################################################
 240 $(BUILD_DIR) $(TARGET_DIR) $(HOST_DIR) $(BINARIES_DIR) $(LEGAL_INFO_DIR) $(REDIST_SOURCES_DIR_TARGET) $(REDIST_SOURCES_DIR_HOST):
 241         @mkdir -p $@
 242
 243 BR2_CONFIG = $(CONFIG_DIR)/.config
 244
 245 # Pull in the user's configuration file
 246 ifeq ($(filter $(noconfig_targets),$(MAKECMDGOALS)),)
 247 -include $(BR2_CONFIG)
 248 endif
 249
 250 # timezone and locale may affect build output
 251 ifeq ($(BR2_REPRODUCIBLE),y)
 252 export TZ = UTC
 253 export LANG = C
 254 export LC_ALL = C
 255 export GZIP = -n
 256 BR2_VERSION_GIT_EPOCH = $(shell GIT_DIR=$(TOPDIR)/.git $(GIT) log -1 --format=%at)
 257 export SOURCE_DATE_EPOCH ?= $(if $(wildcard $(TOPDIR)/.git),$(BR2_VERSION_GIT_EPOCH),$(BR2_VERSION_EPOCH))
 258 DEPENDENCIES_HOST_PREREQ += host-fakedate
 259 endif
 260
 261 # To put more focus on warnings, be less verbose as default
 262 # Use 'make V=1' to see the full commands
 263 ifeq ("$(origin V)", "command line")
 264   KBUILD_VERBOSE = $(V)
 265 endif
 266 ifndef KBUILD_VERBOSE
 267   KBUILD_VERBOSE = 0
 268 endif
 269
 270 ifeq ($(KBUILD_VERBOSE),1)
 271   Q =
 272 ifndef VERBOSE
 273   VERBOSE = 1
 274 endif
 275 export VERBOSE
 276 else
 277   Q = @
 278 endif
 279
 280 # kconfig uses CONFIG_SHELL
 281 CONFIG_SHELL := $(SHELL)
 282
 283 export SHELL CONFIG_SHELL Q KBUILD_VERBOSE
 284
 285 ifndef HOSTAR
 286 HOSTAR := ar
 287 endif
 288 ifndef HOSTAS
 289 HOSTAS := as
 290 endif
 291 ifndef HOSTCC
 292 HOSTCC := gcc
 293 HOSTCC := $(shell which $(HOSTCC) || type -p $(HOSTCC) || echo gcc)
 294 endif
 295 HOSTCC_NOCCACHE := $(HOSTCC)
 296 ifndef HOSTCXX
 297 HOSTCXX := g++
 298 HOSTCXX := $(shell which $(HOSTCXX) || type -p $(HOSTCXX) || echo g++)
 299 endif
 300 HOSTCXX_NOCCACHE := $(HOSTCXX)
 301 ifndef HOSTCPP
 302 HOSTCPP := cpp
 303 endif
 304 ifndef HOSTLD
 305 HOSTLD := ld
 306 endif
 307 ifndef HOSTLN
 308 HOSTLN := ln
 309 endif
 310 ifndef HOSTNM
 311 HOSTNM := nm
 312 endif
 313 ifndef HOSTOBJCOPY
 314 HOSTOBJCOPY := objcopy
 315 endif
 316 ifndef HOSTRANLIB
 317 HOSTRANLIB := ranlib
 318 endif
 319 HOSTAR := $(shell which $(HOSTAR) || type -p $(HOSTAR) || echo ar)
 320 HOSTAS := $(shell which $(HOSTAS) || type -p $(HOSTAS) || echo as)
 321 HOSTCPP := $(shell which $(HOSTCPP) || type -p $(HOSTCPP) || echo cpp)
 322 HOSTLD := $(shell which $(HOSTLD) || type -p $(HOSTLD) || echo ld)
 323 HOSTLN := $(shell which $(HOSTLN) || type -p $(HOSTLN) || echo ln)
 324 HOSTNM := $(shell which $(HOSTNM) || type -p $(HOSTNM) || echo nm)
 325 HOSTOBJCOPY := $(shell which $(HOSTOBJCOPY) || type -p $(HOSTOBJCOPY) || echo objcopy)
 326 HOSTRANLIB := $(shell which $(HOSTRANLIB) || type -p $(HOSTRANLIB) || echo ranlib)
 327 SED := $(shell which sed || type -p sed) -i -e
 328
 329 export HOSTAR HOSTAS HOSTCC HOSTCXX HOSTLD
 330 export HOSTCC_NOCCACHE HOSTCXX_NOCCACHE
 331
 332 # Determine the userland we are running on.
 333 #
 334 # Note that, despite its name, we are not interested in the actual
 335 # architecture name. This is mostly used to determine whether some
 336 # of the binary tools (e.g. pre-built external toolchains) can run
 337 # on the current host. So we need to know if the userland we're
 338 # running on can actually run those toolchains.
 339 #
 340 # For example, a 64-bit prebuilt toolchain will not run on a 64-bit
 341 # kernel if the userland is 32-bit (e.g. in a chroot for example).
 342 #
 343 # So, we extract the first part of the tuple the host gcc was
 344 # configured to generate code for; we assume this is our userland.
 345 #
 346 export HOSTARCH := $(shell LC_ALL=C $(HOSTCC_NOCCACHE) -v 2>&1 | \
 347         sed -e '/^Target: \([^-]*\).*/!d' \
 348             -e 's//\1/' \
 349             -e 's/i.86/x86/' \
 350             -e 's/sun4u/sparc64/' \
 351             -e 's/arm.*/arm/' \
 352             -e 's/sa110/arm/' \
 353             -e 's/ppc64/powerpc64/' \
 354             -e 's/ppc/powerpc/' \
 355             -e 's/macppc/powerpc/' \
 356             -e 's/sh.*/sh/' )
 357
 358 HOSTCC_VERSION := $(shell $(HOSTCC_NOCCACHE) --version | \
 359         sed -n -r 's/^.* ([0-9]*)\.([0-9]*)\.([0-9]*)[ ]*.*/\1 \2/p')
 360
 361 # For gcc >= 5.x, we only need the major version.
 362 ifneq ($(firstword $(HOSTCC_VERSION)),4)
 363 HOSTCC_VERSION := $(firstword $(HOSTCC_VERSION))
 364 endif
 365
 366 ifeq ($(BR2_NEEDS_HOST_UTF8_LOCALE),y)
 367 # First, we try to use the user's configured locale (as that's the
 368 # language they'd expect messages to be displayed), then we favour
 369 # a non language-specific locale like C.UTF-8 if one is available,
 370 # so we sort with the C locale to get it at the top.
 371 # This is guaranteed to not be empty, because of the check in
 372 # support/dependencies/dependencies.sh
 373 HOST_UTF8_LOCALE := $(shell \
 374                         ( echo $${LC_ALL:-$${LC_MESSAGES:-$${LANG}}}; \
 375                           locale -a 2>/dev/null | LC_ALL=C sort \
 376                         ) \
 377                         | grep -i -E 'utf-?8$$' \
 378                         | head -n 1)
 379 HOST_UTF8_LOCALE_ENV := LC_ALL=$(HOST_UTF8_LOCALE)
 380 endif
 381
 382 # Make sure pkg-config doesn't look outside the buildroot tree
 383 HOST_PKG_CONFIG_PATH := $(PKG_CONFIG_PATH)
 384 unexport PKG_CONFIG_PATH
 385 unexport PKG_CONFIG_SYSROOT_DIR
 386 unexport PKG_CONFIG_LIBDIR
 387
 388 # Having DESTDIR set in the environment confuses the installation
 389 # steps of some packages.
 390 unexport DESTDIR
 391
 392 # Causes breakage with packages that needs host-ruby
 393 unexport RUBYOPT
 394
 395 include package/pkg-utils.mk
 396 include package/doc-asciidoc.mk
 397
 398 ifeq ($(BR2_HAVE_DOT_CONFIG),y)
 399
 400 ################################################################################
 401 #
 402 # Hide troublesome environment variables from sub processes
 403 #
 404 ################################################################################
 405 unexport CROSS_COMPILE
 406 unexport ARCH
 407 unexport CC
 408 unexport LD
 409 unexport AR
 410 unexport CXX
 411 unexport CPP
 412 unexport RANLIB
 413 unexport CFLAGS
 414 unexport CXXFLAGS
 415 unexport GREP_OPTIONS
 416 unexport TAR_OPTIONS
 417 unexport CONFIG_SITE
 418 unexport QMAKESPEC
 419 unexport TERMINFO
 420 unexport MACHINE
 421 unexport O
 422 unexport GCC_COLORS
 423
 424 GNU_HOST_NAME := $(shell support/gnuconfig/config.guess)
 425
 426 PACKAGES :=
 427 PACKAGES_ALL :=
 428
 429 # silent mode requested?
 430 QUIET := $(if $(findstring s,$(filter-out --%,$(MAKEFLAGS))),-q)
 431
 432 # Strip off the annoying quoting
 433 ARCH := $(call qstrip,$(BR2_ARCH))
 434
 435 KERNEL_ARCH := $(shell echo "$(ARCH)" | sed -e "s/-.*//" \
 436         -e s/i.86/i386/ -e s/sun4u/sparc64/ \
 437         -e s/arcle/arc/ \
 438         -e s/arceb/arc/ \
 439         -e s/arm.*/arm/ -e s/sa110/arm/ \
 440         -e s/aarch64.*/arm64/ \
 441         -e s/bfin/blackfin/ \
 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/sh.*/sh/ \
 447         -e s/microblazeel/microblaze/)
 448
 449 ZCAT := $(call qstrip,$(BR2_ZCAT))
 450 BZCAT := $(call qstrip,$(BR2_BZCAT))
 451 XZCAT := $(call qstrip,$(BR2_XZCAT))
 452 LZCAT := $(call qstrip,$(BR2_LZCAT))
 453 TAR_OPTIONS = $(call qstrip,$(BR2_TAR_OPTIONS)) -xf
 454
 455 # packages compiled for the host go here
 456 HOST_DIR := $(call qstrip,$(BR2_HOST_DIR))
 457
 458 # Quotes are needed for spaces and all in the original PATH content.
 459 BR_PATH = "$(HOST_DIR)/bin:$(HOST_DIR)/sbin:$(PATH)"
 460
 461 # Location of a file giving a big fat warning that output/target
 462 # should not be used as the root filesystem.
 463 TARGET_DIR_WARNING_FILE = $(TARGET_DIR)/THIS_IS_NOT_YOUR_ROOT_FILESYSTEM
 464
 465 ifeq ($(BR2_CCACHE),y)
 466 CCACHE := $(HOST_DIR)/bin/ccache
 467 BR_CACHE_DIR ?= $(call qstrip,$(BR2_CCACHE_DIR))
 468 export BR_CACHE_DIR
 469 HOSTCC := $(CCACHE) $(HOSTCC)
 470 HOSTCXX := $(CCACHE) $(HOSTCXX)
 471 else
 472 export BR_NO_CCACHE
 473 endif
 474
 475 # Scripts in support/ or post-build scripts may need to reference
 476 # these locations, so export them so it is easier to use
 477 export BR2_CONFIG
 478 export BR2_REPRODUCIBLE
 479 export TARGET_DIR
 480 export STAGING_DIR
 481 export HOST_DIR
 482 export BINARIES_DIR
 483 export BASE_DIR
 484
 485 ################################################################################
 486 #
 487 # You should probably leave this stuff alone unless you know
 488 # what you are doing.
 489 #
 490 ################################################################################
 491
 492 all: world
 493
 494 # Include legacy before the other things, because package .mk files
 495 # may rely on it.
 496 include Makefile.legacy
 497
 498 include system/system.mk
 499 include package/Makefile.in
 500 # arch/arch.mk.* must be after package/Makefile.in because it may need to
 501 # complement variables defined therein, like BR_NO_CHECK_HASH_FOR.
 502 -include $(sort $(wildcard arch/arch.mk.*))
 503 include support/dependencies/dependencies.mk
 504
 505 PACKAGES += $(DEPENDENCIES_HOST_PREREQ)
 506
 507 include $(sort $(wildcard toolchain/*.mk))
 508 include $(sort $(wildcard toolchain/*/*.mk))
 509
 510 # Include the package override file if one has been provided in the
 511 # configuration.
 512 PACKAGE_OVERRIDE_FILE = $(call qstrip,$(BR2_PACKAGE_OVERRIDE_FILE))
 513 ifneq ($(PACKAGE_OVERRIDE_FILE),)
 514 -include $(PACKAGE_OVERRIDE_FILE)
 515 endif
 516
 517 include $(sort $(wildcard package/*/*.mk))
 518
 519 include boot/common.mk
 520 include linux/linux.mk
 521 include fs/common.mk
 522
 523 # If using a br2-external tree, the BR2_EXTERNAL_$(NAME)_PATH variables
 524 # are also present in the .config file. Since .config is included after
 525 # we defined them in the Makefile, the values for those variables are
 526 # quoted. We just include the generated Makefile fragment .br2-external.mk
 527 # a third time, which will set those variables to the un-quoted values.
 528 include $(BR2_EXTERNAL_FILE)
 529
 530 # Nothing to include if no BR2_EXTERNAL tree in use
 531 include $(BR2_EXTERNAL_MKS)
 532
 533 # Now we are sure we have all the packages scanned and defined. We now
 534 # check for each package in the list of enabled packages, that all its
 535 # dependencies are indeed enabled.
 536 #
 537 # Only trigger the check for default builds. If the user forces building
 538 # a package, even if not enabled in the configuration, we want to accept
 539 # it.
 540 #
 541 ifeq ($(MAKECMDGOALS),)
 542
 543 define CHECK_ONE_DEPENDENCY
 544 ifeq ($$($(2)_TYPE),target)
 545 ifeq ($$($(2)_IS_VIRTUAL),)
 546 ifneq ($$($$($(2)_KCONFIG_VAR)),y)
 547 $$(error $$($(2)_NAME) is in the dependency chain of $$($(1)_NAME) that \
 548 has added it to its _DEPENDENCIES variable without selecting it or \
 549 depending on it from Config.in)
 550 endif
 551 endif
 552 endif
 553 endef
 554
 555 $(foreach pkg,$(call UPPERCASE,$(PACKAGES)),\
 556         $(foreach dep,$(call UPPERCASE,$($(pkg)_FINAL_ALL_DEPENDENCIES)),\
 557                 $(eval $(call CHECK_ONE_DEPENDENCY,$(pkg),$(dep))$(sep))))
 558
 559 endif
 560
 561 .PHONY: dirs
 562 dirs: $(BUILD_DIR) $(STAGING_DIR) $(TARGET_DIR) \
 563         $(HOST_DIR) $(BINARIES_DIR)
 564
 565 $(BUILD_DIR)/buildroot-config/auto.conf: $(BR2_CONFIG)
 566         $(MAKE1) $(EXTRAMAKEARGS) HOSTCC="$(HOSTCC_NOCCACHE)" HOSTCXX="$(HOSTCXX_NOCCACHE)" silentoldconfig
 567
 568 .PHONY: prepare
 569 prepare: $(BUILD_DIR)/buildroot-config/auto.conf
 570
 571 .PHONY: world
 572 world: target-post-image
 573
 574 .PHONY: sdk
 575 sdk: world
 576         @$(call MESSAGE,"Rendering the SDK relocatable")
 577         $(TOPDIR)/support/scripts/fix-rpath host
 578         $(TOPDIR)/support/scripts/fix-rpath staging
 579         $(INSTALL) -m 755 $(TOPDIR)/support/misc/relocate-sdk.sh $(HOST_DIR)/relocate-sdk.sh
 580         echo $(HOST_DIR) > $(HOST_DIR)/share/buildroot/sdk-location
 581
 582 # Populating the staging with the base directories is handled by the skeleton package
 583 $(STAGING_DIR):
 584         @mkdir -p $(STAGING_DIR)
 585         @ln -snf $(STAGING_DIR) $(BASE_DIR)/staging
 586
 587 RSYNC_VCS_EXCLUSIONS = \
 588         --exclude .svn --exclude .git --exclude .hg --exclude .bzr \
 589         --exclude CVS
 590
 591 STRIP_FIND_CMD = find $(TARGET_DIR)
 592 ifneq (,$(call qstrip,$(BR2_STRIP_EXCLUDE_DIRS)))
 593 STRIP_FIND_CMD += \( $(call finddirclauses,$(TARGET_DIR),$(call qstrip,$(BR2_STRIP_EXCLUDE_DIRS))) \) -prune -o
 594 endif
 595 STRIP_FIND_CMD += -type f \( -perm /111 -o -name '*.so*' \)
 596 # file exclusions:
 597 # - libpthread.so: a non-stripped libpthread shared library is needed for
 598 #   proper debugging of pthread programs using gdb.
 599 # - ld.so: a non-stripped dynamic linker library is needed for valgrind
 600 # - kernel modules (*.ko): do not function properly when stripped like normal
 601 #   applications and libraries. Normally kernel modules are already excluded
 602 #   by the executable permission check above, so the explicit exclusion is only
 603 #   done for kernel modules with incorrect permissions.
 604 STRIP_FIND_CMD += -not \( $(call findfileclauses,libpthread*.so* ld-*.so* *.ko $(call qstrip,$(BR2_STRIP_EXCLUDE_FILES))) \) -print0
 605
 606 ifeq ($(BR2_ECLIPSE_REGISTER),y)
 607 define TOOLCHAIN_ECLIPSE_REGISTER
 608         ./support/scripts/eclipse-register-toolchain `readlink -f $(O)` \
 609                 $(notdir $(TARGET_CROSS)) $(BR2_ARCH)
 610 endef
 611 TARGET_FINALIZE_HOOKS += TOOLCHAIN_ECLIPSE_REGISTER
 612 endif
 613
 614 # Generate locale data. Basically, we call the localedef program
 615 # (built by the host-localedef package) for each locale. The input
 616 # data comes preferably from the toolchain, or if the toolchain does
 617 # not have them (Linaro toolchains), we use the ones available on the
 618 # host machine.
 619 ifeq ($(BR2_TOOLCHAIN_USES_GLIBC),y)
 620 GLIBC_GENERATE_LOCALES = $(call qstrip,$(BR2_GENERATE_LOCALE))
 621 ifneq ($(GLIBC_GENERATE_LOCALES),)
 622 PACKAGES += host-localedef
 623
 624 define GENERATE_GLIBC_LOCALES
 625         $(Q)mkdir -p $(TARGET_DIR)/usr/lib/locale/
 626         $(Q)for locale in $(GLIBC_GENERATE_LOCALES) ; do \
 627                 inputfile=`echo $${locale} | cut -f1 -d'.'` ; \
 628                 charmap=`echo $${locale} | cut -f2 -d'.' -s` ; \
 629                 if test -z "$${charmap}" ; then \
 630                         charmap="UTF-8" ; \
 631                 fi ; \
 632                 echo "Generating locale $${inputfile}.$${charmap}" ; \
 633                 I18NPATH=$(STAGING_DIR)/usr/share/i18n:/usr/share/i18n \
 634                 $(HOST_DIR)/bin/localedef \
 635                         --prefix=$(TARGET_DIR) \
 636                         --$(call LOWERCASE,$(BR2_ENDIAN))-endian \
 637                         -i $${inputfile} -f $${charmap} \
 638                         $${locale} ; \
 639         done
 640 endef
 641 TARGET_FINALIZE_HOOKS += GENERATE_GLIBC_LOCALES
 642 endif
 643 endif
 644
 645 ifeq ($(BR2_ENABLE_LOCALE_PURGE),y)
 646 LOCALE_WHITELIST = $(BUILD_DIR)/locales.nopurge
 647 LOCALE_NOPURGE = $(call qstrip,$(BR2_ENABLE_LOCALE_WHITELIST))
 648
 649 # This piece of junk does the following:
 650 # First collect the whitelist in a file.
 651 # Then go over all the locale dirs and for each subdir, check if it exists
 652 # in the whitelist file. If it doesn't, kill it.
 653 # Finally, specifically for X11, regenerate locale.dir from the whitelist.
 654 define PURGE_LOCALES
 655         rm -f $(LOCALE_WHITELIST)
 656         for i in $(LOCALE_NOPURGE) locale-archive; do echo $$i >> $(LOCALE_WHITELIST); done
 657
 658         for dir in $(wildcard $(addprefix $(TARGET_DIR),/usr/share/locale /usr/share/X11/locale /usr/lib/locale)); \
 659         do \
 660                 for langdir in $$dir/*; \
 661                 do \
 662                         if [ -e "$${langdir}" ]; \
 663                         then \
 664                                 grep -qx "$${langdir##*/}" $(LOCALE_WHITELIST) || rm -rf $$langdir; \
 665                         fi \
 666                 done; \
 667         done
 668         if [ -d $(TARGET_DIR)/usr/share/X11/locale ]; \
 669         then \
 670                 for lang in $(LOCALE_NOPURGE); \
 671                 do \
 672                         if [ -f $(TARGET_DIR)/usr/share/X11/locale/$$lang/XLC_LOCALE ]; \
 673                         then \
 674                                 echo "$$lang/XLC_LOCALE: $$lang"; \
 675                         fi \
 676                 done > $(TARGET_DIR)/usr/share/X11/locale/locale.dir; \
 677         fi
 678 endef
 679 TARGET_FINALIZE_HOOKS += PURGE_LOCALES
 680 endif
 681
 682 $(TARGETS_ROOTFS): target-finalize
 683
 684 .PHONY: target-finalize
 685 target-finalize: $(PACKAGES)
 686         @$(call MESSAGE,"Finalizing target directory")
 687         # Check files that are touched by more than one package
 688         ./support/scripts/check-uniq-files -t target $(BUILD_DIR)/packages-file-list.txt
 689         ./support/scripts/check-uniq-files -t staging $(BUILD_DIR)/packages-file-list-staging.txt
 690         ./support/scripts/check-uniq-files -t host $(BUILD_DIR)/packages-file-list-host.txt
 691         $(foreach hook,$(TARGET_FINALIZE_HOOKS),$($(hook))$(sep))
 692         rm -rf $(TARGET_DIR)/usr/include $(TARGET_DIR)/usr/share/aclocal \
 693                 $(TARGET_DIR)/usr/lib/pkgconfig $(TARGET_DIR)/usr/share/pkgconfig \
 694                 $(TARGET_DIR)/usr/lib/cmake $(TARGET_DIR)/usr/share/cmake
 695         find $(TARGET_DIR)/usr/{lib,share}/ -name '*.cmake' -print0 | xargs -0 rm -f
 696         find $(TARGET_DIR)/lib/ $(TARGET_DIR)/usr/lib/ $(TARGET_DIR)/usr/libexec/ \
 697                 \( -name '*.a' -o -name '*.la' \) -print0 | xargs -0 rm -f
 698 ifneq ($(BR2_PACKAGE_GDB),y)
 699         rm -rf $(TARGET_DIR)/usr/share/gdb
 700 endif
 701 ifneq ($(BR2_PACKAGE_BASH),y)
 702         rm -rf $(TARGET_DIR)/usr/share/bash-completion
 703 endif
 704 ifneq ($(BR2_PACKAGE_ZSH),y)
 705         rm -rf $(TARGET_DIR)/usr/share/zsh
 706 endif
 707         rm -rf $(TARGET_DIR)/usr/man $(TARGET_DIR)/usr/share/man
 708         rm -rf $(TARGET_DIR)/usr/info $(TARGET_DIR)/usr/share/info
 709         rm -rf $(TARGET_DIR)/usr/doc $(TARGET_DIR)/usr/share/doc
 710         rm -rf $(TARGET_DIR)/usr/share/gtk-doc
 711         rmdir $(TARGET_DIR)/usr/share 2>/dev/null || true
 712         $(STRIP_FIND_CMD) | xargs -0 $(STRIPCMD) 2>/dev/null || true
 713
 714 # See http://sourceware.org/gdb/wiki/FAQ, "GDB does not see any threads
 715 # besides the one in which crash occurred; or SIGTRAP kills my program when
 716 # I set a breakpoint"
 717 ifeq ($(BR2_TOOLCHAIN_HAS_THREADS),y)
 718         find $(TARGET_DIR)/lib/ -type f -name 'libpthread*.so*' | \
 719                 xargs -r $(STRIPCMD) $(STRIP_STRIP_DEBUG)
 720 endif
 721
 722 # Valgrind needs ld.so with enough information, so only strip
 723 # debugging symbols.
 724         find $(TARGET_DIR)/lib/ -type f -name 'ld-*.so*' | \
 725                 xargs -r $(STRIPCMD) $(STRIP_STRIP_DEBUG)
 726         test -f $(TARGET_DIR)/etc/ld.so.conf && \
 727                 { echo "ERROR: we shouldn't have a /etc/ld.so.conf file"; exit 1; } || true
 728         test -d $(TARGET_DIR)/etc/ld.so.conf.d && \
 729                 { echo "ERROR: we shouldn't have a /etc/ld.so.conf.d directory"; exit 1; } || true
 730         mkdir -p $(TARGET_DIR)/etc
 731         ( \
 732                 echo "NAME=Buildroot"; \
 733                 echo "VERSION=$(BR2_VERSION_FULL)"; \
 734                 echo "ID=buildroot"; \
 735                 echo "VERSION_ID=$(BR2_VERSION)"; \
 736                 echo "PRETTY_NAME=\"Buildroot $(BR2_VERSION)\"" \
 737         ) >  $(TARGET_DIR)/usr/lib/os-release
 738         ln -sf ../usr/lib/os-release $(TARGET_DIR)/etc
 739
 740         @$(call MESSAGE,"Sanitizing RPATH in target tree")
 741         $(TOPDIR)/support/scripts/fix-rpath target
 742
 743         @$(foreach d, $(call qstrip,$(BR2_ROOTFS_OVERLAY)), \
 744                 $(call MESSAGE,"Copying overlay $(d)"); \
 745                 rsync -a --ignore-times --keep-dirlinks $(RSYNC_VCS_EXCLUSIONS) \
 746                         --chmod=u=rwX,go=rX --exclude .empty --exclude '*~' \
 747                         $(d)/ $(TARGET_DIR)$(sep))
 748
 749         @$(foreach s, $(call qstrip,$(BR2_ROOTFS_POST_BUILD_SCRIPT)), \
 750                 $(call MESSAGE,"Executing post-build script $(s)"); \
 751                 $(EXTRA_ENV) $(s) $(TARGET_DIR) $(call qstrip,$(BR2_ROOTFS_POST_SCRIPT_ARGS))$(sep))
 752
 753 .PHONY: target-post-image
 754 target-post-image: $(TARGETS_ROOTFS) target-finalize
 755         @$(foreach s, $(call qstrip,$(BR2_ROOTFS_POST_IMAGE_SCRIPT)), \
 756                 $(call MESSAGE,"Executing post-image script $(s)"); \
 757                 $(EXTRA_ENV) $(s) $(BINARIES_DIR) $(call qstrip,$(BR2_ROOTFS_POST_SCRIPT_ARGS))$(sep))
 758
 759 .PHONY: source
 760 source: $(foreach p,$(PACKAGES),$(p)-all-source)
 761
 762 .PHONY: _external-deps external-deps
 763 _external-deps: $(foreach p,$(PACKAGES),$(p)-all-external-deps)
 764 external-deps:
 765         @$(MAKE1) -Bs $(EXTRAMAKEARGS) _external-deps | sort -u
 766
 767 .PHONY: legal-info-clean
 768 legal-info-clean:
 769         @rm -fr $(LEGAL_INFO_DIR)
 770
 771 .PHONY: legal-info-prepare
 772 legal-info-prepare: $(LEGAL_INFO_DIR)
 773         @$(call MESSAGE,"Buildroot $(BR2_VERSION_FULL) Collecting legal info")
 774         @$(call legal-license-file,buildroot,buildroot,support/legal-info,COPYING,COPYING,HOST)
 775         @$(call legal-manifest,PACKAGE,VERSION,LICENSE,LICENSE FILES,SOURCE ARCHIVE,SOURCE SITE,TARGET)
 776         @$(call legal-manifest,PACKAGE,VERSION,LICENSE,LICENSE FILES,SOURCE ARCHIVE,SOURCE SITE,HOST)
 777         @$(call legal-manifest,buildroot,$(BR2_VERSION_FULL),GPL-2.0+,COPYING,not saved,not saved,HOST)
 778         @$(call legal-warning,the Buildroot source code has not been saved)
 779         @cp $(BR2_CONFIG) $(LEGAL_INFO_DIR)/buildroot.config
 780
 781 .PHONY: legal-info
 782 legal-info: dirs legal-info-clean legal-info-prepare $(foreach p,$(PACKAGES),$(p)-all-legal-info) \
 783                 $(REDIST_SOURCES_DIR_TARGET) $(REDIST_SOURCES_DIR_HOST)
 784         @cat support/legal-info/README.header >>$(LEGAL_REPORT)
 785         @if [ -r $(LEGAL_WARNINGS) ]; then \
 786                 cat support/legal-info/README.warnings-header \
 787                         $(LEGAL_WARNINGS) >>$(LEGAL_REPORT); \
 788                 cat $(LEGAL_WARNINGS); fi
 789         @rm -f $(LEGAL_WARNINGS)
 790         @(cd $(LEGAL_INFO_DIR); \
 791                 find * -type f -exec sha256sum {} + | LC_ALL=C sort -k2 \
 792                         >.legal-info.sha256; \
 793                 mv .legal-info.sha256 legal-info.sha256)
 794         @echo "Legal info produced in $(LEGAL_INFO_DIR)"
 795
 796 .PHONY: show-targets
 797 show-targets:
 798         @echo $(sort $(PACKAGES)) $(sort $(TARGETS_ROOTFS))
 799
 800 .PHONY: show-build-order
 801 show-build-order: $(patsubst %,%-show-build-order,$(PACKAGES))
 802
 803 .PHONY: graph-build
 804 graph-build: $(O)/build/build-time.log
 805         @install -d $(GRAPHS_DIR)
 806         $(foreach o,name build duration,./support/scripts/graph-build-time \
 807                                         --type=histogram --order=$(o) --input=$(<) \
 808                                         --output=$(GRAPHS_DIR)/build.hist-$(o).$(BR_GRAPH_OUT) \
 809                                         $(if $(BR2_GRAPH_ALT),--alternate-colors)$(sep))
 810         $(foreach t,packages steps,./support/scripts/graph-build-time \
 811                                    --type=pie-$(t) --input=$(<) \
 812                                    --output=$(GRAPHS_DIR)/build.pie-$(t).$(BR_GRAPH_OUT) \
 813                                    $(if $(BR2_GRAPH_ALT),--alternate-colors)$(sep))
 814
 815 .PHONY: graph-depends-requirements
 816 graph-depends-requirements:
 817         @dot -? >/dev/null 2>&1 || \
 818                 { echo "ERROR: The 'dot' program from Graphviz is needed for graph-depends" >&2; exit 1; }
 819
 820 .PHONY: graph-depends
 821 graph-depends: graph-depends-requirements
 822         @$(INSTALL) -d $(GRAPHS_DIR)
 823         @cd "$(CONFIG_DIR)"; \
 824         $(TOPDIR)/support/scripts/graph-depends $(BR2_GRAPH_DEPS_OPTS) \
 825                 --direct -o $(GRAPHS_DIR)/$(@).dot
 826         dot $(BR2_GRAPH_DOT_OPTS) -T$(BR_GRAPH_OUT) \
 827                 -o $(GRAPHS_DIR)/$(@).$(BR_GRAPH_OUT) \
 828                 $(GRAPHS_DIR)/$(@).dot
 829
 830 .PHONY: graph-size
 831 graph-size:
 832         $(Q)mkdir -p $(GRAPHS_DIR)
 833         $(Q)$(TOPDIR)/support/scripts/size-stats --builddir $(BASE_DIR) \
 834                 --graph $(GRAPHS_DIR)/graph-size.$(BR_GRAPH_OUT) \
 835                 --file-size-csv $(GRAPHS_DIR)/file-size-stats.csv \
 836                 --package-size-csv $(GRAPHS_DIR)/package-size-stats.csv
 837
 838 .PHONY: check-dependencies
 839 check-dependencies:
 840         @cd "$(CONFIG_DIR)"; \
 841         $(TOPDIR)/support/scripts/graph-depends -C
 842
 843 else # ifeq ($(BR2_HAVE_DOT_CONFIG),y)
 844
 845 # Some subdirectories are also package names. To avoid that "make linux"
 846 # on an unconfigured tree produces "Nothing to be done", add an explicit
 847 # rule for it.
 848 # Also for 'all' we error out and ask the user to configure first.
 849 .PHONY: linux toolchain
 850 linux toolchain all: outputmakefile
 851         $(error Please configure Buildroot first (e.g. "make menuconfig"))
 852         @exit 1
 853
 854 endif # ifeq ($(BR2_HAVE_DOT_CONFIG),y)
 855
 856 # configuration
 857 # ---------------------------------------------------------------------------
 858
 859 HOSTCFLAGS = $(CFLAGS_FOR_BUILD)
 860 export HOSTCFLAGS
 861
 862 .PHONY: prepare-kconfig
 863 prepare-kconfig: outputmakefile $(BUILD_DIR)/.br2-external.in
 864
 865 $(BUILD_DIR)/buildroot-config/%onf:
 866         mkdir -p $(@D)/lxdialog
 867         PKG_CONFIG_PATH="$(HOST_PKG_CONFIG_PATH)" $(MAKE) CC="$(HOSTCC_NOCCACHE)" HOSTCC="$(HOSTCC_NOCCACHE)" \
 868             obj=$(@D) -C $(CONFIG) -f Makefile.br $(@F)
 869
 870 DEFCONFIG = $(call qstrip,$(BR2_DEFCONFIG))
 871
 872 # We don't want to fully expand BR2_DEFCONFIG here, so Kconfig will
 873 # recognize that if it's still at its default $(CONFIG_DIR)/defconfig
 874 COMMON_CONFIG_ENV = \
 875         BR2_DEFCONFIG='$(call qstrip,$(value BR2_DEFCONFIG))' \
 876         KCONFIG_AUTOCONFIG=$(BUILD_DIR)/buildroot-config/auto.conf \
 877         KCONFIG_AUTOHEADER=$(BUILD_DIR)/buildroot-config/autoconf.h \
 878         KCONFIG_TRISTATE=$(BUILD_DIR)/buildroot-config/tristate.config \
 879         BR2_CONFIG=$(BR2_CONFIG) \
 880         HOST_GCC_VERSION="$(HOSTCC_VERSION)" \
 881         BUILD_DIR=$(BUILD_DIR) \
 882         SKIP_LEGACY=
 883
 884 xconfig: $(BUILD_DIR)/buildroot-config/qconf prepare-kconfig
 885         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
 886
 887 gconfig: $(BUILD_DIR)/buildroot-config/gconf prepare-kconfig
 888         @$(COMMON_CONFIG_ENV) srctree=$(TOPDIR) $< $(CONFIG_CONFIG_IN)
 889
 890 menuconfig: $(BUILD_DIR)/buildroot-config/mconf prepare-kconfig
 891         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
 892
 893 nconfig: $(BUILD_DIR)/buildroot-config/nconf prepare-kconfig
 894         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
 895
 896 config: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
 897         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
 898
 899 # For the config targets that automatically select options, we pass
 900 # SKIP_LEGACY=y to disable the legacy options. However, in that case
 901 # no values are set for the legacy options so a subsequent oldconfig
 902 # will query them. Therefore, run an additional olddefconfig.
 903
 904 randconfig allyesconfig alldefconfig allnoconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
 905         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y $< --$@ $(CONFIG_CONFIG_IN)
 906         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
 907
 908 randpackageconfig allyespackageconfig allnopackageconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
 909         @grep -v BR2_PACKAGE_ $(BR2_CONFIG) > $(CONFIG_DIR)/.config.nopkg
 910         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y \
 911                 KCONFIG_ALLCONFIG=$(CONFIG_DIR)/.config.nopkg \
 912                 $< --$(subst package,,$@) $(CONFIG_CONFIG_IN)
 913         @rm -f $(CONFIG_DIR)/.config.nopkg
 914         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
 915
 916 oldconfig silentoldconfig olddefconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
 917         @$(COMMON_CONFIG_ENV) $< --$@ $(CONFIG_CONFIG_IN)
 918
 919 defconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
 920         @$(COMMON_CONFIG_ENV) $< --defconfig$(if $(DEFCONFIG),=$(DEFCONFIG)) $(CONFIG_CONFIG_IN)
 921
 922 define percent_defconfig
 923 # Override the BR2_DEFCONFIG from COMMON_CONFIG_ENV with the new defconfig
 924 %_defconfig: $(BUILD_DIR)/buildroot-config/conf $(1)/configs/%_defconfig prepare-kconfig
 925         @$$(COMMON_CONFIG_ENV) BR2_DEFCONFIG=$(1)/configs/$$@ \
 926                 $$< --defconfig=$(1)/configs/$$@ $$(CONFIG_CONFIG_IN)
 927 endef
 928 $(eval $(foreach d,$(call reverse,$(TOPDIR) $(BR2_EXTERNAL_DIRS)),$(call percent_defconfig,$(d))$(sep)))
 929
 930 savedefconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
 931         @$(COMMON_CONFIG_ENV) $< \
 932                 --savedefconfig=$(if $(DEFCONFIG),$(DEFCONFIG),$(CONFIG_DIR)/defconfig) \
 933                 $(CONFIG_CONFIG_IN)
 934         @$(SED) '/BR2_DEFCONFIG=/d' $(if $(DEFCONFIG),$(DEFCONFIG),$(CONFIG_DIR)/defconfig)
 935
 936 .PHONY: defconfig savedefconfig
 937
 938 ################################################################################
 939 #
 940 # Cleanup and misc junk
 941 #
 942 ################################################################################
 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) \
 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)