qemu-devel.nongnu.org archive mirror
 help / color / mirror / Atom feed
From: "Alex Bennée" <alex.bennee@linaro.org>
To: qemu-devel@nongnu.org
Cc: "Thomas Huth" <thuth@redhat.com>,
	"Daniel P. Berrangé" <berrange@redhat.com>,
	"Paolo Bonzini" <pbonzini@redhat.com>,
	"Alex Bennée" <alex.bennee@linaro.org>,
	"Philippe Mathieu-Daudé" <philmd@linaro.org>,
	"Manos Pitsidianakis" <manos.pitsidianakis@linaro.org>,
	"Richard Henderson" <richard.henderson@linaro.org>
Subject: [PATCH for 10.1 v2 03/14] docs/user: clean up headings
Date: Fri, 25 Jul 2025 16:45:06 +0100	[thread overview]
Message-ID: <20250725154517.3523095-4-alex.bennee@linaro.org> (raw)
In-Reply-To: <20250725154517.3523095-1-alex.bennee@linaro.org>

This was a slightly duff format for rst, make it use proper headings.

Reviewed-by: Manos Pitsidianakis <manos.pitsidianakis@linaro.org>
Reviewed-by: Richard Henderson <richard.henderson@linaro.org>
Signed-off-by: Alex Bennée <alex.bennee@linaro.org>
---
 docs/user/main.rst | 50 ++++++++++++++++++++++++++--------------------
 1 file changed, 28 insertions(+), 22 deletions(-)

diff --git a/docs/user/main.rst b/docs/user/main.rst
index 9a1c60448c5..b8ff203c212 100644
--- a/docs/user/main.rst
+++ b/docs/user/main.rst
@@ -17,28 +17,34 @@ Features
 
 QEMU user space emulation has the following notable features:
 
-**System call translation:**
-   QEMU includes a generic system call translator. This means that the
-   parameters of the system calls can be converted to fix endianness and
-   32/64-bit mismatches between hosts and targets. IOCTLs can be
-   converted too.
-
-**POSIX signal handling:**
-   QEMU can redirect to the running program all signals coming from the
-   host (such as ``SIGALRM``), as well as synthesize signals from
-   virtual CPU exceptions (for example ``SIGFPE`` when the program
-   executes a division by zero).
-
-   QEMU relies on the host kernel to emulate most signal system calls,
-   for example to emulate the signal mask. On Linux, QEMU supports both
-   normal and real-time signals.
-
-**Threading:**
-   On Linux, QEMU can emulate the ``clone`` syscall and create a real
-   host thread (with a separate virtual CPU) for each emulated thread.
-   Note that not all targets currently emulate atomic operations
-   correctly. x86 and Arm use a global lock in order to preserve their
-   semantics.
+System call translation
+~~~~~~~~~~~~~~~~~~~~~~~
+
+QEMU includes a generic system call translator. This means that the
+parameters of the system calls can be converted to fix endianness
+and 32/64-bit mismatches between hosts and targets. IOCTLs can be
+converted too.
+
+POSIX signal handling
+~~~~~~~~~~~~~~~~~~~~~
+
+QEMU can redirect to the running program all signals coming from the
+host (such as ``SIGALRM``), as well as synthesize signals from
+virtual CPU exceptions (for example ``SIGFPE`` when the program
+executes a division by zero).
+
+QEMU relies on the host kernel to emulate most signal system calls,
+for example to emulate the signal mask. On Linux, QEMU supports both
+normal and real-time signals.
+
+Threading
+~~~~~~~~~
+
+On Linux, QEMU can emulate the ``clone`` syscall and create a real
+host thread (with a separate virtual CPU) for each emulated thread.
+Note that not all targets currently emulate atomic operations
+correctly. x86 and Arm use a global lock in order to preserve their
+semantics.
 
 QEMU was conceived so that ultimately it can emulate itself. Although it
 is not very useful, it is an important test to show the power of the
-- 
2.47.2



  parent reply	other threads:[~2025-07-25 15:46 UTC|newest]

Thread overview: 16+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2025-07-25 15:45 [PATCH for 10.1 v2 00/14] documentation updates and test tweaks pre-PR Alex Bennée
2025-07-25 15:45 ` [PATCH for 10.1 v2 01/14] docs/user: clarify user-mode expects the same OS Alex Bennée
2025-07-25 15:45 ` [PATCH for 10.1 v2 02/14] docs/system: reword the TAP notes to remove tarball ref Alex Bennée
2025-07-25 15:45 ` Alex Bennée [this message]
2025-07-25 15:45 ` [PATCH for 10.1 v2 04/14] docs/user: slightly reword section on system calls Alex Bennée
2025-07-25 15:45 ` [PATCH for 10.1 v2 05/14] docs/user: expand section on threading Alex Bennée
2025-07-25 19:57   ` Richard Henderson
2025-07-25 15:45 ` [PATCH for 10.1 v2 06/14] tests/functional: add hypervisor test for aarch64 Alex Bennée
2025-07-25 15:45 ` [PATCH for 10.1 v2 07/14] tests/tcg: skip libsyscall.so on softmmu tests Alex Bennée
2025-07-25 15:45 ` [PATCH for 10.1 v2 08/14] tests/tcg: remove ADDITIONAL_PLUGINS_TESTS Alex Bennée
2025-07-25 15:45 ` [PATCH for 10.1 v2 09/14] tests/tcg: don't include multiarch tests if not supported Alex Bennée
2025-07-25 15:45 ` [PATCH for 10.1 v2 10/14] configure: expose PYTHON to test/tcg/config-host.mak Alex Bennée
2025-07-25 15:45 ` [PATCH for 10.1 v2 11/14] tests/tcg: reduce the number of plugin tests combinations Alex Bennée
2025-07-25 15:45 ` [PATCH for 10.1 v2 12/14] tests/docker: add --arch-only to qemu deps for all-test-cross Alex Bennée
2025-07-25 15:45 ` [PATCH for 10.1 v2 13/14] tests/docker: handle host-arch selection " Alex Bennée
2025-07-25 15:45 ` [PATCH for 10.1 v2 14/14] tests/functional: expose sys.argv to unittest.main 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=20250725154517.3523095-4-alex.bennee@linaro.org \
    --to=alex.bennee@linaro.org \
    --cc=berrange@redhat.com \
    --cc=manos.pitsidianakis@linaro.org \
    --cc=pbonzini@redhat.com \
    --cc=philmd@linaro.org \
    --cc=qemu-devel@nongnu.org \
    --cc=richard.henderson@linaro.org \
    --cc=thuth@redhat.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).