xref: /qemu/tests/Makefile.include (revision 727385c4)
1# -*- Mode: makefile -*-
2
3.PHONY: check-help
4check-help:
5	@echo "Regression testing targets:"
6	@echo " $(MAKE) check                Run block, qapi-schema, unit, softfloat, qtest and decodetree tests"
7	@echo " $(MAKE) bench                Run speed tests"
8	@echo
9	@echo "Individual test suites:"
10	@echo " $(MAKE) check-qtest-TARGET   Run qtest tests for given target"
11	@echo " $(MAKE) check-qtest          Run qtest tests"
12	@echo " $(MAKE) check-unit           Run qobject tests"
13	@echo " $(MAKE) check-qapi-schema    Run QAPI schema tests"
14	@echo " $(MAKE) check-block          Run block tests"
15ifneq ($(filter $(all-check-targets), check-softfloat),)
16	@echo " $(MAKE) check-tcg            Run TCG tests"
17	@echo " $(MAKE) check-softfloat      Run FPU emulation tests"
18endif
19	@echo " $(MAKE) check-avocado        Run avocado (integration) tests for currently configured targets"
20	@echo
21	@echo " $(MAKE) check-report.tap     Generates an aggregated TAP test report"
22	@echo " $(MAKE) check-venv           Creates a Python venv for tests"
23	@echo " $(MAKE) check-clean          Clean the tests and related data"
24	@echo
25	@echo "The following are useful for CI builds"
26	@echo " $(MAKE) check-build          Build most test binaris"
27	@echo " $(MAKE) get-vm-images        Downloads all images used by avocado tests, according to configured targets (~350 MB each, 1.5 GB max)"
28	@echo
29	@echo
30	@echo "The variable SPEED can be set to control the gtester speed setting."
31	@echo "Default options are -k and (for $(MAKE) V=1) --verbose; they can be"
32	@echo "changed with variable GTESTER_OPTIONS."
33
34ifneq ($(wildcard config-host.mak),)
35export SRC_PATH
36
37# Get the list of all supported sysemu targets
38SYSEMU_TARGET_LIST := $(subst -softmmu.mak,,$(notdir \
39   $(wildcard $(SRC_PATH)/configs/*-softmmu.mak)))
40
41SPEED = quick
42
43# Build up our target list from the filtered list of ninja targets
44TARGETS=$(patsubst libqemu-%.fa, %, $(filter libqemu-%.fa, $(ninja-targets)))
45
46# Per guest TCG tests
47BUILD_TCG_TARGET_RULES=$(patsubst %,build-tcg-tests-%, $(TARGETS))
48CLEAN_TCG_TARGET_RULES=$(patsubst %,clean-tcg-tests-%, $(TARGETS))
49RUN_TCG_TARGET_RULES=$(patsubst %,run-tcg-tests-%, $(TARGETS))
50
51# Probe for the Docker Builds needed for each build
52$(foreach PROBE_TARGET,$(TARGET_DIRS), 				\
53	$(eval -include $(SRC_PATH)/tests/tcg/Makefile.prereqs))
54
55$(BUILD_TCG_TARGET_RULES): build-tcg-tests-%: $(if $(CONFIG_PLUGIN),test-plugins)
56	$(call quiet-command,$(MAKE) $(SUBDIR_MAKEFLAGS) \
57		-f $(SRC_PATH)/tests/tcg/Makefile.qemu \
58		SRC_PATH=$(SRC_PATH) \
59	       	V="$(V)" TARGET="$*" guest-tests, \
60		"BUILD", "TCG tests for $*")
61
62$(RUN_TCG_TARGET_RULES): run-tcg-tests-%: build-tcg-tests-% all
63	$(call quiet-command,$(MAKE) $(SUBDIR_MAKEFLAGS) \
64		-f $(SRC_PATH)/tests/tcg/Makefile.qemu \
65		SRC_PATH=$(SRC_PATH) SPEED="$(SPEED)" \
66		V="$(V)" TARGET="$*" run-guest-tests, \
67		"RUN", "TCG tests for $*")
68
69$(CLEAN_TCG_TARGET_RULES): clean-tcg-tests-%:
70	$(call quiet-command,$(MAKE) $(SUBDIR_MAKEFLAGS) \
71		-f $(SRC_PATH)/tests/tcg/Makefile.qemu \
72		SRC_PATH=$(SRC_PATH) TARGET="$*" clean-guest-tests, \
73		"CLEAN", "TCG tests for $*")
74
75.PHONY: build-tcg
76build-tcg: $(BUILD_TCG_TARGET_RULES)
77
78.PHONY: check-tcg
79check-tcg: $(RUN_TCG_TARGET_RULES)
80
81.PHONY: clean-tcg
82clean-tcg: $(CLEAN_TCG_TARGET_RULES)
83
84# Python venv for running tests
85
86.PHONY: check-venv check-avocado check-acceptance check-acceptance-deprecated-warning
87
88TESTS_VENV_DIR=$(BUILD_DIR)/tests/venv
89TESTS_VENV_REQ=$(SRC_PATH)/tests/requirements.txt
90TESTS_RESULTS_DIR=$(BUILD_DIR)/tests/results
91ifndef AVOCADO_TESTS
92	AVOCADO_TESTS=tests/avocado
93endif
94# Controls the output generated by Avocado when running tests.
95# Any number of command separated loggers are accepted.  For more
96# information please refer to "avocado --help".
97AVOCADO_SHOW=app
98ifndef AVOCADO_TAGS
99	AVOCADO_CMDLINE_TAGS=$(patsubst %-softmmu,-t arch:%, \
100						 $(filter %-softmmu,$(TARGETS)))
101else
102	AVOCADO_CMDLINE_TAGS=$(addprefix -t , $(AVOCADO_TAGS))
103endif
104
105$(TESTS_VENV_DIR): $(TESTS_VENV_REQ)
106	$(call quiet-command, \
107            $(PYTHON) -m venv $@, \
108            VENV, $@)
109	$(call quiet-command, \
110            $(TESTS_VENV_DIR)/bin/python -m pip -q install -r $(TESTS_VENV_REQ), \
111            PIP, $(TESTS_VENV_REQ))
112	$(call quiet-command, touch $@)
113
114$(TESTS_RESULTS_DIR):
115	$(call quiet-command, mkdir -p $@, \
116            MKDIR, $@)
117
118check-venv: $(TESTS_VENV_DIR)
119
120FEDORA_31_ARCHES_TARGETS=$(patsubst %-softmmu,%, $(filter %-softmmu,$(TARGETS)))
121FEDORA_31_ARCHES_CANDIDATES=$(patsubst ppc64,ppc64le,$(FEDORA_31_ARCHES_TARGETS))
122FEDORA_31_ARCHES := x86_64 aarch64 ppc64le s390x
123FEDORA_31_DOWNLOAD=$(filter $(FEDORA_31_ARCHES),$(FEDORA_31_ARCHES_CANDIDATES))
124
125# download one specific Fedora 31 image
126get-vm-image-fedora-31-%: check-venv
127	$(call quiet-command, \
128             $(TESTS_VENV_DIR)/bin/python -m avocado vmimage get \
129             --distro=fedora --distro-version=31 --arch=$*, \
130	"AVOCADO", "Downloading avocado tests VM image for $*")
131
132# download all vm images, according to defined targets
133get-vm-images: check-venv $(patsubst %,get-vm-image-fedora-31-%, $(FEDORA_31_DOWNLOAD))
134
135check-avocado: check-venv $(TESTS_RESULTS_DIR) get-vm-images
136	$(call quiet-command, \
137            $(TESTS_VENV_DIR)/bin/python -m avocado \
138            --show=$(AVOCADO_SHOW) run --job-results-dir=$(TESTS_RESULTS_DIR) \
139            $(if $(AVOCADO_TAGS),, --filter-by-tags-include-empty \
140			--filter-by-tags-include-empty-key) \
141            $(AVOCADO_CMDLINE_TAGS) \
142            $(if $(GITLAB_CI),,--failfast) $(AVOCADO_TESTS), \
143            "AVOCADO", "tests/avocado")
144
145check-acceptance-deprecated-warning:
146	@echo
147	@echo "Note '$(MAKE) check-acceptance' is deprecated, use '$(MAKE) check-avocado' instead."
148	@echo
149
150check-acceptance: check-acceptance-deprecated-warning | check-avocado
151
152# Consolidated targets
153
154.PHONY: check-block check check-clean get-vm-images
155check:
156
157ifeq ($(CONFIG_TOOLS)$(CONFIG_POSIX),yy)
158check: check-block
159export PYTHON
160
161ifneq ($(filter check check-block check-build, $(MAKECMDGOALS)),)
162ninja-cmd-goals += \
163	qemu-img$(EXESUF) \
164	qemu-io$(EXESUF) \
165	qemu-nbd$(EXESUF) \
166	storage-daemon/qemu-storage-daemon$(EXESUF) \
167	$(filter qemu-system-%, $(ninja-targets))
168endif
169
170check-block: $(SRC_PATH)/tests/check-block.sh run-ninja
171	@$<
172endif
173
174check-build: run-ninja
175
176check-clean:
177	rm -rf $(TESTS_VENV_DIR) $(TESTS_RESULTS_DIR)
178
179clean: check-clean
180
181endif
182