qmp: Redo how the client requests out-of-band execution

Commit cf869d5317 "qmp: support out-of-band (oob) execution" added a
general mechanism for command-independent arguments just for an
out-of-band flag:

    The "control" key is introduced to store this extra flag.  "control"
    field is used to store arguments that are shared by all the commands,
    rather than command specific arguments.  Let "run-oob" be the first.

However, it failed to reject unknown members of "control".  For
instance, in QMP command

    {"execute": "query-name", "id": 42, "control": {"crap": true}}

"crap" gets silently ignored.

Instead of fixing this, revert the general "control" mechanism
(because YAGNI), and do it the way I initially proposed, with key
"exec-oob".  Simpler code, simpler interface.

An out-of-band command

    {"execute": "migrate-pause", "id": 42, "control": {"run-oob": true}}

becomes

    {"exec-oob": "migrate-pause", "id": 42}

Signed-off-by: Markus Armbruster <armbru@redhat.com>
Reviewed-by: Eric Blake <eblake@redhat.com>
Message-Id: <20180703085358.13941-13-armbru@redhat.com>
[Commit message typo fixed]
This commit is contained in:
Markus Armbruster 2018-07-03 10:53:38 +02:00
parent 674ed7228f
commit 00ecec151d
6 changed files with 39 additions and 53 deletions

View file

@ -649,13 +649,11 @@ example:
{ 'command': 'migrate_recover',
'data': { 'uri': 'str' }, 'allow-oob': true }
To execute a command with out-of-band priority, the client specifies
the "control" field in the request, with "run-oob" set to
true. Example:
To execute a command with out-of-band priority, the client uses key
"exec-oob" instead of "execute". Example:
=> { "execute": "command-support-oob",
"arguments": { ... },
"control": { "run-oob": true } }
=> { "exec-oob": "migrate-recover",
"arguments": { "uri": "tcp:192.168.1.200:12345" } }
<= { "return": { } }
Without it, even the commands that support out-of-band execution will