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.05-rc2
  94 # Actual time the release is cut (for reproducible builds)
  95 BR2_VERSION_EPOCH = 1685305000
  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         PER_PACKAGE_DIR=$(PER_PACKAGE_DIR) $(TOPDIR)/support/scripts/fix-rpath host
 598         PER_PACKAGE_DIR=$(PER_PACKAGE_DIR) $(TOPDIR)/support/scripts/fix-rpath staging
 599         $(INSTALL) -m 755 $(TOPDIR)/support/misc/relocate-sdk.sh $(HOST_DIR)/relocate-sdk.sh
 600         mkdir -p $(HOST_DIR)/share/buildroot
 601         echo $(HOST_DIR) > $(HOST_DIR)/share/buildroot/sdk-location
 602
 603 BR2_SDK_PREFIX ?= $(GNU_TARGET_NAME)_sdk-buildroot
 604 .PHONY: sdk
 605 sdk: prepare-sdk $(BR2_TAR_HOST_DEPENDENCY)
 606         @$(call MESSAGE,"Generating SDK tarball")
 607         $(if $(BR2_SDK_PREFIX),,$(error BR2_SDK_PREFIX can not be empty))
 608         $(Q)mkdir -p $(BINARIES_DIR)
 609         $(TAR) czf "$(BINARIES_DIR)/$(BR2_SDK_PREFIX).tar.gz" \
 610                 --owner=0 --group=0 --numeric-owner \
 611                 --transform='s#^$(patsubst /%,%,$(HOST_DIR))#$(BR2_SDK_PREFIX)#' \
 612                 -C / $(patsubst /%,%,$(HOST_DIR))
 613
 614 RSYNC_VCS_EXCLUSIONS = \
 615         --exclude .svn --exclude .git --exclude .hg --exclude .bzr \
 616         --exclude CVS
 617
 618 # When stripping, obey to BR2_STRIP_EXCLUDE_DIRS and
 619 # BR2_STRIP_EXCLUDE_FILES
 620 STRIP_FIND_COMMON_CMD = \
 621         find $(TARGET_DIR) \
 622         $(if $(call qstrip,$(BR2_STRIP_EXCLUDE_DIRS)), \
 623                 \( $(call finddirclauses,$(TARGET_DIR),$(call qstrip,$(BR2_STRIP_EXCLUDE_DIRS))) \) \
 624                 -prune -o \
 625         ) \
 626         $(if $(call qstrip,$(BR2_STRIP_EXCLUDE_FILES)), \
 627                 -not \( $(call findfileclauses,$(call qstrip,$(BR2_STRIP_EXCLUDE_FILES))) \) )
 628
 629 # Regular stripping for everything, except libpthread, ld-*.so and
 630 # kernel modules:
 631 # - libpthread.so: a non-stripped libpthread shared library is needed for
 632 #   proper debugging of pthread programs using gdb.
 633 # - ld.so: a non-stripped dynamic linker library is needed for valgrind
 634 # - kernel modules (*.ko): do not function properly when stripped like normal
 635 #   applications and libraries. Normally kernel modules are already excluded
 636 #   by the executable permission check, so the explicit exclusion is only
 637 #   done for kernel modules with incorrect permissions.
 638 STRIP_FIND_CMD = \
 639         $(STRIP_FIND_COMMON_CMD) \
 640         -type f \( -perm /111 -o -name '*.so*' \) \
 641         -not \( $(call findfileclauses,libpthread*.so* ld-*.so* *.ko) \) \
 642         -print0
 643
 644 # Special stripping (only debugging symbols) for libpthread and ld-*.so.
 645 STRIP_FIND_SPECIAL_LIBS_CMD = \
 646         $(STRIP_FIND_COMMON_CMD) \
 647         \( -name 'ld-*.so*' -o -name 'libpthread*.so*' \) \
 648         -print0
 649
 650 # Generate locale data.
 651 ifeq ($(BR2_TOOLCHAIN_USES_GLIBC),y)
 652 GLIBC_GENERATE_LOCALES = $(call qstrip,$(BR2_GENERATE_LOCALE))
 653 ifneq ($(GLIBC_GENERATE_LOCALES),)
 654 PACKAGES += host-localedef
 655
 656 define GENERATE_GLIBC_LOCALES
 657         +$(MAKE) -f support/misc/gen-glibc-locales.mk \
 658                 ENDIAN=$(call LOWERCASE,$(BR2_ENDIAN)) \
 659                 LOCALES="$(GLIBC_GENERATE_LOCALES)" \
 660                 Q=$(Q)
 661 endef
 662 TARGET_FINALIZE_HOOKS += GENERATE_GLIBC_LOCALES
 663 endif
 664 endif
 665
 666 ifeq ($(BR2_ENABLE_LOCALE_PURGE),y)
 667 LOCALE_WHITELIST = $(BUILD_DIR)/locales.nopurge
 668 LOCALE_NOPURGE = $(call qstrip,$(BR2_ENABLE_LOCALE_WHITELIST))
 669
 670 # This piece of junk does the following:
 671 # First collect the whitelist in a file.
 672 # Then go over all the locale dirs and for each subdir, check if it exists
 673 # in the whitelist file. If it doesn't, kill it.
 674 # Finally, specifically for X11, regenerate locale.dir from the whitelist.
 675 define PURGE_LOCALES
 676         printf '%s\n' $(LOCALE_NOPURGE) locale-archive > $(LOCALE_WHITELIST)
 677
 678         for dir in $(addprefix $(TARGET_DIR),/usr/share/locale /usr/share/X11/locale /usr/lib/locale); \
 679         do \
 680                 if [ ! -d $$dir ]; then continue; fi; \
 681                 for langdir in $$dir/*; \
 682                 do \
 683                         if [ -e "$${langdir}" ]; \
 684                         then \
 685                                 grep -qx "$${langdir##*/}" $(LOCALE_WHITELIST) || rm -rf $$langdir; \
 686                         fi \
 687                 done; \
 688         done
 689         if [ -d $(TARGET_DIR)/usr/share/X11/locale ]; \
 690         then \
 691                 for lang in $(LOCALE_NOPURGE); \
 692                 do \
 693                         if [ -f $(TARGET_DIR)/usr/share/X11/locale/$$lang/XLC_LOCALE ]; \
 694                         then \
 695                                 echo "$$lang/XLC_LOCALE: $$lang"; \
 696                         fi \
 697                 done > $(TARGET_DIR)/usr/share/X11/locale/locale.dir; \
 698         fi
 699 endef
 700 TARGET_FINALIZE_HOOKS += PURGE_LOCALES
 701 endif
 702
 703 $(TARGETS_ROOTFS): target-finalize
 704
 705 # Avoid the rootfs name leaking down the dependency chain
 706 target-finalize: ROOTFS=
 707
 708 TARGET_DIR_FILES_LISTS = $(sort $(wildcard $(BUILD_DIR)/*/.files-list.txt))
 709 HOST_DIR_FILES_LISTS = $(sort $(wildcard $(BUILD_DIR)/*/.files-list-host.txt))
 710 STAGING_DIR_FILES_LISTS = $(sort $(wildcard $(BUILD_DIR)/*/.files-list-staging.txt))
 711
 712 .PHONY: host-finalize
 713 host-finalize: $(PACKAGES) $(HOST_DIR) $(HOST_DIR_SYMLINK)
 714         @$(call MESSAGE,"Finalizing host directory")
 715         $(call per-package-rsync,$(sort $(PACKAGES)),host,$(HOST_DIR))
 716
 717 .PHONY: staging-finalize
 718 staging-finalize: $(STAGING_DIR_SYMLINK)
 719
 720 .PHONY: target-finalize
 721 target-finalize: $(PACKAGES) $(TARGET_DIR) host-finalize
 722         @$(call MESSAGE,"Finalizing target directory")
 723         $(call per-package-rsync,$(sort $(PACKAGES)),target,$(TARGET_DIR))
 724         $(foreach hook,$(TARGET_FINALIZE_HOOKS),$($(hook))$(sep))
 725         rm -rf $(TARGET_DIR)/usr/include $(TARGET_DIR)/usr/share/aclocal \
 726                 $(TARGET_DIR)/usr/lib/pkgconfig $(TARGET_DIR)/usr/share/pkgconfig \
 727                 $(TARGET_DIR)/usr/lib/cmake $(TARGET_DIR)/usr/share/cmake \
 728                 $(TARGET_DIR)/usr/lib/rpm $(TARGET_DIR)/usr/doc
 729         find $(TARGET_DIR)/usr/{lib,share}/ -name '*.cmake' -print0 | xargs -0 rm -f
 730         find $(TARGET_DIR)/lib/ $(TARGET_DIR)/usr/lib/ $(TARGET_DIR)/usr/libexec/ \
 731                 \( -name '*.a' -o -name '*.la' -o -name '*.prl' \) -print0 | xargs -0 rm -f
 732 ifneq ($(BR2_PACKAGE_GDB),y)
 733         rm -rf $(TARGET_DIR)/usr/share/gdb
 734 endif
 735 ifneq ($(BR2_PACKAGE_BASH),y)
 736         rm -rf $(TARGET_DIR)/usr/share/bash-completion
 737         rm -rf $(TARGET_DIR)/etc/bash_completion.d
 738 endif
 739 ifneq ($(BR2_PACKAGE_ZSH),y)
 740         rm -rf $(TARGET_DIR)/usr/share/zsh
 741 endif
 742         rm -rf $(TARGET_DIR)/usr/man $(TARGET_DIR)/usr/share/man
 743         rm -rf $(TARGET_DIR)/usr/info $(TARGET_DIR)/usr/share/info
 744         rm -rf $(TARGET_DIR)/usr/doc $(TARGET_DIR)/usr/share/doc
 745         rm -rf $(TARGET_DIR)/usr/share/gtk-doc
 746         rmdir $(TARGET_DIR)/usr/share 2>/dev/null || true
 747 ifneq ($(BR2_ENABLE_DEBUG):$(BR2_STRIP_strip),y:)
 748         rm -rf $(TARGET_DIR)/lib/debug $(TARGET_DIR)/usr/lib/debug
 749 endif
 750         $(STRIP_FIND_CMD) | xargs -0 $(STRIPCMD) 2>/dev/null || true
 751         $(STRIP_FIND_SPECIAL_LIBS_CMD) | xargs -0 -r $(STRIPCMD) $(STRIP_STRIP_DEBUG) 2>/dev/null || true
 752
 753         test -f $(TARGET_DIR)/etc/ld.so.conf && \
 754                 { echo "ERROR: we shouldn't have a /etc/ld.so.conf file"; exit 1; } || true
 755         test -d $(TARGET_DIR)/etc/ld.so.conf.d && \
 756                 { echo "ERROR: we shouldn't have a /etc/ld.so.conf.d directory"; exit 1; } || true
 757         mkdir -p $(TARGET_DIR)/etc
 758         ( \
 759                 echo "NAME=Buildroot"; \
 760                 echo "VERSION=$(BR2_VERSION_FULL)"; \
 761                 echo "ID=buildroot"; \
 762                 echo "VERSION_ID=$(BR2_VERSION)"; \
 763                 echo "PRETTY_NAME=\"Buildroot $(BR2_VERSION)\"" \
 764         ) >  $(TARGET_DIR)/usr/lib/os-release
 765         ln -sf ../usr/lib/os-release $(TARGET_DIR)/etc
 766
 767         @$(call MESSAGE,"Sanitizing RPATH in target tree")
 768         PER_PACKAGE_DIR=$(PER_PACKAGE_DIR) $(TOPDIR)/support/scripts/fix-rpath target
 769
 770 # For a merged /usr, ensure that /lib, /bin and /sbin and their /usr
 771 # counterparts are appropriately setup as symlinks ones to the others.
 772 ifeq ($(BR2_ROOTFS_MERGED_USR),y)
 773
 774         $(foreach d, $(call qstrip,$(BR2_ROOTFS_OVERLAY)), \
 775                 @$(call MESSAGE,"Sanity check in overlay $(d)")$(sep) \
 776                 $(Q)not_merged_dirs="$$(support/scripts/check-merged-usr.sh $(d))"; \
 777                 test -n "$$not_merged_dirs" && { \
 778                         echo "ERROR: The overlay in $(d) is not" \
 779                                 "using a merged /usr for the following directories:" \
 780                                 $$not_merged_dirs; \
 781                         exit 1; \
 782                 } || true$(sep))
 783
 784 endif # merged /usr
 785
 786         $(foreach d, $(call qstrip,$(BR2_ROOTFS_OVERLAY)), \
 787                 @$(call MESSAGE,"Copying overlay $(d)")$(sep) \
 788                 $(Q)$(call SYSTEM_RSYNC,$(d),$(TARGET_DIR))$(sep))
 789
 790         $(Q)$(if $(TARGET_DIR_FILES_LISTS), \
 791                 cat $(TARGET_DIR_FILES_LISTS)) > $(BUILD_DIR)/packages-file-list.txt
 792         $(Q)$(if $(HOST_DIR_FILES_LISTS), \
 793                 cat $(HOST_DIR_FILES_LISTS)) > $(BUILD_DIR)/packages-file-list-host.txt
 794         $(Q)$(if $(STAGING_DIR_FILES_LISTS), \
 795                 cat $(STAGING_DIR_FILES_LISTS)) > $(BUILD_DIR)/packages-file-list-staging.txt
 796
 797         $(foreach s, $(call qstrip,$(BR2_ROOTFS_POST_BUILD_SCRIPT)), \
 798                 @$(call MESSAGE,"Executing post-build script $(s)")$(sep) \
 799                 $(Q)$(EXTRA_ENV) $(s) $(TARGET_DIR) $(call qstrip,$(BR2_ROOTFS_POST_SCRIPT_ARGS))$(sep))
 800
 801         touch $(TARGET_DIR)/usr
 802
 803 # Note: this will run in the filesystem context, so will use a copy
 804 # of target/, not the real one, so the files are still available on
 805 # re-builds (foo-rebuild, etc...)
 806 define ROOTFS_RM_HWDB_DATA
 807         rm -rf $(TARGET_DIR)/usr/lib/udev/hwdb.d/ $(TARGET_DIR)/etc/udev/hwdb.d/
 808 endef
 809 ROOTFS_PRE_CMD_HOOKS += ROOTFS_RM_HWDB_DATA
 810
 811 .PHONY: target-post-image
 812 target-post-image: $(TARGETS_ROOTFS) target-finalize staging-finalize
 813         @rm -f $(ROOTFS_COMMON_TAR)
 814         $(Q)mkdir -p $(BINARIES_DIR)
 815         @$(foreach s, $(call qstrip,$(BR2_ROOTFS_POST_IMAGE_SCRIPT)), \
 816                 $(call MESSAGE,"Executing post-image script $(s)"); \
 817                 $(EXTRA_ENV) $(s) $(BINARIES_DIR) $(call qstrip,$(BR2_ROOTFS_POST_SCRIPT_ARGS))$(sep))
 818
 819 .PHONY: source
 820 source: $(foreach p,$(PACKAGES),$(p)-all-source)
 821
 822 .PHONY: _external-deps external-deps
 823 _external-deps: $(foreach p,$(PACKAGES),$(p)-all-external-deps)
 824 external-deps:
 825         @$(MAKE1) -Bs $(EXTRAMAKEARGS) _external-deps | sort -u
 826
 827 .PHONY: legal-info-clean
 828 legal-info-clean:
 829         @rm -fr $(LEGAL_INFO_DIR)
 830
 831 .PHONY: legal-info-prepare
 832 legal-info-prepare: $(LEGAL_INFO_DIR)
 833         @$(call MESSAGE,"Buildroot $(BR2_VERSION_FULL) Collecting legal info")
 834         @$(call legal-license-file,buildroot,buildroot,support/legal-info/buildroot.hash,COPYING,COPYING,HOST)
 835         @$(call legal-manifest,TARGET,PACKAGE,VERSION,LICENSE,LICENSE FILES,SOURCE ARCHIVE,SOURCE SITE,DEPENDENCIES WITH LICENSES)
 836         @$(call legal-manifest,HOST,PACKAGE,VERSION,LICENSE,LICENSE FILES,SOURCE ARCHIVE,SOURCE SITE,DEPENDENCIES WITH LICENSES)
 837         @$(call legal-manifest,HOST,buildroot,$(BR2_VERSION_FULL),GPL-2.0+,COPYING,not saved,not saved)
 838         @$(call legal-warning,the Buildroot source code has not been saved)
 839         @cp $(BR2_CONFIG) $(LEGAL_INFO_DIR)/buildroot.config
 840
 841 .PHONY: legal-info
 842 legal-info: legal-info-clean legal-info-prepare $(foreach p,$(PACKAGES),$(p)-all-legal-info) \
 843                 $(REDIST_SOURCES_DIR_TARGET) $(REDIST_SOURCES_DIR_HOST)
 844         @cat support/legal-info/README.header >>$(LEGAL_REPORT)
 845         @if [ -r $(LEGAL_WARNINGS) ]; then \
 846                 cat support/legal-info/README.warnings-header \
 847                         $(LEGAL_WARNINGS) >>$(LEGAL_REPORT); \
 848                 cat $(LEGAL_WARNINGS); fi
 849         @rm -f $(LEGAL_WARNINGS)
 850         @(cd $(LEGAL_INFO_DIR); \
 851                 find * -type f -exec sha256sum {} + | LC_ALL=C sort -k2 \
 852                         >.legal-info.sha256; \
 853                 mv .legal-info.sha256 legal-info.sha256)
 854         @echo "Legal info produced in $(LEGAL_INFO_DIR)"
 855
 856 .PHONY: show-targets
 857 show-targets:
 858         @echo $(sort $(PACKAGES)) $(sort $(TARGETS_ROOTFS))
 859
 860 .PHONY: show-build-order
 861 show-build-order: $(patsubst %,%-show-build-order,$(PACKAGES))
 862
 863 .PHONY: graph-build
 864 graph-build: $(O)/build/build-time.log
 865         @install -d $(GRAPHS_DIR)
 866         $(foreach o,name build duration,./support/scripts/graph-build-time \
 867                                         --type=histogram --order=$(o) --input=$(<) \
 868                                         --output=$(GRAPHS_DIR)/build.hist-$(o).$(BR_GRAPH_OUT) \
 869                                         $(if $(BR2_GRAPH_ALT),--alternate-colors)$(sep))
 870         $(foreach t,packages steps,./support/scripts/graph-build-time \
 871                                    --type=pie-$(t) --input=$(<) \
 872                                    --output=$(GRAPHS_DIR)/build.pie-$(t).$(BR_GRAPH_OUT) \
 873                                    $(if $(BR2_GRAPH_ALT),--alternate-colors)$(sep))
 874         ./support/scripts/graph-build-time --type=timeline --input=$(<) \
 875                 --output=$(GRAPHS_DIR)/build.timeline.$(BR_GRAPH_OUT) \
 876                 $(if $(BR2_GRAPH_ALT),--alternate-colors)
 877
 878 .PHONY: graph-depends-requirements
 879 graph-depends-requirements:
 880         @dot -? >/dev/null 2>&1 || \
 881                 { echo "ERROR: The 'dot' program from Graphviz is needed for graph-depends" >&2; exit 1; }
 882
 883 .PHONY: graph-depends
 884 graph-depends: graph-depends-requirements
 885         @$(INSTALL) -d $(GRAPHS_DIR)
 886         @cd "$(CONFIG_DIR)"; \
 887         $(TOPDIR)/support/scripts/graph-depends $(BR2_GRAPH_DEPS_OPTS) \
 888                 --direct -o $(GRAPHS_DIR)/$(@).dot
 889         dot $(BR2_GRAPH_DOT_OPTS) -T$(BR_GRAPH_OUT) \
 890                 -o $(GRAPHS_DIR)/$(@).$(BR_GRAPH_OUT) \
 891                 $(GRAPHS_DIR)/$(@).dot
 892
 893 .PHONY: graph-size
 894 graph-size:
 895         $(Q)mkdir -p $(GRAPHS_DIR)
 896         $(Q)$(TOPDIR)/support/scripts/size-stats --builddir $(BASE_DIR) \
 897                 --graph $(GRAPHS_DIR)/graph-size.$(BR_GRAPH_OUT) \
 898                 --file-size-csv $(GRAPHS_DIR)/file-size-stats.csv \
 899                 --package-size-csv $(GRAPHS_DIR)/package-size-stats.csv \
 900                 $(BR2_GRAPH_SIZE_OPTS)
 901
 902 .PHONY: check-dependencies
 903 check-dependencies:
 904         @cd "$(CONFIG_DIR)"; \
 905         $(TOPDIR)/support/scripts/graph-depends -C
 906
 907 .PHONY: show-info
 908 show-info:
 909         @:
 910         $(info $(call clean-json, \
 911                         { $(foreach p, \
 912                                 $(sort $(foreach i,$(PACKAGES) $(TARGETS_ROOTFS), \
 913                                                 $(i) \
 914                                                 $($(call UPPERCASE,$(i))_FINAL_RECURSIVE_DEPENDENCIES) \
 915                                         ) \
 916                                 ), \
 917                                 $(call json-info,$(call UPPERCASE,$(p)))$(comma) \
 918                         ) } \
 919                 ) \
 920         )
 921
 922 .PHONY: pkg-stats
 923 pkg-stats:
 924         @cd "$(CONFIG_DIR)" ; \
 925         $(TOPDIR)/support/scripts/pkg-stats -c \
 926                 --json $(O)/pkg-stats.json \
 927                 --html $(O)/pkg-stats.html \
 928                 --nvd-path $(DL_DIR)/buildroot-nvd
 929
 930 .PHONY: missing-cpe
 931 missing-cpe:
 932         $(Q)mkdir -p $(CPE_UPDATES_DIR)
 933         $(Q)cd "$(CONFIG_DIR)" ; \
 934         $(TOPDIR)/support/scripts/gen-missing-cpe \
 935                 --nvd-path $(DL_DIR)/buildroot-nvd \
 936                 --output $(CPE_UPDATES_DIR)
 937
 938 else # ifeq ($(BR2_HAVE_DOT_CONFIG),y)
 939
 940 # Some subdirectories are also package names. To avoid that "make linux"
 941 # on an unconfigured tree produces "Nothing to be done", add an explicit
 942 # rule for it.
 943 # Also for 'all' we error out and ask the user to configure first.
 944 .PHONY: linux toolchain
 945 linux toolchain all: outputmakefile
 946         $(error Please configure Buildroot first (e.g. "make menuconfig"))
 947         @exit 1
 948
 949 endif # ifeq ($(BR2_HAVE_DOT_CONFIG),y)
 950
 951 # configuration
 952 # ---------------------------------------------------------------------------
 953
 954 HOSTCFLAGS = $(CFLAGS_FOR_BUILD)
 955 export HOSTCFLAGS
 956
 957 $(BUILD_DIR)/buildroot-config/%onf:
 958         mkdir -p $(@D)/lxdialog
 959         PKG_CONFIG_PATH="$(HOST_PKG_CONFIG_PATH)" $(MAKE) CC="$(HOSTCC_NOCCACHE)" HOSTCC="$(HOSTCC_NOCCACHE)" \
 960             obj=$(@D) -C $(CONFIG) -f Makefile.br $(@F)
 961
 962 DEFCONFIG = $(call qstrip,$(BR2_DEFCONFIG))
 963
 964 # We don't want to fully expand BR2_DEFCONFIG here, so Kconfig will
 965 # recognize that if it's still at its default $(CONFIG_DIR)/defconfig
 966 COMMON_CONFIG_ENV = \
 967         BR2_DEFCONFIG='$(call qstrip,$(value BR2_DEFCONFIG))' \
 968         KCONFIG_AUTOCONFIG=$(BUILD_DIR)/buildroot-config/auto.conf \
 969         KCONFIG_AUTOHEADER=$(BUILD_DIR)/buildroot-config/autoconf.h \
 970         KCONFIG_TRISTATE=$(BUILD_DIR)/buildroot-config/tristate.config \
 971         BR2_CONFIG=$(BR2_CONFIG) \
 972         HOST_GCC_VERSION="$(HOSTCC_VERSION)" \
 973         BASE_DIR=$(BASE_DIR) \
 974         SKIP_LEGACY=
 975
 976 xconfig: $(BUILD_DIR)/buildroot-config/qconf outputmakefile
 977         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
 978
 979 gconfig: $(BUILD_DIR)/buildroot-config/gconf outputmakefile
 980         @$(COMMON_CONFIG_ENV) srctree=$(TOPDIR) $< $(CONFIG_CONFIG_IN)
 981
 982 menuconfig: $(BUILD_DIR)/buildroot-config/mconf outputmakefile
 983         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
 984
 985 nconfig: $(BUILD_DIR)/buildroot-config/nconf outputmakefile
 986         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
 987
 988 config: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 989         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
 990
 991 # For the config targets that automatically select options, we pass
 992 # SKIP_LEGACY=y to disable the legacy options. However, in that case
 993 # no values are set for the legacy options so a subsequent oldconfig
 994 # will query them. Therefore, run an additional olddefconfig.
 995
 996 randconfig allyesconfig alldefconfig allnoconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 997         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y $< --$@ $(CONFIG_CONFIG_IN)
 998         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
 999
1000 randpackageconfig allyespackageconfig allnopackageconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
1001         @grep -v BR2_PACKAGE_ $(BR2_CONFIG) > $(CONFIG_DIR)/.config.nopkg
1002         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y \
1003                 KCONFIG_ALLCONFIG=$(CONFIG_DIR)/.config.nopkg \
1004                 $< --$(subst package,,$@) $(CONFIG_CONFIG_IN)
1005         @rm -f $(CONFIG_DIR)/.config.nopkg
1006         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
1007
1008 oldconfig syncconfig olddefconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
1009         @$(COMMON_CONFIG_ENV) $< --$@ $(CONFIG_CONFIG_IN)
1010
1011 defconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
1012         @$(COMMON_CONFIG_ENV) $< --defconfig$(if $(DEFCONFIG),=$(DEFCONFIG)) $(CONFIG_CONFIG_IN)
1013
1014 %_defconfig: $(BUILD_DIR)/buildroot-config/conf  outputmakefile
1015         @defconfig=$(or \
1016                 $(firstword \
1017                         $(foreach d, \
1018                                 $(call reverse,$(TOPDIR) $(BR2_EXTERNAL_DIRS)), \
1019                                 $(wildcard $(d)/configs/$@) \
1020                         ) \
1021                 ), \
1022                 $(error "Can't find $@") \
1023         ); \
1024         $(COMMON_CONFIG_ENV) BR2_DEFCONFIG=$${defconfig} \
1025                 $< --defconfig=$${defconfig} $(CONFIG_CONFIG_IN)
1026
1027 update-defconfig: savedefconfig
1028
1029 savedefconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
1030         @$(COMMON_CONFIG_ENV) $< \
1031                 --savedefconfig=$(if $(DEFCONFIG),$(DEFCONFIG),$(CONFIG_DIR)/defconfig) \
1032                 $(CONFIG_CONFIG_IN)
1033         @$(SED) '/^BR2_DEFCONFIG=/d' $(if $(DEFCONFIG),$(DEFCONFIG),$(CONFIG_DIR)/defconfig)
1034
1035 .PHONY: defconfig savedefconfig update-defconfig
1036
1037 ################################################################################
1038 #
1039 # Cleanup and misc junk
1040 #
1041 ################################################################################
1042
1043 # staging and target directories do NOT list these as
1044 # dependencies anywhere else
1045 $(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):
1046         @mkdir -p $@
1047
1048 # outputmakefile generates a Makefile in the output directory, if using a
1049 # separate output directory. This allows convenient use of make in the
1050 # output directory.
1051 .PHONY: outputmakefile
1052 outputmakefile:
1053 ifeq ($(NEED_WRAPPER),y)
1054         $(Q)$(TOPDIR)/support/scripts/mkmakefile $(TOPDIR) $(O)
1055 endif
1056
1057 # printvars prints all the variables currently defined in our
1058 # Makefiles. Alternatively, if a non-empty VARS variable is passed,
1059 # only the variables matching the make pattern passed in VARS are
1060 # displayed.
1061 # show-vars does the same, but as a JSON dictionnary.
1062 #
1063 # Note: we iterate of .VARIABLES and filter each variable individually,
1064 # to workaround a bug in make 4.3; see https://savannah.gnu.org/bugs/?59093
1065 .PHONY: printvars
1066 printvars:
1067 ifndef VARS
1068         $(error Please pass a non-empty VARS to 'make printvars')
1069 endif
1070         @:
1071         $(foreach V, \
1072                 $(sort $(foreach X, $(.VARIABLES), $(filter $(VARS),$(X)))), \
1073                 $(if $(filter-out environment% default automatic, \
1074                                 $(origin $V)), \
1075                 $(if $(QUOTED_VARS),\
1076                         $(info $V='$(subst ','\'',$(if $(RAW_VARS),$(value $V),$($V)))'), \
1077                         $(info $V=$(if $(RAW_VARS),$(value $V),$($V))))))
1078 # ')))) # Syntax colouring...
1079
1080 # See details above, same as for printvars
1081 .PHONY: show-vars
1082 show-vars: VARS?=%
1083 show-vars:
1084         @:
1085         $(foreach i, \
1086                 $(call clean-json, { \
1087                         $(foreach V, \
1088                                 $(.VARIABLES), \
1089                                 $(and $(filter $(VARS),$(V)) \
1090                                         , \
1091                                         $(filter-out environment% default automatic, $(origin $V)) \
1092                                         , \
1093                                         "$V": { \
1094                                                 "expanded": $(call mk-json-str,$($V))$(comma) \
1095                                                 "raw": $(call mk-json-str,$(value $V)) \
1096                                         }$(comma) \
1097                                 ) \
1098                         ) \
1099                 } ) \
1100                 , \
1101                 $(info $(i)) \
1102         )
1103
1104 .PHONY: clean
1105 clean:
1106         rm -rf $(BASE_TARGET_DIR) $(BINARIES_DIR) $(HOST_DIR) $(HOST_DIR_SYMLINK) \
1107                 $(BUILD_DIR) $(BASE_DIR)/staging \
1108                 $(LEGAL_INFO_DIR) $(GRAPHS_DIR) $(PER_PACKAGE_DIR) $(CPE_UPDATES_DIR) \
1109                 $(O)/pkg-stats.*
1110
1111 .PHONY: distclean
1112 distclean: clean
1113 ifeq ($(O),$(CURDIR)/output)
1114         rm -rf $(O)
1115 endif
1116         rm -rf $(TOPDIR)/dl $(BR2_CONFIG) $(CONFIG_DIR)/.config.old $(CONFIG_DIR)/..config.tmp \
1117                 $(CONFIG_DIR)/.auto.deps $(BASE_DIR)/.br2-external.*
1118
1119 .PHONY: help
1120 help:
1121         @echo 'Cleaning:'
1122         @echo '  clean                  - delete all files created by build'
1123         @echo '  distclean              - delete all non-source files (including .config)'
1124         @echo
1125         @echo 'Build:'
1126         @echo '  all                    - make world'
1127         @echo '  toolchain              - build toolchain'
1128         @echo '  sdk                    - build relocatable SDK'
1129         @echo
1130         @echo 'Configuration:'
1131         @echo '  menuconfig             - interactive curses-based configurator'
1132         @echo '  nconfig                - interactive ncurses-based configurator'
1133         @echo '  xconfig                - interactive Qt-based configurator'
1134         @echo '  gconfig                - interactive GTK-based configurator'
1135         @echo '  oldconfig              - resolve any unresolved symbols in .config'
1136         @echo '  syncconfig             - Same as oldconfig, but quietly, additionally update deps'
1137         @echo '  olddefconfig           - Same as syncconfig but sets new symbols to their default value'
1138         @echo '  randconfig             - New config with random answer to all options'
1139         @echo '  defconfig              - New config with default answer to all options;'
1140         @echo '                             BR2_DEFCONFIG, if set on the command line, is used as input'
1141         @echo '  savedefconfig          - Save current config to BR2_DEFCONFIG (minimal config)'
1142         @echo '  update-defconfig       - Same as savedefconfig'
1143         @echo '  allyesconfig           - New config where all options are accepted with yes'
1144         @echo '  allnoconfig            - New config where all options are answered with no'
1145         @echo '  alldefconfig           - New config where all options are set to default'
1146         @echo '  randpackageconfig      - New config with random answer to package options'
1147         @echo '  allyespackageconfig    - New config where pkg options are accepted with yes'
1148         @echo '  allnopackageconfig     - New config where package options are answered with no'
1149         @echo
1150         @echo 'Package-specific:'
1151         @echo '  <pkg>                  - Build and install <pkg> and all its dependencies'
1152         @echo '  <pkg>-source           - Only download the source files for <pkg>'
1153         @echo '  <pkg>-extract          - Extract <pkg> sources'
1154         @echo '  <pkg>-patch            - Apply patches to <pkg>'
1155         @echo '  <pkg>-depends          - Build <pkg>'\''s dependencies'
1156         @echo '  <pkg>-configure        - Build <pkg> up to the configure step'
1157         @echo '  <pkg>-build            - Build <pkg> up to the build step'
1158         @echo '  <pkg>-show-info        - generate info about <pkg>, as a JSON blurb'
1159         @echo '  <pkg>-show-depends     - List packages on which <pkg> depends'
1160         @echo '  <pkg>-show-rdepends    - List packages which have <pkg> as a dependency'
1161         @echo '  <pkg>-show-recursive-depends'
1162         @echo '                         - Recursively list packages on which <pkg> depends'
1163         @echo '  <pkg>-show-recursive-rdepends'
1164         @echo '                         - Recursively list packages which have <pkg> as a dependency'
1165         @echo '  <pkg>-graph-depends    - Generate a graph of <pkg>'\''s dependencies'
1166         @echo '  <pkg>-graph-rdepends   - Generate a graph of <pkg>'\''s reverse dependencies'
1167         @echo '  <pkg>-dirclean         - Remove <pkg> build directory'
1168         @echo '  <pkg>-reconfigure      - Restart the build from the configure step'
1169         @echo '  <pkg>-rebuild          - Restart the build from the build step'
1170         @echo '  <pkg>-reinstall        - Restart the build from the install step'
1171         $(foreach p,$(HELP_PACKAGES), \
1172                 @echo $(sep) \
1173                 @echo '$($(p)_NAME):' $(sep) \
1174                 $($(p)_HELP_CMDS)$(sep))
1175         @echo
1176         @echo 'Documentation:'
1177         @echo '  manual                 - build manual in all formats'
1178         @echo '  manual-html            - build manual in HTML'
1179         @echo '  manual-split-html      - build manual in split HTML'
1180         @echo '  manual-pdf             - build manual in PDF'
1181         @echo '  manual-text            - build manual in text'
1182         @echo '  manual-epub            - build manual in ePub'
1183         @echo '  graph-build            - generate graphs of the build times'
1184         @echo '  graph-depends          - generate graph of the dependency tree'
1185         @echo '  graph-size             - generate stats of the filesystem size'
1186         @echo '  list-defconfigs        - list all defconfigs (pre-configured minimal systems)'
1187         @echo
1188         @echo 'Miscellaneous:'
1189         @echo '  source                 - download all sources needed for offline-build'
1190         @echo '  external-deps          - list external packages used'
1191         @echo '  legal-info             - generate info about license compliance'
1192         @echo '  show-info              - generate info about packages, as a JSON blurb'
1193         @echo '  pkg-stats              - generate info about packages as JSON and HTML'
1194         @echo '  missing-cpe            - generate XML snippets for missing CPE identifiers'
1195         @echo '  printvars              - dump internal variables selected with VARS=...'
1196         @echo '  show-vars              - dump all internal variables as a JSON blurb; use VARS=...'
1197         @echo '                           to limit the list to variables names matching that pattern'
1198         @echo
1199         @echo '  make V=0|1             - 0 => quiet build (default), 1 => verbose build'
1200         @echo '  make O=dir             - Locate all output files in "dir", including .config'
1201         @echo
1202         @echo 'For further details, see README, generate the Buildroot manual, or consult'
1203         @echo 'it on-line at http://buildroot.org/docs.html'
1204         @echo
1205
1206 # List the defconfig files
1207 # $(1): base directory
1208 # $(2): br2-external name, empty for bundled
1209 define list-defconfigs
1210         @first=true; \
1211         for defconfig in $(1)/configs/*_defconfig; do \
1212                 [ -f "$${defconfig}" ] || continue; \
1213                 if $${first}; then \
1214                         if [ "$(2)" ]; then \
1215                                 printf 'External configs in "$(call qstrip,$(2))":\n'; \
1216                         else \
1217                                 printf "Built-in configs:\n"; \
1218                         fi; \
1219                         first=false; \
1220                 fi; \
1221                 defconfig="$${defconfig##*/}"; \
1222                 printf "  %-35s - Build for %s\n" "$${defconfig}" "$${defconfig%_defconfig}"; \
1223         done; \
1224         $${first} || printf "\n"
1225 endef
1226
1227 # We iterate over BR2_EXTERNAL_NAMES rather than BR2_EXTERNAL_DIRS,
1228 # because we want to display the name of the br2-external tree.
1229 .PHONY: list-defconfigs
1230 list-defconfigs:
1231         $(call list-defconfigs,$(TOPDIR))
1232         $(foreach name,$(BR2_EXTERNAL_NAMES),\
1233                 $(call list-defconfigs,$(BR2_EXTERNAL_$(name)_PATH),\
1234                         $(BR2_EXTERNAL_$(name)_DESC))$(sep))
1235
1236 release: OUT = buildroot-$(BR2_VERSION)
1237
1238 # Create release tarballs. We need to fiddle a bit to add the generated
1239 # documentation to the git output
1240 release:
1241         git archive --format=tar --prefix=$(OUT)/ HEAD > $(OUT).tar
1242         $(MAKE) O=$(OUT) manual-html manual-text manual-pdf
1243         $(MAKE) O=$(OUT) distclean
1244         tar rf $(OUT).tar $(OUT)
1245         gzip -9 -c < $(OUT).tar > $(OUT).tar.gz
1246         xz -9 -c < $(OUT).tar > $(OUT).tar.xz
1247         rm -rf $(OUT) $(OUT).tar
1248
1249 print-version:
1250         @echo $(BR2_VERSION_FULL)
1251
1252 check-package:
1253         $(Q)./utils/check-package `git ls-tree -r --name-only HEAD` \
1254                 --ignore-list=$(TOPDIR)/.checkpackageignore
1255
1256 .PHONY: .checkpackageignore
1257 .checkpackageignore:
1258         $(Q)./utils/check-package --failed-only `git ls-tree -r --name-only HEAD` \
1259                 > .checkpackageignore
1260
1261 include docs/manual/manual.mk
1262 -include $(foreach dir,$(BR2_EXTERNAL_DIRS),$(sort $(wildcard $(dir)/docs/*/*.mk)))
1263
1264 .PHONY: $(noconfig_targets)
1265
1266 endif #umask / $(CURDIR) / $(O)