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-2017 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 := 2017.11-git
  91 # Actual time the release is cut (for reproducible builds)
  92 BR2_VERSION_EPOCH = 1504300000
  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 source-check \
 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 # Make sure pkg-config doesn't look outside the buildroot tree
 367 HOST_PKG_CONFIG_PATH := $(PKG_CONFIG_PATH)
 368 unexport PKG_CONFIG_PATH
 369 unexport PKG_CONFIG_SYSROOT_DIR
 370 unexport PKG_CONFIG_LIBDIR
 371
 372 # Having DESTDIR set in the environment confuses the installation
 373 # steps of some packages.
 374 unexport DESTDIR
 375
 376 # Causes breakage with packages that needs host-ruby
 377 unexport RUBYOPT
 378
 379 include package/pkg-utils.mk
 380 include package/doc-asciidoc.mk
 381
 382 ifeq ($(BR2_HAVE_DOT_CONFIG),y)
 383
 384 ################################################################################
 385 #
 386 # Hide troublesome environment variables from sub processes
 387 #
 388 ################################################################################
 389 unexport CROSS_COMPILE
 390 unexport ARCH
 391 unexport CC
 392 unexport LD
 393 unexport AR
 394 unexport CXX
 395 unexport CPP
 396 unexport RANLIB
 397 unexport CFLAGS
 398 unexport CXXFLAGS
 399 unexport GREP_OPTIONS
 400 unexport TAR_OPTIONS
 401 unexport CONFIG_SITE
 402 unexport QMAKESPEC
 403 unexport TERMINFO
 404 unexport MACHINE
 405 unexport O
 406 unexport GCC_COLORS
 407
 408 GNU_HOST_NAME := $(shell support/gnuconfig/config.guess)
 409
 410 PACKAGES :=
 411 PACKAGES_ALL :=
 412
 413 # silent mode requested?
 414 QUIET := $(if $(findstring s,$(filter-out --%,$(MAKEFLAGS))),-q)
 415
 416 # Strip off the annoying quoting
 417 ARCH := $(call qstrip,$(BR2_ARCH))
 418
 419 KERNEL_ARCH := $(shell echo "$(ARCH)" | sed -e "s/-.*//" \
 420         -e s/i.86/i386/ -e s/sun4u/sparc64/ \
 421         -e s/arcle/arc/ \
 422         -e s/arceb/arc/ \
 423         -e s/arm.*/arm/ -e s/sa110/arm/ \
 424         -e s/aarch64.*/arm64/ \
 425         -e s/bfin/blackfin/ \
 426         -e s/or1k/openrisc/ \
 427         -e s/parisc64/parisc/ \
 428         -e s/powerpc64.*/powerpc/ \
 429         -e s/ppc.*/powerpc/ -e s/mips.*/mips/ \
 430         -e s/sh.*/sh/ \
 431         -e s/microblazeel/microblaze/)
 432
 433 ZCAT := $(call qstrip,$(BR2_ZCAT))
 434 BZCAT := $(call qstrip,$(BR2_BZCAT))
 435 XZCAT := $(call qstrip,$(BR2_XZCAT))
 436 LZCAT := $(call qstrip,$(BR2_LZCAT))
 437 TAR_OPTIONS = $(call qstrip,$(BR2_TAR_OPTIONS)) -xf
 438
 439 # packages compiled for the host go here
 440 HOST_DIR := $(call qstrip,$(BR2_HOST_DIR))
 441
 442 # Quotes are needed for spaces and all in the original PATH content.
 443 BR_PATH = "$(HOST_DIR)/bin:$(HOST_DIR)/sbin:$(PATH)"
 444
 445 # Location of a file giving a big fat warning that output/target
 446 # should not be used as the root filesystem.
 447 TARGET_DIR_WARNING_FILE = $(TARGET_DIR)/THIS_IS_NOT_YOUR_ROOT_FILESYSTEM
 448
 449 ifeq ($(BR2_CCACHE),y)
 450 CCACHE := $(HOST_DIR)/bin/ccache
 451 BR_CACHE_DIR ?= $(call qstrip,$(BR2_CCACHE_DIR))
 452 export BR_CACHE_DIR
 453 HOSTCC := $(CCACHE) $(HOSTCC)
 454 HOSTCXX := $(CCACHE) $(HOSTCXX)
 455 else
 456 export BR_NO_CCACHE
 457 endif
 458
 459 # Scripts in support/ or post-build scripts may need to reference
 460 # these locations, so export them so it is easier to use
 461 export BR2_CONFIG
 462 export BR2_REPRODUCIBLE
 463 export TARGET_DIR
 464 export STAGING_DIR
 465 export HOST_DIR
 466 export BINARIES_DIR
 467 export BASE_DIR
 468
 469 ################################################################################
 470 #
 471 # You should probably leave this stuff alone unless you know
 472 # what you are doing.
 473 #
 474 ################################################################################
 475
 476 all: world
 477
 478 # Include legacy before the other things, because package .mk files
 479 # may rely on it.
 480 include Makefile.legacy
 481
 482 include system/system.mk
 483 include package/Makefile.in
 484 # arch/arch.mk.* must be after package/Makefile.in because it may need to
 485 # complement variables defined therein, like BR_NO_CHECK_HASH_FOR.
 486 -include $(wildcard arch/arch.mk.*)
 487 include support/dependencies/dependencies.mk
 488
 489 include toolchain/*.mk
 490 include toolchain/*/*.mk
 491
 492 # Include the package override file if one has been provided in the
 493 # configuration.
 494 PACKAGE_OVERRIDE_FILE = $(call qstrip,$(BR2_PACKAGE_OVERRIDE_FILE))
 495 ifneq ($(PACKAGE_OVERRIDE_FILE),)
 496 -include $(PACKAGE_OVERRIDE_FILE)
 497 endif
 498
 499 include $(sort $(wildcard package/*/*.mk))
 500
 501 include boot/common.mk
 502 include linux/linux.mk
 503 include fs/common.mk
 504
 505 # If using a br2-external tree, the BR2_EXTERNAL_$(NAME)_PATH variables
 506 # are also present in the .config file. Since .config is included after
 507 # we defined them in the Makefile, the values for those variables are
 508 # quoted. We just include the generated Makefile fragment .br2-external.mk
 509 # a third time, which will set those variables to the un-quoted values.
 510 include $(BR2_EXTERNAL_FILE)
 511
 512 # Nothing to include if no BR2_EXTERNAL tree in use
 513 include $(BR2_EXTERNAL_MKS)
 514
 515 # Now we are sure we have all the packages scanned and defined. We now
 516 # check for each package in the list of enabled packages, that all its
 517 # dependencies are indeed enabled.
 518 #
 519 # Only trigger the check for default builds. If the user forces building
 520 # a package, even if not enabled in the configuration, we want to accept
 521 # it.
 522 #
 523 ifeq ($(MAKECMDGOALS),)
 524
 525 define CHECK_ONE_DEPENDENCY
 526 ifeq ($$($(2)_TYPE),target)
 527 ifeq ($$($(2)_IS_VIRTUAL),)
 528 ifneq ($$($$($(2)_KCONFIG_VAR)),y)
 529 $$(error $$($(2)_NAME) is in the dependency chain of $$($(1)_NAME) that \
 530 has added it to its _DEPENDENCIES variable without selecting it or \
 531 depending on it from Config.in)
 532 endif
 533 endif
 534 endif
 535 endef
 536
 537 $(foreach pkg,$(call UPPERCASE,$(PACKAGES)),\
 538         $(foreach dep,$(call UPPERCASE,$($(pkg)_FINAL_ALL_DEPENDENCIES)),\
 539                 $(eval $(call CHECK_ONE_DEPENDENCY,$(pkg),$(dep))$(sep))))
 540
 541 endif
 542
 543 .PHONY: dirs
 544 dirs: $(BUILD_DIR) $(STAGING_DIR) $(TARGET_DIR) \
 545         $(HOST_DIR) $(HOST_DIR)/usr $(BINARIES_DIR)
 546
 547 $(BUILD_DIR)/buildroot-config/auto.conf: $(BR2_CONFIG)
 548         $(MAKE1) $(EXTRAMAKEARGS) HOSTCC="$(HOSTCC_NOCCACHE)" HOSTCXX="$(HOSTCXX_NOCCACHE)" silentoldconfig
 549
 550 .PHONY: prepare
 551 prepare: $(BUILD_DIR)/buildroot-config/auto.conf
 552
 553 .PHONY: world
 554 world: target-post-image
 555
 556 .PHONY: sdk
 557 sdk: world
 558         @$(call MESSAGE,"Rendering the SDK relocatable")
 559         $(TOPDIR)/support/scripts/fix-rpath host
 560         $(TOPDIR)/support/scripts/fix-rpath staging
 561         $(INSTALL) -m 755 $(TOPDIR)/support/misc/relocate-sdk.sh $(HOST_DIR)/relocate-sdk.sh
 562         echo $(HOST_DIR) > $(HOST_DIR)/share/buildroot/sdk-location
 563
 564 # Compatibility symlink in case a post-build script still uses $(HOST_DIR)/usr
 565 $(HOST_DIR)/usr: $(HOST_DIR)
 566         @ln -snf . $@
 567
 568 # Populating the staging with the base directories is handled by the skeleton package
 569 $(STAGING_DIR):
 570         @mkdir -p $(STAGING_DIR)
 571         @ln -snf $(STAGING_DIR) $(BASE_DIR)/staging
 572
 573 RSYNC_VCS_EXCLUSIONS = \
 574         --exclude .svn --exclude .git --exclude .hg --exclude .bzr \
 575         --exclude CVS
 576
 577 STRIP_FIND_CMD = find $(TARGET_DIR)
 578 ifneq (,$(call qstrip,$(BR2_STRIP_EXCLUDE_DIRS)))
 579 STRIP_FIND_CMD += \( $(call finddirclauses,$(TARGET_DIR),$(call qstrip,$(BR2_STRIP_EXCLUDE_DIRS))) \) -prune -o
 580 endif
 581 STRIP_FIND_CMD += -type f \( -perm /111 -o -name '*.so*' \)
 582 # file exclusions:
 583 # - libpthread.so: a non-stripped libpthread shared library is needed for
 584 #   proper debugging of pthread programs using gdb.
 585 # - ld.so: a non-stripped dynamic linker library is needed for valgrind
 586 # - kernel modules (*.ko): do not function properly when stripped like normal
 587 #   applications and libraries. Normally kernel modules are already excluded
 588 #   by the executable permission check above, so the explicit exclusion is only
 589 #   done for kernel modules with incorrect permissions.
 590 STRIP_FIND_CMD += -not \( $(call findfileclauses,libpthread*.so* ld-*.so* *.ko $(call qstrip,$(BR2_STRIP_EXCLUDE_FILES))) \) -print0
 591
 592 ifeq ($(BR2_ECLIPSE_REGISTER),y)
 593 define TOOLCHAIN_ECLIPSE_REGISTER
 594         ./support/scripts/eclipse-register-toolchain `readlink -f $(O)` \
 595                 $(notdir $(TARGET_CROSS)) $(BR2_ARCH)
 596 endef
 597 TARGET_FINALIZE_HOOKS += TOOLCHAIN_ECLIPSE_REGISTER
 598 endif
 599
 600 # Generate locale data. Basically, we call the localedef program
 601 # (built by the host-localedef package) for each locale. The input
 602 # data comes preferably from the toolchain, or if the toolchain does
 603 # not have them (Linaro toolchains), we use the ones available on the
 604 # host machine.
 605 ifeq ($(BR2_TOOLCHAIN_USES_GLIBC),y)
 606 GLIBC_GENERATE_LOCALES = $(call qstrip,$(BR2_GENERATE_LOCALE))
 607 ifneq ($(GLIBC_GENERATE_LOCALES),)
 608 PACKAGES += host-localedef
 609
 610 define GENERATE_GLIBC_LOCALES
 611         $(Q)mkdir -p $(TARGET_DIR)/usr/lib/locale/
 612         $(Q)for locale in $(GLIBC_GENERATE_LOCALES) ; do \
 613                 inputfile=`echo $${locale} | cut -f1 -d'.'` ; \
 614                 charmap=`echo $${locale} | cut -f2 -d'.' -s` ; \
 615                 if test -z "$${charmap}" ; then \
 616                         charmap="UTF-8" ; \
 617                 fi ; \
 618                 echo "Generating locale $${inputfile}.$${charmap}" ; \
 619                 I18NPATH=$(STAGING_DIR)/usr/share/i18n:/usr/share/i18n \
 620                 $(HOST_DIR)/bin/localedef \
 621                         --prefix=$(TARGET_DIR) \
 622                         --$(call LOWERCASE,$(BR2_ENDIAN))-endian \
 623                         -i $${inputfile} -f $${charmap} \
 624                         $${locale} ; \
 625         done
 626 endef
 627 TARGET_FINALIZE_HOOKS += GENERATE_GLIBC_LOCALES
 628 endif
 629 endif
 630
 631 ifeq ($(BR2_ENABLE_LOCALE_PURGE),y)
 632 LOCALE_WHITELIST = $(BUILD_DIR)/locales.nopurge
 633 LOCALE_NOPURGE = $(call qstrip,$(BR2_ENABLE_LOCALE_WHITELIST))
 634
 635 # This piece of junk does the following:
 636 # First collect the whitelist in a file.
 637 # Then go over all the locale dirs and for each subdir, check if it exists
 638 # in the whitelist file. If it doesn't, kill it.
 639 # Finally, specifically for X11, regenerate locale.dir from the whitelist.
 640 define PURGE_LOCALES
 641         rm -f $(LOCALE_WHITELIST)
 642         for i in $(LOCALE_NOPURGE) locale-archive; do echo $$i >> $(LOCALE_WHITELIST); done
 643
 644         for dir in $(wildcard $(addprefix $(TARGET_DIR),/usr/share/locale /usr/share/X11/locale /usr/lib/locale)); \
 645         do \
 646                 for langdir in $$dir/*; \
 647                 do \
 648                         if [ -e "$${langdir}" ]; \
 649                         then \
 650                                 grep -qx "$${langdir##*/}" $(LOCALE_WHITELIST) || rm -rf $$langdir; \
 651                         fi \
 652                 done; \
 653         done
 654         if [ -d $(TARGET_DIR)/usr/share/X11/locale ]; \
 655         then \
 656                 for lang in $(LOCALE_NOPURGE); \
 657                 do \
 658                         if [ -f $(TARGET_DIR)/usr/share/X11/locale/$$lang/XLC_LOCALE ]; \
 659                         then \
 660                                 echo "$$lang/XLC_LOCALE: $$lang"; \
 661                         fi \
 662                 done > $(TARGET_DIR)/usr/share/X11/locale/locale.dir; \
 663         fi
 664 endef
 665 TARGET_FINALIZE_HOOKS += PURGE_LOCALES
 666 endif
 667
 668 $(TARGETS_ROOTFS): target-finalize
 669
 670 .PHONY: target-finalize
 671 target-finalize: $(PACKAGES)
 672         @$(call MESSAGE,"Finalizing target directory")
 673         $(foreach hook,$(TARGET_FINALIZE_HOOKS),$($(hook))$(sep))
 674         rm -rf $(TARGET_DIR)/usr/include $(TARGET_DIR)/usr/share/aclocal \
 675                 $(TARGET_DIR)/usr/lib/pkgconfig $(TARGET_DIR)/usr/share/pkgconfig \
 676                 $(TARGET_DIR)/usr/lib/cmake $(TARGET_DIR)/usr/share/cmake
 677         find $(TARGET_DIR)/usr/{lib,share}/ -name '*.cmake' -print0 | xargs -0 rm -f
 678         find $(TARGET_DIR)/lib/ $(TARGET_DIR)/usr/lib/ $(TARGET_DIR)/usr/libexec/ \
 679                 \( -name '*.a' -o -name '*.la' \) -print0 | xargs -0 rm -f
 680 ifneq ($(BR2_PACKAGE_GDB),y)
 681         rm -rf $(TARGET_DIR)/usr/share/gdb
 682 endif
 683 ifneq ($(BR2_PACKAGE_BASH),y)
 684         rm -rf $(TARGET_DIR)/usr/share/bash-completion
 685 endif
 686 ifneq ($(BR2_PACKAGE_ZSH),y)
 687         rm -rf $(TARGET_DIR)/usr/share/zsh
 688 endif
 689         rm -rf $(TARGET_DIR)/usr/man $(TARGET_DIR)/usr/share/man
 690         rm -rf $(TARGET_DIR)/usr/info $(TARGET_DIR)/usr/share/info
 691         rm -rf $(TARGET_DIR)/usr/doc $(TARGET_DIR)/usr/share/doc
 692         rm -rf $(TARGET_DIR)/usr/share/gtk-doc
 693         rmdir $(TARGET_DIR)/usr/share 2>/dev/null || true
 694         $(STRIP_FIND_CMD) | xargs -0 $(STRIPCMD) 2>/dev/null || true
 695
 696 # See http://sourceware.org/gdb/wiki/FAQ, "GDB does not see any threads
 697 # besides the one in which crash occurred; or SIGTRAP kills my program when
 698 # I set a breakpoint"
 699 ifeq ($(BR2_TOOLCHAIN_HAS_THREADS),y)
 700         find $(TARGET_DIR)/lib/ -type f -name 'libpthread*.so*' | \
 701                 xargs -r $(STRIPCMD) $(STRIP_STRIP_DEBUG)
 702 endif
 703
 704 # Valgrind needs ld.so with enough information, so only strip
 705 # debugging symbols.
 706         find $(TARGET_DIR)/lib/ -type f -name 'ld-*.so*' | \
 707                 xargs -r $(STRIPCMD) $(STRIP_STRIP_DEBUG)
 708         test -f $(TARGET_DIR)/etc/ld.so.conf && \
 709                 { echo "ERROR: we shouldn't have a /etc/ld.so.conf file"; exit 1; } || true
 710         test -d $(TARGET_DIR)/etc/ld.so.conf.d && \
 711                 { echo "ERROR: we shouldn't have a /etc/ld.so.conf.d directory"; exit 1; } || true
 712         mkdir -p $(TARGET_DIR)/etc
 713         ( \
 714                 echo "NAME=Buildroot"; \
 715                 echo "VERSION=$(BR2_VERSION_FULL)"; \
 716                 echo "ID=buildroot"; \
 717                 echo "VERSION_ID=$(BR2_VERSION)"; \
 718                 echo "PRETTY_NAME=\"Buildroot $(BR2_VERSION)\"" \
 719         ) >  $(TARGET_DIR)/etc/os-release
 720
 721         @$(call MESSAGE,"Sanitizing RPATH in target tree")
 722         $(TOPDIR)/support/scripts/fix-rpath target
 723
 724         @$(foreach d, $(call qstrip,$(BR2_ROOTFS_OVERLAY)), \
 725                 $(call MESSAGE,"Copying overlay $(d)"); \
 726                 rsync -a --ignore-times --keep-dirlinks $(RSYNC_VCS_EXCLUSIONS) \
 727                         --chmod=u=rwX,go=rX --exclude .empty --exclude '*~' \
 728                         $(d)/ $(TARGET_DIR)$(sep))
 729
 730         @$(foreach s, $(call qstrip,$(BR2_ROOTFS_POST_BUILD_SCRIPT)), \
 731                 $(call MESSAGE,"Executing post-build script $(s)"); \
 732                 $(EXTRA_ENV) $(s) $(TARGET_DIR) $(call qstrip,$(BR2_ROOTFS_POST_SCRIPT_ARGS))$(sep))
 733
 734 .PHONY: target-post-image
 735 target-post-image: $(TARGETS_ROOTFS) target-finalize
 736         @$(foreach s, $(call qstrip,$(BR2_ROOTFS_POST_IMAGE_SCRIPT)), \
 737                 $(call MESSAGE,"Executing post-image script $(s)"); \
 738                 $(EXTRA_ENV) $(s) $(BINARIES_DIR) $(call qstrip,$(BR2_ROOTFS_POST_SCRIPT_ARGS))$(sep))
 739
 740 .PHONY: source
 741 source: $(foreach p,$(PACKAGES),$(p)-all-source)
 742
 743 .PHONY: _external-deps external-deps
 744 _external-deps: $(foreach p,$(PACKAGES),$(p)-all-external-deps)
 745 external-deps:
 746         @$(MAKE1) -Bs $(EXTRAMAKEARGS) _external-deps | sort -u
 747
 748 # check if download URLs are outdated
 749 .PHONY: source-check
 750 source-check: $(foreach p,$(PACKAGES),$(p)-all-source-check)
 751
 752 .PHONY: legal-info-clean
 753 legal-info-clean:
 754         @rm -fr $(LEGAL_INFO_DIR)
 755
 756 .PHONY: legal-info-prepare
 757 legal-info-prepare: $(LEGAL_INFO_DIR)
 758         @$(call MESSAGE,"Buildroot $(BR2_VERSION_FULL) Collecting legal info")
 759         @$(call legal-license-file,buildroot,buildroot,support/legal-info,COPYING,COPYING,HOST)
 760         @$(call legal-manifest,PACKAGE,VERSION,LICENSE,LICENSE FILES,SOURCE ARCHIVE,SOURCE SITE,TARGET)
 761         @$(call legal-manifest,PACKAGE,VERSION,LICENSE,LICENSE FILES,SOURCE ARCHIVE,SOURCE SITE,HOST)
 762         @$(call legal-manifest,buildroot,$(BR2_VERSION_FULL),GPL-2.0+,COPYING,not saved,not saved,HOST)
 763         @$(call legal-warning,the Buildroot source code has not been saved)
 764         @cp $(BR2_CONFIG) $(LEGAL_INFO_DIR)/buildroot.config
 765
 766 .PHONY: legal-info
 767 legal-info: dirs legal-info-clean legal-info-prepare $(foreach p,$(PACKAGES),$(p)-all-legal-info) \
 768                 $(REDIST_SOURCES_DIR_TARGET) $(REDIST_SOURCES_DIR_HOST)
 769         @cat support/legal-info/README.header >>$(LEGAL_REPORT)
 770         @if [ -r $(LEGAL_WARNINGS) ]; then \
 771                 cat support/legal-info/README.warnings-header \
 772                         $(LEGAL_WARNINGS) >>$(LEGAL_REPORT); \
 773                 cat $(LEGAL_WARNINGS); fi
 774         @rm -f $(LEGAL_WARNINGS)
 775         @(cd $(LEGAL_INFO_DIR); \
 776                 find * -type f -exec sha256sum {} + | LC_ALL=C sort -k2 \
 777                         >.legal-info.sha256; \
 778                 mv .legal-info.sha256 legal-info.sha256)
 779         @echo "Legal info produced in $(LEGAL_INFO_DIR)"
 780
 781 .PHONY: show-targets
 782 show-targets:
 783         @echo $(PACKAGES) $(TARGETS_ROOTFS)
 784
 785 .PHONY: show-build-order
 786 show-build-order: $(patsubst %,%-show-build-order,$(PACKAGES))
 787
 788 .PHONY: graph-build
 789 graph-build: $(O)/build/build-time.log
 790         @install -d $(GRAPHS_DIR)
 791         $(foreach o,name build duration,./support/scripts/graph-build-time \
 792                                         --type=histogram --order=$(o) --input=$(<) \
 793                                         --output=$(GRAPHS_DIR)/build.hist-$(o).$(BR_GRAPH_OUT) \
 794                                         $(if $(BR2_GRAPH_ALT),--alternate-colors)$(sep))
 795         $(foreach t,packages steps,./support/scripts/graph-build-time \
 796                                    --type=pie-$(t) --input=$(<) \
 797                                    --output=$(GRAPHS_DIR)/build.pie-$(t).$(BR_GRAPH_OUT) \
 798                                    $(if $(BR2_GRAPH_ALT),--alternate-colors)$(sep))
 799
 800 .PHONY: graph-depends-requirements
 801 graph-depends-requirements:
 802         @dot -? >/dev/null 2>&1 || \
 803                 { echo "ERROR: The 'dot' program from Graphviz is needed for graph-depends" >&2; exit 1; }
 804
 805 .PHONY: graph-depends
 806 graph-depends: graph-depends-requirements
 807         @$(INSTALL) -d $(GRAPHS_DIR)
 808         @cd "$(CONFIG_DIR)"; \
 809         $(TOPDIR)/support/scripts/graph-depends $(BR2_GRAPH_DEPS_OPTS) \
 810                 --direct -o $(GRAPHS_DIR)/$(@).dot
 811         dot $(BR2_GRAPH_DOT_OPTS) -T$(BR_GRAPH_OUT) \
 812                 -o $(GRAPHS_DIR)/$(@).$(BR_GRAPH_OUT) \
 813                 $(GRAPHS_DIR)/$(@).dot
 814
 815 .PHONY: graph-size
 816 graph-size:
 817         $(Q)mkdir -p $(GRAPHS_DIR)
 818         $(Q)$(TOPDIR)/support/scripts/size-stats --builddir $(BASE_DIR) \
 819                 --graph $(GRAPHS_DIR)/graph-size.$(BR_GRAPH_OUT) \
 820                 --file-size-csv $(GRAPHS_DIR)/file-size-stats.csv \
 821                 --package-size-csv $(GRAPHS_DIR)/package-size-stats.csv
 822
 823 .PHONY: check-dependencies
 824 check-dependencies:
 825         @cd "$(CONFIG_DIR)"; \
 826         $(TOPDIR)/support/scripts/graph-depends -C
 827
 828 else # ifeq ($(BR2_HAVE_DOT_CONFIG),y)
 829
 830 # Some subdirectories are also package names. To avoid that "make linux"
 831 # on an unconfigured tree produces "Nothing to be done", add an explicit
 832 # rule for it.
 833 # Also for 'all' we error out and ask the user to configure first.
 834 .PHONY: linux toolchain
 835 linux toolchain all: outputmakefile
 836         $(error Please configure Buildroot first (e.g. "make menuconfig"))
 837         @exit 1
 838
 839 endif # ifeq ($(BR2_HAVE_DOT_CONFIG),y)
 840
 841 # configuration
 842 # ---------------------------------------------------------------------------
 843
 844 HOSTCFLAGS = $(CFLAGS_FOR_BUILD)
 845 export HOSTCFLAGS
 846
 847 .PHONY: prepare-kconfig
 848 prepare-kconfig: outputmakefile $(BUILD_DIR)/.br2-external.in
 849
 850 $(BUILD_DIR)/buildroot-config/%onf:
 851         mkdir -p $(@D)/lxdialog
 852         PKG_CONFIG_PATH="$(HOST_PKG_CONFIG_PATH)" $(MAKE) CC="$(HOSTCC_NOCCACHE)" HOSTCC="$(HOSTCC_NOCCACHE)" \
 853             obj=$(@D) -C $(CONFIG) -f Makefile.br $(@F)
 854
 855 DEFCONFIG = $(call qstrip,$(BR2_DEFCONFIG))
 856
 857 # We don't want to fully expand BR2_DEFCONFIG here, so Kconfig will
 858 # recognize that if it's still at its default $(CONFIG_DIR)/defconfig
 859 COMMON_CONFIG_ENV = \
 860         BR2_DEFCONFIG='$(call qstrip,$(value BR2_DEFCONFIG))' \
 861         KCONFIG_AUTOCONFIG=$(BUILD_DIR)/buildroot-config/auto.conf \
 862         KCONFIG_AUTOHEADER=$(BUILD_DIR)/buildroot-config/autoconf.h \
 863         KCONFIG_TRISTATE=$(BUILD_DIR)/buildroot-config/tristate.config \
 864         BR2_CONFIG=$(BR2_CONFIG) \
 865         HOST_GCC_VERSION="$(HOSTCC_VERSION)" \
 866         BUILD_DIR=$(BUILD_DIR) \
 867         SKIP_LEGACY=
 868
 869 xconfig: $(BUILD_DIR)/buildroot-config/qconf prepare-kconfig
 870         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
 871
 872 gconfig: $(BUILD_DIR)/buildroot-config/gconf prepare-kconfig
 873         @$(COMMON_CONFIG_ENV) srctree=$(TOPDIR) $< $(CONFIG_CONFIG_IN)
 874
 875 menuconfig: $(BUILD_DIR)/buildroot-config/mconf prepare-kconfig
 876         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
 877
 878 nconfig: $(BUILD_DIR)/buildroot-config/nconf prepare-kconfig
 879         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
 880
 881 config: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
 882         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
 883
 884 # For the config targets that automatically select options, we pass
 885 # SKIP_LEGACY=y to disable the legacy options. However, in that case
 886 # no values are set for the legacy options so a subsequent oldconfig
 887 # will query them. Therefore, run an additional olddefconfig.
 888
 889 randconfig allyesconfig alldefconfig allnoconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
 890         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y $< --$@ $(CONFIG_CONFIG_IN)
 891         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
 892
 893 randpackageconfig allyespackageconfig allnopackageconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
 894         @grep -v BR2_PACKAGE_ $(BR2_CONFIG) > $(CONFIG_DIR)/.config.nopkg
 895         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y \
 896                 KCONFIG_ALLCONFIG=$(CONFIG_DIR)/.config.nopkg \
 897                 $< --$(subst package,,$@) $(CONFIG_CONFIG_IN)
 898         @rm -f $(CONFIG_DIR)/.config.nopkg
 899         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
 900
 901 oldconfig silentoldconfig olddefconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
 902         @$(COMMON_CONFIG_ENV) $< --$@ $(CONFIG_CONFIG_IN)
 903
 904 defconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
 905         @$(COMMON_CONFIG_ENV) $< --defconfig$(if $(DEFCONFIG),=$(DEFCONFIG)) $(CONFIG_CONFIG_IN)
 906
 907 define percent_defconfig
 908 # Override the BR2_DEFCONFIG from COMMON_CONFIG_ENV with the new defconfig
 909 %_defconfig: $(BUILD_DIR)/buildroot-config/conf $(1)/configs/%_defconfig prepare-kconfig
 910         @$$(COMMON_CONFIG_ENV) BR2_DEFCONFIG=$(1)/configs/$$@ \
 911                 $$< --defconfig=$(1)/configs/$$@ $$(CONFIG_CONFIG_IN)
 912 endef
 913 $(eval $(foreach d,$(call reverse,$(TOPDIR) $(BR2_EXTERNAL_DIRS)),$(call percent_defconfig,$(d))$(sep)))
 914
 915 savedefconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
 916         @$(COMMON_CONFIG_ENV) $< \
 917                 --savedefconfig=$(if $(DEFCONFIG),$(DEFCONFIG),$(CONFIG_DIR)/defconfig) \
 918                 $(CONFIG_CONFIG_IN)
 919         @$(SED) '/BR2_DEFCONFIG=/d' $(if $(DEFCONFIG),$(DEFCONFIG),$(CONFIG_DIR)/defconfig)
 920
 921 .PHONY: defconfig savedefconfig
 922
 923 ################################################################################
 924 #
 925 # Cleanup and misc junk
 926 #
 927 ################################################################################
 928
 929 # outputmakefile generates a Makefile in the output directory, if using a
 930 # separate output directory. This allows convenient use of make in the
 931 # output directory.
 932 .PHONY: outputmakefile
 933 outputmakefile:
 934 ifeq ($(NEED_WRAPPER),y)
 935         $(Q)$(TOPDIR)/support/scripts/mkmakefile $(TOPDIR) $(O)
 936 endif
 937
 938 # Even though the target is a real file, we mark it as PHONY as we
 939 # want it to be re-generated each time make is invoked, in case the
 940 # value of BR2_EXTERNAL is changed.
 941 .PHONY: $(BUILD_DIR)/.br2-external.in
 942 $(BUILD_DIR)/.br2-external.in: $(BUILD_DIR)
 943         $(Q)support/scripts/br2-external -k -o "$(@)" $(BR2_EXTERNAL)
 944
 945 # printvars prints all the variables currently defined in our
 946 # Makefiles. Alternatively, if a non-empty VARS variable is passed,
 947 # only the variables matching the make pattern passed in VARS are
 948 # displayed.
 949 .PHONY: printvars
 950 printvars:
 951         @:$(foreach V, \
 952                 $(sort $(if $(VARS),$(filter $(VARS),$(.VARIABLES)),$(.VARIABLES))), \
 953                 $(if $(filter-out environment% default automatic, \
 954                                 $(origin $V)), \
 955                 $(if $(QUOTED_VARS),\
 956                         $(info $V='$(subst ','\'',$(if $(RAW_VARS),$(value $V),$($V)))'), \
 957                         $(info $V=$(if $(RAW_VARS),$(value $V),$($V))))))
 958 # ' Syntax colouring...
 959
 960 .PHONY: clean
 961 clean:
 962         rm -rf $(TARGET_DIR) $(BINARIES_DIR) $(HOST_DIR) \
 963                 $(BUILD_DIR) $(BASE_DIR)/staging \
 964                 $(LEGAL_INFO_DIR) $(GRAPHS_DIR)
 965
 966 .PHONY: distclean
 967 distclean: clean
 968 ifeq ($(O),$(CURDIR)/output)
 969         rm -rf $(O)
 970 endif
 971         rm -rf $(TOPDIR)/dl $(BR2_CONFIG) $(CONFIG_DIR)/.config.old $(CONFIG_DIR)/..config.tmp \
 972                 $(CONFIG_DIR)/.auto.deps $(BR2_EXTERNAL_FILE)
 973
 974 .PHONY: help
 975 help:
 976         @echo 'Cleaning:'
 977         @echo '  clean                  - delete all files created by build'
 978         @echo '  distclean              - delete all non-source files (including .config)'
 979         @echo
 980         @echo 'Build:'
 981         @echo '  all                    - make world'
 982         @echo '  toolchain              - build toolchain'
 983         @echo '  sdk                    - build relocatable SDK'
 984         @echo
 985         @echo 'Configuration:'
 986         @echo '  menuconfig             - interactive curses-based configurator'
 987         @echo '  nconfig                - interactive ncurses-based configurator'
 988         @echo '  xconfig                - interactive Qt-based configurator'
 989         @echo '  gconfig                - interactive GTK-based configurator'
 990         @echo '  oldconfig              - resolve any unresolved symbols in .config'
 991         @echo '  silentoldconfig        - Same as oldconfig, but quietly, additionally update deps'
 992         @echo '  olddefconfig           - Same as silentoldconfig but sets new symbols to their default value'
 993         @echo '  randconfig             - New config with random answer to all options'
 994         @echo '  defconfig              - New config with default answer to all options'
 995         @echo '                             BR2_DEFCONFIG, if set, is used as input'
 996         @echo '  savedefconfig          - Save current config to BR2_DEFCONFIG (minimal config)'
 997         @echo '  allyesconfig           - New config where all options are accepted with yes'
 998         @echo '  allnoconfig            - New config where all options are answered with no'
 999         @echo '  alldefconfig           - New config where all options are set to default'
1000         @echo '  randpackageconfig      - New config with random answer to package options'
1001         @echo '  allyespackageconfig    - New config where pkg options are accepted with yes'
1002         @echo '  allnopackageconfig     - New config where package options are answered with no'
1003         @echo
1004         @echo 'Package-specific:'
1005         @echo '  <pkg>                  - Build and install <pkg> and all its dependencies'
1006         @echo '  <pkg>-source           - Only download the source files for <pkg>'
1007         @echo '  <pkg>-extract          - Extract <pkg> sources'
1008         @echo '  <pkg>-patch            - Apply patches to <pkg>'
1009         @echo '  <pkg>-depends          - Build <pkg>'\''s dependencies'
1010         @echo '  <pkg>-configure        - Build <pkg> up to the configure step'
1011         @echo '  <pkg>-build            - Build <pkg> up to the build step'
1012         @echo '  <pkg>-show-depends     - List packages on which <pkg> depends'
1013         @echo '  <pkg>-show-rdepends    - List packages which have <pkg> as a dependency'
1014         @echo '  <pkg>-graph-depends    - Generate a graph of <pkg>'\''s dependencies'
1015         @echo '  <pkg>-graph-rdepends   - Generate a graph of <pkg>'\''s reverse dependencies'
1016         @echo '  <pkg>-dirclean         - Remove <pkg> build directory'
1017         @echo '  <pkg>-reconfigure      - Restart the build from the configure step'
1018         @echo '  <pkg>-rebuild          - Restart the build from the build step'
1019         $(foreach p,$(HELP_PACKAGES), \
1020                 @echo $(sep) \
1021                 @echo '$($(p)_NAME):' $(sep) \
1022                 $($(p)_HELP_CMDS)$(sep))
1023         @echo
1024         @echo 'Documentation:'
1025         @echo '  manual                 - build manual in all formats'
1026         @echo '  manual-html            - build manual in HTML'
1027         @echo '  manual-split-html      - build manual in split HTML'
1028         @echo '  manual-pdf             - build manual in PDF'
1029         @echo '  manual-text            - build manual in text'
1030         @echo '  manual-epub            - build manual in ePub'
1031         @echo '  graph-build            - generate graphs of the build times'
1032         @echo '  graph-depends          - generate graph of the dependency tree'
1033         @echo '  graph-size             - generate stats of the filesystem size'
1034         @echo '  list-defconfigs        - list all defconfigs (pre-configured minimal systems)'
1035         @echo
1036         @echo 'Miscellaneous:'
1037         @echo '  source                 - download all sources needed for offline-build'
1038         @echo '  source-check           - check selected packages for valid download URLs'
1039         @echo '  external-deps          - list external packages used'
1040         @echo '  legal-info             - generate info about license compliance'
1041         @echo '  printvars              - dump all the internal variables'
1042         @echo
1043         @echo '  make V=0|1             - 0 => quiet build (default), 1 => verbose build'
1044         @echo '  make O=dir             - Locate all output files in "dir", including .config'
1045         @echo
1046         @echo 'For further details, see README, generate the Buildroot manual, or consult'
1047         @echo 'it on-line at http://buildroot.org/docs.html'
1048         @echo
1049
1050 # List the defconfig files
1051 # $(1): base directory
1052 # $(2): br2-external name, empty for bundled
1053 define list-defconfigs
1054         @first=true; \
1055         for defconfig in $(1)/configs/*_defconfig; do \
1056                 [ -f "$${defconfig}" ] || continue; \
1057                 if $${first}; then \
1058                         if [ "$(2)" ]; then \
1059                                 printf 'External configs in "$(call qstrip,$(2))":\n'; \
1060                         else \
1061                                 printf "Built-in configs:\n"; \
1062                         fi; \
1063                         first=false; \
1064                 fi; \
1065                 defconfig="$${defconfig##*/}"; \
1066                 printf "  %-35s - Build for %s\n" "$${defconfig}" "$${defconfig%_defconfig}"; \
1067         done; \
1068         $${first} || printf "\n"
1069 endef
1070
1071 # We iterate over BR2_EXTERNAL_NAMES rather than BR2_EXTERNAL_DIRS,
1072 # because we want to display the name of the br2-external tree.
1073 .PHONY: list-defconfigs
1074 list-defconfigs:
1075         $(call list-defconfigs,$(TOPDIR))
1076         $(foreach name,$(BR2_EXTERNAL_NAMES),\
1077                 $(call list-defconfigs,$(BR2_EXTERNAL_$(name)_PATH),\
1078                         $(BR2_EXTERNAL_$(name)_DESC))$(sep))
1079
1080 release: OUT = buildroot-$(BR2_VERSION)
1081
1082 # Create release tarballs. We need to fiddle a bit to add the generated
1083 # documentation to the git output
1084 release:
1085         git archive --format=tar --prefix=$(OUT)/ HEAD > $(OUT).tar
1086         $(MAKE) O=$(OUT) manual-html manual-text manual-pdf
1087         $(MAKE) O=$(OUT) manual-clean
1088         tar rf $(OUT).tar $(OUT)
1089         gzip -9 -c < $(OUT).tar > $(OUT).tar.gz
1090         bzip2 -9 -c < $(OUT).tar > $(OUT).tar.bz2
1091         rm -rf $(OUT) $(OUT).tar
1092
1093 print-version:
1094         @echo $(BR2_VERSION_FULL)
1095
1096 .PHONY: .gitlab-ci.yml
1097 .gitlab-ci.yml: .gitlab-ci.yml.in
1098         cp $< $@
1099         (cd configs; LC_ALL=C ls -1 *_defconfig) | sed 's/$$/: *defconfig/' >> $@
1100         ./support/testing/run-tests -l 2>&1 | sed -r -e '/^test_run \((.*)\).*/!d; s//\1: *runtime_test/' | LC_ALL=C sort >> $@
1101
1102 include docs/manual/manual.mk
1103 -include $(foreach dir,$(BR2_EXTERNAL_DIRS),$(dir)/docs/*/*.mk)
1104
1105 .PHONY: $(noconfig_targets)
1106
1107 endif #umask / $(CURDIR) / $(O)