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.

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

On Thu, Jul 24, 2025 at 2:00 PM Alex Bennée <alex.bennee@linaro.org> wrote:
>
> 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.
>
> 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
>
>

Reviewed-by: Manos Pitsidianakis <manos.pitsidianakis@linaro.org>