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.02
  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) $(HOST_DIR)/usr $(HOST_DIR)/lib $(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 # Compatibility symlink in case a post-build script still uses $(HOST_DIR)/usr
 583 $(HOST_DIR)/usr: $(HOST_DIR)
 584         @ln -snf . $@
 585
 586 $(HOST_DIR)/lib: $(HOST_DIR)
 587         @mkdir -p $@
 588         @case $(HOSTARCH) in \
 589                 (*64) ln -snf lib $(@D)/lib64;; \
 590                 (*)   ln -snf lib $(@D)/lib32;; \
 591         esac
 592
 593 # Populating the staging with the base directories is handled by the skeleton package
 594 $(STAGING_DIR):
 595         @mkdir -p $(STAGING_DIR)
 596         @ln -snf $(STAGING_DIR) $(BASE_DIR)/staging
 597
 598 RSYNC_VCS_EXCLUSIONS = \
 599         --exclude .svn --exclude .git --exclude .hg --exclude .bzr \
 600         --exclude CVS
 601
 602 STRIP_FIND_CMD = find $(TARGET_DIR)
 603 ifneq (,$(call qstrip,$(BR2_STRIP_EXCLUDE_DIRS)))
 604 STRIP_FIND_CMD += \( $(call finddirclauses,$(TARGET_DIR),$(call qstrip,$(BR2_STRIP_EXCLUDE_DIRS))) \) -prune -o
 605 endif
 606 STRIP_FIND_CMD += -type f \( -perm /111 -o -name '*.so*' \)
 607 # file exclusions:
 608 # - libpthread.so: a non-stripped libpthread shared library is needed for
 609 #   proper debugging of pthread programs using gdb.
 610 # - ld.so: a non-stripped dynamic linker library is needed for valgrind
 611 # - kernel modules (*.ko): do not function properly when stripped like normal
 612 #   applications and libraries. Normally kernel modules are already excluded
 613 #   by the executable permission check above, so the explicit exclusion is only
 614 #   done for kernel modules with incorrect permissions.
 615 STRIP_FIND_CMD += -not \( $(call findfileclauses,libpthread*.so* ld-*.so* *.ko $(call qstrip,$(BR2_STRIP_EXCLUDE_FILES))) \) -print0
 616
 617 ifeq ($(BR2_ECLIPSE_REGISTER),y)
 618 define TOOLCHAIN_ECLIPSE_REGISTER
 619         ./support/scripts/eclipse-register-toolchain `readlink -f $(O)` \
 620                 $(notdir $(TARGET_CROSS)) $(BR2_ARCH)
 621 endef
 622 TARGET_FINALIZE_HOOKS += TOOLCHAIN_ECLIPSE_REGISTER
 623 endif
 624
 625 # Generate locale data. Basically, we call the localedef program
 626 # (built by the host-localedef package) for each locale. The input
 627 # data comes preferably from the toolchain, or if the toolchain does
 628 # not have them (Linaro toolchains), we use the ones available on the
 629 # host machine.
 630 ifeq ($(BR2_TOOLCHAIN_USES_GLIBC),y)
 631 GLIBC_GENERATE_LOCALES = $(call qstrip,$(BR2_GENERATE_LOCALE))
 632 ifneq ($(GLIBC_GENERATE_LOCALES),)
 633 PACKAGES += host-localedef
 634
 635 define GENERATE_GLIBC_LOCALES
 636         $(Q)mkdir -p $(TARGET_DIR)/usr/lib/locale/
 637         $(Q)for locale in $(GLIBC_GENERATE_LOCALES) ; do \
 638                 inputfile=`echo $${locale} | cut -f1 -d'.'` ; \
 639                 charmap=`echo $${locale} | cut -f2 -d'.' -s` ; \
 640                 if test -z "$${charmap}" ; then \
 641                         charmap="UTF-8" ; \
 642                 fi ; \
 643                 echo "Generating locale $${inputfile}.$${charmap}" ; \
 644                 I18NPATH=$(STAGING_DIR)/usr/share/i18n:/usr/share/i18n \
 645                 $(HOST_DIR)/bin/localedef \
 646                         --prefix=$(TARGET_DIR) \
 647                         --$(call LOWERCASE,$(BR2_ENDIAN))-endian \
 648                         -i $${inputfile} -f $${charmap} \
 649                         $${locale} ; \
 650         done
 651 endef
 652 TARGET_FINALIZE_HOOKS += GENERATE_GLIBC_LOCALES
 653 endif
 654 endif
 655
 656 ifeq ($(BR2_ENABLE_LOCALE_PURGE),y)
 657 LOCALE_WHITELIST = $(BUILD_DIR)/locales.nopurge
 658 LOCALE_NOPURGE = $(call qstrip,$(BR2_ENABLE_LOCALE_WHITELIST))
 659
 660 # This piece of junk does the following:
 661 # First collect the whitelist in a file.
 662 # Then go over all the locale dirs and for each subdir, check if it exists
 663 # in the whitelist file. If it doesn't, kill it.
 664 # Finally, specifically for X11, regenerate locale.dir from the whitelist.
 665 define PURGE_LOCALES
 666         rm -f $(LOCALE_WHITELIST)
 667         for i in $(LOCALE_NOPURGE) locale-archive; do echo $$i >> $(LOCALE_WHITELIST); done
 668
 669         for dir in $(wildcard $(addprefix $(TARGET_DIR),/usr/share/locale /usr/share/X11/locale /usr/lib/locale)); \
 670         do \
 671                 for langdir in $$dir/*; \
 672                 do \
 673                         if [ -e "$${langdir}" ]; \
 674                         then \
 675                                 grep -qx "$${langdir##*/}" $(LOCALE_WHITELIST) || rm -rf $$langdir; \
 676                         fi \
 677                 done; \
 678         done
 679         if [ -d $(TARGET_DIR)/usr/share/X11/locale ]; \
 680         then \
 681                 for lang in $(LOCALE_NOPURGE); \
 682                 do \
 683                         if [ -f $(TARGET_DIR)/usr/share/X11/locale/$$lang/XLC_LOCALE ]; \
 684                         then \
 685                                 echo "$$lang/XLC_LOCALE: $$lang"; \
 686                         fi \
 687                 done > $(TARGET_DIR)/usr/share/X11/locale/locale.dir; \
 688         fi
 689 endef
 690 TARGET_FINALIZE_HOOKS += PURGE_LOCALES
 691 endif
 692
 693 $(TARGETS_ROOTFS): target-finalize
 694
 695 .PHONY: target-finalize
 696 target-finalize: $(PACKAGES)
 697         @$(call MESSAGE,"Finalizing target directory")
 698         # Check files that are touched by more than one package
 699         ./support/scripts/check-uniq-files -t target $(BUILD_DIR)/packages-file-list.txt
 700         ./support/scripts/check-uniq-files -t staging $(BUILD_DIR)/packages-file-list-staging.txt
 701         ./support/scripts/check-uniq-files -t host $(BUILD_DIR)/packages-file-list-host.txt
 702         $(foreach hook,$(TARGET_FINALIZE_HOOKS),$($(hook))$(sep))
 703         rm -rf $(TARGET_DIR)/usr/include $(TARGET_DIR)/usr/share/aclocal \
 704                 $(TARGET_DIR)/usr/lib/pkgconfig $(TARGET_DIR)/usr/share/pkgconfig \
 705                 $(TARGET_DIR)/usr/lib/cmake $(TARGET_DIR)/usr/share/cmake
 706         find $(TARGET_DIR)/usr/{lib,share}/ -name '*.cmake' -print0 | xargs -0 rm -f
 707         find $(TARGET_DIR)/lib/ $(TARGET_DIR)/usr/lib/ $(TARGET_DIR)/usr/libexec/ \
 708                 \( -name '*.a' -o -name '*.la' \) -print0 | xargs -0 rm -f
 709 ifneq ($(BR2_PACKAGE_GDB),y)
 710         rm -rf $(TARGET_DIR)/usr/share/gdb
 711 endif
 712 ifneq ($(BR2_PACKAGE_BASH),y)
 713         rm -rf $(TARGET_DIR)/usr/share/bash-completion
 714 endif
 715 ifneq ($(BR2_PACKAGE_ZSH),y)
 716         rm -rf $(TARGET_DIR)/usr/share/zsh
 717 endif
 718         rm -rf $(TARGET_DIR)/usr/man $(TARGET_DIR)/usr/share/man
 719         rm -rf $(TARGET_DIR)/usr/info $(TARGET_DIR)/usr/share/info
 720         rm -rf $(TARGET_DIR)/usr/doc $(TARGET_DIR)/usr/share/doc
 721         rm -rf $(TARGET_DIR)/usr/share/gtk-doc
 722         rmdir $(TARGET_DIR)/usr/share 2>/dev/null || true
 723         $(STRIP_FIND_CMD) | xargs -0 $(STRIPCMD) 2>/dev/null || true
 724
 725 # See http://sourceware.org/gdb/wiki/FAQ, "GDB does not see any threads
 726 # besides the one in which crash occurred; or SIGTRAP kills my program when
 727 # I set a breakpoint"
 728 ifeq ($(BR2_TOOLCHAIN_HAS_THREADS),y)
 729         find $(TARGET_DIR)/lib/ -type f -name 'libpthread*.so*' | \
 730                 xargs -r $(STRIPCMD) $(STRIP_STRIP_DEBUG)
 731 endif
 732
 733 # Valgrind needs ld.so with enough information, so only strip
 734 # debugging symbols.
 735         find $(TARGET_DIR)/lib/ -type f -name 'ld-*.so*' | \
 736                 xargs -r $(STRIPCMD) $(STRIP_STRIP_DEBUG)
 737         test -f $(TARGET_DIR)/etc/ld.so.conf && \
 738                 { echo "ERROR: we shouldn't have a /etc/ld.so.conf file"; exit 1; } || true
 739         test -d $(TARGET_DIR)/etc/ld.so.conf.d && \
 740                 { echo "ERROR: we shouldn't have a /etc/ld.so.conf.d directory"; exit 1; } || true
 741         mkdir -p $(TARGET_DIR)/etc
 742         ( \
 743                 echo "NAME=Buildroot"; \
 744                 echo "VERSION=$(BR2_VERSION_FULL)"; \
 745                 echo "ID=buildroot"; \
 746                 echo "VERSION_ID=$(BR2_VERSION)"; \
 747                 echo "PRETTY_NAME=\"Buildroot $(BR2_VERSION)\"" \
 748         ) >  $(TARGET_DIR)/usr/lib/os-release
 749         ln -sf ../usr/lib/os-release $(TARGET_DIR)/etc
 750
 751         @$(call MESSAGE,"Sanitizing RPATH in target tree")
 752         $(TOPDIR)/support/scripts/fix-rpath target
 753
 754         @$(foreach d, $(call qstrip,$(BR2_ROOTFS_OVERLAY)), \
 755                 $(call MESSAGE,"Copying overlay $(d)"); \
 756                 rsync -a --ignore-times --keep-dirlinks $(RSYNC_VCS_EXCLUSIONS) \
 757                         --chmod=u=rwX,go=rX --exclude .empty --exclude '*~' \
 758                         $(d)/ $(TARGET_DIR)$(sep))
 759
 760         @$(foreach s, $(call qstrip,$(BR2_ROOTFS_POST_BUILD_SCRIPT)), \
 761                 $(call MESSAGE,"Executing post-build script $(s)"); \
 762                 $(EXTRA_ENV) $(s) $(TARGET_DIR) $(call qstrip,$(BR2_ROOTFS_POST_SCRIPT_ARGS))$(sep))
 763
 764 .PHONY: target-post-image
 765 target-post-image: $(TARGETS_ROOTFS) target-finalize
 766         @$(foreach s, $(call qstrip,$(BR2_ROOTFS_POST_IMAGE_SCRIPT)), \
 767                 $(call MESSAGE,"Executing post-image script $(s)"); \
 768                 $(EXTRA_ENV) $(s) $(BINARIES_DIR) $(call qstrip,$(BR2_ROOTFS_POST_SCRIPT_ARGS))$(sep))
 769
 770 .PHONY: source
 771 source: $(foreach p,$(PACKAGES),$(p)-all-source)
 772
 773 .PHONY: _external-deps external-deps
 774 _external-deps: $(foreach p,$(PACKAGES),$(p)-all-external-deps)
 775 external-deps:
 776         @$(MAKE1) -Bs $(EXTRAMAKEARGS) _external-deps | sort -u
 777
 778 .PHONY: legal-info-clean
 779 legal-info-clean:
 780         @rm -fr $(LEGAL_INFO_DIR)
 781
 782 .PHONY: legal-info-prepare
 783 legal-info-prepare: $(LEGAL_INFO_DIR)
 784         @$(call MESSAGE,"Buildroot $(BR2_VERSION_FULL) Collecting legal info")
 785         @$(call legal-license-file,buildroot,buildroot,support/legal-info,COPYING,COPYING,HOST)
 786         @$(call legal-manifest,PACKAGE,VERSION,LICENSE,LICENSE FILES,SOURCE ARCHIVE,SOURCE SITE,TARGET)
 787         @$(call legal-manifest,PACKAGE,VERSION,LICENSE,LICENSE FILES,SOURCE ARCHIVE,SOURCE SITE,HOST)
 788         @$(call legal-manifest,buildroot,$(BR2_VERSION_FULL),GPL-2.0+,COPYING,not saved,not saved,HOST)
 789         @$(call legal-warning,the Buildroot source code has not been saved)
 790         @cp $(BR2_CONFIG) $(LEGAL_INFO_DIR)/buildroot.config
 791
 792 .PHONY: legal-info
 793 legal-info: dirs legal-info-clean legal-info-prepare $(foreach p,$(PACKAGES),$(p)-all-legal-info) \
 794                 $(REDIST_SOURCES_DIR_TARGET) $(REDIST_SOURCES_DIR_HOST)
 795         @cat support/legal-info/README.header >>$(LEGAL_REPORT)
 796         @if [ -r $(LEGAL_WARNINGS) ]; then \
 797                 cat support/legal-info/README.warnings-header \
 798                         $(LEGAL_WARNINGS) >>$(LEGAL_REPORT); \
 799                 cat $(LEGAL_WARNINGS); fi
 800         @rm -f $(LEGAL_WARNINGS)
 801         @(cd $(LEGAL_INFO_DIR); \
 802                 find * -type f -exec sha256sum {} + | LC_ALL=C sort -k2 \
 803                         >.legal-info.sha256; \
 804                 mv .legal-info.sha256 legal-info.sha256)
 805         @echo "Legal info produced in $(LEGAL_INFO_DIR)"
 806
 807 .PHONY: show-targets
 808 show-targets:
 809         @echo $(sort $(PACKAGES)) $(sort $(TARGETS_ROOTFS))
 810
 811 .PHONY: show-build-order
 812 show-build-order: $(patsubst %,%-show-build-order,$(PACKAGES))
 813
 814 .PHONY: graph-build
 815 graph-build: $(O)/build/build-time.log
 816         @install -d $(GRAPHS_DIR)
 817         $(foreach o,name build duration,./support/scripts/graph-build-time \
 818                                         --type=histogram --order=$(o) --input=$(<) \
 819                                         --output=$(GRAPHS_DIR)/build.hist-$(o).$(BR_GRAPH_OUT) \
 820                                         $(if $(BR2_GRAPH_ALT),--alternate-colors)$(sep))
 821         $(foreach t,packages steps,./support/scripts/graph-build-time \
 822                                    --type=pie-$(t) --input=$(<) \
 823                                    --output=$(GRAPHS_DIR)/build.pie-$(t).$(BR_GRAPH_OUT) \
 824                                    $(if $(BR2_GRAPH_ALT),--alternate-colors)$(sep))
 825
 826 .PHONY: graph-depends-requirements
 827 graph-depends-requirements:
 828         @dot -? >/dev/null 2>&1 || \
 829                 { echo "ERROR: The 'dot' program from Graphviz is needed for graph-depends" >&2; exit 1; }
 830
 831 .PHONY: graph-depends
 832 graph-depends: graph-depends-requirements
 833         @$(INSTALL) -d $(GRAPHS_DIR)
 834         @cd "$(CONFIG_DIR)"; \
 835         $(TOPDIR)/support/scripts/graph-depends $(BR2_GRAPH_DEPS_OPTS) \
 836                 --direct -o $(GRAPHS_DIR)/$(@).dot
 837         dot $(BR2_GRAPH_DOT_OPTS) -T$(BR_GRAPH_OUT) \
 838                 -o $(GRAPHS_DIR)/$(@).$(BR_GRAPH_OUT) \
 839                 $(GRAPHS_DIR)/$(@).dot
 840
 841 .PHONY: graph-size
 842 graph-size:
 843         $(Q)mkdir -p $(GRAPHS_DIR)
 844         $(Q)$(TOPDIR)/support/scripts/size-stats --builddir $(BASE_DIR) \
 845                 --graph $(GRAPHS_DIR)/graph-size.$(BR_GRAPH_OUT) \
 846                 --file-size-csv $(GRAPHS_DIR)/file-size-stats.csv \
 847                 --package-size-csv $(GRAPHS_DIR)/package-size-stats.csv
 848
 849 .PHONY: check-dependencies
 850 check-dependencies:
 851         @cd "$(CONFIG_DIR)"; \
 852         $(TOPDIR)/support/scripts/graph-depends -C
 853
 854 else # ifeq ($(BR2_HAVE_DOT_CONFIG),y)
 855
 856 # Some subdirectories are also package names. To avoid that "make linux"
 857 # on an unconfigured tree produces "Nothing to be done", add an explicit
 858 # rule for it.
 859 # Also for 'all' we error out and ask the user to configure first.
 860 .PHONY: linux toolchain
 861 linux toolchain all: outputmakefile
 862         $(error Please configure Buildroot first (e.g. "make menuconfig"))
 863         @exit 1
 864
 865 endif # ifeq ($(BR2_HAVE_DOT_CONFIG),y)
 866
 867 # configuration
 868 # ---------------------------------------------------------------------------
 869
 870 HOSTCFLAGS = $(CFLAGS_FOR_BUILD)
 871 export HOSTCFLAGS
 872
 873 .PHONY: prepare-kconfig
 874 prepare-kconfig: outputmakefile $(BUILD_DIR)/.br2-external.in
 875
 876 $(BUILD_DIR)/buildroot-config/%onf:
 877         mkdir -p $(@D)/lxdialog
 878         PKG_CONFIG_PATH="$(HOST_PKG_CONFIG_PATH)" $(MAKE) CC="$(HOSTCC_NOCCACHE)" HOSTCC="$(HOSTCC_NOCCACHE)" \
 879             obj=$(@D) -C $(CONFIG) -f Makefile.br $(@F)
 880
 881 DEFCONFIG = $(call qstrip,$(BR2_DEFCONFIG))
 882
 883 # We don't want to fully expand BR2_DEFCONFIG here, so Kconfig will
 884 # recognize that if it's still at its default $(CONFIG_DIR)/defconfig
 885 COMMON_CONFIG_ENV = \
 886         BR2_DEFCONFIG='$(call qstrip,$(value BR2_DEFCONFIG))' \
 887         KCONFIG_AUTOCONFIG=$(BUILD_DIR)/buildroot-config/auto.conf \
 888         KCONFIG_AUTOHEADER=$(BUILD_DIR)/buildroot-config/autoconf.h \
 889         KCONFIG_TRISTATE=$(BUILD_DIR)/buildroot-config/tristate.config \
 890         BR2_CONFIG=$(BR2_CONFIG) \
 891         HOST_GCC_VERSION="$(HOSTCC_VERSION)" \
 892         BUILD_DIR=$(BUILD_DIR) \
 893         SKIP_LEGACY=
 894
 895 xconfig: $(BUILD_DIR)/buildroot-config/qconf prepare-kconfig
 896         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
 897
 898 gconfig: $(BUILD_DIR)/buildroot-config/gconf prepare-kconfig
 899         @$(COMMON_CONFIG_ENV) srctree=$(TOPDIR) $< $(CONFIG_CONFIG_IN)
 900
 901 menuconfig: $(BUILD_DIR)/buildroot-config/mconf prepare-kconfig
 902         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
 903
 904 nconfig: $(BUILD_DIR)/buildroot-config/nconf prepare-kconfig
 905         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
 906
 907 config: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
 908         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
 909
 910 # For the config targets that automatically select options, we pass
 911 # SKIP_LEGACY=y to disable the legacy options. However, in that case
 912 # no values are set for the legacy options so a subsequent oldconfig
 913 # will query them. Therefore, run an additional olddefconfig.
 914
 915 randconfig allyesconfig alldefconfig allnoconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
 916         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y $< --$@ $(CONFIG_CONFIG_IN)
 917         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
 918
 919 randpackageconfig allyespackageconfig allnopackageconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
 920         @grep -v BR2_PACKAGE_ $(BR2_CONFIG) > $(CONFIG_DIR)/.config.nopkg
 921         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y \
 922                 KCONFIG_ALLCONFIG=$(CONFIG_DIR)/.config.nopkg \
 923                 $< --$(subst package,,$@) $(CONFIG_CONFIG_IN)
 924         @rm -f $(CONFIG_DIR)/.config.nopkg
 925         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
 926
 927 oldconfig silentoldconfig olddefconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
 928         @$(COMMON_CONFIG_ENV) $< --$@ $(CONFIG_CONFIG_IN)
 929
 930 defconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
 931         @$(COMMON_CONFIG_ENV) $< --defconfig$(if $(DEFCONFIG),=$(DEFCONFIG)) $(CONFIG_CONFIG_IN)
 932
 933 define percent_defconfig
 934 # Override the BR2_DEFCONFIG from COMMON_CONFIG_ENV with the new defconfig
 935 %_defconfig: $(BUILD_DIR)/buildroot-config/conf $(1)/configs/%_defconfig prepare-kconfig
 936         @$$(COMMON_CONFIG_ENV) BR2_DEFCONFIG=$(1)/configs/$$@ \
 937                 $$< --defconfig=$(1)/configs/$$@ $$(CONFIG_CONFIG_IN)
 938 endef
 939 $(eval $(foreach d,$(call reverse,$(TOPDIR) $(BR2_EXTERNAL_DIRS)),$(call percent_defconfig,$(d))$(sep)))
 940
 941 savedefconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
 942         @$(COMMON_CONFIG_ENV) $< \
 943                 --savedefconfig=$(if $(DEFCONFIG),$(DEFCONFIG),$(CONFIG_DIR)/defconfig) \
 944                 $(CONFIG_CONFIG_IN)
 945         @$(SED) '/BR2_DEFCONFIG=/d' $(if $(DEFCONFIG),$(DEFCONFIG),$(CONFIG_DIR)/defconfig)
 946
 947 .PHONY: defconfig savedefconfig
 948
 949 ################################################################################
 950 #
 951 # Cleanup and misc junk
 952 #
 953 ################################################################################
 954
 955 # outputmakefile generates a Makefile in the output directory, if using a
 956 # separate output directory. This allows convenient use of make in the
 957 # output directory.
 958 .PHONY: outputmakefile
 959 outputmakefile:
 960 ifeq ($(NEED_WRAPPER),y)
 961         $(Q)$(TOPDIR)/support/scripts/mkmakefile $(TOPDIR) $(O)
 962 endif
 963
 964 # Even though the target is a real file, we mark it as PHONY as we
 965 # want it to be re-generated each time make is invoked, in case the
 966 # value of BR2_EXTERNAL is changed.
 967 .PHONY: $(BUILD_DIR)/.br2-external.in
 968 $(BUILD_DIR)/.br2-external.in: $(BUILD_DIR)
 969         $(Q)support/scripts/br2-external -k -o "$(@)" $(BR2_EXTERNAL)
 970
 971 # printvars prints all the variables currently defined in our
 972 # Makefiles. Alternatively, if a non-empty VARS variable is passed,
 973 # only the variables matching the make pattern passed in VARS are
 974 # displayed.
 975 .PHONY: printvars
 976 printvars:
 977         @:$(foreach V, \
 978                 $(sort $(if $(VARS),$(filter $(VARS),$(.VARIABLES)),$(.VARIABLES))), \
 979                 $(if $(filter-out environment% default automatic, \
 980                                 $(origin $V)), \
 981                 $(if $(QUOTED_VARS),\
 982                         $(info $V='$(subst ','\'',$(if $(RAW_VARS),$(value $V),$($V)))'), \
 983                         $(info $V=$(if $(RAW_VARS),$(value $V),$($V))))))
 984 # ' Syntax colouring...
 985
 986 .PHONY: clean
 987 clean:
 988         rm -rf $(TARGET_DIR) $(BINARIES_DIR) $(HOST_DIR) \
 989                 $(BUILD_DIR) $(BASE_DIR)/staging \
 990                 $(LEGAL_INFO_DIR) $(GRAPHS_DIR)
 991
 992 .PHONY: distclean
 993 distclean: clean
 994 ifeq ($(O),$(CURDIR)/output)
 995         rm -rf $(O)
 996 endif
 997         rm -rf $(TOPDIR)/dl $(BR2_CONFIG) $(CONFIG_DIR)/.config.old $(CONFIG_DIR)/..config.tmp \
 998                 $(CONFIG_DIR)/.auto.deps $(BR2_EXTERNAL_FILE)
 999
1000 .PHONY: help
1001 help:
1002         @echo 'Cleaning:'
1003         @echo '  clean                  - delete all files created by build'
1004         @echo '  distclean              - delete all non-source files (including .config)'
1005         @echo
1006         @echo 'Build:'
1007         @echo '  all                    - make world'
1008         @echo '  toolchain              - build toolchain'
1009         @echo '  sdk                    - build relocatable SDK'
1010         @echo
1011         @echo 'Configuration:'
1012         @echo '  menuconfig             - interactive curses-based configurator'
1013         @echo '  nconfig                - interactive ncurses-based configurator'
1014         @echo '  xconfig                - interactive Qt-based configurator'
1015         @echo '  gconfig                - interactive GTK-based configurator'
1016         @echo '  oldconfig              - resolve any unresolved symbols in .config'
1017         @echo '  silentoldconfig        - Same as oldconfig, but quietly, additionally update deps'
1018         @echo '  olddefconfig           - Same as silentoldconfig but sets new symbols to their default value'
1019         @echo '  randconfig             - New config with random answer to all options'
1020         @echo '  defconfig              - New config with default answer to all options'
1021         @echo '                             BR2_DEFCONFIG, if set, is used as input'
1022         @echo '  savedefconfig          - Save current config to BR2_DEFCONFIG (minimal config)'
1023         @echo '  allyesconfig           - New config where all options are accepted with yes'
1024         @echo '  allnoconfig            - New config where all options are answered with no'
1025         @echo '  alldefconfig           - New config where all options are set to default'
1026         @echo '  randpackageconfig      - New config with random answer to package options'
1027         @echo '  allyespackageconfig    - New config where pkg options are accepted with yes'
1028         @echo '  allnopackageconfig     - New config where package options are answered with no'
1029         @echo
1030         @echo 'Package-specific:'
1031         @echo '  <pkg>                  - Build and install <pkg> and all its dependencies'
1032         @echo '  <pkg>-source           - Only download the source files for <pkg>'
1033         @echo '  <pkg>-extract          - Extract <pkg> sources'
1034         @echo '  <pkg>-patch            - Apply patches to <pkg>'
1035         @echo '  <pkg>-depends          - Build <pkg>'\''s dependencies'
1036         @echo '  <pkg>-configure        - Build <pkg> up to the configure step'
1037         @echo '  <pkg>-build            - Build <pkg> up to the build step'
1038         @echo '  <pkg>-show-depends     - List packages on which <pkg> depends'
1039         @echo '  <pkg>-show-rdepends    - List packages which have <pkg> as a dependency'
1040         @echo '  <pkg>-graph-depends    - Generate a graph of <pkg>'\''s dependencies'
1041         @echo '  <pkg>-graph-rdepends   - Generate a graph of <pkg>'\''s reverse dependencies'
1042         @echo '  <pkg>-dirclean         - Remove <pkg> build directory'
1043         @echo '  <pkg>-reconfigure      - Restart the build from the configure step'
1044         @echo '  <pkg>-rebuild          - Restart the build from the build step'
1045         $(foreach p,$(HELP_PACKAGES), \
1046                 @echo $(sep) \
1047                 @echo '$($(p)_NAME):' $(sep) \
1048                 $($(p)_HELP_CMDS)$(sep))
1049         @echo
1050         @echo 'Documentation:'
1051         @echo '  manual                 - build manual in all formats'
1052         @echo '  manual-html            - build manual in HTML'
1053         @echo '  manual-split-html      - build manual in split HTML'
1054         @echo '  manual-pdf             - build manual in PDF'
1055         @echo '  manual-text            - build manual in text'
1056         @echo '  manual-epub            - build manual in ePub'
1057         @echo '  graph-build            - generate graphs of the build times'
1058         @echo '  graph-depends          - generate graph of the dependency tree'
1059         @echo '  graph-size             - generate stats of the filesystem size'
1060         @echo '  list-defconfigs        - list all defconfigs (pre-configured minimal systems)'
1061         @echo
1062         @echo 'Miscellaneous:'
1063         @echo '  source                 - download all sources needed for offline-build'
1064         @echo '  external-deps          - list external packages used'
1065         @echo '  legal-info             - generate info about license compliance'
1066         @echo '  printvars              - dump all the internal variables'
1067         @echo
1068         @echo '  make V=0|1             - 0 => quiet build (default), 1 => verbose build'
1069         @echo '  make O=dir             - Locate all output files in "dir", including .config'
1070         @echo
1071         @echo 'For further details, see README, generate the Buildroot manual, or consult'
1072         @echo 'it on-line at http://buildroot.org/docs.html'
1073         @echo
1074
1075 # List the defconfig files
1076 # $(1): base directory
1077 # $(2): br2-external name, empty for bundled
1078 define list-defconfigs
1079         @first=true; \
1080         for defconfig in $(1)/configs/*_defconfig; do \
1081                 [ -f "$${defconfig}" ] || continue; \
1082                 if $${first}; then \
1083                         if [ "$(2)" ]; then \
1084                                 printf 'External configs in "$(call qstrip,$(2))":\n'; \
1085                         else \
1086                                 printf "Built-in configs:\n"; \
1087                         fi; \
1088                         first=false; \
1089                 fi; \
1090                 defconfig="$${defconfig##*/}"; \
1091                 printf "  %-35s - Build for %s\n" "$${defconfig}" "$${defconfig%_defconfig}"; \
1092         done; \
1093         $${first} || printf "\n"
1094 endef
1095
1096 # We iterate over BR2_EXTERNAL_NAMES rather than BR2_EXTERNAL_DIRS,
1097 # because we want to display the name of the br2-external tree.
1098 .PHONY: list-defconfigs
1099 list-defconfigs:
1100         $(call list-defconfigs,$(TOPDIR))
1101         $(foreach name,$(BR2_EXTERNAL_NAMES),\
1102                 $(call list-defconfigs,$(BR2_EXTERNAL_$(name)_PATH),\
1103                         $(BR2_EXTERNAL_$(name)_DESC))$(sep))
1104
1105 release: OUT = buildroot-$(BR2_VERSION)
1106
1107 # Create release tarballs. We need to fiddle a bit to add the generated
1108 # documentation to the git output
1109 release:
1110         git archive --format=tar --prefix=$(OUT)/ HEAD > $(OUT).tar
1111         $(MAKE) O=$(OUT) manual-html manual-text manual-pdf
1112         $(MAKE) O=$(OUT) manual-clean
1113         tar rf $(OUT).tar $(OUT)
1114         gzip -9 -c < $(OUT).tar > $(OUT).tar.gz
1115         bzip2 -9 -c < $(OUT).tar > $(OUT).tar.bz2
1116         rm -rf $(OUT) $(OUT).tar
1117
1118 print-version:
1119         @echo $(BR2_VERSION_FULL)
1120
1121 .PHONY: .gitlab-ci.yml
1122 .gitlab-ci.yml: .gitlab-ci.yml.in
1123         cp $< $@
1124         (cd configs; LC_ALL=C ls -1 *_defconfig) | sed 's/$$/: *defconfig/' >> $@
1125         ./support/testing/run-tests -l 2>&1 | sed -r -e '/^test_run \((.*)\).*/!d; s//\1: *runtime_test/' | LC_ALL=C sort >> $@
1126
1127 include docs/manual/manual.mk
1128 -include $(foreach dir,$(BR2_EXTERNAL_DIRS),$(sort $(wildcard $(dir)/docs/*/*.mk)))
1129
1130 .PHONY: $(noconfig_targets)
1131
1132 endif #umask / $(CURDIR) / $(O)