[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH v2 4/6] docs/devel: expand on use of containers to build tests
From: |
Alex Bennée |
Subject: |
[PATCH v2 4/6] docs/devel: expand on use of containers to build tests |
Date: |
Mon, 22 Feb 2021 10:14:53 +0000 |
Expand on the usage of containers for building tests and why we have
some that are not used to build QEMU itself.
Signed-off-by: Alex Bennée <alex.bennee@linaro.org>
Cc: Thomas Huth <thuth@redhat.com>
---
docs/devel/testing.rst | 21 ++++++++++++++-------
1 file changed, 14 insertions(+), 7 deletions(-)
diff --git a/docs/devel/testing.rst b/docs/devel/testing.rst
index 00ce16de48..488d4e3537 100644
--- a/docs/devel/testing.rst
+++ b/docs/devel/testing.rst
@@ -272,10 +272,10 @@ Note that the following group names have a special
meaning:
- disabled: Tests in this group are disabled and ignored by check.
-.. _docker-ref:
+.. _container-ref:
-Docker based tests
-==================
+Container based tests
+=====================
Introduction
------------
@@ -1001,10 +1001,17 @@ for the architecture in question, for example::
There is also a ``--cross-cc-flags-ARCH`` flag in case additional
compiler flags are needed to build for a given target.
-If you have the ability to run containers as the user you can also
-take advantage of the build systems "Docker" support. It will then use
-containers to build any test case for an enabled guest where there is
-no system compiler available. See :ref:`docker-ref` for details.
+If you have the ability to run containers as the user the build system
+will automatically use them where no system compiler is available. For
+architectures where we also support building QEMU we will generally
+use the same container to build tests. However there are a number of
+additional containers defined that have a minimal cross-build
+environment that is only suitable for building test cases. Sometimes
+we may use a bleeding edge distribution for compiler features needed
+for test cases that aren't yet in the LTS distros we support for QEMU
+itself.
+
+See :ref:`container-ref` for more details.
Running subset of tests
-----------------------
--
2.20.1
- [PATCH v2 0/6] testing/next (meson check-tcg, fedora bump, docs), Alex Bennée, 2021/02/22
- [PATCH v2 1/6] meson.build: expose TCG cross compiler information in summary, Alex Bennée, 2021/02/22
- [PATCH v2 2/6] docker: Bump Fedora images to release 33, Alex Bennée, 2021/02/22
- [PATCH v2 3/6] tests/acceptance: allow a "graceful" failing for virtio-gpu test, Alex Bennée, 2021/02/22
- [PATCH v2 4/6] docs/devel: expand on use of containers to build tests,
Alex Bennée <=
- [PATCH v2 6/6] docs/devel: add forward reference to check-tcg, Alex Bennée, 2021/02/22
- [PATCH v2 5/6] docs/devel: update the container based tests, Alex Bennée, 2021/02/22
- Re: [PATCH v2 0/6] testing/next (meson check-tcg, fedora bump, docs), Richard Henderson, 2021/02/23