[PATCH v3 04/10] linux-user: Add '-one-insn-per-tb' option equivalent to '-singlestep'

[Philippe Mathieu-Daudé]

On 20/4/23 11:19, Peter Maydell wrote:
> On Thu, 20 Apr 2023 at 10:13, Philippe Mathieu-Daudé <philmd at linaro.org> wrote:
>>
>> On 17/4/23 18:40, Peter Maydell wrote:
>>> 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 at linaro.org>
>>> Reviewed-by: Richard Henderson <richard.henderson at linaro.org>
>>> Reviewed-by: Warner Losh <imp at bsdimp.com>
>>> ---
>>>    docs/user/main.rst | 7 ++++++-
>>>    linux-user/main.c  | 9 ++++++---
>>>    2 files changed, 12 insertions(+), 4 deletions(-)
>>
>>
>>> @@ -500,8 +500,11 @@ static const struct qemu_argument arg_table[] = {
>>>         "logfile",     "write logs to 'logfile' (default stderr)"},
>>>        {"p",          "QEMU_PAGESIZE",    true,  handle_arg_pagesize,
>>>         "pagesize",   "set the host page size to 'pagesize'"},
>>> -    {"singlestep", "QEMU_SINGLESTEP",  false, handle_arg_singlestep,
>>> -     "",           "run in singlestep mode"},
>>> +    {"one-insn-per-tb",
>>> +                   "QEMU_ONE_INSN_PER_TB",  false, handle_arg_one_insn_per_tb,
>>> +     "",           "run with one guest instruction per emulated TB"},
>>> +    {"singlestep", "QEMU_SINGLESTEP",  false, handle_arg_one_insn_per_tb,
>>> +     "",           "deprecated synonym for -one-insn-per-tb"},
>>
>> Maybe worth mentioning QEMU_ONE_INSN_PER_TB too here:
>>
>>     "deprecated synonyms for -one-insn-per-tb and QEMU_ONE_INSN_PER_TB"
> 
> There's not a lot of space in the -help output, and I think in
> context it's clear enough without.

Fine.