aboutsummaryrefslogtreecommitdiffstats
path: root/docs/misc/libxl_memory.txt
diff options
context:
space:
mode:
authorIan Campbell <ian.campbell@citrix.com>2012-10-01 17:54:11 +0100
committerIan Campbell <ian.campbell@citrix.com>2012-10-01 17:54:11 +0100
commit5c88d313c0a57b0c8a7c72cd6e14737d1cc26ea4 (patch)
tree565d0c67e4b0ba46b421961bb8201466ba2873ee /docs/misc/libxl_memory.txt
parent8dbecc00d5f97d9809dcc6f0e80f1e2637e11351 (diff)
downloadxen-5c88d313c0a57b0c8a7c72cd6e14737d1cc26ea4.tar.gz
xen-5c88d313c0a57b0c8a7c72cd6e14737d1cc26ea4.tar.bz2
xen-5c88d313c0a57b0c8a7c72cd6e14737d1cc26ea4.zip
docs: initial documentation for xenstore paths
This is based upon my inspection of a system with a single PV domain and a single HVM domain running and is therefore very incomplete. Signed-off-by: Ian Campbell <ian.campbell@citrix.com> Acked-by: Ian Jackson <ian.jackson@eu.citrix.com> Committed-by: Ian Jackson <ian.jackson@eu.citrix.com>
Diffstat (limited to 'docs/misc/libxl_memory.txt')
-rw-r--r--docs/misc/libxl_memory.txt70
1 files changed, 70 insertions, 0 deletions
diff --git a/docs/misc/libxl_memory.txt b/docs/misc/libxl_memory.txt
new file mode 100644
index 0000000000..253476d208
--- /dev/null
+++ b/docs/misc/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
+
+
+ ========================================================================= */