diff options
author | Alex Bennée <alex.bennee@linaro.org> | 2023-11-20 15:08:26 +0000 |
---|---|---|
committer | Alex Bennée <alex.bennee@linaro.org> | 2023-11-23 14:10:06 +0000 |
commit | ef073ebd329aecc5f31a3a9d6e355e367f5bfb99 (patch) | |
tree | 7d35f0a62e13b185fd4385a4817836bb2e1b0ed7 | |
parent | 1be75e24e88020c8a2329c2dbf0f3460300eb2df (diff) |
docs/emulation: expand warning about semihosting
A surprising feature of calls like SYS_READC is this can cause QEMU to
indefinitely block as there is no handling for EOF.
Clarifies: https://gitlab.com/qemu-project/qemu/-/issues/1963
Reviewed-by: Richard Henderson <richard.henderson@linaro.org>
Signed-off-by: Alex Bennée <alex.bennee@linaro.org>
Message-Id: <20231120150833.2552739-8-alex.bennee@linaro.org>
-rw-r--r-- | docs/about/emulation.rst | 5 |
1 files changed, 3 insertions, 2 deletions
diff --git a/docs/about/emulation.rst b/docs/about/emulation.rst index 0ad0b86f0d..a2eefe3f3f 100644 --- a/docs/about/emulation.rst +++ b/docs/about/emulation.rst @@ -129,8 +129,9 @@ causing most hypervisors to trap and fault on them. .. warning:: Semihosting inherently bypasses any isolation there may be between the guest and the host. As a result a program using semihosting can - happily trash your host system. You should only ever run trusted - code with semihosting enabled. + happily trash your host system. Some semihosting calls (e.g. + ``SYS_READC``) can block execution indefinitely. You should only + ever run trusted code with semihosting enabled. Redirection ~~~~~~~~~~~ |