Signed-off-by: John Snow <[email protected]> --- qapi/block-core.json | 96 +++++++++++++++++++++----------------------- 1 file changed, 46 insertions(+), 50 deletions(-)
diff --git a/qapi/block-core.json b/qapi/block-core.json index 33e1147792b..29f011dc209 100644 --- a/qapi/block-core.json +++ b/qapi/block-core.json @@ -1816,12 +1816,12 @@ ## # @change-backing-file: -# -# Change the backing file in the image file metadata. This does not -# cause QEMU to reopen the image file to reparse the backing filename -# (it may, however, perform a reopen to change permissions from r/o -> -# r/w -> r/o, if needed). The new backing file string is written into -# the image file metadata, and the QEMU internal strings are updated. +# Change the backing file in the image file metadata. This does +# not cause QEMU to reopen the image file to reparse the backing +# filename (it may, however, perform a reopen to change +# permissions from r/o -> r/w -> r/o, if needed). The new backing +# file string is written into the image file metadata, and the +# QEMU internal strings are updated. # # @image-node-name: The name of the block driver state node of the # image to modify. The "device" argument is used to verify @@ -1957,12 +1957,12 @@ ## # @drive-backup: -# -# Start a point-in-time copy of a block device to a new destination. -# The status of ongoing `drive-backup` operations can be checked with -# `query-block-jobs` where the `BlockJobInfo`.type field has the value -# 'backup'. The operation can be stopped before it has completed -# using the `job-cancel` or `block-job-cancel` command. +# Start a point-in-time copy of a block device to a new +# destination. The status of ongoing `drive-backup` operations +# can be checked with `query-block-jobs` where the +# `BlockJobInfo`.type field has the value 'backup'. The operation +# can be stopped before it has completed using the `job-cancel` or +# `block-job-cancel` command. # # Features: # @@ -1988,12 +1988,12 @@ ## # @blockdev-backup: -# -# Start a point-in-time copy of a block device to a new destination. -# The status of ongoing `blockdev-backup` operations can be checked -# with `query-block-jobs` where the `BlockJobInfo`.type field has the -# value 'backup'. The operation can be stopped before it has -# completed using the `job-cancel` or `block-job-cancel` command. +# Start a point-in-time copy of a block device to a new +# destination. The status of ongoing `blockdev-backup` operations +# can be checked with `query-block-jobs` where the +# `BlockJobInfo`.type field has the value 'backup'. The operation +# can be stopped before it has completed using the `job-cancel` or +# `block-job-cancel` command. # # Errors: # - If @device is not a valid block device, DeviceNotFound @@ -2185,13 +2185,13 @@ ## # @drive-mirror: -# -# Start mirroring a block device's writes to a new destination. -# target specifies the target of the new image. If the file exists, -# or if it is a device, it will be used as the new destination for -# writes. If it does not exist, a new file will be created. @format -# specifies the format of the mirror image, default is to probe if -# mode='existing', else the format of the source. +# Start mirroring a block device's writes to a new destination. +# target specifies the target of the new image. If the file +# exists, or if it is a device, it will be used as the new +# destination for writes. If it does not exist, a new file will +# be created. @format specifies the format of the mirror image, +# default is to probe if mode='existing', else the format of the +# source. # # Errors: # - If @device is not a valid block device, GenericError @@ -2387,10 +2387,9 @@ ## # @block-dirty-bitmap-remove: -# -# Stop write tracking and remove the dirty bitmap that was created -# with `block-dirty-bitmap-add`. If the bitmap is persistent, remove -# it from its storage too. +# Stop write tracking and remove the dirty bitmap that was created +# with `block-dirty-bitmap-add`. If the bitmap is persistent, +# remove it from its storage too. # # Errors: # - If @node is not a valid block device or node, DeviceNotFound @@ -4937,10 +4936,9 @@ ## # @blockdev-del: -# -# Deletes a block device that has been added using `blockdev-add`. -# The command will fail if the node is attached to a device or is -# otherwise being used. +# Deletes a block device that has been added using `blockdev-add`. +# The command will fail if the node is attached to a device or is +# otherwise being used. # # @node-name: Name of the graph node to delete. # @@ -5453,9 +5451,9 @@ ## # @blockdev-create: -# -# Starts a job to create an image format on a given node. The job is -# automatically finalized, but a manual `job-dismiss` is required. +# Starts a job to create an image format on a given node. The job +# is automatically finalized, but a manual `job-dismiss` is +# required. # # @job-id: Identifier for the newly created job. # @@ -5510,10 +5508,9 @@ ## # @x-blockdev-amend: -# -# Starts a job to amend format specific options of an existing open -# block device. The job is automatically finalized, but a manual -# `job-dismiss` is required. +# Starts a job to amend format specific options of an existing +# open block device. The job is automatically finalized, but a +# manual `job-dismiss` is required. # # @job-id: Identifier for the newly created job. # @@ -6087,11 +6084,10 @@ ## # @blockdev-snapshot-internal-sync: -# -# Synchronously take an internal snapshot of a block device, when the -# format of the image used supports it. If the name is an empty -# string, or a snapshot with name already exists, the operation will -# fail. +# Synchronously take an internal snapshot of a block device, when +# the format of the image used supports it. If the name is an +# empty string, or a snapshot with name already exists, the +# operation will fail. # # Errors: # - If @device is not a valid block device, GenericError @@ -6119,11 +6115,11 @@ ## # @blockdev-snapshot-delete-internal-sync: -# -# Synchronously delete an internal snapshot of a block device, when -# the format of the image used support it. The snapshot is identified -# by name or id or both. One of the name or id is required. Return -# `SnapshotInfo` for the successfully deleted snapshot. +# Synchronously delete an internal snapshot of a block device, +# when the format of the image used support it. The snapshot is +# identified by name or id or both. One of the name or id is +# required. Return `SnapshotInfo` for the successfully deleted +# snapshot. # # @device: the device name or node-name of a root node to delete the # snapshot from -- 2.55.0
