xref: /qemu/tests/Makefile.include (revision d45c8332)
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 binaries"
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
37SPEED = quick
38
39-include tests/tcg/Makefile.prereqs
40config-host.mak: $(SRC_PATH)/tests/tcg/configure.sh
41tests/tcg/Makefile.prereqs: config-host.mak
42
43# Per guest TCG tests
44BUILD_TCG_TARGET_RULES=$(patsubst %,build-tcg-tests-%, $(TCG_TESTS_TARGETS))
45CLEAN_TCG_TARGET_RULES=$(patsubst %,clean-tcg-tests-%, $(TCG_TESTS_TARGETS))
46RUN_TCG_TARGET_RULES=$(patsubst %,run-tcg-tests-%, $(TCG_TESTS_TARGETS))
47
48$(foreach TARGET,$(TCG_TESTS_TARGETS), \
49        $(eval $(BUILD_DIR)/tests/tcg/config-$(TARGET).mak: config-host.mak))
50
51.PHONY: $(TCG_TESTS_TARGETS:%=build-tcg-tests-%)
52$(TCG_TESTS_TARGETS:%=build-tcg-tests-%): build-tcg-tests-%: $(BUILD_DIR)/tests/tcg/config-%.mak
53	$(call quiet-command, \
54            $(MAKE) -C tests/tcg/$* -f ../Makefile.target $(SUBDIR_MAKEFLAGS) \
55                        DOCKER_SCRIPT="$(DOCKER_SCRIPT)" \
56                        TARGET="$*" SRC_PATH="$(SRC_PATH)", \
57        "BUILD","$* guest-tests")
58
59.PHONY: $(TCG_TESTS_TARGETS:%=run-tcg-tests-%)
60$(TCG_TESTS_TARGETS:%=run-tcg-tests-%): run-tcg-tests-%: build-tcg-tests-% $(if $(CONFIG_PLUGIN),test-plugins)
61	$(call quiet-command, \
62           $(MAKE) -C tests/tcg/$* -f ../Makefile.target $(SUBDIR_MAKEFLAGS) \
63                        TARGET="$*" SRC_PATH="$(SRC_PATH)" SPEED=$(SPEED) run, \
64        "RUN", "$* guest-tests")
65
66.PHONY: $(TCG_TESTS_TARGETS:%=clean-tcg-tests-%)
67$(TCG_TESTS_TARGETS:%=clean-tcg-tests-%): clean-tcg-tests-%:
68	$(call quiet-command, \
69           $(MAKE) -C tests/tcg/$* -f ../Makefile.target $(SUBDIR_MAKEFLAGS) \
70                        TARGET="$*" SRC_PATH="$(SRC_PATH)" clean, \
71        "CLEAN", "$* guest-tests")
72
73.PHONY: build-tcg
74build-tcg: $(BUILD_TCG_TARGET_RULES)
75
76.PHONY: check-tcg
77check-tcg: $(RUN_TCG_TARGET_RULES)
78
79.PHONY: clean-tcg
80clean-tcg: $(CLEAN_TCG_TARGET_RULES)
81
82# Python venv for running tests
83
84.PHONY: check-venv check-avocado check-acceptance check-acceptance-deprecated-warning
85
86# Build up our target list from the filtered list of ninja targets
87TARGETS=$(patsubst libqemu-%.fa, %, $(filter libqemu-%.fa, $(ninja-targets)))
88
89TESTS_VENV_DIR=$(BUILD_DIR)/tests/venv
90TESTS_VENV_REQ=$(SRC_PATH)/tests/requirements.txt
91TESTS_RESULTS_DIR=$(BUILD_DIR)/tests/results
92ifndef AVOCADO_TESTS
93	AVOCADO_TESTS=tests/avocado
94endif
95# Controls the output generated by Avocado when running tests.
96# Any number of command separated loggers are accepted.  For more
97# information please refer to "avocado --help".
98AVOCADO_SHOW=app
99ifndef AVOCADO_TAGS
100	AVOCADO_CMDLINE_TAGS=$(patsubst %-softmmu,-t arch:%, \
101						 $(filter %-softmmu,$(TARGETS)))
102else
103	AVOCADO_CMDLINE_TAGS=$(addprefix -t , $(AVOCADO_TAGS))
104endif
105
106$(TESTS_VENV_DIR): $(TESTS_VENV_REQ)
107	$(call quiet-command, \
108            $(PYTHON) -m venv $@, \
109            VENV, $@)
110	$(call quiet-command, \
111            $(TESTS_VENV_DIR)/bin/python -m pip -q install -r $(TESTS_VENV_REQ), \
112            PIP, $(TESTS_VENV_REQ))
113	$(call quiet-command, touch $@)
114
115$(TESTS_RESULTS_DIR):
116	$(call quiet-command, mkdir -p $@, \
117            MKDIR, $@)
118
119check-venv: $(TESTS_VENV_DIR)
120
121FEDORA_31_ARCHES_TARGETS=$(patsubst %-softmmu,%, $(filter %-softmmu,$(TARGETS)))
122FEDORA_31_ARCHES_CANDIDATES=$(patsubst ppc64,ppc64le,$(FEDORA_31_ARCHES_TARGETS))
123FEDORA_31_ARCHES := x86_64 aarch64 ppc64le s390x
124FEDORA_31_DOWNLOAD=$(filter $(FEDORA_31_ARCHES),$(FEDORA_31_ARCHES_CANDIDATES))
125
126# download one specific Fedora 31 image
127get-vm-image-fedora-31-%: check-venv
128	$(call quiet-command, \
129             $(TESTS_VENV_DIR)/bin/python -m avocado vmimage get \
130             --distro=fedora --distro-version=31 --arch=$*, \
131	"AVOCADO", "Downloading avocado tests VM image for $*")
132
133# download all vm images, according to defined targets
134get-vm-images: check-venv $(patsubst %,get-vm-image-fedora-31-%, $(FEDORA_31_DOWNLOAD))
135
136check-avocado: check-venv $(TESTS_RESULTS_DIR) get-vm-images
137	$(call quiet-command, \
138            $(TESTS_VENV_DIR)/bin/python -m avocado \
139            --show=$(AVOCADO_SHOW) run --job-results-dir=$(TESTS_RESULTS_DIR) \
140            $(if $(AVOCADO_TAGS),, --filter-by-tags-include-empty \
141			--filter-by-tags-include-empty-key) \
142            $(AVOCADO_CMDLINE_TAGS) \
143            $(if $(GITLAB_CI),,--failfast) $(AVOCADO_TESTS), \
144            "AVOCADO", "tests/avocado")
145
146check-acceptance-deprecated-warning:
147	@echo
148	@echo "Note '$(MAKE) check-acceptance' is deprecated, use '$(MAKE) check-avocado' instead."
149	@echo
150
151check-acceptance: check-acceptance-deprecated-warning | check-avocado
152
153# Consolidated targets
154
155.PHONY: check check-clean get-vm-images
156check:
157
158check-build: run-ninja
159
160check-clean:
161	rm -rf $(TESTS_VENV_DIR) $(TESTS_RESULTS_DIR)
162
163clean: check-clean clean-tcg
164
165endif
166