diff options
author | Ian Jackson <ian.jackson@eu.citrix.com> | 2012-08-03 09:54:15 +0100 |
---|---|---|
committer | Ian Jackson <ian.jackson@eu.citrix.com> | 2012-08-03 09:54:15 +0100 |
commit | 215f2a9aa994541259aa2c271158a173a7f099ef (patch) | |
tree | 46354ccebe6d7a4396c4483623f712f5ddc7efe1 | |
parent | 15c7bb46682e37def21acb584f0cfd096a9f96dc (diff) | |
download | xen-215f2a9aa994541259aa2c271158a173a7f099ef.tar.gz xen-215f2a9aa994541259aa2c271158a173a7f099ef.tar.bz2 xen-215f2a9aa994541259aa2c271158a173a7f099ef.zip |
libxl: add a comment re the memory management API instability
Signed-off-by: Ian Jackson <ian.jackson@eu.citrix.com>
Acked-by: Ian Campbell <ian.campbell@citrix.com>
Committed-by: Ian Campbell <ian.campbell@citrix.com>
-rw-r--r-- | tools/libxl/libxl.h | 12 |
1 files changed, 12 insertions, 0 deletions
diff --git a/tools/libxl/libxl.h b/tools/libxl/libxl.h index cc74e1359f..c614d6fdb9 100644 --- a/tools/libxl/libxl.h +++ b/tools/libxl/libxl.h @@ -567,6 +567,17 @@ int libxl_domain_core_dump(libxl_ctx *ctx, uint32_t domid, int libxl_domain_setmaxmem(libxl_ctx *ctx, uint32_t domid, uint32_t target_memkb); int libxl_set_memory_target(libxl_ctx *ctx, uint32_t domid, int32_t target_memkb, int relative, int enforce); int libxl_get_memory_target(libxl_ctx *ctx, uint32_t domid, uint32_t *out_target); + + +/* + * WARNING + * This memory management API is unstable even in Xen 4.2. + * It has a numer of deficiencies and we intend to replace it. + * + * The semantics of these functions should not be relied on to be very + * coherent or stable. We will however endeavour to keep working + * existing programs which use them in roughly the same way as libxl. + */ /* how much free memory in the system a domain needs to be built */ int libxl_domain_need_memory(libxl_ctx *ctx, libxl_domain_build_info *b_info, uint32_t *need_memkb); @@ -577,6 +588,7 @@ int libxl_wait_for_free_memory(libxl_ctx *ctx, uint32_t domid, uint32_t memory_k /* wait for the memory target of a domain to be reached */ int libxl_wait_for_memory_target(libxl_ctx *ctx, uint32_t domid, int wait_secs); + int libxl_vncviewer_exec(libxl_ctx *ctx, uint32_t domid, int autopass); int libxl_console_exec(libxl_ctx *ctx, uint32_t domid, int cons_num, libxl_console_type type); /* libxl_primary_console_exec finds the domid and console number |