aboutsummaryrefslogtreecommitdiffstats
path: root/docs/misc/libxl_memory.txt
diff options
context:
space:
mode:
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
+
+
+ ========================================================================= */