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>
This commit is contained in:
Markus Armbruster 2025-05-21 08:37:09 +02:00
parent 428d1789df
commit c2fb6eaeb9
2 changed files with 14 additions and 9 deletions

View file

@ -179,6 +179,11 @@ Use ``job-dismiss`` instead.
Use ``job-finalize`` instead. Use ``job-finalize`` instead.
``migrate`` argument ``detach`` (since 10.1)
''''''''''''''''''''''''''''''''''''''''''''
This argument has always been ignored.
``query-migrationthreads`` (since 9.2) ``query-migrationthreads`` (since 9.2)
'''''''''''''''''''''''''''''''''''''' ''''''''''''''''''''''''''''''''''''''

View file

@ -1660,6 +1660,10 @@
# #
# @resume: resume one paused migration, default "off". (since 3.0) # @resume: resume one paused migration, default "off". (since 3.0)
# #
# Features:
#
# @deprecated: Argument @detach is deprecated.
#
# Since: 0.14 # Since: 0.14
# #
# .. admonition:: Notes # .. admonition:: Notes
@ -1668,19 +1672,14 @@
# migration's progress and final result (this information is # migration's progress and final result (this information is
# provided by the 'status' member). # provided by the 'status' member).
# #
# 2. All boolean arguments default to false. # 2. The uri argument should have the Uniform Resource Identifier
#
# 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
# of default destination VM. This connection will be bound to # of default destination VM. This connection will be bound to
# default network. # 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. # 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. # exactly one of the two should be present.
# #
# .. qmp-example:: # .. qmp-example::
@ -1724,7 +1723,8 @@
{ 'command': 'migrate', { 'command': 'migrate',
'data': {'*uri': 'str', 'data': {'*uri': 'str',
'*channels': [ 'MigrationChannel' ], '*channels': [ 'MigrationChannel' ],
'*detach': 'bool', '*resume': 'bool' } } '*detach': { 'type': 'bool', 'features': [ 'deprecated' ] },
'*resume': 'bool' } }
## ##
# @migrate-incoming: # @migrate-incoming: