[libvirt] [PATCH] doc: Correct the default werror policy

Osier Yang jyang at redhat.com
Mon Oct 24 11:46:50 UTC 2011


<quote>
@item werror=@var{action},rerror=@var{action}
Specify which @var{action} to take on write and read errors. Valid actions are:
"ignore" (ignore the error and try to continue), "stop" (pause QEMU),
"report" (report the error to the guest), "enospc" (pause QEMU only if the
host disk is full; report the error to the guest otherwise).
The default setting is @option{werror=enospc} and @option{rerror=report}.
@item readonly
</quote>

libvirt doesn't set any default value for "(r)error_policy", the
original doc should mean QEMU sets "report" as the default value
for "werror", but it's not true, QEMU uses "enospc" as the default.
And it's better to document "(r)error_policy" are only supported
by QEMU.
---
 docs/formatdomain.html.in |   20 +++++++++-----------
 1 files changed, 9 insertions(+), 11 deletions(-)

diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
index dc6b152..e98e709 100644
--- a/docs/formatdomain.html.in
+++ b/docs/formatdomain.html.in
@@ -1011,19 +1011,17 @@
             The optional <code>error_policy</code> attribute controls
             how the hypervisor will behave on a disk read or write
             error, possible values are "stop", "report", "ignore", and
-            "enospace".<span class="since">Since 0.8.0, "report" since
-            0.9.7</span> The default setting of error_policy is "report".
-            There is also an
-            optional <code>rerror_policy</code> that controls behavior
-            for read errors only. <span class="since">Since
-            0.9.7</span>. If no rerror_policy is given, error_policy
-            is used for both read and write errors. If rerror_policy
-            is given, it overrides the <code>error_policy</code> for
-            read errors. Also note that "enospace" is not a valid
+            "enospace".<span class="since">Since 0.8.0 (QEMU and KVM only),
+            "report" since 0.9.7</span>. QEMU sets error_policy as "enospc"
+            by default. There is also an optional <code>rerror_policy</code>
+            that controls behavior for read errors only. <span class="since">
+            Since 0.9.7 (QEMU and KVM only)</span>. If no rerror_policy is
+            given, error_policy is used for both read and write errors. If
+            rerror_policy is given, it overrides the <code>error_policy</code>
+            for read errors. Also note that "enospace" is not a valid
             policy for read errors, so if <code>error_policy</code> is
             set to "enospace" and no <code>rerror_policy</code> is
-            given, the read error policy will be left at its default,
-            which is "report".
+            given, QEMU will set the read error policy as "report" by default.
           </li>
           <li>
             The optional <code>io</code> attribute controls specific
-- 
1.7.6




More information about the libvir-list mailing list