From: "Alex Bennée" <alex.bennee@linaro.org>
To: qemu-devel@nongnu.org
Cc: "Eduardo Habkost" <eduardo@habkost.net>,
"Thomas Huth" <thuth@redhat.com>,
"Beraldo Leal" <bleal@redhat.com>,
"Palmer Dabbelt" <palmer@dabbelt.com>,
"Alex Bennée" <alex.bennee@linaro.org>,
"Bin Meng" <bmeng.cn@gmail.com>,
"Paolo Bonzini" <pbonzini@redhat.com>,
"Philippe Mathieu-Daudé" <philmd@linaro.org>,
qemu-riscv@nongnu.org, "Weiwei Li" <liwei1518@gmail.com>,
"Pierrick Bouvier" <pierrick.bouvier@linaro.org>,
"Peter Maydell" <peter.maydell@linaro.org>,
"Richard Henderson" <richard.henderson@linaro.org>,
"Liu Zhiwei" <zhiwei_liu@linux.alibaba.com>,
"Daniel Henrique Barboza" <dbarboza@ventanamicro.com>,
qemu-s390x@nongnu.org, "Cleber Rosa" <crosa@redhat.com>,
"Ilya Leoshkevich" <iii@linux.ibm.com>,
"Mahmoud Mandour" <ma.mandourr@gmail.com>,
qemu-arm@nongnu.org, "Alexandre Iooss" <erdnaxe@crans.org>,
"Song Gao" <gaosong@loongson.cn>,
"David Hildenbrand" <david@redhat.com>,
"Alistair Francis" <alistair.francis@wdc.com>,
"Wainer dos Santos Moschetta" <wainersm@redhat.com>
Subject: [PATCH 06/14] docs/devel: update the testing introduction
Date: Mon, 29 Jul 2024 15:44:06 +0100 [thread overview]
Message-ID: <20240729144414.830369-7-alex.bennee@linaro.org> (raw)
In-Reply-To: <20240729144414.830369-1-alex.bennee@linaro.org>
Move the mention of "check-help" up to the intro text and also mention
the meson test integration.
Signed-off-by: Alex Bennée <alex.bennee@linaro.org>
---
docs/devel/testing.rst | 21 ++++++++++++++++++---
1 file changed, 18 insertions(+), 3 deletions(-)
diff --git a/docs/devel/testing.rst b/docs/devel/testing.rst
index 23d3f44f52..b984c5dd26 100644
--- a/docs/devel/testing.rst
+++ b/docs/devel/testing.rst
@@ -3,13 +3,28 @@
Testing in QEMU
===============
-This document describes the testing infrastructure in QEMU.
+QEMU's testing infrastructure is fairly complex as it covers
+everything from unit testing and exercising specific sub-systems all
+the way to full blown acceptance tests. To get an overview of the
+tests you can run ``make check-help`` from either the source or build
+tree.
+
+Most (but not all) tests are also integrated into the meson build
+system so can be run directly from the build tree, for example:
+
+.. code::
+
+ [./pyvenv/bin/]meson test --suite qemu:softfloat
+
+will run just the softfloat tests.
+
+The rest of this document will cover the details for specific test
+groups.
Testing with "make check"
-------------------------
-The "make check" testing family includes most of the C based tests in QEMU. For
-a quick help, run ``make check-help`` from the source tree.
+The "make check" testing family includes most of the C based tests in QEMU.
The usual way to run these tests is:
--
2.39.2
next prev parent reply other threads:[~2024-07-29 14:46 UTC|newest]
Thread overview: 27+ messages / expand[flat|nested] mbox.gz Atom feed top
2024-07-29 14:44 [PATCH 00/14] Various fixes and tweaks for 9.1-rc0/1 Alex Bennée
2024-07-29 14:44 ` [PATCH 01/14] gitlab: record installed packages in /packages.txt in containers Alex Bennée
2024-07-29 22:21 ` Richard Henderson
2024-07-29 14:44 ` [PATCH 02/14] gitlab: display /packages.txt in build jobs Alex Bennée
2024-07-29 22:22 ` Richard Henderson
2024-07-29 14:44 ` [PATCH 03/14] tests/tcg: Use --noexecstack with assembler files Alex Bennée
2024-07-29 14:44 ` [PATCH 04/14] tests/tcg/loongarch64: Use --no-warn-rwx-segments to link system tests Alex Bennée
2024-07-29 14:44 ` [PATCH 05/14] tests/tcg: update README Alex Bennée
2024-07-29 22:23 ` Richard Henderson
2024-07-29 14:44 ` Alex Bennée [this message]
2024-07-29 22:24 ` [PATCH 06/14] docs/devel: update the testing introduction Richard Henderson
2024-07-29 14:44 ` [PATCH 07/14] docs/devel: document how to run individual TCG tests Alex Bennée
2024-07-29 22:25 ` Richard Henderson
2024-07-29 14:44 ` [PATCH 08/14] tests/avocado: remove tcg_plugins virt_mem_icount test Alex Bennée
2024-07-29 22:26 ` Richard Henderson
2024-08-12 6:25 ` Thomas Huth
2024-07-29 14:44 ` [PATCH 09/14] tests/tcg: move test plugins into tcg subdir Alex Bennée
2024-07-29 15:15 ` Philippe Mathieu-Daudé
2024-07-29 22:27 ` Richard Henderson
2024-07-29 14:44 ` [PATCH 10/14] docs: split TCG plugin usage from devel section Alex Bennée
2024-07-29 22:29 ` Richard Henderson
2024-07-29 14:44 ` [PATCH 11/14] contrib/plugins/cache.c: Remove redundant check of l2_access Alex Bennée
2024-07-29 22:30 ` Richard Henderson
2024-07-29 14:44 ` [PATCH 12/14] contrib/plugins: be more vocal building Alex Bennée
2024-07-29 14:44 ` [PATCH 13/14] contrib/plugins: add compat for g_memdup2 Alex Bennée
2024-07-29 15:16 ` Philippe Mathieu-Daudé
2024-07-29 14:44 ` [PATCH 14/14] plugin/loader: handle basic help query Alex Bennée
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20240729144414.830369-7-alex.bennee@linaro.org \
--to=alex.bennee@linaro.org \
--cc=alistair.francis@wdc.com \
--cc=bleal@redhat.com \
--cc=bmeng.cn@gmail.com \
--cc=crosa@redhat.com \
--cc=david@redhat.com \
--cc=dbarboza@ventanamicro.com \
--cc=eduardo@habkost.net \
--cc=erdnaxe@crans.org \
--cc=gaosong@loongson.cn \
--cc=iii@linux.ibm.com \
--cc=liwei1518@gmail.com \
--cc=ma.mandourr@gmail.com \
--cc=palmer@dabbelt.com \
--cc=pbonzini@redhat.com \
--cc=peter.maydell@linaro.org \
--cc=philmd@linaro.org \
--cc=pierrick.bouvier@linaro.org \
--cc=qemu-arm@nongnu.org \
--cc=qemu-devel@nongnu.org \
--cc=qemu-riscv@nongnu.org \
--cc=qemu-s390x@nongnu.org \
--cc=richard.henderson@linaro.org \
--cc=thuth@redhat.com \
--cc=wainersm@redhat.com \
--cc=zhiwei_liu@linux.alibaba.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).