aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMarkus Armbruster <armbru@redhat.com>2025-05-21 08:37:09 +0200
committerMarkus Armbruster <armbru@redhat.com>2025-05-28 06:53:20 +0200
commitc2fb6eaeb9d479a80b104914f459a0c6c32e5a88 (patch)
tree72cc1da5d55d3f527ff1af19df7a824477fa63ac
parent428d1789df911bc863e55eed2d8f33ce991cbd09 (diff)
downloadqemu-c2fb6eaeb9d479a80b104914f459a0c6c32e5a88.zip
qemu-c2fb6eaeb9d479a80b104914f459a0c6c32e5a88.tar.gz
qemu-c2fb6eaeb9d479a80b104914f459a0c6c32e5a88.tar.bz2
qapi/migration: Deprecate migrate argument @detach
Argument @detach has always been ignored. Start the clock to get rid of it. Cc: Peter Xu <peterx@redhat.com> Cc: Fabiano Rosas <farosas@suse.de> Signed-off-by: Markus Armbruster <armbru@redhat.com> Message-ID: <20250521063711.29840-3-armbru@redhat.com> ACKed-by: Peter Krempa <pkrempa@redhat.com> Reviewed-by: Fabiano Rosas <farosas@suse.de> Reviewed-by: Peter Xu <peterx@redhat.com>
-rw-r--r--docs/about/deprecated.rst5
-rw-r--r--qapi/migration.json18
2 files changed, 14 insertions, 9 deletions
diff --git a/docs/about/deprecated.rst b/docs/about/deprecated.rst
index 9665bc6..ef4ea84 100644
--- a/docs/about/deprecated.rst
+++ b/docs/about/deprecated.rst
@@ -179,6 +179,11 @@ Use ``job-dismiss`` instead.
Use ``job-finalize`` instead.
+``migrate`` argument ``detach`` (since 10.1)
+''''''''''''''''''''''''''''''''''''''''''''
+
+This argument has always been ignored.
+
``query-migrationthreads`` (since 9.2)
''''''''''''''''''''''''''''''''''''''
diff --git a/qapi/migration.json b/qapi/migration.json
index 8b9c535..ecd266f 100644
--- a/qapi/migration.json
+++ b/qapi/migration.json
@@ -1660,6 +1660,10 @@
#
# @resume: resume one paused migration, default "off". (since 3.0)
#
+# Features:
+#
+# @deprecated: Argument @detach is deprecated.
+#
# Since: 0.14
#
# .. admonition:: Notes
@@ -1668,19 +1672,14 @@
# migration's progress and final result (this information is
# provided by the 'status' member).
#
-# 2. All boolean arguments default to false.
-#
-# 3. The user Monitor's "detach" argument is invalid in QMP and
-# should not be used.
-#
-# 4. The uri argument should have the Uniform Resource Identifier
+# 2. The uri argument should have the Uniform Resource Identifier
# of default destination VM. This connection will be bound to
# default network.
#
-# 5. For now, number of migration streams is restricted to one,
+# 3. For now, number of migration streams is restricted to one,
# i.e. number of items in 'channels' list is just 1.
#
-# 6. The 'uri' and 'channels' arguments are mutually exclusive;
+# 4. The 'uri' and 'channels' arguments are mutually exclusive;
# exactly one of the two should be present.
#
# .. qmp-example::
@@ -1724,7 +1723,8 @@
{ 'command': 'migrate',
'data': {'*uri': 'str',
'*channels': [ 'MigrationChannel' ],
- '*detach': 'bool', '*resume': 'bool' } }
+ '*detach': { 'type': 'bool', 'features': [ 'deprecated' ] },
+ '*resume': 'bool' } }
##
# @migrate-incoming: