tests/Makefile.include

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