Makefile

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