diff mbox

qmp: Documentation for BLOCK_IMAGE_CORRUPTED

Message ID 1378126884-9544-1-git-send-email-mreitz@redhat.com
State New
Headers show

Commit Message

Max Reitz Sept. 2, 2013, 1:01 p.m. UTC
Add an appropriate entry describing this event and its parameters into
qmp-events.txt.

Signed-off-by: Max Reitz <mreitz@redhat.com>
---
Follow-up to:
 - Add metadata overlap checks (series, v5); particularly patch 2
   (qcow2: Metadata overlap checks)
---
 QMP/qmp-events.txt | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

Comments

Eric Blake Sept. 3, 2013, 1:39 p.m. UTC | #1
On 09/02/2013 07:01 AM, Max Reitz wrote:
> Add an appropriate entry describing this event and its parameters into
> qmp-events.txt.
> 
> Signed-off-by: Max Reitz <mreitz@redhat.com>
> ---
> Follow-up to:
>  - Add metadata overlap checks (series, v5); particularly patch 2
>    (qcow2: Metadata overlap checks)
> ---
>  QMP/qmp-events.txt | 22 ++++++++++++++++++++++
>  1 file changed, 22 insertions(+)
> 
> diff --git a/QMP/qmp-events.txt b/QMP/qmp-events.txt
> index 39b6016..6ff74d6 100644
> --- a/QMP/qmp-events.txt
> +++ b/QMP/qmp-events.txt
> @@ -478,3 +478,25 @@ Example:
>  
>  { "event": "GUEST_PANICKED",
>       "data": { "action": "pause" } }
> +
> +BLOCK_IMAGE_CORRUPTED
> +---------------------

The content is fine, but the location is not.  We are trying to keep
this file sorted by event name, so this belongs between BALLOON_CHANGE
and BLOCK_IO_ERROR.

As sorting is trivial, you can add this to your v2:
Reviewed-by: Eric Blake <eblake@redhat.com>
Max Reitz Sept. 3, 2013, 1:51 p.m. UTC | #2
On 2013-09-03 15:39, Eric Blake wrote:
> On 09/02/2013 07:01 AM, Max Reitz wrote:
>> Add an appropriate entry describing this event and its parameters into
>> qmp-events.txt.
>>
>> Signed-off-by: Max Reitz <mreitz@redhat.com>
>> ---
>> Follow-up to:
>>   - Add metadata overlap checks (series, v5); particularly patch 2
>>     (qcow2: Metadata overlap checks)
>> ---
>>   QMP/qmp-events.txt | 22 ++++++++++++++++++++++
>>   1 file changed, 22 insertions(+)
>>
>> diff --git a/QMP/qmp-events.txt b/QMP/qmp-events.txt
>> index 39b6016..6ff74d6 100644
>> --- a/QMP/qmp-events.txt
>> +++ b/QMP/qmp-events.txt
>> @@ -478,3 +478,25 @@ Example:
>>   
>>   { "event": "GUEST_PANICKED",
>>        "data": { "action": "pause" } }
>> +
>> +BLOCK_IMAGE_CORRUPTED
>> +---------------------
> The content is fine, but the location is not.  We are trying to keep
> this file sorted by event name, so this belongs between BALLOON_CHANGE
> and BLOCK_IO_ERROR.
Okay, I was wondering about something like that, but the GUEST_PANICED 
at the end signaled to me there would be no such sorting. ;-)

> As sorting is trivial, you can add this to your v2:
> Reviewed-by: Eric Blake <eblake@redhat.com>
>
Thank you, I just sent v2.

Max
diff mbox

Patch

diff --git a/QMP/qmp-events.txt b/QMP/qmp-events.txt
index 39b6016..6ff74d6 100644
--- a/QMP/qmp-events.txt
+++ b/QMP/qmp-events.txt
@@ -478,3 +478,25 @@  Example:
 
 { "event": "GUEST_PANICKED",
      "data": { "action": "pause" } }
+
+BLOCK_IMAGE_CORRUPTED
+---------------------
+
+Emitted when a disk image is being marked corrupt.
+
+Data:
+
+- "device": Device name (json-string)
+- "msg":    Informative message (e.g., reason for the corruption) (json-string)
+- "offset": If the corruption resulted from an image access, this is the access
+            offset into the image (json-int)
+- "size":   If the corruption resulted from an image access, this is the access
+            size (json-int)
+
+Example:
+
+{ "event": "BLOCK_IMAGE_CORRUPTED",
+    "data": { "device": "ide0-hd0",
+        "msg": "Prevented active L1 table overwrite", "offset": 196608,
+        "size": 65536 },
+    "timestamp": { "seconds": 1378126126, "microseconds": 966463 } }