2006-05-14 12:07:53 +00:00
|
|
|
# Makefile for QEMU.
|
|
|
|
|
2019-05-26 14:47:47 +00:00
|
|
|
ifneq ($(words $(subst :, ,$(CURDIR))), 1)
|
|
|
|
$(error main directory cannot contain spaces nor colons)
|
|
|
|
endif
|
|
|
|
|
2011-09-16 19:50:43 +00:00
|
|
|
# Always point to the root of the build tree (needs GNU make).
|
|
|
|
BUILD_DIR=$(CURDIR)
|
2011-09-15 20:45:35 +00:00
|
|
|
|
2015-05-22 05:35:07 +00:00
|
|
|
# Before including a proper config-host.mak, assume we are in the source tree
|
|
|
|
SRC_PATH=.
|
|
|
|
|
2020-09-01 16:10:05 +00:00
|
|
|
# Don't use implicit rules or variables
|
|
|
|
# we have explicit rules for everything
|
|
|
|
MAKEFLAGS += -rR
|
|
|
|
|
2021-07-05 08:25:42 +00:00
|
|
|
SHELL = bash -o pipefail
|
2020-10-14 11:35:13 +00:00
|
|
|
|
2020-09-01 16:10:05 +00:00
|
|
|
# Usage: $(call quiet-command,command and args,"NAME","args to print")
|
|
|
|
# This will run "command and args", and either:
|
|
|
|
# if V=1 just print the whole command and args
|
|
|
|
# otherwise print the 'quiet' output in the format " NAME args to print"
|
|
|
|
# NAME should be a short name of the command, 7 letters or fewer.
|
|
|
|
# If called with only a single argument, will print nothing in quiet mode.
|
|
|
|
quiet-command-run = $(if $(V),,$(if $2,printf " %-7s %s\n" $2 $3 && ))$1
|
|
|
|
quiet-@ = $(if $(V),,@)
|
|
|
|
quiet-command = $(quiet-@)$(call quiet-command-run,$1,$2,$3)
|
|
|
|
|
make: clean after distclean deletes source files
Run 'make distclean' in a tree, and GNUmakefile is removed.
But, GNUmakefile is where we change directory to build.
Run 'make distclean' or 'make clean' again, and Makefile applies
the clean actions, such as this one, at the top level of the tree.
For example, it removes the .d source files in 'meson/test cases/d/*/*.d'.
find . \( -name '*.so' -o -name '*.dll' -o \
-name '*.[oda]' -o -name '*.gcno' \) -type f \
! -path ./roms/edk2/ArmPkg/Library/GccLto/liblto-aarch64.a \
! -path ./roms/edk2/ArmPkg/Library/GccLto/liblto-arm.a \
-exec rm {} +
To fix, remove clean and distclean from UNCHECKED_GOALS, so those targets
are "checked", meaning that configure must be run before make. However,
the check action does not trigger, because clean does not depend on
config-host.mak, so change the action to simply throw an error.
Signed-off-by: Steve Sistare <steven.sistare@oracle.com>
Message-Id: <1681909700-94095-1-git-send-email-steven.sistare@oracle.com>
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
2023-04-19 13:08:20 +00:00
|
|
|
UNCHECKED_GOALS := TAGS gtags cscope ctags dist \
|
2018-01-04 16:05:08 +00:00
|
|
|
help check-help print-% \
|
2019-05-31 06:43:41 +00:00
|
|
|
docker docker-% vm-help vm-test vm-build-%
|
2015-05-22 05:35:07 +00:00
|
|
|
|
2020-10-15 16:20:02 +00:00
|
|
|
all:
|
|
|
|
.PHONY: all clean distclean recurse-all dist msi FORCE
|
|
|
|
|
|
|
|
# Don't try to regenerate Makefile or configure
|
|
|
|
# We don't generate any of them
|
|
|
|
Makefile: ;
|
|
|
|
configure: ;
|
|
|
|
|
2012-03-06 18:50:38 +00:00
|
|
|
# All following code might depend on configuration variables
|
2009-04-15 14:42:57 +00:00
|
|
|
ifneq ($(wildcard config-host.mak),)
|
2006-04-16 12:41:07 +00:00
|
|
|
include config-host.mak
|
2012-10-19 13:54:23 +00:00
|
|
|
|
2022-09-29 11:42:05 +00:00
|
|
|
include Makefile.prereqs
|
|
|
|
Makefile.prereqs: config-host.mak
|
|
|
|
|
2020-08-13 13:28:11 +00:00
|
|
|
# 0. ensure the build tree is okay
|
2019-06-10 10:05:14 +00:00
|
|
|
|
2012-10-19 13:54:23 +00:00
|
|
|
# Check that we're not trying to do an out-of-tree build from
|
|
|
|
# a tree that's been used for an in-tree build.
|
|
|
|
ifneq ($(realpath $(SRC_PATH)),$(realpath .))
|
|
|
|
ifneq ($(wildcard $(SRC_PATH)/config-host.mak),)
|
|
|
|
$(error This is an out of tree build but your source tree ($(SRC_PATH)) \
|
|
|
|
seems to have been used for an in-tree build. You can fix this by running \
|
2017-11-21 09:55:10 +00:00
|
|
|
"$(MAKE) distclean && rm -rf *-linux-user *-softmmu" in your source tree)
|
2012-10-19 13:54:23 +00:00
|
|
|
endif
|
|
|
|
endif
|
|
|
|
|
2020-10-15 16:20:02 +00:00
|
|
|
# force a rerun of configure if config-host.mak is too old or corrupted
|
|
|
|
ifeq ($(MESON),)
|
|
|
|
.PHONY: config-host.mak
|
|
|
|
x := $(shell rm -rf meson-private meson-info meson-logs)
|
|
|
|
endif
|
|
|
|
ifeq ($(NINJA),)
|
|
|
|
.PHONY: config-host.mak
|
|
|
|
x := $(shell rm -rf meson-private meson-info meson-logs)
|
2020-10-23 12:34:54 +00:00
|
|
|
else
|
|
|
|
export NINJA
|
2020-10-15 16:20:02 +00:00
|
|
|
endif
|
|
|
|
ifeq ($(wildcard build.ninja),)
|
|
|
|
.PHONY: config-host.mak
|
|
|
|
x := $(shell rm -rf meson-private meson-info meson-logs)
|
|
|
|
endif
|
2020-10-16 07:19:14 +00:00
|
|
|
ifeq ($(origin prefix),file)
|
|
|
|
.PHONY: config-host.mak
|
|
|
|
x := $(shell rm -rf meson-private meson-info meson-logs)
|
|
|
|
endif
|
2020-10-15 16:20:02 +00:00
|
|
|
|
2020-08-13 13:28:11 +00:00
|
|
|
# 1. ensure config-host.mak is up-to-date
|
2022-06-24 15:02:58 +00:00
|
|
|
config-host.mak: $(SRC_PATH)/configure $(SRC_PATH)/scripts/meson-buildoptions.sh $(SRC_PATH)/VERSION
|
2020-10-23 12:34:54 +00:00
|
|
|
@echo config-host.mak is out-of-date, running configure
|
2019-06-10 10:05:14 +00:00
|
|
|
@if test -f meson-private/coredata.dat; then \
|
|
|
|
./config.status --skip-meson; \
|
|
|
|
else \
|
2020-10-23 12:34:54 +00:00
|
|
|
./config.status && touch build.ninja.stamp; \
|
2019-06-10 10:05:14 +00:00
|
|
|
fi
|
2018-10-21 17:56:29 +00:00
|
|
|
|
2020-10-23 12:34:54 +00:00
|
|
|
# 2. meson.stamp exists if meson has run at least once (so ninja reconfigure
|
|
|
|
# works), but otherwise never needs to be updated
|
|
|
|
meson-private/coredata.dat: meson.stamp
|
|
|
|
meson.stamp: config-host.mak
|
|
|
|
@touch meson.stamp
|
|
|
|
|
|
|
|
# 3. ensure generated build files are up-to-date
|
2020-08-13 13:28:11 +00:00
|
|
|
|
|
|
|
ifneq ($(NINJA),)
|
|
|
|
Makefile.ninja: build.ninja
|
2020-10-23 12:34:54 +00:00
|
|
|
$(quiet-@){ \
|
|
|
|
echo 'ninja-targets = \'; \
|
|
|
|
$(NINJA) -t targets all | sed 's/:.*//; $$!s/$$/ \\/'; \
|
|
|
|
echo 'build-files = \'; \
|
|
|
|
$(NINJA) -t query build.ninja | sed -n '1,/^ input:/d; /^ outputs:/q; s/$$/ \\/p'; \
|
|
|
|
} > $@.tmp && mv $@.tmp $@
|
2020-08-13 13:28:11 +00:00
|
|
|
-include Makefile.ninja
|
2023-05-19 17:32:56 +00:00
|
|
|
endif
|
2020-10-23 12:34:54 +00:00
|
|
|
|
2023-05-19 17:32:56 +00:00
|
|
|
ifneq ($(MESON),)
|
2020-10-23 12:34:54 +00:00
|
|
|
# A separate rule is needed for Makefile dependencies to avoid -n
|
|
|
|
build.ninja: build.ninja.stamp
|
2020-12-16 12:13:40 +00:00
|
|
|
$(build-files):
|
2020-10-23 12:34:54 +00:00
|
|
|
build.ninja.stamp: meson.stamp $(build-files)
|
2023-05-19 17:32:56 +00:00
|
|
|
$(MESON) setup --reconfigure $(SRC_PATH) && touch $@
|
2020-08-13 13:28:11 +00:00
|
|
|
|
2020-10-23 12:34:54 +00:00
|
|
|
Makefile.mtest: build.ninja scripts/mtest2make.py
|
2020-08-13 13:28:11 +00:00
|
|
|
$(MESON) introspect --targets --tests --benchmarks | $(PYTHON) scripts/mtest2make.py > $@
|
|
|
|
-include Makefile.mtest
|
2021-10-07 13:08:28 +00:00
|
|
|
|
|
|
|
.PHONY: update-buildoptions
|
|
|
|
all update-buildoptions: $(SRC_PATH)/scripts/meson-buildoptions.sh
|
|
|
|
$(SRC_PATH)/scripts/meson-buildoptions.sh: $(SRC_PATH)/meson_options.txt
|
|
|
|
$(MESON) introspect --buildoptions $(SRC_PATH)/meson.build | $(PYTHON) \
|
|
|
|
scripts/meson-buildoptions.py > $@.tmp && mv $@.tmp $@
|
2020-08-13 13:28:11 +00:00
|
|
|
endif
|
|
|
|
|
2020-10-23 12:34:54 +00:00
|
|
|
# 4. Rules to bridge to other makefiles
|
2020-08-13 13:28:11 +00:00
|
|
|
|
|
|
|
ifneq ($(NINJA),)
|
2021-07-22 02:08:46 +00:00
|
|
|
# Filter out long options to avoid flags like --no-print-directory which
|
|
|
|
# may result in false positive match for MAKE.n
|
|
|
|
MAKE.n = $(findstring n,$(firstword $(filter-out --%,$(MAKEFLAGS))))
|
|
|
|
MAKE.k = $(findstring k,$(firstword $(filter-out --%,$(MAKEFLAGS))))
|
|
|
|
MAKE.q = $(findstring q,$(firstword $(filter-out --%,$(MAKEFLAGS))))
|
2020-10-26 15:58:54 +00:00
|
|
|
MAKE.nq = $(if $(word 2, $(MAKE.n) $(MAKE.q)),nq)
|
|
|
|
NINJAFLAGS = $(if $V,-v) $(if $(MAKE.n), -n) $(if $(MAKE.k), -k0) \
|
2020-08-13 13:28:11 +00:00
|
|
|
$(filter-out -j, $(lastword -j1 $(filter -l% -j%, $(MAKEFLAGS)))) \
|
2022-05-27 15:35:43 +00:00
|
|
|
-d keepdepfile
|
2020-08-13 13:28:11 +00:00
|
|
|
ninja-cmd-goals = $(or $(MAKECMDGOALS), all)
|
2022-09-14 14:19:36 +00:00
|
|
|
ninja-cmd-goals += $(foreach g, $(MAKECMDGOALS), $(.ninja-goals.$g))
|
2020-08-13 13:28:11 +00:00
|
|
|
|
2023-01-10 15:12:50 +00:00
|
|
|
makefile-targets := build.ninja ctags TAGS cscope dist clean
|
2020-10-23 12:34:54 +00:00
|
|
|
# "ninja -t targets" also lists all prerequisites. If build system
|
|
|
|
# files are marked as PHONY, however, Make will always try to execute
|
|
|
|
# "ninja build.ninja".
|
|
|
|
ninja-targets := $(filter-out $(build-files) $(makefile-targets), $(ninja-targets))
|
2020-08-13 13:28:11 +00:00
|
|
|
.PHONY: $(ninja-targets) run-ninja
|
|
|
|
$(ninja-targets): run-ninja
|
|
|
|
|
|
|
|
# Use "| cat" to give Ninja a more "make-y" output. Use "+" to bypass the
|
|
|
|
# --output-sync line.
|
|
|
|
run-ninja: config-host.mak
|
|
|
|
ifneq ($(filter $(ninja-targets), $(ninja-cmd-goals)),)
|
2022-05-27 15:35:43 +00:00
|
|
|
+$(if $(MAKE.nq),@:,$(quiet-@)$(NINJA) $(NINJAFLAGS) \
|
|
|
|
$(sort $(filter $(ninja-targets), $(ninja-cmd-goals))) | cat)
|
2020-08-13 13:28:11 +00:00
|
|
|
endif
|
|
|
|
endif
|
|
|
|
|
2018-10-21 17:56:29 +00:00
|
|
|
ifeq ($(CONFIG_PLUGIN),y)
|
2020-09-09 11:27:41 +00:00
|
|
|
.PHONY: plugins
|
|
|
|
plugins:
|
|
|
|
$(call quiet-command,\
|
|
|
|
$(MAKE) $(SUBDIR_MAKEFLAGS) -C contrib/plugins V="$(V)", \
|
|
|
|
"BUILD", "example plugins")
|
2020-10-15 16:20:02 +00:00
|
|
|
endif # $(CONFIG_PLUGIN)
|
2018-10-21 17:56:29 +00:00
|
|
|
|
2020-10-15 16:20:02 +00:00
|
|
|
else # config-host.mak does not exist
|
2015-05-22 05:35:07 +00:00
|
|
|
ifneq ($(filter-out $(UNCHECKED_GOALS),$(MAKECMDGOALS)),$(if $(MAKECMDGOALS),,fail))
|
make: clean after distclean deletes source files
Run 'make distclean' in a tree, and GNUmakefile is removed.
But, GNUmakefile is where we change directory to build.
Run 'make distclean' or 'make clean' again, and Makefile applies
the clean actions, such as this one, at the top level of the tree.
For example, it removes the .d source files in 'meson/test cases/d/*/*.d'.
find . \( -name '*.so' -o -name '*.dll' -o \
-name '*.[oda]' -o -name '*.gcno' \) -type f \
! -path ./roms/edk2/ArmPkg/Library/GccLto/liblto-aarch64.a \
! -path ./roms/edk2/ArmPkg/Library/GccLto/liblto-arm.a \
-exec rm {} +
To fix, remove clean and distclean from UNCHECKED_GOALS, so those targets
are "checked", meaning that configure must be run before make. However,
the check action does not trigger, because clean does not depend on
config-host.mak, so change the action to simply throw an error.
Signed-off-by: Steve Sistare <steven.sistare@oracle.com>
Message-Id: <1681909700-94095-1-git-send-email-steven.sistare@oracle.com>
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
2023-04-19 13:08:20 +00:00
|
|
|
$(error Please call configure before running make)
|
2009-04-15 14:42:57 +00:00
|
|
|
endif
|
2020-10-15 16:20:02 +00:00
|
|
|
endif # config-host.mak does not exist
|
2003-02-18 23:35:48 +00:00
|
|
|
|
2020-09-01 16:10:05 +00:00
|
|
|
SUBDIR_MAKEFLAGS=$(if $(V),,--no-print-directory --quiet)
|
2009-11-22 16:25:30 +00:00
|
|
|
|
2016-06-01 02:23:31 +00:00
|
|
|
include $(SRC_PATH)/tests/Makefile.include
|
2012-12-21 07:34:49 +00:00
|
|
|
|
2019-12-12 12:30:36 +00:00
|
|
|
all: recurse-all
|
2019-02-12 16:25:23 +00:00
|
|
|
|
2022-09-29 11:41:56 +00:00
|
|
|
ROMS_RULES=$(foreach t, all clean distclean, $(addsuffix /$(t), $(ROMS)))
|
2022-04-13 13:22:01 +00:00
|
|
|
.PHONY: $(ROMS_RULES)
|
|
|
|
$(ROMS_RULES):
|
2020-08-31 12:36:27 +00:00
|
|
|
$(call quiet-command,$(MAKE) $(SUBDIR_MAKEFLAGS) -C $(dir $@) V="$(V)" TARGET_DIR="$(dir $@)" $(notdir $@),)
|
2009-07-31 12:18:32 +00:00
|
|
|
|
2020-08-05 11:05:13 +00:00
|
|
|
.PHONY: recurse-all recurse-clean
|
2022-04-13 13:22:01 +00:00
|
|
|
recurse-all: $(addsuffix /all, $(ROMS))
|
|
|
|
recurse-clean: $(addsuffix /clean, $(ROMS))
|
2022-09-29 11:41:56 +00:00
|
|
|
recurse-distclean: $(addsuffix /distclean, $(ROMS))
|
2006-08-01 16:21:11 +00:00
|
|
|
|
2011-05-15 08:51:28 +00:00
|
|
|
######################################################################
|
2007-11-07 19:24:02 +00:00
|
|
|
|
2020-08-13 13:28:11 +00:00
|
|
|
clean: recurse-clean
|
2020-11-05 12:44:56 +00:00
|
|
|
-$(quiet-@)test -f build.ninja && $(NINJA) $(NINJAFLAGS) -t clean || :
|
|
|
|
-$(quiet-@)test -f build.ninja && $(NINJA) $(NINJAFLAGS) clean-ctlist || :
|
2022-02-04 20:43:12 +00:00
|
|
|
find . \( -name '*.so' -o -name '*.dll' -o \
|
|
|
|
-name '*.[oda]' -o -name '*.gcno' \) -type f \
|
2019-02-04 16:03:21 +00:00
|
|
|
! -path ./roms/edk2/ArmPkg/Library/GccLto/liblto-aarch64.a \
|
|
|
|
! -path ./roms/edk2/ArmPkg/Library/GccLto/liblto-arm.a \
|
|
|
|
-exec rm {} +
|
2021-10-13 11:51:32 +00:00
|
|
|
rm -f TAGS cscope.* *~ */*~
|
2003-02-18 22:55:36 +00:00
|
|
|
|
2020-08-04 16:14:26 +00:00
|
|
|
VERSION = $(shell cat $(SRC_PATH)/VERSION)
|
2012-07-17 18:33:32 +00:00
|
|
|
|
|
|
|
dist: qemu-$(VERSION).tar.bz2
|
|
|
|
|
|
|
|
qemu-%.tar.bz2:
|
|
|
|
$(SRC_PATH)/scripts/make-release "$(SRC_PATH)" "$(patsubst qemu-%.tar.bz2,%,$@)"
|
|
|
|
|
2022-09-29 11:41:56 +00:00
|
|
|
distclean: clean recurse-distclean
|
2020-11-05 12:44:56 +00:00
|
|
|
-$(quiet-@)test -f build.ninja && $(NINJA) $(NINJAFLAGS) -t clean -g || :
|
2023-03-01 11:19:10 +00:00
|
|
|
rm -f config-host.mak Makefile.prereqs
|
2022-09-29 11:42:07 +00:00
|
|
|
rm -f tests/tcg/*/config-target.mak tests/tcg/config-host.mak
|
2021-10-13 11:51:32 +00:00
|
|
|
rm -f config.status
|
|
|
|
rm -f roms/seabios/config.mak
|
2018-10-21 17:56:29 +00:00
|
|
|
rm -f qemu-plugins-ld.symbols qemu-plugins-ld64.symbols
|
2020-08-03 15:04:25 +00:00
|
|
|
rm -f *-config-target.h *-config-devices.mak *-config-devices.h
|
2019-06-10 10:05:14 +00:00
|
|
|
rm -rf meson-private meson-logs meson-info compile_commands.json
|
2020-10-23 12:34:54 +00:00
|
|
|
rm -f Makefile.ninja Makefile.mtest build.ninja.stamp meson.stamp
|
2011-07-26 03:56:02 +00:00
|
|
|
rm -f config.log
|
2012-02-01 18:50:42 +00:00
|
|
|
rm -f linux-headers/asm
|
2023-03-01 11:19:10 +00:00
|
|
|
rm -Rf .sdk qemu-bundle
|
2003-03-06 23:23:54 +00:00
|
|
|
|
2021-08-04 13:23:28 +00:00
|
|
|
find-src-path = find "$(SRC_PATH)" -path "$(SRC_PATH)/meson" -prune -o \
|
|
|
|
-type l -prune -o \( -name "*.[chsS]" -o -name "*.[ch].inc" \)
|
2020-09-03 19:47:55 +00:00
|
|
|
|
2020-09-01 14:20:10 +00:00
|
|
|
.PHONY: ctags
|
|
|
|
ctags:
|
2021-01-14 16:57:23 +00:00
|
|
|
$(call quiet-command, \
|
|
|
|
rm -f "$(SRC_PATH)/"tags, \
|
|
|
|
"CTAGS", "Remove old tags")
|
|
|
|
$(call quiet-command, \
|
|
|
|
$(find-src-path) -exec ctags \
|
|
|
|
-f "$(SRC_PATH)/"tags --append {} +, \
|
|
|
|
"CTAGS", "Re-index $(SRC_PATH)")
|
2020-09-01 14:20:10 +00:00
|
|
|
|
2021-01-14 16:57:20 +00:00
|
|
|
.PHONY: gtags
|
|
|
|
gtags:
|
|
|
|
$(call quiet-command, \
|
|
|
|
rm -f "$(SRC_PATH)/"GTAGS; \
|
|
|
|
rm -f "$(SRC_PATH)/"GRTAGS; \
|
|
|
|
rm -f "$(SRC_PATH)/"GPATH, \
|
|
|
|
"GTAGS", "Remove old $@ files")
|
|
|
|
$(call quiet-command, \
|
|
|
|
(cd $(SRC_PATH) && \
|
2021-08-04 13:23:27 +00:00
|
|
|
$(find-src-path) -print | gtags -f -), \
|
2021-01-14 16:57:20 +00:00
|
|
|
"GTAGS", "Re-index $(SRC_PATH)")
|
|
|
|
|
2020-09-01 14:20:10 +00:00
|
|
|
.PHONY: TAGS
|
|
|
|
TAGS:
|
2021-01-14 16:57:24 +00:00
|
|
|
$(call quiet-command, \
|
|
|
|
rm -f "$(SRC_PATH)/"TAGS, \
|
|
|
|
"TAGS", "Remove old $@")
|
|
|
|
$(call quiet-command, \
|
|
|
|
$(find-src-path) -exec etags \
|
|
|
|
-f "$(SRC_PATH)/"TAGS --append {} +, \
|
|
|
|
"TAGS", "Re-index $(SRC_PATH)")
|
2020-09-01 14:20:10 +00:00
|
|
|
|
|
|
|
.PHONY: cscope
|
|
|
|
cscope:
|
2021-01-14 16:57:25 +00:00
|
|
|
$(call quiet-command, \
|
|
|
|
rm -f "$(SRC_PATH)/"cscope.* , \
|
|
|
|
"cscope", "Remove old $@ files")
|
|
|
|
$(call quiet-command, \
|
|
|
|
($(find-src-path) -print | sed -e 's,^\./,,' \
|
|
|
|
> "$(SRC_PATH)/cscope.files"), \
|
|
|
|
"cscope", "Create file list")
|
|
|
|
$(call quiet-command, \
|
|
|
|
cscope -b -i"$(SRC_PATH)/cscope.files" \
|
|
|
|
-f"$(SRC_PATH)"/cscope.out, \
|
|
|
|
"cscope", "Re-index $(SRC_PATH)")
|
2020-09-01 14:20:10 +00:00
|
|
|
|
2019-06-10 10:05:14 +00:00
|
|
|
# Needed by "meson install"
|
|
|
|
export DESTDIR
|
2003-03-22 17:31:19 +00:00
|
|
|
|
2022-01-05 13:49:42 +00:00
|
|
|
include $(SRC_PATH)/tests/lcitool/Makefile.include
|
Makefile: Rules for docker testing
This adds a group of make targets to run docker tests, all are available
in source tree without running ./configure.
The usage is shown with "make docker".
Besides the fixed ones, dynamic targets for building each image and
running each test in each image are generated automatically by make,
scanning $(SRC_PATH)/tests/docker/ files with specific patterns.
Alternative to manually list particular targets (docker-TEST@IMAGE)
set, you can control which tests/images to run by filtering variables,
TESTS= and IMAGES=, which are expressed in Makefile pattern syntax,
"foo% %bar ...". For example:
$ make docker-test IMAGES="ubuntu fedora"
Unfortunately, it's impossible to propagate "-j $JOBS" into make in
containers, however since each combination is made a first class target
in the top Makefile, "make -j$N docker-test" still parallels the tests
coarsely.
Still, $J is made a magic variable to let all make invocations in
containers to use -j$J.
Instead of providing a live version of the source tree to the docker
container we snapshot it with git-archive. This ensures the tree is in a
pristine state for whatever operations the container is going to run on
them.
Uncommitted changes known to files known by the git index will be
included in the snapshot if there are any.
Signed-off-by: Fam Zheng <famz@redhat.com>
Signed-off-by: Alex Bennée <alex.bennee@linaro.org>
Message-id: 1464755128-32490-5-git-send-email-famz@redhat.com
2016-06-01 04:25:17 +00:00
|
|
|
include $(SRC_PATH)/tests/docker/Makefile.include
|
2017-09-05 02:11:58 +00:00
|
|
|
include $(SRC_PATH)/tests/vm/Makefile.include
|
2016-09-13 14:20:33 +00:00
|
|
|
|
2020-03-05 00:48:54 +00:00
|
|
|
print-help-run = printf " %-30s - %s\\n" "$1" "$2"
|
2020-11-05 15:47:00 +00:00
|
|
|
print-help = @$(call print-help-run,$1,$2)
|
2020-03-05 00:48:54 +00:00
|
|
|
|
2016-09-13 14:20:33 +00:00
|
|
|
.PHONY: help
|
|
|
|
help:
|
|
|
|
@echo 'Generic targets:'
|
2020-03-05 00:48:54 +00:00
|
|
|
$(call print-help,all,Build all)
|
|
|
|
$(call print-help,dir/file.o,Build specified target only)
|
|
|
|
$(call print-help,install,Install QEMU, documentation and tools)
|
2021-01-14 16:57:20 +00:00
|
|
|
$(call print-help,ctags/gtags/TAGS,Generate tags file for editors)
|
2020-03-05 00:48:54 +00:00
|
|
|
$(call print-help,cscope,Generate cscope index)
|
2020-02-03 13:45:33 +00:00
|
|
|
$(call print-help,sparse,Run sparse on the QEMU source)
|
2016-09-13 14:20:33 +00:00
|
|
|
@echo ''
|
2020-09-09 11:27:41 +00:00
|
|
|
ifeq ($(CONFIG_PLUGIN),y)
|
|
|
|
@echo 'Plugin targets:'
|
|
|
|
$(call print-help,plugins,Build the example TCG plugins)
|
|
|
|
@echo ''
|
|
|
|
endif
|
2016-09-13 14:20:33 +00:00
|
|
|
@echo 'Cleaning targets:'
|
2020-03-05 00:48:54 +00:00
|
|
|
$(call print-help,clean,Remove most generated files but keep the config)
|
|
|
|
$(call print-help,distclean,Remove all generated files)
|
|
|
|
$(call print-help,dist,Build a distributable tarball)
|
2016-09-13 14:20:33 +00:00
|
|
|
@echo ''
|
|
|
|
@echo 'Test targets:'
|
2020-03-05 00:48:54 +00:00
|
|
|
$(call print-help,check,Run all tests (check-help for details))
|
2020-09-02 11:25:19 +00:00
|
|
|
$(call print-help,bench,Run all benchmarks)
|
2022-01-05 13:49:42 +00:00
|
|
|
$(call print-help,lcitool-help,Help about targets for managing build environment manifests)
|
2021-02-02 13:39:50 +00:00
|
|
|
$(call print-help,docker-help,Help about targets running tests inside containers)
|
2020-03-05 00:48:54 +00:00
|
|
|
$(call print-help,vm-help,Help about targets running tests inside VM)
|
2016-09-13 14:20:33 +00:00
|
|
|
@echo ''
|
|
|
|
@echo 'Documentation targets:'
|
docs/interop: Convert qemu-qmp-ref to rST
Convert qemu-qmp-ref to rST format. This includes dropping
the plain-text, pdf and info format outputs for this document;
as with all our other Sphinx-based documentation, we provide
HTML and manpage only.
The qemu-qmp-ref.rst is somewhat more stripped down than
the .texi was, because we do not (currently) attempt to
generate indexes for the commands, events and data types
being documented.
Again, we drop the direct link from index.html.in now that
the QMP ref is part of the interop manual.
This commit removes the code from the root meson.build file that
handled the various Texinfo-based outputs, because we no longer
generate any documentation except for the Sphinx HTML manuals and the
manpages, and the code can't handle having an empty list of files
to process.. We'll do further cleanup of the remainders of
Texinfo support in subsequent commits.
Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
Message-Id: <20200925162316.21205-10-peter.maydell@linaro.org>
Reviewed-by: Markus Armbruster <armbru@redhat.com>
[Unicode legacy literal dumbed down to plain string literal, TODO
comment on displaying QEMU version added, "make html" fixed,
storage-daemon/qapi/meson.build updated]
Signed-off-by: Markus Armbruster <armbru@redhat.com>
2020-09-25 16:23:04 +00:00
|
|
|
$(call print-help,html man,Build documentation in specified format)
|
2016-09-13 14:20:33 +00:00
|
|
|
@echo ''
|
|
|
|
ifdef CONFIG_WIN32
|
|
|
|
@echo 'Windows targets:'
|
2020-03-05 00:48:54 +00:00
|
|
|
$(call print-help,installer,Build NSIS-based installer for QEMU)
|
|
|
|
$(call print-help,msi,Build MSI-based installer for qemu-ga)
|
2016-09-13 14:20:33 +00:00
|
|
|
@echo ''
|
|
|
|
endif
|
2020-03-05 00:48:54 +00:00
|
|
|
$(call print-help,$(MAKE) [targets],(quiet build, default))
|
|
|
|
$(call print-help,$(MAKE) V=1 [targets],(verbose build))
|
2020-09-01 16:10:05 +00:00
|
|
|
|
|
|
|
# will delete the target of a rule if commands exit with a nonzero exit status
|
|
|
|
.DELETE_ON_ERROR:
|
|
|
|
|
|
|
|
print-%:
|
|
|
|
@echo '$*=$($*)'
|