mirror of
https://github.com/Motorhead1991/qemu.git
synced 2025-08-05 16:53:55 -06:00
qemu-doc: Belatedly document QMP command arg & result deprecation
A number of deprecated QMP arguments and results were missed in commiteb22aeca65
"docs: document deprecation policy & deprecated features in appendix" (v2.10.0): * Commitb33945cfff
"block: Accept device model name for blockdev-open/close-tray" (v2.8.0) deprecated blockdev-open-tray, blockdev-close-tray argument @device. * Commitfbe2d8163e
"block: Accept device model name for eject" (v2.8.0) deprecated eject argument @device. * Commit70e2cb3bd7
"block: Accept device model name for blockdev-change-medium" (v2.8.0) deprecated blockdev-change-medium argument @device. * Commit7a9877a026
"block: Accept device model name for block_set_io_throttle" (v2.8.0) deprecated block_set_io_throttle argument @device. * Commitc01c214b69
"block: remove all encryption handling APIs" (v2.10.0) deprecated query-named-block-nodes result @encryption_key_missing and query-block result @inserted member @encryption_key_missing. * Commitc42e8742f5
"block: Use JSON null instead of "" to disable backing file" (v2.10.0) deprecated blockdev-add empty string argument @backing. Since then, we missed a few more: * Commit3c605f4074
"commit: Add top-node/base-node options" (v3.1.0) deprecated block-commit arguments @base and @top. * Commit4db6ceb0b5
"block/dirty-bitmap: add recording and busy properties" (v4.0.0) deprecated query-named-block-nodes result @dirty-bitmaps member @status, not just query-block. Make up for all that. Signed-off-by: Markus Armbruster <armbru@redhat.com> Reviewed-by: Eric Blake <eblake@redhat.com> Message-Id: <20200317115459.31821-2-armbru@redhat.com>
This commit is contained in:
parent
942ab6865a
commit
73756ae3e3
1 changed files with 44 additions and 4 deletions
|
@ -180,27 +180,67 @@ QEMU Machine Protocol (QMP) commands
|
||||||
|
|
||||||
Use ``blockdev-change-medium`` or ``change-vnc-password`` instead.
|
Use ``blockdev-change-medium`` or ``change-vnc-password`` instead.
|
||||||
|
|
||||||
|
``blockdev-open-tray``, ``blockdev-close-tray`` argument ``device`` (since 2.8.0)
|
||||||
|
'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
|
||||||
|
|
||||||
|
Use argument ``id`` instead.
|
||||||
|
|
||||||
|
``eject`` argument ``device`` (since 2.8.0)
|
||||||
|
'''''''''''''''''''''''''''''''''''''''''''
|
||||||
|
|
||||||
|
Use argument ``id`` instead.
|
||||||
|
|
||||||
|
``blockdev-change-medium`` argument ``device`` (since 2.8.0)
|
||||||
|
''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
|
||||||
|
|
||||||
|
Use argument ``id`` instead.
|
||||||
|
|
||||||
|
``block_set_io_throttle`` argument ``device`` (since 2.8.0)
|
||||||
|
'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
|
||||||
|
|
||||||
|
Use argument ``id`` instead.
|
||||||
|
|
||||||
``migrate_set_downtime`` and ``migrate_set_speed`` (since 2.8.0)
|
``migrate_set_downtime`` and ``migrate_set_speed`` (since 2.8.0)
|
||||||
''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
|
''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
|
||||||
|
|
||||||
Use ``migrate-set-parameters`` instead.
|
Use ``migrate-set-parameters`` instead.
|
||||||
|
|
||||||
|
``query-named-block-nodes`` result ``encryption_key_missing`` (since 2.10.0)
|
||||||
|
''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
|
||||||
|
|
||||||
|
Always false.
|
||||||
|
|
||||||
|
``query-block`` result ``inserted.encryption_key_missing`` (since 2.10.0)
|
||||||
|
'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
|
||||||
|
|
||||||
|
Always false.
|
||||||
|
|
||||||
|
``blockdev-add`` empty string argument ``backing`` (since 2.10.0)
|
||||||
|
'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
|
||||||
|
|
||||||
|
Use argument value ``null`` instead.
|
||||||
|
|
||||||
``migrate-set-cache-size`` and ``query-migrate-cache-size`` (since 2.11.0)
|
``migrate-set-cache-size`` and ``query-migrate-cache-size`` (since 2.11.0)
|
||||||
''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
|
''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
|
||||||
|
|
||||||
Use ``migrate-set-parameters`` and ``query-migrate-parameters`` instead.
|
Use ``migrate-set-parameters`` and ``query-migrate-parameters`` instead.
|
||||||
|
|
||||||
|
``block-commit`` arguments ``base`` and ``top`` (since 3.1.0)
|
||||||
|
'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
|
||||||
|
|
||||||
|
Use arguments ``base-node`` and ``top-node`` instead.
|
||||||
|
|
||||||
``object-add`` option ``props`` (since 5.0)
|
``object-add`` option ``props`` (since 5.0)
|
||||||
'''''''''''''''''''''''''''''''''''''''''''
|
'''''''''''''''''''''''''''''''''''''''''''
|
||||||
|
|
||||||
Specify the properties for the object as top-level arguments instead.
|
Specify the properties for the object as top-level arguments instead.
|
||||||
|
|
||||||
``query-block`` result field ``dirty-bitmaps[i].status`` (since 4.0)
|
``query-named-block-nodes`` and ``query-block`` result dirty-bitmaps[i].status (since 4.0)
|
||||||
''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
|
''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
|
||||||
|
|
||||||
The ``status`` field of the ``BlockDirtyInfo`` structure, returned by
|
The ``status`` field of the ``BlockDirtyInfo`` structure, returned by
|
||||||
the query-block command is deprecated. Two new boolean fields,
|
these commands is deprecated. Two new boolean fields, ``recording`` and
|
||||||
``recording`` and ``busy`` effectively replace it.
|
``busy`` effectively replace it.
|
||||||
|
|
||||||
``query-block`` result field ``dirty-bitmaps`` (Since 4.2)
|
``query-block`` result field ``dirty-bitmaps`` (Since 4.2)
|
||||||
''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
|
''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue