SYS-OSS/FRET-qemu
4
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

migration: massage cpr-reboot documentation

Browse Source 
Re-wrap the cpr-reboot documentation to 70 columns, use '@' for
cpr-reboot references, capitalize COLO and VFIO, and tweak the
wording.

Suggested-by: Markus Armbruster <armbru@redhat.com>
Signed-off-by: Steve Sistare <steven.sistare@oracle.com>
Link: https://lore.kernel.org/r/1709218462-3640-1-git-send-email-steven.sistare@oracle.com
[peterx: s/qemu/QEMU per Markus's suggestion]
Reviewed-by: Markus Armbruster <armbru@redhat.com>
Signed-off-by: Peter Xu <peterx@redhat.com>
This commit is contained in:
Steve Sistare 2024-02-29 06:54:22 -08:00 committed by Peter Xu
parent c0c6a0e352
commit 87a2848715
1 changed files with 19 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
qapi/migration.json
View File

@ -636,28 +636,30 @@
# #
# @normal: the original form of migration. (since 8.2) # @normal: the original form of migration. (since 8.2)
# #
# @cpr-reboot: The migrate command stops the VM and saves state to the URI. # @cpr-reboot: The migrate command stops the VM and saves state to
# After quitting qemu, the user resumes by running qemu -incoming. # the URI. After quitting QEMU, the user resumes by running
# QEMU -incoming.
# #
# This mode allows the user to quit qemu, and restart an updated version # This mode allows the user to quit QEMU, optionally update and
# of qemu. The user may even update and reboot the OS before restarting, # reboot the OS, and restart QEMU. If the user reboots, the URI
# as long as the URI persists across a reboot. # must persist across the reboot, such as by using a file.
# #
# Unlike normal mode, the use of certain local storage options does not # Unlike normal mode, the use of certain local storage options
# block the migration, but the user must not modify guest block devices # does not block the migration, but the user must not modify the
# between the quit and restart. # contents of guest block devices between the quit and restart.
# #
# This mode supports vfio devices provided the user first puts the guest # This mode supports VFIO devices provided the user first puts
# in the suspended runstate, such as by issuing guest-suspend-ram to the # the guest in the suspended runstate, such as by issuing
# qemu guest agent. # guest-suspend-ram to the QEMU guest agent.
# #
# Best performance is achieved when the memory backend is shared and the # Best performance is achieved when the memory backend is shared
# @x-ignore-shared migration capability is set, but this is not required. # and the @x-ignore-shared migration capability is set, but this
# Further, if the user reboots before restarting such a configuration, the # is not required. Further, if the user reboots before restarting
# shared backend must be be non-volatile across reboot, such as by backing # such a configuration, the shared memory must persist across the
# it with a dax device. # reboot, such as by backing it with a dax device.
# #
# cpr-reboot may not be used with postcopy, colo, or background-snapshot. # @cpr-reboot may not be used with postcopy, background-snapshot,
# or COLO.
# #
# (since 8.2) # (since 8.2)
## ##