migration: rename migration_bitmap_sync_range to ramblock_sync_dirty_bitmap

[mirror_qemu.git] / hmp-commands.hx

diff --git a/hmp-commands.hx b/hmp-commands.hx
index db0c681f747197a654cd57603c356461e5a1abc0..bfa5681dd2579c120d656982871c4439afd49400 100644 (file)
--- a/hmp-commands.hx
+++ b/hmp-commands.hx
@@ -350,49 +350,57 @@ ETEXI
     {
         .name       = "savevm",
         .args_type  = "name:s?",
     {
         .name       = "savevm",
         .args_type  = "name:s?",

-        .params     = "[tag|id]",
-        .help       = "save a VM snapshot. If no tag or id are provided, a new snapshot is created",
+        .params     = "tag",
+        .help       = "save a VM snapshot. If no tag is provided, a new snapshot is created",

         .cmd        = hmp_savevm,
     },
 
 STEXI
         .cmd        = hmp_savevm,
     },
 
 STEXI

-@item savevm [@var{tag}|@var{id}]
+@item savevm @var{tag}

 @findex savevm
 Create a snapshot of the whole virtual machine. If @var{tag} is
 provided, it is used as human readable identifier. If there is already
 @findex savevm
 Create a snapshot of the whole virtual machine. If @var{tag} is
 provided, it is used as human readable identifier. If there is already

-a snapshot with the same tag or ID, it is replaced. More info at
+a snapshot with the same tag, it is replaced. More info at

 @ref{vm_snapshots}.
 @ref{vm_snapshots}.

+
+Since 4.0, savevm stopped allowing the snapshot id to be set, accepting
+only @var{tag} as parameter.

 ETEXI
 
     {
         .name       = "loadvm",
         .args_type  = "name:s",
 ETEXI
 
     {
         .name       = "loadvm",
         .args_type  = "name:s",

-        .params     = "tag|id",
-        .help       = "restore a VM snapshot from its tag or id",
+        .params     = "tag",
+        .help       = "restore a VM snapshot from its tag",

         .cmd        = hmp_loadvm,
         .command_completion = loadvm_completion,
     },
 
 STEXI
         .cmd        = hmp_loadvm,
         .command_completion = loadvm_completion,
     },
 
 STEXI

-@item loadvm @var{tag}|@var{id}
+@item loadvm @var{tag}

 @findex loadvm
 Set the whole virtual machine to the snapshot identified by the tag
 @findex loadvm
 Set the whole virtual machine to the snapshot identified by the tag

-@var{tag} or the unique snapshot ID @var{id}.
+@var{tag}.
+
+Since 4.0, loadvm stopped accepting snapshot id as parameter.

 ETEXI
 
     {
         .name       = "delvm",
         .args_type  = "name:s",
 ETEXI
 
     {
         .name       = "delvm",
         .args_type  = "name:s",

-        .params     = "tag|id",
-        .help       = "delete a VM snapshot from its tag or id",
+        .params     = "tag",
+        .help       = "delete a VM snapshot from its tag",

         .cmd        = hmp_delvm,
         .command_completion = delvm_completion,
     },
 
 STEXI
         .cmd        = hmp_delvm,
         .command_completion = delvm_completion,
     },
 
 STEXI

-@item delvm @var{tag}|@var{id}
+@item delvm @var{tag}

 @findex delvm
 @findex delvm

-Delete the snapshot identified by @var{tag} or @var{id}.
+Delete the snapshot identified by @var{tag}.
+
+Since 4.0, delvm stopped deleting snapshots by snapshot id, accepting
+only @var{tag} as parameter.

 ETEXI
 
     {
 ETEXI
 
     {


@@ -577,6 +585,21 @@ STEXI
 @findex gpa2hpa
 Print the host physical address at which the guest's physical address @var{addr}
 is mapped.
 @findex gpa2hpa
 Print the host physical address at which the guest's physical address @var{addr}
 is mapped.

+ETEXI
+
+    {
+        .name       = "gva2gpa",
+        .args_type  = "addr:l",
+        .params     = "addr",
+        .help       = "print the guest physical address corresponding to a guest virtual address",
+        .cmd        = hmp_gva2gpa,
+    },
+
+STEXI
+@item gva2gpa @var{addr}
+@findex gva2gpa
+Print the guest physical address at which the guest's virtual address @var{addr}
+is mapped based on the mapping for the current CPU.

 ETEXI
 
     {
 ETEXI
 
     {


@@ -928,6 +951,25 @@ Bug: can screw up when the buffer contains invalid UTF-8 sequences,
 NUL characters, after the ring buffer lost data, and when reading
 stops because the size limit is reached.
 
 NUL characters, after the ring buffer lost data, and when reading
 stops because the size limit is reached.
 

+ETEXI
+
+    {
+        .name       = "announce_self",
+        .args_type  = "interfaces:s?,id:s?",
+        .params     = "[interfaces] [id]",
+        .help       = "Trigger GARP/RARP announcements",
+        .cmd        = hmp_announce_self,
+    },
+
+STEXI
+@item announce_self
+@findex announce_self
+Trigger a round of GARP/RARP broadcasts; this is useful for explicitly updating the
+network infrastructure after a reconfiguration or some forms of migration.
+The timings of the round are set by the migration announce parameters.
+An optional comma separated @var{interfaces} list restricts the announce to the
+named set of interfaces. An optional @var{id} can be used to start a separate announce
+timer and to change the parameters of it later.

 ETEXI
 
     {
 ETEXI
 
     {


@@ -1849,14 +1891,16 @@ ETEXI
         .name       = "cpu-add",
         .args_type  = "id:i",
         .params     = "id",
         .name       = "cpu-add",
         .args_type  = "id:i",
         .params     = "id",

-        .help       = "add cpu",
+        .help       = "add cpu (deprecated, use device_add instead)",

         .cmd        = hmp_cpu_add,
     },
 
 STEXI
 @item cpu-add @var{id}
 @findex cpu-add
         .cmd        = hmp_cpu_add,
     },
 
 STEXI
 @item cpu-add @var{id}
 @findex cpu-add

-Add CPU with id @var{id}
+Add CPU with id @var{id}.  This command is deprecated, please
++use @code{device_add} instead. For details, refer to
+'docs/cpu-hotplug.rst'.

 ETEXI
 
     {
 ETEXI
 
     {


@@ -1893,7 +1937,7 @@ ETEXI
         .params     = "[subcommand]",
         .help       = "show various information about the system state",
         .cmd        = hmp_info_help,
         .params     = "[subcommand]",
         .help       = "show various information about the system state",
         .cmd        = hmp_info_help,

-        .sub_table  = info_cmds,
+        .sub_table  = hmp_info_cmds,

         .flags      = "p",
     },
 
         .flags      = "p",
     },