Makefile

   1 # Makefile for buildroot
   2 #
   3 # Copyright (C) 1999-2005 by Erik Andersen <andersen@codepoet.org>
   4 # Copyright (C) 2006-2014 by the Buildroot developers <buildroot@uclibc.org>
   5 # Copyright (C) 2014 by the Buildroot developers <buildroot@buildroot.org>
   6 #
   7 # This program is free software; you can redistribute it and/or modify
   8 # it under the terms of the GNU General Public License as published by
   9 # the Free Software Foundation; either version 2 of the License, or
  10 # (at your option) any later version.
  11 #
  12 # This program is distributed in the hope that it will be useful,
  13 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  15 # General Public License for more details.
  16 #
  17 # You should have received a copy of the GNU General Public License
  18 # along with this program; if not, write to the Free Software
  19 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  20 #
  21
  22 #--------------------------------------------------------------
  23 # Just run 'make menuconfig', configure stuff, then run 'make'.
  24 # You shouldn't need to mess with anything beyond this point...
  25 #--------------------------------------------------------------
  26
  27 # This is our default rule, so must come first
  28 all:
  29
  30 # Set and export the version string
  31 export BR2_VERSION := 2015.08-git
  32
  33 # Check for minimal make version (note: this check will break at make 10.x)
  34 MIN_MAKE_VERSION = 3.81
  35 ifneq ($(firstword $(sort $(MAKE_VERSION) $(MIN_MAKE_VERSION))),$(MIN_MAKE_VERSION))
  36 $(error You have make '$(MAKE_VERSION)' installed. GNU make >= $(MIN_MAKE_VERSION) is required)
  37 endif
  38
  39 export HOSTARCH := $(shell uname -m | \
  40         sed -e s/i.86/x86/ \
  41             -e s/sun4u/sparc64/ \
  42             -e s/arm.*/arm/ \
  43             -e s/sa110/arm/ \
  44             -e s/ppc64/powerpc64/ \
  45             -e s/ppc/powerpc/ \
  46             -e s/macppc/powerpc/\
  47             -e s/sh.*/sh/)
  48
  49 # Parallel execution of this Makefile is disabled because it changes
  50 # the packages building order, that can be a problem for two reasons:
  51 # - If a package has an unspecified optional dependency and that
  52 #   dependency is present when the package is built, it is used,
  53 #   otherwise it isn't (but compilation happily proceeds) so the end
  54 #   result will differ if the order is swapped due to parallel
  55 #   building.
  56 # - Also changing the building order can be a problem if two packages
  57 #   manipulate the same file in the target directory.
  58 #
  59 # Taking into account the above considerations, if you still want to execute
  60 # this top-level Makefile in parallel comment the ".NOTPARALLEL" line and
  61 # use the -j<jobs> option when building, e.g:
  62 #      make -j$((`getconf _NPROCESSORS_ONLN`+1))
  63 .NOTPARALLEL:
  64
  65 # absolute path
  66 TOPDIR := $(shell pwd)
  67 CONFIG_CONFIG_IN = Config.in
  68 CONFIG = support/kconfig
  69 DATE := $(shell date +%Y%m%d)
  70
  71 # Compute the full local version string so packages can use it as-is
  72 # Need to export it, so it can be got from environment in children (eg. mconf)
  73 export BR2_VERSION_FULL := $(BR2_VERSION)$(shell $(TOPDIR)/support/scripts/setlocalversion)
  74
  75 noconfig_targets := menuconfig nconfig gconfig xconfig config oldconfig randconfig \
  76         defconfig %_defconfig allyesconfig allnoconfig silentoldconfig release \
  77         randpackageconfig allyespackageconfig allnopackageconfig \
  78         print-version olddefconfig
  79
  80 # Some global targets do not trigger a build, but are used to collect
  81 # metadata, or do various checks. When such targets are triggered,
  82 # some packages should not do their configuration sanity
  83 # checks. Provide them a BR_BUILDING variable set to 'y' when we're
  84 # actually building and they should do their sanity checks.
  85 #
  86 # We're building in two situations: when MAKECMDGOALS is empty
  87 # (default target is to build), or when MAKECMDGOALS contains
  88 # something else than one of the nobuild_targets.
  89 nobuild_targets := source source-check \
  90         legal-info external-deps _external-deps \
  91         clean distclean
  92 ifeq ($(MAKECMDGOALS),)
  93 BR_BUILDING = y
  94 else ifneq ($(filter-out $(nobuild_targets),$(MAKECMDGOALS)),)
  95 BR_BUILDING = y
  96 endif
  97
  98 # Strip quotes and then whitespaces
  99 qstrip = $(strip $(subst ",,$(1)))
 100 #"))
 101
 102 # Variables for use in Make constructs
 103 comma := ,
 104 empty :=
 105 space := $(empty) $(empty)
 106
 107 ifneq ("$(origin O)", "command line")
 108 O := output
 109 CONFIG_DIR := $(TOPDIR)
 110 NEED_WRAPPER =
 111 else
 112 # other packages might also support Linux-style out of tree builds
 113 # with the O=<dir> syntax (E.G. BusyBox does). As make automatically
 114 # forwards command line variable definitions those packages get very
 115 # confused. Fix this by telling make to not do so
 116 MAKEOVERRIDES =
 117 # strangely enough O is still passed to submakes with MAKEOVERRIDES
 118 # (with make 3.81 atleast), the only thing that changes is the output
 119 # of the origin function (command line -> environment).
 120 # Unfortunately some packages don't look at origin (E.G. uClibc 0.9.31+)
 121 # To really make O go away, we have to override it.
 122 override O := $(O)
 123 CONFIG_DIR := $(O)
 124 # we need to pass O= everywhere we call back into the toplevel makefile
 125 EXTRAMAKEARGS = O=$(O)
 126 NEED_WRAPPER = y
 127 endif
 128
 129 # bash prints the name of the directory on 'cd <dir>' if CDPATH is
 130 # set, so unset it here to not cause problems. Notice that the export
 131 # line doesn't affect the environment of $(shell ..) calls, so
 132 # explictly throw away any output from 'cd' here.
 133 export CDPATH :=
 134 BASE_DIR := $(shell mkdir -p $(O) && cd $(O) >/dev/null && pwd)
 135 $(if $(BASE_DIR),, $(error output directory "$(O)" does not exist))
 136
 137
 138 # Handling of BR2_EXTERNAL.
 139 #
 140 # The value of BR2_EXTERNAL is stored in .br-external in the output directory.
 141 # On subsequent invocations of make, it is read in. It can still be overridden
 142 # on the command line, therefore the file is re-created every time make is run.
 143 #
 144 # When BR2_EXTERNAL is set to an empty value (e.g. explicitly in command
 145 # line), the .br-external file is removed and we point to
 146 # support/dummy-external. This makes sure we can unconditionally include the
 147 # Config.in and external.mk from the BR2_EXTERNAL directory. In this case,
 148 # override is necessary so the user can clear BR2_EXTERNAL from the command
 149 # line, but the dummy path is still used internally.
 150
 151 BR2_EXTERNAL_FILE = $(BASE_DIR)/.br-external
 152 -include $(BR2_EXTERNAL_FILE)
 153 ifeq ($(BR2_EXTERNAL),)
 154   override BR2_EXTERNAL = support/dummy-external
 155   $(shell rm -f $(BR2_EXTERNAL_FILE))
 156 else
 157   _BR2_EXTERNAL = $(shell cd $(BR2_EXTERNAL) >/dev/null 2>&1 && pwd)
 158   ifeq ($(_BR2_EXTERNAL),)
 159     $(error BR2_EXTERNAL='$(BR2_EXTERNAL)' does not exist, relative to $(TOPDIR))
 160   endif
 161   override BR2_EXTERNAL := $(_BR2_EXTERNAL)
 162   $(shell echo BR2_EXTERNAL ?= $(BR2_EXTERNAL) > $(BR2_EXTERNAL_FILE))
 163 endif
 164
 165 # To make sure that the environment variable overrides the .config option,
 166 # set this before including .config.
 167 ifneq ($(BR2_DL_DIR),)
 168 DL_DIR := $(BR2_DL_DIR)
 169 endif
 170
 171
 172 # Need that early, before we scan packages
 173 # Avoids doing the $(or...) everytime
 174 BR_GRAPH_OUT := $(or $(BR2_GRAPH_OUT),pdf)
 175
 176 BUILD_DIR := $(BASE_DIR)/build
 177 BINARIES_DIR := $(BASE_DIR)/images
 178 TARGET_DIR := $(BASE_DIR)/target
 179 # initial definition so that 'make clean' works for most users, even without
 180 # .config. HOST_DIR will be overwritten later when .config is included.
 181 HOST_DIR := $(BASE_DIR)/host
 182 GRAPHS_DIR := $(BASE_DIR)/graphs
 183
 184 LEGAL_INFO_DIR = $(BASE_DIR)/legal-info
 185 REDIST_SOURCES_DIR_TARGET = $(LEGAL_INFO_DIR)/sources
 186 REDIST_SOURCES_DIR_HOST = $(LEGAL_INFO_DIR)/host-sources
 187 LICENSE_FILES_DIR_TARGET = $(LEGAL_INFO_DIR)/licenses
 188 LICENSE_FILES_DIR_HOST = $(LEGAL_INFO_DIR)/host-licenses
 189 LEGAL_MANIFEST_CSV_TARGET = $(LEGAL_INFO_DIR)/manifest.csv
 190 LEGAL_MANIFEST_CSV_HOST = $(LEGAL_INFO_DIR)/host-manifest.csv
 191 LEGAL_LICENSES_TXT_TARGET = $(LEGAL_INFO_DIR)/licenses.txt
 192 LEGAL_LICENSES_TXT_HOST = $(LEGAL_INFO_DIR)/host-licenses.txt
 193 LEGAL_WARNINGS = $(LEGAL_INFO_DIR)/.warnings
 194 LEGAL_REPORT = $(LEGAL_INFO_DIR)/README
 195
 196 BR2_CONFIG = $(CONFIG_DIR)/.config
 197
 198 # Pull in the user's configuration file
 199 ifeq ($(filter $(noconfig_targets),$(MAKECMDGOALS)),)
 200 -include $(BR2_CONFIG)
 201 endif
 202
 203 # To put more focus on warnings, be less verbose as default
 204 # Use 'make V=1' to see the full commands
 205 ifeq ("$(origin V)", "command line")
 206   KBUILD_VERBOSE = $(V)
 207 endif
 208 ifndef KBUILD_VERBOSE
 209   KBUILD_VERBOSE = 0
 210 endif
 211
 212 ifeq ($(KBUILD_VERBOSE),1)
 213   quiet =
 214   Q =
 215 ifndef VERBOSE
 216   VERBOSE = 1
 217 endif
 218 export VERBOSE
 219 else
 220   quiet = quiet_
 221   Q = @
 222 endif
 223
 224 # we want bash as shell
 225 SHELL := $(shell if [ -x "$$BASH" ]; then echo $$BASH; \
 226          else if [ -x /bin/bash ]; then echo /bin/bash; \
 227          else echo sh; fi; fi)
 228
 229 # kconfig uses CONFIG_SHELL
 230 CONFIG_SHELL := $(SHELL)
 231
 232 export SHELL CONFIG_SHELL quiet Q KBUILD_VERBOSE
 233
 234 ifndef HOSTAR
 235 HOSTAR := ar
 236 endif
 237 ifndef HOSTAS
 238 HOSTAS := as
 239 endif
 240 ifndef HOSTCC
 241 HOSTCC := gcc
 242 HOSTCC := $(shell which $(HOSTCC) || type -p $(HOSTCC) || echo gcc)
 243 endif
 244 HOSTCC_NOCCACHE := $(HOSTCC)
 245 ifndef HOSTCXX
 246 HOSTCXX := g++
 247 HOSTCXX := $(shell which $(HOSTCXX) || type -p $(HOSTCXX) || echo g++)
 248 endif
 249 HOSTCXX_NOCCACHE := $(HOSTCXX)
 250 ifndef HOSTCPP
 251 HOSTCPP := cpp
 252 endif
 253 ifndef HOSTLD
 254 HOSTLD := ld
 255 endif
 256 ifndef HOSTLN
 257 HOSTLN := ln
 258 endif
 259 ifndef HOSTNM
 260 HOSTNM := nm
 261 endif
 262 ifndef HOSTOBJCOPY
 263 HOSTOBJCOPY := objcopy
 264 endif
 265 ifndef HOSTRANLIB
 266 HOSTRANLIB := ranlib
 267 endif
 268 HOSTAR := $(shell which $(HOSTAR) || type -p $(HOSTAR) || echo ar)
 269 HOSTAS := $(shell which $(HOSTAS) || type -p $(HOSTAS) || echo as)
 270 HOSTCPP := $(shell which $(HOSTCPP) || type -p $(HOSTCPP) || echo cpp)
 271 HOSTLD := $(shell which $(HOSTLD) || type -p $(HOSTLD) || echo ld)
 272 HOSTLN := $(shell which $(HOSTLN) || type -p $(HOSTLN) || echo ln)
 273 HOSTNM := $(shell which $(HOSTNM) || type -p $(HOSTNM) || echo nm)
 274 HOSTOBJCOPY := $(shell which $(HOSTOBJCOPY) || type -p $(HOSTOBJCOPY) || echo objcopy)
 275 HOSTRANLIB := $(shell which $(HOSTRANLIB) || type -p $(HOSTRANLIB) || echo ranlib)
 276
 277 export HOSTAR HOSTAS HOSTCC HOSTCXX HOSTLD
 278 export HOSTCC_NOCCACHE HOSTCXX_NOCCACHE
 279
 280 # Make sure pkg-config doesn't look outside the buildroot tree
 281 HOST_PKG_CONFIG_PATH := $(PKG_CONFIG_PATH)
 282 unexport PKG_CONFIG_PATH
 283 unexport PKG_CONFIG_SYSROOT_DIR
 284 unexport PKG_CONFIG_LIBDIR
 285
 286 # Having DESTDIR set in the environment confuses the installation
 287 # steps of some packages.
 288 unexport DESTDIR
 289
 290 # Causes breakage with packages that needs host-ruby
 291 unexport RUBYOPT
 292
 293 include package/pkg-utils.mk
 294 include package/doc-asciidoc.mk
 295
 296 ifeq ($(BR2_HAVE_DOT_CONFIG),y)
 297
 298 ################################################################################
 299 #
 300 # Hide troublesome environment variables from sub processes
 301 #
 302 ################################################################################
 303 unexport CROSS_COMPILE
 304 unexport ARCH
 305 unexport CC
 306 unexport CXX
 307 unexport CPP
 308 unexport CFLAGS
 309 unexport CXXFLAGS
 310 unexport GREP_OPTIONS
 311 unexport TAR_OPTIONS
 312 unexport CONFIG_SITE
 313 unexport QMAKESPEC
 314 unexport TERMINFO
 315 unexport MACHINE
 316
 317 GNU_HOST_NAME := $(shell support/gnuconfig/config.guess)
 318
 319 PACKAGES :=
 320
 321 # silent mode requested?
 322 QUIET := $(if $(findstring s,$(filter-out --%,$(MAKEFLAGS))),-q)
 323
 324 # Strip off the annoying quoting
 325 ARCH := $(call qstrip,$(BR2_ARCH))
 326
 327 KERNEL_ARCH := $(shell echo "$(ARCH)" | sed -e "s/-.*//" \
 328         -e s/i.86/i386/ -e s/sun4u/sparc64/ \
 329         -e s/arcle/arc/ \
 330         -e s/arceb/arc/ \
 331         -e s/arm.*/arm/ -e s/sa110/arm/ \
 332         -e s/aarch64/arm64/ \
 333         -e s/bfin/blackfin/ \
 334         -e s/parisc64/parisc/ \
 335         -e s/powerpc64.*/powerpc/ \
 336         -e s/ppc.*/powerpc/ -e s/mips.*/mips/ \
 337         -e s/sh.*/sh/ \
 338         -e s/microblazeel/microblaze/)
 339
 340 ZCAT := $(call qstrip,$(BR2_ZCAT))
 341 BZCAT := $(call qstrip,$(BR2_BZCAT))
 342 XZCAT := $(call qstrip,$(BR2_XZCAT))
 343 TAR_OPTIONS = $(call qstrip,$(BR2_TAR_OPTIONS)) -xf
 344
 345 # packages compiled for the host go here
 346 HOST_DIR := $(call qstrip,$(BR2_HOST_DIR))
 347
 348 # Quotes are needed for spaces and all in the original PATH content.
 349 BR_PATH = "$(HOST_DIR)/bin:$(HOST_DIR)/sbin:$(HOST_DIR)/usr/bin:$(HOST_DIR)/usr/sbin:$(PATH)"
 350
 351 TARGET_SKELETON = $(TOPDIR)/system/skeleton
 352
 353 # Location of a file giving a big fat warning that output/target
 354 # should not be used as the root filesystem.
 355 TARGET_DIR_WARNING_FILE = $(TARGET_DIR)/THIS_IS_NOT_YOUR_ROOT_FILESYSTEM
 356
 357 ifeq ($(BR2_CCACHE),y)
 358 CCACHE := $(HOST_DIR)/usr/bin/ccache
 359 BR_CACHE_DIR = $(call qstrip,$(BR2_CCACHE_DIR))
 360 export BR_CACHE_DIR
 361 HOSTCC := $(CCACHE) $(HOSTCC)
 362 HOSTCXX := $(CCACHE) $(HOSTCXX)
 363 endif
 364
 365 # Scripts in support/ or post-build scripts may need to reference
 366 # these locations, so export them so it is easier to use
 367 export BR2_CONFIG
 368 export TARGET_DIR
 369 export STAGING_DIR
 370 export HOST_DIR
 371 export BINARIES_DIR
 372 export BASE_DIR
 373
 374 ################################################################################
 375 #
 376 # You should probably leave this stuff alone unless you know
 377 # what you are doing.
 378 #
 379 ################################################################################
 380
 381 all: world
 382
 383 # Include legacy before the other things, because package .mk files
 384 # may rely on it.
 385 ifneq ($(BR2_DEPRECATED),y)
 386 include Makefile.legacy
 387 endif
 388
 389 include package/Makefile.in
 390 include support/dependencies/dependencies.mk
 391
 392 include toolchain/*.mk
 393 include toolchain/*/*.mk
 394
 395 # Include the package override file if one has been provided in the
 396 # configuration.
 397 PACKAGE_OVERRIDE_FILE = $(call qstrip,$(BR2_PACKAGE_OVERRIDE_FILE))
 398 ifneq ($(PACKAGE_OVERRIDE_FILE),)
 399 -include $(PACKAGE_OVERRIDE_FILE)
 400 endif
 401
 402 include $(sort $(wildcard package/*/*.mk))
 403
 404 include boot/common.mk
 405 include linux/linux.mk
 406 include system/system.mk
 407 include fs/common.mk
 408
 409 include $(BR2_EXTERNAL)/external.mk
 410
 411 dirs: $(BUILD_DIR) $(STAGING_DIR) $(TARGET_DIR) \
 412         $(HOST_DIR) $(BINARIES_DIR)
 413
 414 $(BUILD_DIR)/buildroot-config/auto.conf: $(BR2_CONFIG)
 415         $(MAKE1) $(EXTRAMAKEARGS) HOSTCC="$(HOSTCC_NOCCACHE)" HOSTCXX="$(HOSTCXX_NOCCACHE)" silentoldconfig
 416
 417 prepare: $(BUILD_DIR)/buildroot-config/auto.conf
 418
 419 world: target-post-image
 420
 421 .PHONY: all world toolchain dirs clean distclean source outputmakefile \
 422         legal-info legal-info-prepare legal-info-clean printvars help \
 423         list-defconfigs target-finalize target-post-image source-check
 424
 425 ################################################################################
 426 #
 427 # staging and target directories do NOT list these as
 428 # dependencies anywhere else
 429 #
 430 ################################################################################
 431 $(BUILD_DIR) $(HOST_DIR) $(BINARIES_DIR) $(LEGAL_INFO_DIR) $(REDIST_SOURCES_DIR_TARGET) $(REDIST_SOURCES_DIR_HOST):
 432         @mkdir -p $@
 433
 434 # We make a symlink lib32->lib or lib64->lib as appropriate
 435 # MIPS64/n32 requires lib32 even though it's a 64-bit arch.
 436 ifeq ($(BR2_ARCH_IS_64)$(BR2_MIPS_NABI32),y)
 437 LIB_SYMLINK = lib64
 438 else
 439 LIB_SYMLINK = lib32
 440 endif
 441
 442 $(STAGING_DIR):
 443         @mkdir -p $(STAGING_DIR)/bin
 444         @mkdir -p $(STAGING_DIR)/lib
 445         @ln -snf lib $(STAGING_DIR)/$(LIB_SYMLINK)
 446         @mkdir -p $(STAGING_DIR)/usr/lib
 447         @ln -snf lib $(STAGING_DIR)/usr/$(LIB_SYMLINK)
 448         @mkdir -p $(STAGING_DIR)/usr/include
 449         @mkdir -p $(STAGING_DIR)/usr/bin
 450         @ln -snf $(STAGING_DIR) $(BASE_DIR)/staging
 451
 452 ifeq ($(BR2_ROOTFS_SKELETON_CUSTOM),y)
 453 TARGET_SKELETON = $(BR2_ROOTFS_SKELETON_CUSTOM_PATH)
 454 endif
 455
 456 RSYNC_VCS_EXCLUSIONS = \
 457         --exclude .svn --exclude .git --exclude .hg --exclude .bzr \
 458         --exclude CVS
 459
 460 $(BUILD_DIR)/.root:
 461         mkdir -p $(TARGET_DIR)
 462         rsync -a --ignore-times $(RSYNC_VCS_EXCLUSIONS) \
 463                 --chmod=Du+w --exclude .empty --exclude '*~' \
 464                 $(TARGET_SKELETON)/ $(TARGET_DIR)/
 465         $(INSTALL) -m 0644 support/misc/target-dir-warning.txt $(TARGET_DIR_WARNING_FILE)
 466         @ln -snf lib $(TARGET_DIR)/$(LIB_SYMLINK)
 467         @mkdir -p $(TARGET_DIR)/usr
 468         @ln -snf lib $(TARGET_DIR)/usr/$(LIB_SYMLINK)
 469         touch $@
 470
 471 $(TARGET_DIR): $(BUILD_DIR)/.root
 472
 473 STRIP_FIND_CMD = find $(TARGET_DIR)
 474 ifneq (,$(call qstrip,$(BR2_STRIP_EXCLUDE_DIRS)))
 475 STRIP_FIND_CMD += \( $(call finddirclauses,$(TARGET_DIR),$(call qstrip,$(BR2_STRIP_EXCLUDE_DIRS))) \) -prune -o
 476 endif
 477 STRIP_FIND_CMD += -type f \( -perm /111 -o -name '*.so*' \)
 478 # file exclusions:
 479 # - libpthread.so: a non-stripped libpthread shared library is needed for
 480 #   proper debugging of pthread programs using gdb.
 481 # - kernel modules (*.ko): do not function properly when stripped like normal
 482 #   applications and libraries. Normally kernel modules are already excluded
 483 #   by the executable permission check above, so the explicit exclusion is only
 484 #   done for kernel modules with incorrect permissions.
 485 STRIP_FIND_CMD += -not \( $(call findfileclauses,libpthread*.so* *.ko $(call qstrip,$(BR2_STRIP_EXCLUDE_FILES))) \) -print0
 486
 487 ifeq ($(BR2_ECLIPSE_REGISTER),y)
 488 define TOOLCHAIN_ECLIPSE_REGISTER
 489         ./support/scripts/eclipse-register-toolchain `readlink -f $(O)` \
 490                 $(notdir $(TARGET_CROSS)) $(BR2_ARCH)
 491 endef
 492 TARGET_FINALIZE_HOOKS += TOOLCHAIN_ECLIPSE_REGISTER
 493 endif
 494
 495 # Generate locale data. Basically, we call the localedef program
 496 # (built by the host-localedef package) for each locale. The input
 497 # data comes preferably from the toolchain, or if the toolchain does
 498 # not have them (Linaro toolchains), we use the ones available on the
 499 # host machine.
 500 ifeq ($(BR2_TOOLCHAIN_USES_GLIBC),y)
 501 GLIBC_GENERATE_LOCALES = $(call qstrip,$(BR2_GENERATE_LOCALE))
 502 ifneq ($(GLIBC_GENERATE_LOCALES),)
 503 PACKAGES += host-localedef
 504
 505 define GENERATE_GLIBC_LOCALES
 506         $(Q)mkdir -p $(TARGET_DIR)/usr/lib/locale/
 507         $(Q)for locale in $(GLIBC_GENERATE_LOCALES) ; do \
 508                 inputfile=`echo $${locale} | cut -f1 -d'.'` ; \
 509                 charmap=`echo $${locale} | cut -f2 -d'.' -s` ; \
 510                 if test -z "$${charmap}" ; then \
 511                         charmap="UTF-8" ; \
 512                 fi ; \
 513                 echo "Generating locale $${inputfile}.$${charmap}" ; \
 514                 I18NPATH=$(STAGING_DIR)/usr/share/i18n:/usr/share/i18n \
 515                 $(HOST_DIR)/usr/bin/localedef \
 516                         --prefix=$(TARGET_DIR) \
 517                         --$(call LOWERCASE,$(BR2_ENDIAN))-endian \
 518                         -i $${inputfile} -f $${charmap} \
 519                         $${locale} ; \
 520         done
 521 endef
 522 TARGET_FINALIZE_HOOKS += GENERATE_GLIBC_LOCALES
 523 endif
 524 endif
 525
 526 ifeq ($(BR2_ENABLE_LOCALE_PURGE),y)
 527 LOCALE_WHITELIST = $(BUILD_DIR)/locales.nopurge
 528 LOCALE_NOPURGE = $(call qstrip,$(BR2_ENABLE_LOCALE_WHITELIST))
 529
 530 define PURGE_LOCALES
 531         rm -f $(LOCALE_WHITELIST)
 532         for i in $(LOCALE_NOPURGE) locale-archive; do echo $$i >> $(LOCALE_WHITELIST); done
 533
 534         for dir in $(wildcard $(addprefix $(TARGET_DIR),/usr/share/locale /usr/share/X11/locale /usr/man /usr/share/man /usr/lib/locale)); \
 535         do \
 536                 for lang in $$(cd $$dir; ls .|grep -v man); \
 537                 do \
 538                         grep -qx $$lang $(LOCALE_WHITELIST) || rm -rf $$dir/$$lang; \
 539                 done; \
 540         done
 541 endef
 542 TARGET_FINALIZE_HOOKS += PURGE_LOCALES
 543 endif
 544
 545 $(TARGETS_ROOTFS): target-finalize
 546
 547 target-finalize: $(PACKAGES)
 548         @$(call MESSAGE,"Finalizing target directory")
 549         $(foreach hook,$(TARGET_FINALIZE_HOOKS),$($(hook))$(sep))
 550         rm -rf $(TARGET_DIR)/usr/include $(TARGET_DIR)/usr/share/aclocal \
 551                 $(TARGET_DIR)/usr/lib/pkgconfig $(TARGET_DIR)/usr/share/pkgconfig \
 552                 $(TARGET_DIR)/usr/lib/cmake $(TARGET_DIR)/usr/share/cmake
 553         find $(TARGET_DIR)/usr/{lib,share}/ -name '*.cmake' -print0 | xargs -0 rm -f
 554         find $(TARGET_DIR)/lib \( -name '*.a' -o -name '*.la' \) -print0 | xargs -0 rm -f
 555         find $(TARGET_DIR)/usr/lib \( -name '*.a' -o -name '*.la' \) -print0 | xargs -0 rm -f
 556 ifneq ($(BR2_PACKAGE_GDB),y)
 557         rm -rf $(TARGET_DIR)/usr/share/gdb
 558 endif
 559         rm -rf $(TARGET_DIR)/usr/man $(TARGET_DIR)/usr/share/man
 560         rm -rf $(TARGET_DIR)/usr/info $(TARGET_DIR)/usr/share/info
 561         rm -rf $(TARGET_DIR)/usr/doc $(TARGET_DIR)/usr/share/doc
 562         rm -rf $(TARGET_DIR)/usr/share/gtk-doc
 563         -rmdir $(TARGET_DIR)/usr/share 2>/dev/null
 564         $(STRIP_FIND_CMD) | xargs -0 $(STRIPCMD) 2>/dev/null || true
 565         if test -d $(TARGET_DIR)/lib/modules; then \
 566                 find $(TARGET_DIR)/lib/modules -type f -name '*.ko' -print0 | \
 567                 xargs -0 -r $(KSTRIPCMD); fi
 568
 569 # See http://sourceware.org/gdb/wiki/FAQ, "GDB does not see any threads
 570 # besides the one in which crash occurred; or SIGTRAP kills my program when
 571 # I set a breakpoint"
 572 ifeq ($(BR2_TOOLCHAIN_HAS_THREADS),y)
 573         find $(TARGET_DIR)/lib -type f -name 'libpthread*.so*' | \
 574                 xargs -r $(STRIPCMD) $(STRIP_STRIP_DEBUG)
 575 endif
 576
 577         mkdir -p $(TARGET_DIR)/etc
 578         # Mandatory configuration file and auxiliary cache directory
 579         # for recent versions of ldconfig
 580         touch $(TARGET_DIR)/etc/ld.so.conf
 581         mkdir -p $(TARGET_DIR)/var/cache/ldconfig
 582         if [ -x "$(TARGET_CROSS)ldconfig" ]; \
 583         then \
 584                 $(TARGET_CROSS)ldconfig -r $(TARGET_DIR) \
 585                                         -f $(TARGET_DIR)/etc/ld.so.conf; \
 586         else \
 587                 /sbin/ldconfig -r $(TARGET_DIR) \
 588                                -f $(TARGET_DIR)/etc/ld.so.conf; \
 589         fi
 590         ( \
 591                 echo "NAME=Buildroot"; \
 592                 echo "VERSION=$(BR2_VERSION_FULL)"; \
 593                 echo "ID=buildroot"; \
 594                 echo "VERSION_ID=$(BR2_VERSION)"; \
 595                 echo "PRETTY_NAME=\"Buildroot $(BR2_VERSION)\"" \
 596         ) >  $(TARGET_DIR)/etc/os-release
 597
 598         @$(foreach d, $(call qstrip,$(BR2_ROOTFS_OVERLAY)), \
 599                 $(call MESSAGE,"Copying overlay $(d)"); \
 600                 rsync -a --ignore-times $(RSYNC_VCS_EXCLUSIONS) \
 601                         --chmod=Du+w --exclude .empty --exclude '*~' \
 602                         $(d)/ $(TARGET_DIR)$(sep))
 603
 604         @$(foreach s, $(call qstrip,$(BR2_ROOTFS_POST_BUILD_SCRIPT)), \
 605                 $(call MESSAGE,"Executing post-build script $(s)"); \
 606                 $(EXTRA_ENV) $(s) $(TARGET_DIR) $(call qstrip,$(BR2_ROOTFS_POST_SCRIPT_ARGS))$(sep))
 607
 608 target-post-image: $(TARGETS_ROOTFS) target-finalize
 609         @$(foreach s, $(call qstrip,$(BR2_ROOTFS_POST_IMAGE_SCRIPT)), \
 610                 $(call MESSAGE,"Executing post-image script $(s)"); \
 611                 $(EXTRA_ENV) $(s) $(BINARIES_DIR) $(call qstrip,$(BR2_ROOTFS_POST_SCRIPT_ARGS))$(sep))
 612
 613 source: $(foreach p,$(PACKAGES),$(p)-all-source)
 614
 615 _external-deps: $(foreach p,$(PACKAGES),$(p)-all-external-deps)
 616 external-deps:
 617         @$(MAKE1) -Bs $(EXTRAMAKEARGS) _external-deps | sort -u
 618
 619 # check if download URLs are outdated
 620 source-check: $(foreach p,$(PACKAGES),$(p)-all-source-check)
 621
 622 legal-info-clean:
 623         @rm -fr $(LEGAL_INFO_DIR)
 624
 625 legal-info-prepare: $(LEGAL_INFO_DIR)
 626         @$(call MESSAGE,"Collecting legal info")
 627         @$(call legal-license-file,buildroot,COPYING,COPYING,HOST)
 628         @$(call legal-manifest,PACKAGE,VERSION,LICENSE,LICENSE FILES,SOURCE ARCHIVE,SOURCE SITE,TARGET)
 629         @$(call legal-manifest,PACKAGE,VERSION,LICENSE,LICENSE FILES,SOURCE ARCHIVE,SOURCE SITE,HOST)
 630         @$(call legal-manifest,buildroot,$(BR2_VERSION_FULL),GPLv2+,COPYING,not saved,not saved,HOST)
 631         @$(call legal-warning,the Buildroot source code has not been saved)
 632         @$(call legal-warning,the toolchain has not been saved)
 633         @cp $(BR2_CONFIG) $(LEGAL_INFO_DIR)/buildroot.config
 634
 635 legal-info: dirs legal-info-clean legal-info-prepare $(foreach p,$(PACKAGES),$(p)-all-legal-info) \
 636                 $(REDIST_SOURCES_DIR_TARGET) $(REDIST_SOURCES_DIR_HOST)
 637         @cat support/legal-info/README.header >>$(LEGAL_REPORT)
 638         @if [ -r $(LEGAL_WARNINGS) ]; then \
 639                 cat support/legal-info/README.warnings-header \
 640                         $(LEGAL_WARNINGS) >>$(LEGAL_REPORT); \
 641                 cat $(LEGAL_WARNINGS); fi
 642         @echo "Legal info produced in $(LEGAL_INFO_DIR)"
 643         @rm -f $(LEGAL_WARNINGS)
 644
 645 show-targets:
 646         @echo $(PACKAGES) $(TARGETS_ROOTFS)
 647
 648 graph-build: $(O)/build/build-time.log
 649         @install -d $(GRAPHS_DIR)
 650         $(foreach o,name build duration,./support/scripts/graph-build-time \
 651                                         --type=histogram --order=$(o) --input=$(<) \
 652                                         --output=$(GRAPHS_DIR)/build.hist-$(o).$(BR_GRAPH_OUT) \
 653                                         $(if $(BR2_GRAPH_ALT),--alternate-colors)$(sep))
 654         $(foreach t,packages steps,./support/scripts/graph-build-time \
 655                                    --type=pie-$(t) --input=$(<) \
 656                                    --output=$(GRAPHS_DIR)/build.pie-$(t).$(BR_GRAPH_OUT) \
 657                                    $(if $(BR2_GRAPH_ALT),--alternate-colors)$(sep))
 658
 659 graph-depends-requirements:
 660         @dot -? >/dev/null 2>&1 || \
 661                 { echo "ERROR: The 'dot' program from Graphviz is needed for graph-depends" >&2; exit 1; }
 662
 663 graph-depends: graph-depends-requirements
 664         @$(INSTALL) -d $(GRAPHS_DIR)
 665         @cd "$(CONFIG_DIR)"; \
 666         $(TOPDIR)/support/scripts/graph-depends $(BR2_GRAPH_DEPS_OPTS) \
 667         |tee $(GRAPHS_DIR)/$(@).dot \
 668         |dot $(BR2_GRAPH_DOT_OPTS) -T$(BR_GRAPH_OUT) -o $(GRAPHS_DIR)/$(@).$(BR_GRAPH_OUT)
 669
 670 else # ifeq ($(BR2_HAVE_DOT_CONFIG),y)
 671
 672 all: menuconfig
 673
 674 endif # ifeq ($(BR2_HAVE_DOT_CONFIG),y)
 675
 676 # configuration
 677 # ---------------------------------------------------------------------------
 678
 679 HOSTCFLAGS = $(CFLAGS_FOR_BUILD)
 680 export HOSTCFLAGS
 681
 682 $(BUILD_DIR)/buildroot-config/%onf:
 683         mkdir -p $(@D)/lxdialog
 684         PKG_CONFIG_PATH="$(HOST_PKG_CONFIG_PATH)" $(MAKE) CC="$(HOSTCC_NOCCACHE)" HOSTCC="$(HOSTCC_NOCCACHE)" \
 685             obj=$(@D) -C $(CONFIG) -f Makefile.br $(@F)
 686
 687 DEFCONFIG = $(call qstrip,$(BR2_DEFCONFIG))
 688
 689 # We don't want to fully expand BR2_DEFCONFIG here, so Kconfig will
 690 # recognize that if it's still at its default $(CONFIG_DIR)/defconfig
 691 COMMON_CONFIG_ENV = \
 692         BR2_DEFCONFIG='$(call qstrip,$(value BR2_DEFCONFIG))' \
 693         KCONFIG_AUTOCONFIG=$(BUILD_DIR)/buildroot-config/auto.conf \
 694         KCONFIG_AUTOHEADER=$(BUILD_DIR)/buildroot-config/autoconf.h \
 695         KCONFIG_TRISTATE=$(BUILD_DIR)/buildroot-config/tristate.config \
 696         BR2_CONFIG=$(BR2_CONFIG) \
 697         BR2_EXTERNAL=$(BR2_EXTERNAL) \
 698         SKIP_LEGACY=
 699
 700 xconfig: $(BUILD_DIR)/buildroot-config/qconf outputmakefile
 701         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
 702
 703 gconfig: $(BUILD_DIR)/buildroot-config/gconf outputmakefile
 704         @$(COMMON_CONFIG_ENV) srctree=$(TOPDIR) $< $(CONFIG_CONFIG_IN)
 705
 706 menuconfig: $(BUILD_DIR)/buildroot-config/mconf outputmakefile
 707         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
 708
 709 nconfig: $(BUILD_DIR)/buildroot-config/nconf outputmakefile
 710         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
 711
 712 config: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 713         @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
 714
 715 # For the config targets that automatically select options, we pass
 716 # SKIP_LEGACY=y to disable the legacy options. However, in that case
 717 # no values are set for the legacy options so a subsequent oldconfig
 718 # will query them. Therefore, run an additional olddefconfig.
 719
 720 oldconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 721         @$(COMMON_CONFIG_ENV) $< --oldconfig $(CONFIG_CONFIG_IN)
 722
 723 randconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 724         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y $< --randconfig $(CONFIG_CONFIG_IN)
 725         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
 726
 727 allyesconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 728         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y $< --allyesconfig $(CONFIG_CONFIG_IN)
 729         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
 730
 731 allnoconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 732         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y $< --allnoconfig $(CONFIG_CONFIG_IN)
 733         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
 734
 735 randpackageconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 736         @grep -v BR2_PACKAGE_ $(BR2_CONFIG) > $(CONFIG_DIR)/.config.nopkg
 737         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y \
 738                 KCONFIG_ALLCONFIG=$(CONFIG_DIR)/.config.nopkg \
 739                 $< --randconfig $(CONFIG_CONFIG_IN)
 740         @rm -f $(CONFIG_DIR)/.config.nopkg
 741         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
 742
 743 allyespackageconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 744         @grep -v BR2_PACKAGE_ $(BR2_CONFIG) > $(CONFIG_DIR)/.config.nopkg
 745         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y \
 746                 KCONFIG_ALLCONFIG=$(CONFIG_DIR)/.config.nopkg \
 747                 $< --allyesconfig $(CONFIG_CONFIG_IN)
 748         @rm -f $(CONFIG_DIR)/.config.nopkg
 749         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
 750
 751 allnopackageconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 752         @grep -v BR2_PACKAGE_ $(BR2_CONFIG) > $(CONFIG_DIR)/.config.nopkg
 753         @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y \
 754                 KCONFIG_ALLCONFIG=$(CONFIG_DIR)/.config.nopkg \
 755                 $< --allnoconfig $(CONFIG_CONFIG_IN)
 756         @rm -f $(CONFIG_DIR)/.config.nopkg
 757         @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
 758
 759 silentoldconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 760         $(COMMON_CONFIG_ENV) $< --silentoldconfig $(CONFIG_CONFIG_IN)
 761
 762 olddefconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 763         $(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN)
 764
 765 defconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 766         @$(COMMON_CONFIG_ENV) $< --defconfig$(if $(DEFCONFIG),=$(DEFCONFIG)) $(CONFIG_CONFIG_IN)
 767
 768 # Override the BR2_DEFCONFIG from COMMON_CONFIG_ENV with the new defconfig
 769 %_defconfig: $(BUILD_DIR)/buildroot-config/conf $(TOPDIR)/configs/%_defconfig outputmakefile
 770         @$(COMMON_CONFIG_ENV) BR2_DEFCONFIG=$(TOPDIR)/configs/$@ \
 771                 $< --defconfig=$(TOPDIR)/configs/$@ $(CONFIG_CONFIG_IN)
 772
 773 %_defconfig: $(BUILD_DIR)/buildroot-config/conf $(BR2_EXTERNAL)/configs/%_defconfig outputmakefile
 774         @$(COMMON_CONFIG_ENV) BR2_DEFCONFIG=$(BR2_EXTERNAL)/configs/$@ \
 775                 $< --defconfig=$(BR2_EXTERNAL)/configs/$@ $(CONFIG_CONFIG_IN)
 776
 777 savedefconfig: $(BUILD_DIR)/buildroot-config/conf outputmakefile
 778         @$(COMMON_CONFIG_ENV) $< \
 779                 --savedefconfig=$(if $(DEFCONFIG),$(DEFCONFIG),$(CONFIG_DIR)/defconfig) \
 780                 $(CONFIG_CONFIG_IN)
 781         @$(SED) '/BR2_DEFCONFIG=/d' $(if $(DEFCONFIG),$(DEFCONFIG),$(CONFIG_DIR)/defconfig)
 782
 783 .PHONY: defconfig savedefconfig
 784
 785 ################################################################################
 786 #
 787 # Cleanup and misc junk
 788 #
 789 ################################################################################
 790
 791 # outputmakefile generates a Makefile in the output directory, if using a
 792 # separate output directory. This allows convenient use of make in the
 793 # output directory.
 794 outputmakefile:
 795 ifeq ($(NEED_WRAPPER),y)
 796         $(Q)$(TOPDIR)/support/scripts/mkmakefile $(TOPDIR) $(O)
 797 endif
 798
 799 # printvars prints all the variables currently defined in our Makefiles
 800 printvars:
 801         @$(foreach V, \
 802                 $(sort $(.VARIABLES)), \
 803                 $(if $(filter-out environment% default automatic, \
 804                                 $(origin $V)), \
 805                 $(info $V=$($V) ($(value $V)))))
 806
 807 clean:
 808         rm -rf $(TARGET_DIR) $(BINARIES_DIR) $(HOST_DIR) \
 809                 $(BUILD_DIR) $(BASE_DIR)/staging \
 810                 $(LEGAL_INFO_DIR) $(GRAPHS_DIR)
 811
 812 distclean: clean
 813 ifeq ($(DL_DIR),$(TOPDIR)/dl)
 814         rm -rf $(DL_DIR)
 815 endif
 816 ifeq ($(O),output)
 817         rm -rf $(O)
 818 endif
 819         rm -rf $(BR2_CONFIG) $(CONFIG_DIR)/.config.old $(CONFIG_DIR)/..config.tmp \
 820                 $(CONFIG_DIR)/.auto.deps
 821
 822 help:
 823         @echo 'Cleaning:'
 824         @echo '  clean                  - delete all files created by build'
 825         @echo '  distclean              - delete all non-source files (including .config)'
 826         @echo
 827         @echo 'Build:'
 828         @echo '  all                    - make world'
 829         @echo '  toolchain              - build toolchain'
 830         @echo
 831         @echo 'Configuration:'
 832         @echo '  menuconfig             - interactive curses-based configurator'
 833         @echo '  nconfig                - interactive ncurses-based configurator'
 834         @echo '  xconfig                - interactive Qt-based configurator'
 835         @echo '  gconfig                - interactive GTK-based configurator'
 836         @echo '  oldconfig              - resolve any unresolved symbols in .config'
 837         @echo '  silentoldconfig        - Same as oldconfig, but quietly, additionally update deps'
 838         @echo '  olddefconfig           - Same as silentoldconfig but sets new symbols to their default value'
 839         @echo '  randconfig             - New config with random answer to all options'
 840         @echo '  defconfig              - New config with default answer to all options'
 841         @echo '                             BR2_DEFCONFIG, if set, is used as input'
 842         @echo '  savedefconfig          - Save current config to BR2_DEFCONFIG (minimal config)'
 843         @echo '  allyesconfig           - New config where all options are accepted with yes'
 844         @echo '  allnoconfig            - New config where all options are answered with no'
 845         @echo '  randpackageconfig      - New config with random answer to package options'
 846         @echo '  allyespackageconfig    - New config where pkg options are accepted with yes'
 847         @echo '  allnopackageconfig     - New config where package options are answered with no'
 848         @echo
 849         @echo 'Package-specific:'
 850         @echo '  <pkg>                  - Build and install <pkg> and all its dependencies'
 851         @echo '  <pkg>-source           - Only download the source files for <pkg>'
 852         @echo '  <pkg>-extract          - Extract <pkg> sources'
 853         @echo '  <pkg>-patch            - Apply patches to <pkg>'
 854         @echo '  <pkg>-depends          - Build <pkg>'\''s dependencies'
 855         @echo '  <pkg>-configure        - Build <pkg> up to the configure step'
 856         @echo '  <pkg>-build            - Build <pkg> up to the build step'
 857         @echo '  <pkg>-graph-depends    - Generate a graph of <pkg>'\''s dependencies'
 858         @echo '  <pkg>-dirclean         - Remove <pkg> build directory'
 859         @echo '  <pkg>-reconfigure      - Restart the build from the configure step'
 860         @echo '  <pkg>-rebuild          - Restart the build from the build step'
 861         @echo '  <pkg>-legal-info       - Generate license information for <pkg>'
 862 ifeq ($(BR2_PACKAGE_BUSYBOX),y)
 863         @echo '  busybox-menuconfig     - Run BusyBox menuconfig'
 864 endif
 865 ifeq ($(BR2_LINUX_KERNEL),y)
 866         @echo '  linux-menuconfig       - Run Linux kernel menuconfig'
 867         @echo '  linux-savedefconfig    - Run Linux kernel savedefconfig'
 868         @echo '  linux-update-defconfig - Save the Linux configuration to the path specified'
 869         @echo '                             by BR2_LINUX_KERNEL_CUSTOM_CONFIG_FILE'
 870 endif
 871 ifeq ($(BR2_TOOLCHAIN_BUILDROOT),y)
 872         @echo '  uclibc-menuconfig      - Run uClibc menuconfig'
 873 endif
 874 ifeq ($(BR2_TARGET_BAREBOX),y)
 875         @echo '  barebox-menuconfig     - Run barebox menuconfig'
 876         @echo '  barebox-savedefconfig  - Run barebox savedefconfig'
 877 endif
 878         @echo
 879         @echo 'Documentation:'
 880         @echo '  manual                 - build manual in all formats'
 881         @echo '  manual-html            - build manual in HTML'
 882         @echo '  manual-split-html      - build manual in split HTML'
 883         @echo '  manual-pdf             - build manual in PDF'
 884         @echo '  manual-text            - build manual in text'
 885         @echo '  manual-epub            - build manual in ePub'
 886         @echo '  graph-build            - generate graphs of the build times'
 887         @echo '  graph-depends          - generate graph of the dependency tree'
 888         @echo '  list-defconfigs        - list all defconfigs (pre-configured minimal systems)'
 889         @echo
 890         @echo 'Miscellaneous:'
 891         @echo '  source                 - download all sources needed for offline-build'
 892         @echo '  source-check           - check selected packages for valid download URLs'
 893         @echo '  external-deps          - list external packages used'
 894         @echo '  legal-info             - generate info about license compliance'
 895         @echo
 896         @echo '  make V=0|1             - 0 => quiet build (default), 1 => verbose build'
 897         @echo '  make O=dir             - Locate all output files in "dir", including .config'
 898         @echo
 899         @echo 'For further details, see README, generate the Buildroot manual, or consult'
 900         @echo 'it on-line at http://buildroot.org/docs.html'
 901         @echo
 902
 903 list-defconfigs:
 904         @echo 'Built-in configs:'
 905         @$(foreach b, $(sort $(notdir $(wildcard $(TOPDIR)/configs/*_defconfig))), \
 906           printf "  %-35s - Build for %s\\n" $(b) $(b:_defconfig=);)
 907 ifneq ($(wildcard $(BR2_EXTERNAL)/configs/*_defconfig),)
 908         @echo
 909         @echo 'User-provided configs:'
 910         @$(foreach b, $(sort $(notdir $(wildcard $(BR2_EXTERNAL)/configs/*_defconfig))), \
 911           printf "  %-35s - Build for %s\\n" $(b) $(b:_defconfig=);)
 912 endif
 913         @echo
 914
 915 release: OUT = buildroot-$(BR2_VERSION)
 916
 917 # Create release tarballs. We need to fiddle a bit to add the generated
 918 # documentation to the git output
 919 release:
 920         git archive --format=tar --prefix=$(OUT)/ HEAD > $(OUT).tar
 921         $(MAKE) O=$(OUT) manual-html manual-text manual-pdf
 922         tar rf $(OUT).tar $(OUT)
 923         gzip -9 -c < $(OUT).tar > $(OUT).tar.gz
 924         bzip2 -9 -c < $(OUT).tar > $(OUT).tar.bz2
 925         rm -rf $(OUT) $(OUT).tar
 926
 927 print-version:
 928         @echo $(BR2_VERSION_FULL)
 929
 930 include docs/manual/manual.mk
 931 -include $(BR2_EXTERNAL)/docs/*/*.mk
 932
 933 .PHONY: $(noconfig_targets)