Testing QEMU

Details about how to test QEMU and how it is integrated into our CI testing infrastructure.

• Testing in QEMU
  • Testing with “make check”
    • Unit tests
    • QTest
    • Writing portable test cases
    • QAPI schema tests
    • check-block
  • QEMU iotests
    • Writing a new test case
    • Debugging a test case
    • Test case groups
  • Container based tests
    • Introduction
    • Docker Prerequisites
    • Podman Prerequisites
    • Quickstart
    • Registry
    • Images
    • Tests
    • Debugging a Docker test failure
    • Options
  • Thread Sanitizer
    • Thread Sanitizer in Docker
    • Building and Testing with TSan
    • TSan Suppressions
    • TSan Annotations
  • docker-binfmt-image-debian-% targets
    • Setting up binfmt_misc
    • Example invocation
  • VM testing
    • Quickstart
    • QEMU binaries
    • Make jobs
    • Debugging
    • Manual invocation
    • Adding new guests
  • Image fuzzer testing
  • Functional tests using Python
  • Integration tests using the Avocado Framework
  • Testing with “make check-tcg”
    • Running subset of tests
    • Running individual tests
    • TCG test dependencies
  • Other TCG Tests
    • KVM Unit Tests
    • Linux Test Project
  • GCC gcov support
• QTest Device Emulation Testing Framework
  • Qtest Driver Framework
    • QGraph concepts
    • Creating a new driver and its interface
    • Adding a new test
    • Qgraph API reference
  • QTest Protocol
    • Valid requests
  • libqtest API reference
• Functional testing with Python
  • Running tests
  • Overview
    • The qemu_test.QemuSystemTest base test class
  • QEMUMachine
    • QEMU binary selection
  • Attribute reference
    • QemuBaseTest
    • QemuUserTest
    • QemuSystemTest
  • Asset handling
  • Skipping tests
    • QEMU_TEST_ALLOW_LARGE_STORAGE
    • QEMU_TEST_ALLOW_UNTRUSTED_CODE
    • QEMU_TEST_FLAKY_TESTS
• Integration testing with Avocado
  • Running tests
  • Manual Installation
  • Overview
    • The avocado_qemu.QemuSystemTest base test class
    • The avocado_qemu.LinuxTest base test class
  • QEMUMachine
    • QEMU binary selection
  • Attribute reference
    • Test
    • LinuxTest
  • Parameter reference
    • Test
    • LinuxTest
  • Skipping tests
    • AVOCADO_ALLOW_LARGE_STORAGE
    • SPEED
    • AVOCADO_ALLOW_UNTRUSTED_CODE
    • AVOCADO_TIMEOUT_EXPECTED
    • QEMU_TEST_FLAKY_TESTS
  • Uninstalling Avocado
• ACPI/SMBIOS testing using biosbits
  • Introduction
  • Description of the test framework
• CI
  • Definition of terms
    • Automated tests
    • Unit testing
    • Functional testing
    • System testing
    • Flaky tests
    • Gating
    • Continuous Integration (CI)
    • References
  • Custom CI/CD variables
    • Set variable globally in the user’s CI namespace
    • Set variable manually when pushing a branch or tag to the user’s repository
    • Setting aliases in your git config
    • Variable naming and grouping
    • Maintainer controlled job variables
    • Contributor controlled runtime variables
    • Other misc variables
  • Jobs on Custom Runners
    • Machine Setup Howto
• Fuzzing
  • Basics
  • Building the fuzzers
  • Useful libFuzzer flags
  • Generating Coverage Reports
  • Adding a new fuzzer
  • The Generic Fuzzer
  • OSS-Fuzz
  • Building Crash Reproducers
  • Implementation Details / Fuzzer Lifecycle
• Block I/O error injection using blkdebug
  • Background
  • Rules
  • Events
  • State transitions
  • Suspend and resume
• Block driver correctness testing with blkverify
  • Introduction
  • How it works
  • Example