board/csky: fixup gdb instructions in readme.txt
[buildroot-gz.git] / Makefile
blobfb2c235293652fefd2ce6cb3349362a54153118f
1 # Makefile for buildroot
3 # Copyright (C) 1999-2005 by Erik Andersen <andersen@codepoet.org>
4 # Copyright (C) 2006-2014 by the Buildroot developers <buildroot@uclibc.org>
5 # Copyright (C) 2014-2017 by the Buildroot developers <buildroot@buildroot.org>
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.
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.
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
22 #--------------------------------------------------------------
23 # Just run 'make menuconfig', configure stuff, then run 'make'.
24 # You shouldn't need to mess with anything beyond this point...
25 #--------------------------------------------------------------
27 # Delete default rules. We don't use them. This saves a bit of time.
28 .SUFFIXES:
30 # we want bash as shell
31 SHELL := $(shell if [ -x "$$BASH" ]; then echo $$BASH; \
32 else if [ -x /bin/bash ]; then echo /bin/bash; \
33 else echo sh; fi; fi)
35 # Set O variable if not already done on the command line;
36 # or avoid confusing packages that can use the O=<dir> syntax for out-of-tree
37 # build by preventing it from being forwarded to sub-make calls.
38 ifneq ("$(origin O)", "command line")
39 O := $(CURDIR)/output
40 endif
42 # Check if the current Buildroot execution meets all the pre-requisites.
43 # If they are not met, Buildroot will actually do its job in a sub-make meeting
44 # its pre-requisites, which are:
45 # 1- Permissive enough umask:
46 # Wrong or too restrictive umask will prevent Buildroot and packages from
47 # creating files and directories.
48 # 2- Absolute canonical CWD (i.e. $(CURDIR)):
49 # Otherwise, some packages will use CWD as-is, others will compute its
50 # absolute canonical path. This makes harder tracking and fixing host
51 # machine path leaks.
52 # 3- Absolute canonical output location (i.e. $(O)):
53 # For the same reason as the one for CWD.
55 # Remove the trailing '/.' from $(O) as it can be added by the makefile wrapper
56 # installed in the $(O) directory.
57 # Also remove the trailing '/' the user can set when on the command line.
58 override O := $(patsubst %/,%,$(patsubst %.,%,$(O)))
59 # Make sure $(O) actually exists before calling realpath on it; this is to
60 # avoid empty CANONICAL_O in case on non-existing entry.
61 CANONICAL_O := $(shell mkdir -p $(O) >/dev/null 2>&1)$(realpath $(O))
63 CANONICAL_CURDIR = $(realpath $(CURDIR))
65 REQ_UMASK = 0022
67 # Make sure O= is passed (with its absolute canonical path) everywhere the
68 # toplevel makefile is called back.
69 EXTRAMAKEARGS := O=$(CANONICAL_O)
71 # Check Buildroot execution pre-requisites here.
72 ifneq ($(shell umask):$(CURDIR):$(O),$(REQ_UMASK):$(CANONICAL_CURDIR):$(CANONICAL_O))
73 .PHONY: _all $(MAKECMDGOALS)
75 $(MAKECMDGOALS): _all
78 _all:
79 @umask $(REQ_UMASK) && \
80 $(MAKE) -C $(CANONICAL_CURDIR) --no-print-directory \
81 $(MAKECMDGOALS) $(EXTRAMAKEARGS)
83 else # umask / $(CURDIR) / $(O)
85 # This is our default rule, so must come first
86 all:
88 # Set and export the version string
89 export BR2_VERSION := 2017.05-git
90 # Actual time the release is cut (for reproducible builds)
91 BR2_VERSION_EPOCH = 1488315000
93 # Save running make version since it's clobbered by the make package
94 RUNNING_MAKE_VERSION := $(MAKE_VERSION)
96 # Check for minimal make version (note: this check will break at make 10.x)
97 MIN_MAKE_VERSION = 3.81
98 ifneq ($(firstword $(sort $(RUNNING_MAKE_VERSION) $(MIN_MAKE_VERSION))),$(MIN_MAKE_VERSION))
99 $(error You have make '$(RUNNING_MAKE_VERSION)' installed. GNU make >= $(MIN_MAKE_VERSION) is required)
100 endif
102 # Parallel execution of this Makefile is disabled because it changes
103 # the packages building order, that can be a problem for two reasons:
104 # - If a package has an unspecified optional dependency and that
105 # dependency is present when the package is built, it is used,
106 # otherwise it isn't (but compilation happily proceeds) so the end
107 # result will differ if the order is swapped due to parallel
108 # building.
109 # - Also changing the building order can be a problem if two packages
110 # manipulate the same file in the target directory.
112 # Taking into account the above considerations, if you still want to execute
113 # this top-level Makefile in parallel comment the ".NOTPARALLEL" line and
114 # use the -j<jobs> option when building, e.g:
115 # make -j$((`getconf _NPROCESSORS_ONLN`+1))
116 .NOTPARALLEL:
118 # absolute path
119 TOPDIR := $(CURDIR)
120 CONFIG_CONFIG_IN = Config.in
121 CONFIG = support/kconfig
122 DATE := $(shell date +%Y%m%d)
124 # Compute the full local version string so packages can use it as-is
125 # Need to export it, so it can be got from environment in children (eg. mconf)
126 export BR2_VERSION_FULL := $(BR2_VERSION)$(shell $(TOPDIR)/support/scripts/setlocalversion)
128 noconfig_targets := menuconfig nconfig gconfig xconfig config oldconfig randconfig \
129 defconfig %_defconfig allyesconfig allnoconfig silentoldconfig release \
130 randpackageconfig allyespackageconfig allnopackageconfig \
131 print-version olddefconfig distclean manual manual-html manual-split-html \
132 manual-pdf manual-text manual-epub
134 # Some global targets do not trigger a build, but are used to collect
135 # metadata, or do various checks. When such targets are triggered,
136 # some packages should not do their configuration sanity
137 # checks. Provide them a BR_BUILDING variable set to 'y' when we're
138 # actually building and they should do their sanity checks.
140 # We're building in two situations: when MAKECMDGOALS is empty
141 # (default target is to build), or when MAKECMDGOALS contains
142 # something else than one of the nobuild_targets.
143 nobuild_targets := source %-source source-check \
144 legal-info %-legal-info external-deps _external-deps \
145 clean distclean help show-targets graph-depends \
146 %-graph-depends %-show-depends %-show-version \
147 graph-build graph-size list-defconfigs \
148 savedefconfig printvars
149 ifeq ($(MAKECMDGOALS),)
150 BR_BUILDING = y
151 else ifneq ($(filter-out $(nobuild_targets),$(MAKECMDGOALS)),)
152 BR_BUILDING = y
153 endif
155 # We call make recursively to build packages. The command-line overrides that
156 # are passed to Buildroot don't apply to those package build systems. In
157 # particular, we don't want to pass down the O=<dir> option for out-of-tree
158 # builds, because the value specified on the command line will not be correct
159 # for packages.
160 MAKEOVERRIDES :=
162 # Include some helper macros and variables
163 include support/misc/utils.mk
165 # Set variables related to in-tree or out-of-tree build.
166 # Here, both $(O) and $(CURDIR) are absolute canonical paths.
167 ifeq ($(O),$(CURDIR)/output)
168 CONFIG_DIR := $(CURDIR)
169 NEED_WRAPPER =
170 else
171 CONFIG_DIR := $(O)
172 NEED_WRAPPER = y
173 endif
175 # bash prints the name of the directory on 'cd <dir>' if CDPATH is
176 # set, so unset it here to not cause problems. Notice that the export
177 # line doesn't affect the environment of $(shell ..) calls.
178 export CDPATH :=
180 BASE_DIR := $(CANONICAL_O)
181 $(if $(BASE_DIR),, $(error output directory "$(O)" does not exist))
184 # Handling of BR2_EXTERNAL.
186 # The value of BR2_EXTERNAL is stored in .br-external in the output directory.
187 # The location of the external.mk makefile fragments is computed in that file.
188 # On subsequent invocations of make, this file is read in. BR2_EXTERNAL can
189 # still be overridden on the command line, therefore the file is re-created
190 # every time make is run.
192 BR2_EXTERNAL_FILE = $(BASE_DIR)/.br-external.mk
193 -include $(BR2_EXTERNAL_FILE)
194 $(shell support/scripts/br2-external \
195 -m -o '$(BR2_EXTERNAL_FILE)' $(BR2_EXTERNAL))
196 BR2_EXTERNAL_ERROR =
197 include $(BR2_EXTERNAL_FILE)
198 ifneq ($(BR2_EXTERNAL_ERROR),)
199 $(error $(BR2_EXTERNAL_ERROR))
200 endif
202 # To make sure that the environment variable overrides the .config option,
203 # set this before including .config.
204 ifneq ($(BR2_DL_DIR),)
205 DL_DIR := $(BR2_DL_DIR)
206 endif
207 ifneq ($(BR2_CCACHE_DIR),)
208 BR_CACHE_DIR := $(BR2_CCACHE_DIR)
209 endif
211 # Need that early, before we scan packages
212 # Avoids doing the $(or...) everytime
213 BR_GRAPH_OUT := $(or $(BR2_GRAPH_OUT),pdf)
215 BUILD_DIR := $(BASE_DIR)/build
216 BINARIES_DIR := $(BASE_DIR)/images
217 TARGET_DIR := $(BASE_DIR)/target
218 # initial definition so that 'make clean' works for most users, even without
219 # .config. HOST_DIR will be overwritten later when .config is included.
220 HOST_DIR := $(BASE_DIR)/host
221 GRAPHS_DIR := $(BASE_DIR)/graphs
223 LEGAL_INFO_DIR = $(BASE_DIR)/legal-info
224 REDIST_SOURCES_DIR_TARGET = $(LEGAL_INFO_DIR)/sources
225 REDIST_SOURCES_DIR_HOST = $(LEGAL_INFO_DIR)/host-sources
226 LICENSE_FILES_DIR_TARGET = $(LEGAL_INFO_DIR)/licenses
227 LICENSE_FILES_DIR_HOST = $(LEGAL_INFO_DIR)/host-licenses
228 LEGAL_MANIFEST_CSV_TARGET = $(LEGAL_INFO_DIR)/manifest.csv
229 LEGAL_MANIFEST_CSV_HOST = $(LEGAL_INFO_DIR)/host-manifest.csv
230 LEGAL_WARNINGS = $(LEGAL_INFO_DIR)/.warnings
231 LEGAL_REPORT = $(LEGAL_INFO_DIR)/README
233 ################################################################################
235 # staging and target directories do NOT list these as
236 # dependencies anywhere else
238 ################################################################################
239 $(BUILD_DIR) $(TARGET_DIR) $(HOST_DIR) $(BINARIES_DIR) $(LEGAL_INFO_DIR) $(REDIST_SOURCES_DIR_TARGET) $(REDIST_SOURCES_DIR_HOST):
240 @mkdir -p $@
242 BR2_CONFIG = $(CONFIG_DIR)/.config
244 # Pull in the user's configuration file
245 ifeq ($(filter $(noconfig_targets),$(MAKECMDGOALS)),)
246 -include $(BR2_CONFIG)
247 endif
249 # timezone and locale may affect build output
250 ifeq ($(BR2_REPRODUCIBLE),y)
251 export TZ = UTC
252 export LANG = C
253 export LC_ALL = C
254 export GZIP = -n
255 BR2_VERSION_GIT_EPOCH = $(shell GIT_DIR=$(TOPDIR)/.git $(GIT) log -1 --format=%at)
256 export SOURCE_DATE_EPOCH = $(if $(wildcard $(TOPDIR)/.git),$(BR2_VERSION_GIT_EPOCH),$(BR2_VERSION_EPOCH))
257 DEPENDENCIES_HOST_PREREQ += host-fakedate
258 endif
260 # To put more focus on warnings, be less verbose as default
261 # Use 'make V=1' to see the full commands
262 ifeq ("$(origin V)", "command line")
263 KBUILD_VERBOSE = $(V)
264 endif
265 ifndef KBUILD_VERBOSE
266 KBUILD_VERBOSE = 0
267 endif
269 ifeq ($(KBUILD_VERBOSE),1)
271 ifndef VERBOSE
272 VERBOSE = 1
273 endif
274 export VERBOSE
275 else
276 Q = @
277 endif
279 # kconfig uses CONFIG_SHELL
280 CONFIG_SHELL := $(SHELL)
282 export SHELL CONFIG_SHELL Q KBUILD_VERBOSE
284 ifndef HOSTAR
285 HOSTAR := ar
286 endif
287 ifndef HOSTAS
288 HOSTAS := as
289 endif
290 ifndef HOSTCC
291 HOSTCC := gcc
292 HOSTCC := $(shell which $(HOSTCC) || type -p $(HOSTCC) || echo gcc)
293 endif
294 HOSTCC_NOCCACHE := $(HOSTCC)
295 ifndef HOSTCXX
296 HOSTCXX := g++
297 HOSTCXX := $(shell which $(HOSTCXX) || type -p $(HOSTCXX) || echo g++)
298 endif
299 HOSTCXX_NOCCACHE := $(HOSTCXX)
300 ifndef HOSTCPP
301 HOSTCPP := cpp
302 endif
303 ifndef HOSTLD
304 HOSTLD := ld
305 endif
306 ifndef HOSTLN
307 HOSTLN := ln
308 endif
309 ifndef HOSTNM
310 HOSTNM := nm
311 endif
312 ifndef HOSTOBJCOPY
313 HOSTOBJCOPY := objcopy
314 endif
315 ifndef HOSTRANLIB
316 HOSTRANLIB := ranlib
317 endif
318 HOSTAR := $(shell which $(HOSTAR) || type -p $(HOSTAR) || echo ar)
319 HOSTAS := $(shell which $(HOSTAS) || type -p $(HOSTAS) || echo as)
320 HOSTCPP := $(shell which $(HOSTCPP) || type -p $(HOSTCPP) || echo cpp)
321 HOSTLD := $(shell which $(HOSTLD) || type -p $(HOSTLD) || echo ld)
322 HOSTLN := $(shell which $(HOSTLN) || type -p $(HOSTLN) || echo ln)
323 HOSTNM := $(shell which $(HOSTNM) || type -p $(HOSTNM) || echo nm)
324 HOSTOBJCOPY := $(shell which $(HOSTOBJCOPY) || type -p $(HOSTOBJCOPY) || echo objcopy)
325 HOSTRANLIB := $(shell which $(HOSTRANLIB) || type -p $(HOSTRANLIB) || echo ranlib)
326 SED := $(shell which sed || type -p sed) -i -e
328 export HOSTAR HOSTAS HOSTCC HOSTCXX HOSTLD
329 export HOSTCC_NOCCACHE HOSTCXX_NOCCACHE
331 # Determine the userland we are running on.
333 # Note that, despite its name, we are not interested in the actual
334 # architecture name. This is mostly used to determine whether some
335 # of the binary tools (e.g. pre-built external toolchains) can run
336 # on the current host. So we need to know if the userland we're
337 # running on can actually run those toolchains.
339 # For example, a 64-bit prebuilt toolchain will not run on a 64-bit
340 # kernel if the userland is 32-bit (e.g. in a chroot for example).
342 # So, we extract the first part of the tuple the host gcc was
343 # configured to generate code for; we assume this is our userland.
345 export HOSTARCH := $(shell LC_ALL=C $(HOSTCC_NOCCACHE) -v 2>&1 | \
346 sed -e '/^Target: \([^-]*\).*/!d' \
347 -e 's//\1/' \
348 -e 's/i.86/x86/' \
349 -e 's/sun4u/sparc64/' \
350 -e 's/arm.*/arm/' \
351 -e 's/sa110/arm/' \
352 -e 's/ppc64/powerpc64/' \
353 -e 's/ppc/powerpc/' \
354 -e 's/macppc/powerpc/' \
355 -e 's/sh.*/sh/' )
357 HOSTCC_VERSION := $(shell $(HOSTCC_NOCCACHE) --version | \
358 sed -n -r 's/^.* ([0-9]*)\.([0-9]*)\.([0-9]*)[ ]*.*/\1 \2/p')
360 # For gcc >= 5.x, we only need the major version.
361 ifneq ($(firstword $(HOSTCC_VERSION)),4)
362 HOSTCC_VERSION := $(firstword $(HOSTCC_VERSION))
363 endif
365 # Make sure pkg-config doesn't look outside the buildroot tree
366 HOST_PKG_CONFIG_PATH := $(PKG_CONFIG_PATH)
367 unexport PKG_CONFIG_PATH
368 unexport PKG_CONFIG_SYSROOT_DIR
369 unexport PKG_CONFIG_LIBDIR
371 # Having DESTDIR set in the environment confuses the installation
372 # steps of some packages.
373 unexport DESTDIR
375 # Causes breakage with packages that needs host-ruby
376 unexport RUBYOPT
378 include package/pkg-utils.mk
379 include package/doc-asciidoc.mk
381 ifeq ($(BR2_HAVE_DOT_CONFIG),y)
383 ################################################################################
385 # Hide troublesome environment variables from sub processes
387 ################################################################################
388 unexport CROSS_COMPILE
389 unexport ARCH
390 unexport CC
391 unexport LD
392 unexport AR
393 unexport CXX
394 unexport CPP
395 unexport RANLIB
396 unexport CFLAGS
397 unexport CXXFLAGS
398 unexport GREP_OPTIONS
399 unexport TAR_OPTIONS
400 unexport CONFIG_SITE
401 unexport QMAKESPEC
402 unexport TERMINFO
403 unexport MACHINE
404 unexport O
405 unexport GCC_COLORS
407 GNU_HOST_NAME := $(shell support/gnuconfig/config.guess)
409 PACKAGES :=
410 PACKAGES_ALL :=
412 # silent mode requested?
413 QUIET := $(if $(findstring s,$(filter-out --%,$(MAKEFLAGS))),-q)
415 # Strip off the annoying quoting
416 ARCH := $(call qstrip,$(BR2_ARCH))
418 KERNEL_ARCH := $(shell echo "$(ARCH)" | sed -e "s/-.*//" \
419 -e s/i.86/i386/ -e s/sun4u/sparc64/ \
420 -e s/arcle/arc/ \
421 -e s/arceb/arc/ \
422 -e s/arm.*/arm/ -e s/sa110/arm/ \
423 -e s/aarch64.*/arm64/ \
424 -e s/bfin/blackfin/ \
425 -e s/or1k/openrisc/ \
426 -e s/parisc64/parisc/ \
427 -e s/powerpc64.*/powerpc/ \
428 -e s/ppc.*/powerpc/ -e s/mips.*/mips/ \
429 -e s/sh.*/sh/ \
430 -e s/microblazeel/microblaze/)
432 ZCAT := $(call qstrip,$(BR2_ZCAT))
433 BZCAT := $(call qstrip,$(BR2_BZCAT))
434 XZCAT := $(call qstrip,$(BR2_XZCAT))
435 LZCAT := $(call qstrip,$(BR2_LZCAT))
436 TAR_OPTIONS = $(call qstrip,$(BR2_TAR_OPTIONS)) -xf
438 # packages compiled for the host go here
439 HOST_DIR := $(call qstrip,$(BR2_HOST_DIR))
441 # Quotes are needed for spaces and all in the original PATH content.
442 BR_PATH = "$(HOST_DIR)/bin:$(HOST_DIR)/sbin:$(HOST_DIR)/usr/bin:$(HOST_DIR)/usr/sbin:$(PATH)"
444 # Location of a file giving a big fat warning that output/target
445 # should not be used as the root filesystem.
446 TARGET_DIR_WARNING_FILE = $(TARGET_DIR)/THIS_IS_NOT_YOUR_ROOT_FILESYSTEM
448 ifeq ($(BR2_CCACHE),y)
449 CCACHE := $(HOST_DIR)/usr/bin/ccache
450 BR_CACHE_DIR ?= $(call qstrip,$(BR2_CCACHE_DIR))
451 export BR_CACHE_DIR
452 HOSTCC := $(CCACHE) $(HOSTCC)
453 HOSTCXX := $(CCACHE) $(HOSTCXX)
454 else
455 export BR_NO_CCACHE
456 endif
458 # Scripts in support/ or post-build scripts may need to reference
459 # these locations, so export them so it is easier to use
460 export BR2_CONFIG
461 export BR2_REPRODUCIBLE
462 export TARGET_DIR
463 export STAGING_DIR
464 export HOST_DIR
465 export BINARIES_DIR
466 export BASE_DIR
468 ################################################################################
470 # You should probably leave this stuff alone unless you know
471 # what you are doing.
473 ################################################################################
475 all: world
477 # Include legacy before the other things, because package .mk files
478 # may rely on it.
479 include Makefile.legacy
481 include package/Makefile.in
482 include support/dependencies/dependencies.mk
484 include toolchain/*.mk
485 include toolchain/*/*.mk
487 # Include the package override file if one has been provided in the
488 # configuration.
489 PACKAGE_OVERRIDE_FILE = $(call qstrip,$(BR2_PACKAGE_OVERRIDE_FILE))
490 ifneq ($(PACKAGE_OVERRIDE_FILE),)
491 -include $(PACKAGE_OVERRIDE_FILE)
492 endif
494 include $(sort $(wildcard package/*/*.mk))
496 include boot/common.mk
497 include linux/linux.mk
498 include fs/common.mk
500 # If using a br2-external tree, the BR2_EXTERNAL_$(NAME)_PATH variables
501 # are also present in the .config file. Since .config is included after
502 # we defined them in the Makefile, the values for those variables are
503 # quoted. We just include the generated Makefile fragment .br2-external.mk
504 # a third time, which will set those variables to the un-quoted values.
505 include $(BR2_EXTERNAL_FILE)
507 # Nothing to include if no BR2_EXTERNAL tree in use
508 include $(BR2_EXTERNAL_MKS)
510 # Now we are sure we have all the packages scanned and defined. We now
511 # check for each package in the list of enabled packages, that all its
512 # dependencies are indeed enabled.
514 # Only trigger the check for default builds. If the user forces building
515 # a package, even if not enabled in the configuration, we want to accept
516 # it.
518 ifeq ($(MAKECMDGOALS),)
520 define CHECK_ONE_DEPENDENCY
521 ifeq ($$($(2)_TYPE),target)
522 ifeq ($$($(2)_IS_VIRTUAL),)
523 ifneq ($$($$($(2)_KCONFIG_VAR)),y)
524 $$(error $$($(2)_NAME) is in the dependency chain of $$($(1)_NAME) that \
525 has added it to its _DEPENDENCIES variable without selecting it or \
526 depending on it from Config.in)
527 endif
528 endif
529 endif
530 endef
532 $(foreach pkg,$(call UPPERCASE,$(PACKAGES)),\
533 $(foreach dep,$(call UPPERCASE,$($(pkg)_FINAL_ALL_DEPENDENCIES)),\
534 $(eval $(call CHECK_ONE_DEPENDENCY,$(pkg),$(dep))$(sep))))
536 endif
538 dirs: $(BUILD_DIR) $(STAGING_DIR) $(TARGET_DIR) \
539 $(HOST_DIR) $(BINARIES_DIR)
541 $(BUILD_DIR)/buildroot-config/auto.conf: $(BR2_CONFIG)
542 $(MAKE1) $(EXTRAMAKEARGS) HOSTCC="$(HOSTCC_NOCCACHE)" HOSTCXX="$(HOSTCXX_NOCCACHE)" silentoldconfig
544 prepare: $(BUILD_DIR)/buildroot-config/auto.conf
546 world: target-post-image
548 .PHONY: all world toolchain dirs clean distclean source outputmakefile \
549 legal-info legal-info-prepare legal-info-clean printvars help \
550 list-defconfigs target-finalize target-post-image source-check
552 # Populating the staging with the base directories is handled by the skeleton package
553 $(STAGING_DIR):
554 @mkdir -p $(STAGING_DIR)
555 @ln -snf $(STAGING_DIR) $(BASE_DIR)/staging
557 RSYNC_VCS_EXCLUSIONS = \
558 --exclude .svn --exclude .git --exclude .hg --exclude .bzr \
559 --exclude CVS
561 STRIP_FIND_CMD = find $(TARGET_DIR)
562 ifneq (,$(call qstrip,$(BR2_STRIP_EXCLUDE_DIRS)))
563 STRIP_FIND_CMD += \( $(call finddirclauses,$(TARGET_DIR),$(call qstrip,$(BR2_STRIP_EXCLUDE_DIRS))) \) -prune -o
564 endif
565 STRIP_FIND_CMD += -type f \( -perm /111 -o -name '*.so*' \)
566 # file exclusions:
567 # - libpthread.so: a non-stripped libpthread shared library is needed for
568 # proper debugging of pthread programs using gdb.
569 # - ld.so: a non-stripped dynamic linker library is needed for valgrind
570 # - kernel modules (*.ko): do not function properly when stripped like normal
571 # applications and libraries. Normally kernel modules are already excluded
572 # by the executable permission check above, so the explicit exclusion is only
573 # done for kernel modules with incorrect permissions.
574 STRIP_FIND_CMD += -not \( $(call findfileclauses,libpthread*.so* ld-*.so* *.ko $(call qstrip,$(BR2_STRIP_EXCLUDE_FILES))) \) -print0
576 ifeq ($(BR2_ECLIPSE_REGISTER),y)
577 define TOOLCHAIN_ECLIPSE_REGISTER
578 ./support/scripts/eclipse-register-toolchain `readlink -f $(O)` \
579 $(notdir $(TARGET_CROSS)) $(BR2_ARCH)
580 endef
581 TARGET_FINALIZE_HOOKS += TOOLCHAIN_ECLIPSE_REGISTER
582 endif
584 # Generate locale data. Basically, we call the localedef program
585 # (built by the host-localedef package) for each locale. The input
586 # data comes preferably from the toolchain, or if the toolchain does
587 # not have them (Linaro toolchains), we use the ones available on the
588 # host machine.
589 ifeq ($(BR2_TOOLCHAIN_USES_GLIBC),y)
590 GLIBC_GENERATE_LOCALES = $(call qstrip,$(BR2_GENERATE_LOCALE))
591 ifneq ($(GLIBC_GENERATE_LOCALES),)
592 PACKAGES += host-localedef
594 define GENERATE_GLIBC_LOCALES
595 $(Q)mkdir -p $(TARGET_DIR)/usr/lib/locale/
596 $(Q)for locale in $(GLIBC_GENERATE_LOCALES) ; do \
597 inputfile=`echo $${locale} | cut -f1 -d'.'` ; \
598 charmap=`echo $${locale} | cut -f2 -d'.' -s` ; \
599 if test -z "$${charmap}" ; then \
600 charmap="UTF-8" ; \
601 fi ; \
602 echo "Generating locale $${inputfile}.$${charmap}" ; \
603 I18NPATH=$(STAGING_DIR)/usr/share/i18n:/usr/share/i18n \
604 $(HOST_DIR)/usr/bin/localedef \
605 --prefix=$(TARGET_DIR) \
606 --$(call LOWERCASE,$(BR2_ENDIAN))-endian \
607 -i $${inputfile} -f $${charmap} \
608 $${locale} ; \
609 done
610 endef
611 TARGET_FINALIZE_HOOKS += GENERATE_GLIBC_LOCALES
612 endif
613 endif
615 ifeq ($(BR2_ENABLE_LOCALE_PURGE),y)
616 LOCALE_WHITELIST = $(BUILD_DIR)/locales.nopurge
617 LOCALE_NOPURGE = $(call qstrip,$(BR2_ENABLE_LOCALE_WHITELIST))
619 # This piece of junk does the following:
620 # First collect the whitelist in a file.
621 # Then go over all the locale dirs and for each subdir, check if it exists
622 # in the whitelist file. If it doesn't, kill it.
623 # Finally, specifically for X11, regenerate locale.dir from the whitelist.
624 define PURGE_LOCALES
625 rm -f $(LOCALE_WHITELIST)
626 for i in $(LOCALE_NOPURGE) locale-archive; do echo $$i >> $(LOCALE_WHITELIST); done
628 for dir in $(wildcard $(addprefix $(TARGET_DIR),/usr/share/locale /usr/share/X11/locale /usr/lib/locale)); \
629 do \
630 for langdir in $$dir/*; \
631 do \
632 if [ -e "$${langdir}" ]; \
633 then \
634 grep -qx "$${langdir##*/}" $(LOCALE_WHITELIST) || rm -rf $$langdir; \
635 fi \
636 done; \
637 done
638 if [ -d $(TARGET_DIR)/usr/share/X11/locale ]; \
639 then \
640 for lang in $(LOCALE_NOPURGE); \
641 do \
642 if [ -f $(TARGET_DIR)/usr/share/X11/locale/$$lang/XLC_LOCALE ]; \
643 then \
644 echo "$$lang/XLC_LOCALE: $$lang"; \
645 fi \
646 done > $(TARGET_DIR)/usr/share/X11/locale/locale.dir; \
648 endef
649 TARGET_FINALIZE_HOOKS += PURGE_LOCALES
650 endif
652 $(TARGETS_ROOTFS): target-finalize
654 target-finalize: $(PACKAGES)
655 @$(call MESSAGE,"Finalizing target directory")
656 $(foreach hook,$(TARGET_FINALIZE_HOOKS),$($(hook))$(sep))
657 rm -rf $(TARGET_DIR)/usr/include $(TARGET_DIR)/usr/share/aclocal \
658 $(TARGET_DIR)/usr/lib/pkgconfig $(TARGET_DIR)/usr/share/pkgconfig \
659 $(TARGET_DIR)/usr/lib/cmake $(TARGET_DIR)/usr/share/cmake
660 find $(TARGET_DIR)/usr/{lib,share}/ -name '*.cmake' -print0 | xargs -0 rm -f
661 find $(TARGET_DIR)/lib/ $(TARGET_DIR)/usr/lib/ $(TARGET_DIR)/usr/libexec/ \
662 \( -name '*.a' -o -name '*.la' \) -print0 | xargs -0 rm -f
663 ifneq ($(BR2_PACKAGE_GDB),y)
664 rm -rf $(TARGET_DIR)/usr/share/gdb
665 endif
666 ifneq ($(BR2_PACKAGE_BASH),y)
667 rm -rf $(TARGET_DIR)/usr/share/bash-completion
668 endif
669 ifneq ($(BR2_PACKAGE_ZSH),y)
670 rm -rf $(TARGET_DIR)/usr/share/zsh
671 endif
672 rm -rf $(TARGET_DIR)/usr/man $(TARGET_DIR)/usr/share/man
673 rm -rf $(TARGET_DIR)/usr/info $(TARGET_DIR)/usr/share/info
674 rm -rf $(TARGET_DIR)/usr/doc $(TARGET_DIR)/usr/share/doc
675 rm -rf $(TARGET_DIR)/usr/share/gtk-doc
676 rmdir $(TARGET_DIR)/usr/share 2>/dev/null || true
677 $(STRIP_FIND_CMD) | xargs -0 $(STRIPCMD) 2>/dev/null || true
679 # See http://sourceware.org/gdb/wiki/FAQ, "GDB does not see any threads
680 # besides the one in which crash occurred; or SIGTRAP kills my program when
681 # I set a breakpoint"
682 ifeq ($(BR2_TOOLCHAIN_HAS_THREADS),y)
683 find $(TARGET_DIR)/lib/ -type f -name 'libpthread*.so*' | \
684 xargs -r $(STRIPCMD) $(STRIP_STRIP_DEBUG)
685 endif
687 # Valgrind needs ld.so with enough information, so only strip
688 # debugging symbols.
689 find $(TARGET_DIR)/lib/ -type f -name 'ld-*.so*' | \
690 xargs -r $(STRIPCMD) $(STRIP_STRIP_DEBUG)
691 test -f $(TARGET_DIR)/etc/ld.so.conf && \
692 { echo "ERROR: we shouldn't have a /etc/ld.so.conf file"; exit 1; } || true
693 test -d $(TARGET_DIR)/etc/ld.so.conf.d && \
694 { echo "ERROR: we shouldn't have a /etc/ld.so.conf.d directory"; exit 1; } || true
695 mkdir -p $(TARGET_DIR)/etc
697 echo "NAME=Buildroot"; \
698 echo "VERSION=$(BR2_VERSION_FULL)"; \
699 echo "ID=buildroot"; \
700 echo "VERSION_ID=$(BR2_VERSION)"; \
701 echo "PRETTY_NAME=\"Buildroot $(BR2_VERSION)\"" \
702 ) > $(TARGET_DIR)/etc/os-release
704 @$(foreach d, $(call qstrip,$(BR2_ROOTFS_OVERLAY)), \
705 $(call MESSAGE,"Copying overlay $(d)"); \
706 rsync -a --ignore-times --keep-dirlinks $(RSYNC_VCS_EXCLUSIONS) \
707 --chmod=u=rwX,go=rX --exclude .empty --exclude '*~' \
708 $(d)/ $(TARGET_DIR)$(sep))
710 @$(foreach s, $(call qstrip,$(BR2_ROOTFS_POST_BUILD_SCRIPT)), \
711 $(call MESSAGE,"Executing post-build script $(s)"); \
712 $(EXTRA_ENV) $(s) $(TARGET_DIR) $(call qstrip,$(BR2_ROOTFS_POST_SCRIPT_ARGS))$(sep))
714 target-post-image: $(TARGETS_ROOTFS) target-finalize
715 @$(foreach s, $(call qstrip,$(BR2_ROOTFS_POST_IMAGE_SCRIPT)), \
716 $(call MESSAGE,"Executing post-image script $(s)"); \
717 $(EXTRA_ENV) $(s) $(BINARIES_DIR) $(call qstrip,$(BR2_ROOTFS_POST_SCRIPT_ARGS))$(sep))
719 source: $(foreach p,$(PACKAGES),$(p)-all-source)
721 _external-deps: $(foreach p,$(PACKAGES),$(p)-all-external-deps)
722 external-deps:
723 @$(MAKE1) -Bs $(EXTRAMAKEARGS) _external-deps | sort -u
725 # check if download URLs are outdated
726 source-check: $(foreach p,$(PACKAGES),$(p)-all-source-check)
728 legal-info-clean:
729 @rm -fr $(LEGAL_INFO_DIR)
731 legal-info-prepare: $(LEGAL_INFO_DIR)
732 @$(call MESSAGE,"Collecting legal info")
733 @$(call legal-license-file,buildroot,COPYING,COPYING,HOST)
734 @$(call legal-manifest,PACKAGE,VERSION,LICENSE,LICENSE FILES,SOURCE ARCHIVE,SOURCE SITE,TARGET)
735 @$(call legal-manifest,PACKAGE,VERSION,LICENSE,LICENSE FILES,SOURCE ARCHIVE,SOURCE SITE,HOST)
736 @$(call legal-manifest,buildroot,$(BR2_VERSION_FULL),GPLv2+,COPYING,not saved,not saved,HOST)
737 @$(call legal-warning,the Buildroot source code has not been saved)
738 @cp $(BR2_CONFIG) $(LEGAL_INFO_DIR)/buildroot.config
740 legal-info: dirs legal-info-clean legal-info-prepare $(foreach p,$(PACKAGES),$(p)-all-legal-info) \
741 $(REDIST_SOURCES_DIR_TARGET) $(REDIST_SOURCES_DIR_HOST)
742 @cat support/legal-info/README.header >>$(LEGAL_REPORT)
743 @if [ -r $(LEGAL_WARNINGS) ]; then \
744 cat support/legal-info/README.warnings-header \
745 $(LEGAL_WARNINGS) >>$(LEGAL_REPORT); \
746 cat $(LEGAL_WARNINGS); fi
747 @rm -f $(LEGAL_WARNINGS)
748 @(cd $(LEGAL_INFO_DIR); \
749 find * -type f -exec sha256sum {} + | LC_ALL=C sort -k2 \
750 >.legal-info.sha256; \
751 mv .legal-info.sha256 legal-info.sha256)
752 @echo "Legal info produced in $(LEGAL_INFO_DIR)"
754 show-targets:
755 @echo $(PACKAGES) $(TARGETS_ROOTFS)
757 graph-build: $(O)/build/build-time.log
758 @install -d $(GRAPHS_DIR)
759 $(foreach o,name build duration,./support/scripts/graph-build-time \
760 --type=histogram --order=$(o) --input=$(<) \
761 --output=$(GRAPHS_DIR)/build.hist-$(o).$(BR_GRAPH_OUT) \
762 $(if $(BR2_GRAPH_ALT),--alternate-colors)$(sep))
763 $(foreach t,packages steps,./support/scripts/graph-build-time \
764 --type=pie-$(t) --input=$(<) \
765 --output=$(GRAPHS_DIR)/build.pie-$(t).$(BR_GRAPH_OUT) \
766 $(if $(BR2_GRAPH_ALT),--alternate-colors)$(sep))
768 graph-depends-requirements:
769 @dot -? >/dev/null 2>&1 || \
770 { echo "ERROR: The 'dot' program from Graphviz is needed for graph-depends" >&2; exit 1; }
772 graph-depends: graph-depends-requirements
773 @$(INSTALL) -d $(GRAPHS_DIR)
774 @cd "$(CONFIG_DIR)"; \
775 $(TOPDIR)/support/scripts/graph-depends $(BR2_GRAPH_DEPS_OPTS) \
776 --direct -o $(GRAPHS_DIR)/$(@).dot
777 dot $(BR2_GRAPH_DOT_OPTS) -T$(BR_GRAPH_OUT) \
778 -o $(GRAPHS_DIR)/$(@).$(BR_GRAPH_OUT) \
779 $(GRAPHS_DIR)/$(@).dot
781 graph-size:
782 $(Q)mkdir -p $(GRAPHS_DIR)
783 $(Q)$(TOPDIR)/support/scripts/size-stats --builddir $(BASE_DIR) \
784 --graph $(GRAPHS_DIR)/graph-size.$(BR_GRAPH_OUT) \
785 --file-size-csv $(GRAPHS_DIR)/file-size-stats.csv \
786 --package-size-csv $(GRAPHS_DIR)/package-size-stats.csv
788 check-dependencies:
789 @cd "$(CONFIG_DIR)"; \
790 $(TOPDIR)/support/scripts/graph-depends -C
792 else # ifeq ($(BR2_HAVE_DOT_CONFIG),y)
794 all: menuconfig
796 endif # ifeq ($(BR2_HAVE_DOT_CONFIG),y)
798 # configuration
799 # ---------------------------------------------------------------------------
801 HOSTCFLAGS = $(CFLAGS_FOR_BUILD)
802 export HOSTCFLAGS
804 .PHONY: prepare-kconfig
805 prepare-kconfig: outputmakefile $(BUILD_DIR)/.br2-external.in
807 $(BUILD_DIR)/buildroot-config/%onf:
808 mkdir -p $(@D)/lxdialog
809 PKG_CONFIG_PATH="$(HOST_PKG_CONFIG_PATH)" $(MAKE) CC="$(HOSTCC_NOCCACHE)" HOSTCC="$(HOSTCC_NOCCACHE)" \
810 obj=$(@D) -C $(CONFIG) -f Makefile.br $(@F)
812 DEFCONFIG = $(call qstrip,$(BR2_DEFCONFIG))
814 # We don't want to fully expand BR2_DEFCONFIG here, so Kconfig will
815 # recognize that if it's still at its default $(CONFIG_DIR)/defconfig
816 COMMON_CONFIG_ENV = \
817 BR2_DEFCONFIG='$(call qstrip,$(value BR2_DEFCONFIG))' \
818 KCONFIG_AUTOCONFIG=$(BUILD_DIR)/buildroot-config/auto.conf \
819 KCONFIG_AUTOHEADER=$(BUILD_DIR)/buildroot-config/autoconf.h \
820 KCONFIG_TRISTATE=$(BUILD_DIR)/buildroot-config/tristate.config \
821 BR2_CONFIG=$(BR2_CONFIG) \
822 HOST_GCC_VERSION="$(HOSTCC_VERSION)" \
823 BUILD_DIR=$(BUILD_DIR) \
824 SKIP_LEGACY=
826 xconfig: $(BUILD_DIR)/buildroot-config/qconf prepare-kconfig
827 @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
829 gconfig: $(BUILD_DIR)/buildroot-config/gconf prepare-kconfig
830 @$(COMMON_CONFIG_ENV) srctree=$(TOPDIR) $< $(CONFIG_CONFIG_IN)
832 menuconfig: $(BUILD_DIR)/buildroot-config/mconf prepare-kconfig
833 @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
835 nconfig: $(BUILD_DIR)/buildroot-config/nconf prepare-kconfig
836 @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
838 config: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
839 @$(COMMON_CONFIG_ENV) $< $(CONFIG_CONFIG_IN)
841 # For the config targets that automatically select options, we pass
842 # SKIP_LEGACY=y to disable the legacy options. However, in that case
843 # no values are set for the legacy options so a subsequent oldconfig
844 # will query them. Therefore, run an additional olddefconfig.
846 oldconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
847 @$(COMMON_CONFIG_ENV) $< --oldconfig $(CONFIG_CONFIG_IN)
849 randconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
850 @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y $< --randconfig $(CONFIG_CONFIG_IN)
851 @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
853 allyesconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
854 @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y $< --allyesconfig $(CONFIG_CONFIG_IN)
855 @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
857 allnoconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
858 @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y $< --allnoconfig $(CONFIG_CONFIG_IN)
859 @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
861 randpackageconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
862 @grep -v BR2_PACKAGE_ $(BR2_CONFIG) > $(CONFIG_DIR)/.config.nopkg
863 @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y \
864 KCONFIG_ALLCONFIG=$(CONFIG_DIR)/.config.nopkg \
865 $< --randconfig $(CONFIG_CONFIG_IN)
866 @rm -f $(CONFIG_DIR)/.config.nopkg
867 @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
869 allyespackageconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
870 @grep -v BR2_PACKAGE_ $(BR2_CONFIG) > $(CONFIG_DIR)/.config.nopkg
871 @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y \
872 KCONFIG_ALLCONFIG=$(CONFIG_DIR)/.config.nopkg \
873 $< --allyesconfig $(CONFIG_CONFIG_IN)
874 @rm -f $(CONFIG_DIR)/.config.nopkg
875 @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
877 allnopackageconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
878 @grep -v BR2_PACKAGE_ $(BR2_CONFIG) > $(CONFIG_DIR)/.config.nopkg
879 @$(COMMON_CONFIG_ENV) SKIP_LEGACY=y \
880 KCONFIG_ALLCONFIG=$(CONFIG_DIR)/.config.nopkg \
881 $< --allnoconfig $(CONFIG_CONFIG_IN)
882 @rm -f $(CONFIG_DIR)/.config.nopkg
883 @$(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN) >/dev/null
885 silentoldconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
886 $(COMMON_CONFIG_ENV) $< --silentoldconfig $(CONFIG_CONFIG_IN)
888 olddefconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
889 $(COMMON_CONFIG_ENV) $< --olddefconfig $(CONFIG_CONFIG_IN)
891 defconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
892 @$(COMMON_CONFIG_ENV) $< --defconfig$(if $(DEFCONFIG),=$(DEFCONFIG)) $(CONFIG_CONFIG_IN)
894 define percent_defconfig
895 # Override the BR2_DEFCONFIG from COMMON_CONFIG_ENV with the new defconfig
896 %_defconfig: $(BUILD_DIR)/buildroot-config/conf $(1)/configs/%_defconfig prepare-kconfig
897 @$$(COMMON_CONFIG_ENV) BR2_DEFCONFIG=$(1)/configs/$$@ \
898 $$< --defconfig=$(1)/configs/$$@ $$(CONFIG_CONFIG_IN)
899 endef
900 $(eval $(foreach d,$(call reverse,$(TOPDIR) $(BR2_EXTERNAL_DIRS)),$(call percent_defconfig,$(d))$(sep)))
902 savedefconfig: $(BUILD_DIR)/buildroot-config/conf prepare-kconfig
903 @$(COMMON_CONFIG_ENV) $< \
904 --savedefconfig=$(if $(DEFCONFIG),$(DEFCONFIG),$(CONFIG_DIR)/defconfig) \
905 $(CONFIG_CONFIG_IN)
906 @$(SED) '/BR2_DEFCONFIG=/d' $(if $(DEFCONFIG),$(DEFCONFIG),$(CONFIG_DIR)/defconfig)
908 .PHONY: defconfig savedefconfig
910 ################################################################################
912 # Cleanup and misc junk
914 ################################################################################
916 # outputmakefile generates a Makefile in the output directory, if using a
917 # separate output directory. This allows convenient use of make in the
918 # output directory.
919 outputmakefile:
920 ifeq ($(NEED_WRAPPER),y)
921 $(Q)$(TOPDIR)/support/scripts/mkmakefile $(TOPDIR) $(O)
922 endif
924 # Even though the target is a real file, we mark it as PHONY as we
925 # want it to be re-generated each time make is invoked, in case the
926 # value of BR2_EXTERNAL is changed.
927 .PHONY: $(BUILD_DIR)/.br2-external.in
928 $(BUILD_DIR)/.br2-external.in: $(BUILD_DIR)
929 $(Q)support/scripts/br2-external -k -o "$(@)" $(BR2_EXTERNAL)
931 # printvars prints all the variables currently defined in our
932 # Makefiles. Alternatively, if a non-empty VARS variable is passed,
933 # only the variables matching the make pattern passed in VARS are
934 # displayed.
935 printvars:
936 @$(foreach V, \
937 $(sort $(if $(VARS),$(filter $(VARS),$(.VARIABLES)),$(.VARIABLES))), \
938 $(if $(filter-out environment% default automatic, \
939 $(origin $V)), \
940 $(info $V=$($V) ($(value $V)))))
942 clean:
943 rm -rf $(TARGET_DIR) $(BINARIES_DIR) $(HOST_DIR) \
944 $(BUILD_DIR) $(BASE_DIR)/staging \
945 $(LEGAL_INFO_DIR) $(GRAPHS_DIR)
947 distclean: clean
948 ifeq ($(O),$(CURDIR)/output)
949 rm -rf $(O)
950 endif
951 rm -rf $(TOPDIR)/dl $(BR2_CONFIG) $(CONFIG_DIR)/.config.old $(CONFIG_DIR)/..config.tmp \
952 $(CONFIG_DIR)/.auto.deps $(BR2_EXTERNAL_FILE)
954 help:
955 @echo 'Cleaning:'
956 @echo ' clean - delete all files created by build'
957 @echo ' distclean - delete all non-source files (including .config)'
958 @echo
959 @echo 'Build:'
960 @echo ' all - make world'
961 @echo ' toolchain - build toolchain'
962 @echo
963 @echo 'Configuration:'
964 @echo ' menuconfig - interactive curses-based configurator'
965 @echo ' nconfig - interactive ncurses-based configurator'
966 @echo ' xconfig - interactive Qt-based configurator'
967 @echo ' gconfig - interactive GTK-based configurator'
968 @echo ' oldconfig - resolve any unresolved symbols in .config'
969 @echo ' silentoldconfig - Same as oldconfig, but quietly, additionally update deps'
970 @echo ' olddefconfig - Same as silentoldconfig but sets new symbols to their default value'
971 @echo ' randconfig - New config with random answer to all options'
972 @echo ' defconfig - New config with default answer to all options'
973 @echo ' BR2_DEFCONFIG, if set, is used as input'
974 @echo ' savedefconfig - Save current config to BR2_DEFCONFIG (minimal config)'
975 @echo ' allyesconfig - New config where all options are accepted with yes'
976 @echo ' allnoconfig - New config where all options are answered with no'
977 @echo ' randpackageconfig - New config with random answer to package options'
978 @echo ' allyespackageconfig - New config where pkg options are accepted with yes'
979 @echo ' allnopackageconfig - New config where package options are answered with no'
980 @echo
981 @echo 'Package-specific:'
982 @echo ' <pkg> - Build and install <pkg> and all its dependencies'
983 @echo ' <pkg>-source - Only download the source files for <pkg>'
984 @echo ' <pkg>-extract - Extract <pkg> sources'
985 @echo ' <pkg>-patch - Apply patches to <pkg>'
986 @echo ' <pkg>-depends - Build <pkg>'\''s dependencies'
987 @echo ' <pkg>-configure - Build <pkg> up to the configure step'
988 @echo ' <pkg>-build - Build <pkg> up to the build step'
989 @echo ' <pkg>-show-depends - List packages on which <pkg> depends'
990 @echo ' <pkg>-show-rdepends - List packages which have <pkg> as a dependency'
991 @echo ' <pkg>-graph-depends - Generate a graph of <pkg>'\''s dependencies'
992 @echo ' <pkg>-graph-rdepends - Generate a graph of <pkg>'\''s reverse dependencies'
993 @echo ' <pkg>-dirclean - Remove <pkg> build directory'
994 @echo ' <pkg>-reconfigure - Restart the build from the configure step'
995 @echo ' <pkg>-rebuild - Restart the build from the build step'
996 $(foreach p,$(HELP_PACKAGES), \
997 @echo $(sep) \
998 @echo '$($(p)_NAME):' $(sep) \
999 $($(p)_HELP_CMDS)$(sep))
1000 @echo
1001 @echo 'Documentation:'
1002 @echo ' manual - build manual in all formats'
1003 @echo ' manual-html - build manual in HTML'
1004 @echo ' manual-split-html - build manual in split HTML'
1005 @echo ' manual-pdf - build manual in PDF'
1006 @echo ' manual-text - build manual in text'
1007 @echo ' manual-epub - build manual in ePub'
1008 @echo ' graph-build - generate graphs of the build times'
1009 @echo ' graph-depends - generate graph of the dependency tree'
1010 @echo ' graph-size - generate stats of the filesystem size'
1011 @echo ' list-defconfigs - list all defconfigs (pre-configured minimal systems)'
1012 @echo
1013 @echo 'Miscellaneous:'
1014 @echo ' source - download all sources needed for offline-build'
1015 @echo ' source-check - check selected packages for valid download URLs'
1016 @echo ' external-deps - list external packages used'
1017 @echo ' legal-info - generate info about license compliance'
1018 @echo
1019 @echo ' make V=0|1 - 0 => quiet build (default), 1 => verbose build'
1020 @echo ' make O=dir - Locate all output files in "dir", including .config'
1021 @echo
1022 @echo 'For further details, see README, generate the Buildroot manual, or consult'
1023 @echo 'it on-line at http://buildroot.org/docs.html'
1024 @echo
1026 # List the defconfig files
1027 # $(1): base directory
1028 # $(2): br2-external name, empty for bundled
1029 define list-defconfigs
1030 @first=true; \
1031 for defconfig in $(1)/configs/*_defconfig; do \
1032 [ -f "$${defconfig}" ] || continue; \
1033 if $${first}; then \
1034 if [ "$(2)" ]; then \
1035 printf 'External configs in "$(call qstrip,$(2))":\n'; \
1036 else \
1037 printf "Built-in configs:\n"; \
1038 fi; \
1039 first=false; \
1040 fi; \
1041 defconfig="$${defconfig##*/}"; \
1042 printf " %-35s - Build for %s\n" "$${defconfig}" "$${defconfig%_defconfig}"; \
1043 done; \
1044 $${first} || printf "\n"
1045 endef
1047 # We iterate over BR2_EXTERNAL_NAMES rather than BR2_EXTERNAL_DIRS,
1048 # because we want to display the name of the br2-external tree.
1049 list-defconfigs:
1050 $(call list-defconfigs,$(TOPDIR))
1051 $(foreach name,$(BR2_EXTERNAL_NAMES),\
1052 $(call list-defconfigs,$(BR2_EXTERNAL_$(name)_PATH),\
1053 $(BR2_EXTERNAL_$(name)_DESC))$(sep))
1055 release: OUT = buildroot-$(BR2_VERSION)
1057 # Create release tarballs. We need to fiddle a bit to add the generated
1058 # documentation to the git output
1059 release:
1060 git archive --format=tar --prefix=$(OUT)/ HEAD > $(OUT).tar
1061 $(MAKE) O=$(OUT) manual-html manual-text manual-pdf
1062 $(MAKE) O=$(OUT) manual-clean
1063 tar rf $(OUT).tar $(OUT)
1064 gzip -9 -c < $(OUT).tar > $(OUT).tar.gz
1065 bzip2 -9 -c < $(OUT).tar > $(OUT).tar.bz2
1066 rm -rf $(OUT) $(OUT).tar
1068 print-version:
1069 @echo $(BR2_VERSION_FULL)
1071 .gitlab-ci.yml: .gitlab-ci.yml.in configs/*_defconfig
1072 (cd configs; LC_ALL=C ls -1 *_defconfig) | sed 's/$$/: *defconfig/' | cat $< - > $@
1074 include docs/manual/manual.mk
1075 -include $(foreach dir,$(BR2_EXTERNAL_DIRS),$(dir)/docs/*/*.mk)
1077 .PHONY: $(noconfig_targets)
1079 endif #umask / $(CURDIR) / $(O)