aboutsummaryrefslogtreecommitdiffstats
path: root/tools
diff options
context:
space:
mode:
authorIan Jackson <Ian.Jackson@eu.citrix.com>2010-10-21 18:51:26 +0100
committerIan Jackson <Ian.Jackson@eu.citrix.com>2010-10-21 18:51:26 +0100
commit38f0769cd02f0e0df81947b76d0e25ec8a291398 (patch)
tree38cfc19263bcfac6922c0ee3e6c904dca8e744f7 /tools
parenta050657a54f734d6ed809072f9c1329d8324ee67 (diff)
downloadxen-38f0769cd02f0e0df81947b76d0e25ec8a291398.tar.gz
xen-38f0769cd02f0e0df81947b76d0e25ec8a291398.tar.bz2
xen-38f0769cd02f0e0df81947b76d0e25ec8a291398.zip
libxl: add a detailed explanation of the libxl domain memory model
Originally-by: Stefano Stabellini <stefano.stabellini@eu.citrix.com> Converted to US-ASCII by iwj. Signed-off-by: Stefano Stabellini <stefano.stabellini@eu.citrix.com> Signed-off-by: Ian Jackson <ian.jackson@eu.citrix.com>
Diffstat (limited to 'tools')
-rw-r--r--tools/libxl/libxl_memory.txt70
1 files changed, 70 insertions, 0 deletions
diff --git a/tools/libxl/libxl_memory.txt b/tools/libxl/libxl_memory.txt
new file mode 100644
index 0000000000..253476d208
--- /dev/null
+++ b/tools/libxl/libxl_memory.txt
@@ -0,0 +1,70 @@
+/* === Domain memory breakdown: HVM guests ==================================
+
+ + +----------+ +
+ | | shadow | |
+ | +----------+ |
+ overhead | | extra | |
+ | | external | |
+ | +----------+ + |
+ | | extra | | |
+ | | internal | | |
+ + +----------+ + | | footprint
+ | | video | | | |
+ | +----------+ + + | | xen |
+ | | | | | | actual | maximum |
+ | | | | | | target | |
+ | | guest | | | build | | |
+ | | | | | start | | |
+ static | | | | | | | |
+ maximum | +----------+ | + + + +
+ | | | |
+ | | | |
+ | | balloon | | build
+ | | | | maximum
+ | | | |
+ + +----------+ +
+
+
+ extra internal = LIBXL_MAXMEM_CONSTANT
+ extra external = LIBXL_HVM_EXTRA_MEMORY
+ shadow = libxl_domain_build_info.shadow_memkb
+ static maximum = libxl_domain_build_info.max_memkb
+ video = libxl_domain_build_info.video_memkb
+ build start = libxl_domain_build_info.target_memkb
+ libxl_domain_setmaxmem -> xen maximum
+ libxl_set_memory_target -> actual target
+
+
+ === Domain memory breakdown: PV guests ==================================
+
+
+ + +----------+ +
+ overhead | | extra | |
+ | | external | |
+ | +----------+ + |
+ | | extra | | |
+ | | internal | | |
+ + +----------+ + + + | | footprint
+ | | | | | | | xen |
+ | | | | | | actual | maximum |
+ | | guest | | | build | target | |
+ | | | | | start | | |
+ static | | | | | | | |
+ maximum | +----------+ | + + + +
+ | | | |
+ | | | |
+ | | balloon | | build
+ | | | | maximum
+ | | | |
+ + +----------+ +
+
+
+ extra internal = LIBXL_MAXMEM_CONSTANT
+ extra external = LIBXL_PV_EXTRA_MEMORY
+ static maximum = libxl_domain_build_info.max_memkb
+ build start = libxl_domain_build_info.target_memkb
+ libxl_domain_setmaxmem -> xen maximum
+ libxl_set_memory_target -> actual target
+
+
+ ========================================================================= */