Skip to content

Commit

Permalink
qmp-events: move 'BLOCK_JOB_READY' doc to schema
Browse files Browse the repository at this point in the history
Signed-off-by: Marc-André Lureau <marcandre.lureau@redhat.com>
Signed-off-by: Markus Armbruster <armbru@redhat.com>
  • Loading branch information
elmarco authored and Markus Armbruster committed Jan 16, 2017
1 parent af0e091 commit 11a3dee
Show file tree
Hide file tree
Showing 2 changed files with 8 additions and 27 deletions.
27 changes: 0 additions & 27 deletions docs/qmp-events.txt
Expand Up @@ -30,33 +30,6 @@ Example:

Note: this event is rate-limited.

BLOCK_JOB_READY
---------------

Emitted when a block job is ready to complete.

Data:

- "type": Job type (json-string; "stream" for image streaming
"commit" for block commit)
- "device": Job identifier. Originally the device name but other
values are allowed since QEMU 2.7 (json-string)
- "len": Maximum progress value (json-int)
- "offset": Current progress value (json-int)
On success this is equal to len.
On failure this is less than len.
- "speed": Rate limit, bytes per second (json-int)

Example:

{ "event": "BLOCK_JOB_READY",
"data": { "device": "drive0", "type": "mirror", "speed": 0,
"len": 2097152, "offset": 2097152 }
"timestamp": { "seconds": 1265044230, "microseconds": 450486 } }

Note: The "ready to complete" status is always reset by a BLOCK_JOB_ERROR
event.

DEVICE_DELETED
--------------

Expand Down
8 changes: 8 additions & 0 deletions qapi/block-core.json
Expand Up @@ -3410,6 +3410,14 @@
# event
#
# Since: 1.3
#
# Example:
#
# <- { "event": "BLOCK_JOB_READY",
# "data": { "device": "drive0", "type": "mirror", "speed": 0,
# "len": 2097152, "offset": 2097152 }
# "timestamp": { "seconds": 1265044230, "microseconds": 450486 } }
#
##
{ 'event': 'BLOCK_JOB_READY',
'data': { 'type' : 'BlockJobType',
Expand Down

0 comments on commit 11a3dee

Please sign in to comment.