diff options
author | Peter Maydell <peter.maydell@linaro.org> | 2023-04-17 17:40:36 +0100 |
---|---|---|
committer | Peter Maydell <peter.maydell@linaro.org> | 2023-05-02 15:47:40 +0100 |
commit | 060e0cd7519ada4019e513fce1af4dc307002b7c (patch) | |
tree | ce33200098da11accbc76149a2c1eaa5b6d4229a /docs/user | |
parent | e99c1f89b2c9e779f17f3abab48ca78392977741 (diff) | |
download | qemu-060e0cd7519ada4019e513fce1af4dc307002b7c.zip qemu-060e0cd7519ada4019e513fce1af4dc307002b7c.tar.gz qemu-060e0cd7519ada4019e513fce1af4dc307002b7c.tar.bz2 |
bsd-user: Add '-one-insn-per-tb' option equivalent to '-singlestep'
The '-singlestep' option is confusing, because it doesn't actually
have anything to do with single-stepping the CPU. What it does do
is force TCG emulation to put one guest instruction in each TB,
which can be useful in some situations.
Create a new command line argument -one-insn-per-tb, so we can
document that -singlestep is just a deprecated synonym for it,
and eventually perhaps drop it.
Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
Reviewed-by: Warner Losh <imp@bsdimp.com>
Reviewed-by: Richard Henderson <richard.henderson@linaro.org>
Reviewed-by: Philippe Mathieu-Daudé <philmd@linaro.org>
Message-id: 20230417164041.684562-6-peter.maydell@linaro.org
Diffstat (limited to 'docs/user')
-rw-r--r-- | docs/user/main.rst | 7 |
1 files changed, 6 insertions, 1 deletions
diff --git a/docs/user/main.rst b/docs/user/main.rst index f9ac701..f478635 100644 --- a/docs/user/main.rst +++ b/docs/user/main.rst @@ -247,5 +247,10 @@ Debug options: ``-p pagesize`` Act as if the host page size was 'pagesize' bytes +``-one-insn-per-tb`` + Run the emulation with one guest instruction per translation block. + This slows down emulation a lot, but can be useful in some situations, + such as when trying to analyse the logs produced by the ``-d`` option. + ``-singlestep`` - Run the emulation in single step mode. + This is a deprecated synonym for the ``-one-insn-per-tb`` option. |