From: John Snow <[email protected]> Signed-off-by: John Snow <[email protected]> Message-ID: <[email protected]> Reviewed-by: Markus Armbruster <[email protected]> Signed-off-by: Markus Armbruster <[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 a583bcc05c..5c6a882a24 100644 --- a/qapi/block-core.json +++ b/qapi/block-core.json @@ -1856,12 +1856,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 @@ -1997,12 +1997,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: # @@ -2028,12 +2028,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 @@ -2225,13 +2225,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 @@ -2427,10 +2427,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 @@ -4977,10 +4976,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. # @@ -5493,9 +5491,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. # @@ -5550,10 +5548,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. # @@ -6127,11 +6124,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 @@ -6159,11 +6155,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
