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.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
  34 ifneq ($(wildcard config-host.mak),)
  35 export SRC_PATH
  36
  37 # Get the list of all supported sysemu targets
  38 SYSEMU_TARGET_LIST := $(subst -softmmu.mak,,$(notdir \
  39    $(wildcard $(SRC_PATH)/configs/*-softmmu.mak)))
  40
  41 SPEED = quick
  42
  43 # Build up our target list from the filtered list of ninja targets
  44 TARGETS=$(patsubst libqemu-%.fa, %, $(filter libqemu-%.fa, $(ninja-targets)))
  45
  46 # Per guest TCG tests
  47 BUILD_TCG_TARGET_RULES=$(patsubst %,build-tcg-tests-%, $(TARGETS))
  48 CLEAN_TCG_TARGET_RULES=$(patsubst %,clean-tcg-tests-%, $(TARGETS))
  49 RUN_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
  76 build-tcg: $(BUILD_TCG_TARGET_RULES)
  77
  78 .PHONY: check-tcg
  79 check-tcg: $(RUN_TCG_TARGET_RULES)
  80
  81 .PHONY: clean-tcg
  82 clean-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
  88 TESTS_VENV_DIR=$(BUILD_DIR)/tests/venv
  89 TESTS_VENV_REQ=$(SRC_PATH)/tests/requirements.txt
  90 TESTS_RESULTS_DIR=$(BUILD_DIR)/tests/results
  91 ifndef AVOCADO_TESTS
  92         AVOCADO_TESTS=tests/avocado
  93 endif
  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".
  97 AVOCADO_SHOW=app
  98 ifndef AVOCADO_TAGS
  99         AVOCADO_CMDLINE_TAGS=$(patsubst %-softmmu,-t arch:%, \
 100                                                  $(filter %-softmmu,$(TARGETS)))
 101 else
 102         AVOCADO_CMDLINE_TAGS=$(addprefix -t , $(AVOCADO_TAGS))
 103 endif
 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
 118 check-venv: $(TESTS_VENV_DIR)
 119
 120 FEDORA_31_ARCHES_TARGETS=$(patsubst %-softmmu,%, $(filter %-softmmu,$(TARGETS)))
 121 FEDORA_31_ARCHES_CANDIDATES=$(patsubst ppc64,ppc64le,$(FEDORA_31_ARCHES_TARGETS))
 122 FEDORA_31_ARCHES := x86_64 aarch64 ppc64le s390x
 123 FEDORA_31_DOWNLOAD=$(filter $(FEDORA_31_ARCHES),$(FEDORA_31_ARCHES_CANDIDATES))
 124
 125 # download one specific Fedora 31 image
 126 get-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
 133 get-vm-images: check-venv $(patsubst %,get-vm-image-fedora-31-%, $(FEDORA_31_DOWNLOAD))
 134
 135 check-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
 145 check-acceptance-deprecated-warning:
 146         @echo
 147         @echo "Note '$(MAKE) check-acceptance' is deprecated, use '$(MAKE) check-avocado' instead."
 148         @echo
 149
 150 check-acceptance: check-acceptance-deprecated-warning | check-avocado
 151
 152 # Consolidated targets
 153
 154 .PHONY: check-block check check-clean get-vm-images
 155 check:
 156
 157 ifeq ($(CONFIG_TOOLS)$(CONFIG_POSIX),yy)
 158 check: check-block
 159 check-block: run-ninja
 160         $(if $(MAKE.n),,+)$(MESON) test $(MTESTARGS) $(.mtestargs) --verbose \
 161                 --logbase iotestslog $(call .speed.$(SPEED), block block-slow block-thorough)
 162 endif
 163
 164 check-build: run-ninja
 165
 166 check-clean:
 167         rm -rf $(TESTS_VENV_DIR) $(TESTS_RESULTS_DIR)
 168
 169 clean: check-clean
 170
 171 endif