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