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>
Subject: [PATCH for 10.1 v2 04/14] docs/user: slightly reword section on system calls
Date: Fri, 25 Jul 2025 16:45:07 +0100 [thread overview]
Message-ID: <20250725154517.3523095-5-alex.bennee@linaro.org> (raw)
In-Reply-To: <20250725154517.3523095-1-alex.bennee@linaro.org>
Expand the description slightly and quote ioctl(). I did ponder
mentioning something about why DRM ioctls are often missing but I see
we have the I915 ones so I guess its just no one has done them.
Reviewed-by: Manos Pitsidianakis <manos.pitsidianakis@linaro.org>
Signed-off-by: Alex Bennée <alex.bennee@linaro.org>
---
docs/user/main.rst | 12 ++++++++----
1 file changed, 8 insertions(+), 4 deletions(-)
diff --git a/docs/user/main.rst b/docs/user/main.rst
index b8ff203c212..05de904225c 100644
--- a/docs/user/main.rst
+++ b/docs/user/main.rst
@@ -20,10 +20,14 @@ 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.
+System calls are the principle interface between user-space and the
+kernel. Generally the same system calls exist on all versions of the
+kernel so QEMU includes a generic system call translator. The
+translator takes care of adjusting endianess, 32/64 bit parameter size
+and then calling the equivalent host system call.
+
+QEMU can also adjust device specific ``ioctl()`` calls in a similar
+fashion.
POSIX signal handling
~~~~~~~~~~~~~~~~~~~~~
--
2.47.2
next prev 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 ` [PATCH for 10.1 v2 03/14] docs/user: clean up headings Alex Bennée
2025-07-25 15:45 ` Alex Bennée [this message]
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-5-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=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).