A number of deprecated QMP arguments and results were missed in commit eb22aeca65 "docs: document deprecation policy & deprecated features in appendix" (v2.10.0): * Commit b33945cfff "block: Accept device model name for blockdev-open/close-tray" (v2.8.0) deprecated blockdev-open-tray, blockdev-close-tray argument @device. * Commit fbe2d8163e "block: Accept device model name for eject" (v2.8.0) deprecated eject argument @device. * Commit 70e2cb3bd7 "block: Accept device model name for blockdev-change-medium" (v2.8.0) deprecated blockdev-change-medium argument @device. * Commit 7a9877a026 "block: Accept device model name for block_set_io_throttle" (v2.8.0) deprecated block_set_io_throttle argument @device. * Commit c01c214b69 "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. * Commit c42e8742f5 "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: * Commit 3c605f4074 "commit: Add top-node/base-node options" (v3.1.0) deprecated block-commit arguments @base and @top. * Commit 4db6ceb0b5 "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@xxxxxxxxxx> --- qemu-deprecated.texi | 38 +++++++++++++++++++++++++++++++++++--- 1 file changed, 35 insertions(+), 3 deletions(-) diff --git a/qemu-deprecated.texi b/qemu-deprecated.texi index 66eca3a1de..b9ef56fd97 100644 --- a/qemu-deprecated.texi +++ b/qemu-deprecated.texi @@ -150,19 +150,51 @@ Use @option{-display sdl,show-cursor=on} or Use ``blockdev-change-medium'' or ``change-vnc-password'' instead. +@subsection blockdev-open-tray, blockdev-close-tray argument device (since 2.8.0) + +Use argument ``id'' instead. + +@subsection eject argument device (since 2.8.0) + +Use argument ``id'' instead. + +@subsection blockdev-change-medium argument device (since 2.8.0) + +Use argument ``id'' instead. + +@subsection block_set_io_throttle argument device (since 2.8.0) + +Use argument ``id'' instead. + @subsection migrate_set_downtime and migrate_set_speed (since 2.8.0) Use ``migrate-set-parameters'' instead. +@subsection query-named-block-nodes result encryption_key_missing (since 2.10.0) + +Always false. + +@subsection query-block result inserted.encryption_key_missing (since 2.10.0) + +Always false. + +@subsection blockdev-add empty string argument backing (since 2.10.0) + +Use argument ``null'' instead. + @subsection migrate-set-cache-size and query-migrate-cache-size (since 2.11.0) Use ``migrate-set-parameters'' and ``query-migrate-parameters'' instead. -@subsection query-block result field dirty-bitmaps[i].status (since 4.0) +@subsection block-commit arguments base and top (since 3.1.0) + +Use arguments ``base-node'' and ``top-node'' instead. + +@subsection 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 query-block command is deprecated. Two new boolean fields, -``recording'' and ``busy'' effectively replace it. +these commands is deprecated. Two new boolean fields, ``recording'' and +``busy'' effectively replace it. @subsection query-block result field dirty-bitmaps (Since 4.2) -- 2.21.1