From bfc2e6e9423da679a35f33a9c488060748d94844 Mon Sep 17 00:00:00 2001 From: Stefano Stabellini Date: Thu, 8 May 2014 16:43:08 +0100 Subject: [PATCH] clarify SHUTDOWN_suspend additional argument Clarify the behaviour of SCHEDOP_shutdown: PV x86 guests need to pass a third argument, that is unused on HVM and ARM guests. Signed-off-by: Stefano Stabellini Acked-by: Ian Campbell --- xen/include/public/sched.h | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/xen/include/public/sched.h b/xen/include/public/sched.h index a30b11d96a..4000ac99dd 100644 --- a/xen/include/public/sched.h +++ b/xen/include/public/sched.h @@ -76,9 +76,10 @@ * Halt execution of this domain (all VCPUs) and notify the system controller. * @arg == pointer to sched_shutdown_t structure. * - * If the sched_shutdown_t reason is SHUTDOWN_suspend then this - * hypercall takes an additional extra argument which should be the - * MFN of the guest's start_info_t. + * If the sched_shutdown_t reason is SHUTDOWN_suspend then + * x86 PV guests must also set RDX (EDX for 32-bit guests) to the MFN + * of the guest's start info page. RDX/EDX is the third hypercall + * argument. * * In addition, which reason is SHUTDOWN_suspend this hypercall * returns 1 if suspend was cancelled or the domain was merely -- 2.30.2