[libvirt] [PATCH] virsh.pod: Add information regarding LXC for setmem, memtune, and dominfo

John Ferlan jferlan at redhat.com
Thu Feb 26 23:39:29 UTC 2015


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

Modify the virsh man page to more accurately describe which values are
set by the virsh setmem and displayed by the virsh memtune or dominfo
based on the setmem command results.

Signed-off-by: John Ferlan <jferlan at redhat.com>
---
 tools/virsh.pod | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/tools/virsh.pod b/tools/virsh.pod
index 343f26f..e435d01 100644
--- a/tools/virsh.pod
+++ b/tools/virsh.pod
@@ -1925,6 +1925,13 @@ For example, vSphere/ESX rounds the parameter up to mebibytes (1024 kibibytes).
 For Xen, you can only adjust the memory of a running domain if the domain is
 paravirtualized or running the PV balloon driver.
 
+For LXC, the value being set is the cgroups value for limit_in_bytes or the
+maximum amount of user memory (including file cache). When viewing memory
+inside the container, this is the /proc/meminfo "MemTotal" value. When viewing
+the value from the host, use the B<virsh memtune> command. In order to view
+the current memory in use and the maximum value allowed to set memory, use
+the B<virsh dominfo> command.
+
 =item B<setmaxmem> I<domain> B<size> [[I<--config>] [I<--live>] |
 [I<--current>]]
 
@@ -1973,6 +1980,9 @@ Thus, when counting them, one needs to add up guest RAM, guest video RAM, and
 some memory overhead of QEMU itself.  The last piece is hard to determine so
 one needs guess and try.
 
+For LXC, the displayed hard_limit value is the current memory setting
+from the XML or the results from a B<virsh setmem> command.
+
 =over 4
 
 =item I<--hard-limit>
-- 
2.1.0




More information about the libvir-list mailing list