From: Jiri Denemark <jdenemar@redhat.com>
Date: Tue, 28 Jun 2016 12:00:03 +0000 (+0200)
Subject: docs: Warn against locked memory limit too high
X-Git-Url: http://xenbits.xensource.com/gitweb?a=commitdiff_plain;h=60a545fa685c1083cb1a430ece2a0f8fabc0586a;p=libvirt.git

docs: Warn against locked memory limit too high

https://bugzilla.redhat.com/show_bug.cgi?id=1046833

Signed-off-by: Jiri Denemark <jdenemar@redhat.com>
---

diff --git a/docs/formatdomain.html.in b/docs/formatdomain.html.in
index f660aa685c..b0b2f82ee0 100644
--- a/docs/formatdomain.html.in
+++ b/docs/formatdomain.html.in
@@ -862,8 +862,11 @@
         be allowed to swap them out. For QEMU/KVM this requires
         <code>hard_limit</code> <a href="#elementsMemoryTuning">memory tuning</a>
         element to be used and set to the maximum memory configured for the
-        domain plus any memory consumed by the QEMU process itself.
-        <span class="since">Since 1.0.6</span></dd>
+        domain plus any memory consumed by the QEMU process itself. Beware of
+        setting the memory limit too high (and thus allowing the domain to lock
+        most of the host's memory). Doing so may be dangerous to both the
+        domain and the host itself since the host's kernel may run out of
+        memory. <span class="since">Since 1.0.6</span></dd>
     </dl>