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>
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



  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).