From 5b98da4197df39a76e0bf20ac4fbfce87aaec2b5 Mon Sep 17 00:00:00 2001 From: Wei Liu Date: Wed, 19 Jul 2017 15:59:11 +0100 Subject: [PATCH] x86/mm: document the return values from get_page_from_l*e Signed-off-by: Wei Liu Acked-by: Jan Beulich --- xen/arch/x86/mm.c | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/xen/arch/x86/mm.c b/xen/arch/x86/mm.c index 2a71212fb4..6df8534be8 100644 --- a/xen/arch/x86/mm.c +++ b/xen/arch/x86/mm.c @@ -877,6 +877,12 @@ static int print_mmio_emul_range(unsigned long s, unsigned long e, void *arg) } #endif +/* + * get_page_from_l1e returns: + * 0 => success (page not present also counts as such) + * <0 => error code + * >0 => the page flags to be flipped + */ int get_page_from_l1e( l1_pgentry_t l1e, struct domain *l1e_owner, struct domain *pg_owner) @@ -1089,6 +1095,12 @@ get_page_from_l1e( /* NB. Virtual address 'l2e' maps to a machine address within frame 'pfn'. */ +/* + * get_page_from_l2e returns: + * 1 => page not present + * 0 => success + * <0 => error code + */ define_get_linear_pagetable(l2); static int get_page_from_l2e( @@ -1119,6 +1131,12 @@ get_page_from_l2e( } +/* + * get_page_from_l3e returns: + * 1 => page not present + * 0 => success + * <0 => error code + */ define_get_linear_pagetable(l3); static int get_page_from_l3e( @@ -1146,6 +1164,12 @@ get_page_from_l3e( return rc; } +/* + * get_page_from_l4e returns: + * 1 => page not present + * 0 => success + * <0 => error code + */ define_get_linear_pagetable(l4); static int get_page_from_l4e( -- 2.39.5