[Xen-changelog] [xen-unstable] xl: xl.conf(5): correct advice re autoballooning vs. dom0_mem.

[Xen patchbot-unstable <patchbot@xxxxxxx>]

# HG changeset patch
# User Ian Campbell <ian.campbell@xxxxxxxxxx>
# Date 1354025620 0
# Node ID 17ffbe7cf645029a9c9e0c875ccd9424ec56ac62
# Parent  24779046247dceaeeef194b77b00d3ed0ef1563a
xl: xl.conf(5): correct advice re autoballooning vs. dom0_mem.

The advice was backwards, you should really disable autoballoon if you
use dom0_mem. Also add a reference to the command-line docs.

Signed-off-by: Ian Campbell <ian.campbell@xxxxxxxxxx>
Acked-by: Stefano Stabellini <stefano.stabellini@xxxxxxxxxxxxx>
Committed-by: Ian Campbell <ian.campbell@xxxxxxxxxx>
---


diff -r 24779046247d -r 17ffbe7cf645 docs/man/xl.conf.pod.5
--- a/docs/man/xl.conf.pod.5    Tue Nov 27 14:13:39 2012 +0000
+++ b/docs/man/xl.conf.pod.5    Tue Nov 27 14:13:40 2012 +0000
@@ -49,9 +49,9 @@ The semantics of each C<KEY> defines whi
 
 If disabled then C<xl> will not attempt to reduce the amount of memory
 assigned to domain 0 in order to create free memory when starting a
-new domain. You should set this if you use the C<dom0_mem> hypervisor
-command line to reduce the amount of memory given to domain 0 by
-default.
+new domain. You are strongly recommended to set this to C<0>
+(C<False>) if you use the C<dom0_mem> hypervisor command line to
+reduce the amount of memory given to domain 0 by default.
 
 Default: C<1>
 
diff -r 24779046247d -r 17ffbe7cf645 docs/misc/xen-command-line.markdown
--- a/docs/misc/xen-command-line.markdown       Tue Nov 27 14:13:39 2012 +0000
+++ b/docs/misc/xen-command-line.markdown       Tue Nov 27 14:13:40 2012 +0000
@@ -440,6 +440,11 @@ reservation is unlimited.
 For example, to set dom0's initial memory allocation to 512MB but
 allow it to balloon up as far as 1GB use `dom0_mem=512M,max:1G`
 
+If you use this option then it is highly recommended that you disable
+any dom0 autoballooning feature present in your toolstack. See the
+_xl.conf(5)_ man page or [Xen Best
+Practices](http://wiki.xen.org/wiki/Xen_Best_Practices#Xen_dom0_dedicated_memory_and_preventing_dom0_memory_ballooning).
+
 ### dom0\_shadow
 > `= <boolean>`
 

_______________________________________________
Xen-changelog mailing list
Xen-changelog@xxxxxxxxxxxxx
http://lists.xensource.com/xen-changelog