mirrors/qemu
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

blockjob: Improve BlockJobInfo.offset/len documentation

Browse Source 
Clarify that len is just an estimation of the end value of offset, and
that offset increases monotonically while len can change arbitrarily.

While touching the documentation of offset, move it directly after len
to match the order of the declaration below.

Signed-off-by: Kevin Wolf <kwolf@redhat.com>
Reviewed-by: Eric Blake <eblake@redhat.com>
Reviewed-by: John Snow <jsnow@redhat.com>
This commit is contained in:
Kevin Wolf 2018-05-16 13:04:34 +02:00
parent cd44d96be9
commit a81e0a825e
1 changed files with 6 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
qapi/block-core.json
View File

@ -1148,7 +1148,12 @@
# @device: The job identifier. Originally the device name but other # @device: The job identifier. Originally the device name but other
# values are allowed since QEMU 2.7 # values are allowed since QEMU 2.7
# #
# @len: the maximum progress value # @len: Estimated @offset value at the completion of the job. This value can
# arbitrarily change while the job is running, in both directions.
#
# @offset: Progress made until now. The unit is arbitrary and the value can
# only meaningfully be used for the ratio of @offset to @len. The
# value is monotonically increasing.
# #
# @busy: false if the job is known to be in a quiescent state, with # @busy: false if the job is known to be in a quiescent state, with
# no pending I/O. Since 1.3. # no pending I/O. Since 1.3.
@ -1156,8 +1161,6 @@
# @paused: whether the job is paused or, if @busy is true, will # @paused: whether the job is paused or, if @busy is true, will
# pause itself as soon as possible. Since 1.3. # pause itself as soon as possible. Since 1.3.
# #
# @offset: the current progress value
#
# @speed: the rate limit, bytes per second # @speed: the rate limit, bytes per second
# #
# @io-status: the status of the job (since 1.3) # @io-status: the status of the job (since 1.3)