[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Qemu-devel] [PATCH] qmp-shell: add documentation
From: |
John Snow |
Subject: |
Re: [Qemu-devel] [PATCH] qmp-shell: add documentation |
Date: |
Tue, 07 Jul 2015 12:33:31 -0400 |
User-agent: |
Mozilla/5.0 (X11; Linux x86_64; rv:31.0) Gecko/20100101 Thunderbird/31.7.0 |
On 07/02/2015 11:31 AM, Luiz Capitulino wrote:
> On Wed, 1 Jul 2015 14:25:49 -0400
> John Snow <address@hidden> wrote:
>
>> I should probably document the changes that were made.
>>
>> Signed-off-by: John Snow <address@hidden>
>
> Looks good to me, CC'ing maintainer.
>
Whoops, didn't realize Markus took this file over, too. Sorry Luiz.
Markus, would you consider staging this? It's purely a documentation
update for only a dev tool, so it doesn't really matter /when/ it lands
either way, just shoring up some changes I made a while back to the
interpreter here.
tldr: "ping"
>> ---
>> scripts/qmp/qmp-shell | 35 +++++++++++++++++++++++++++++++++++
>> 1 file changed, 35 insertions(+)
>>
>> diff --git a/scripts/qmp/qmp-shell b/scripts/qmp/qmp-shell
>> index 65280d2..fa39bf0 100755
>> --- a/scripts/qmp/qmp-shell
>> +++ b/scripts/qmp/qmp-shell
>> @@ -29,6 +29,41 @@
>> # (QEMU) device_add driver=e1000 id=net1
>> # {u'return': {}}
>> # (QEMU)
>> +#
>> +# key=value pairs also support Python or JSON object literal subset
>> notations,
>> +# without spaces. Dictionaries/objects {} are supported as are arrays [].
>> +#
>> +# example-command arg-name1={'key':'value','obj'={'prop':"value"}}
>> +#
>> +# Both JSON and Python formatting should work, including both styles of
>> +# string literal quotes. Both paradigms of literal values should work,
>> +# including null/true/false for JSON and None/True/False for Python.
>> +#
>> +#
>> +# Transactions have the following multi-line format:
>> +#
>> +# transaction(
>> +# action-name1 [ arg-name1=arg1 ] ... [arg-nameN=argN ]
>> +# ...
>> +# action-nameN [ arg-name1=arg1 ] ... [arg-nameN=argN ]
>> +# )
>> +#
>> +# One line transactions are also supported:
>> +#
>> +# transaction( action-name1 ... )
>> +#
>> +# For example:
>> +#
>> +# (QEMU) transaction(
>> +# TRANS> block-dirty-bitmap-add node=drive0 name=bitmap1
>> +# TRANS> block-dirty-bitmap-clear node=drive0 name=bitmap0
>> +# TRANS> )
>> +# {"return": {}}
>> +# (QEMU)
>> +#
>> +# Use the -v and -p options to activate the verbose and pretty-print
>> options,
>> +# which will echo back the properly formatted JSON-compliant QMP that is
>> being
>> +# sent to QEMU, which is useful for debugging and documentation generation.
>>
>> import qmp
>> import json
>
>
Re: [Qemu-devel] [PATCH] qmp-shell: add documentation, Kashyap Chamarthy, 2015/07/28