From: Julien Grall Date: Thu, 25 Mar 2021 17:46:30 +0000 (+0000) Subject: docs/misc: xenstored: Re-instate and tweak the documentation for XS_RESUME X-Git-Tag: archive/raspbian/4.16.0+51-g0941d6cb-1+rpi1~2^2~42^2~801 X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=03bee3fd475cb755572dd21214daecf9a77a6bb4;p=xen.git docs/misc: xenstored: Re-instate and tweak the documentation for XS_RESUME Commit 13dd372834a4 removed the documentation for XS_RESUME, however this command is still implemented (at least in C Xenstored) and used by libxl when resuming a domain. So re-instate the documentation for the XS_RESUME. Take the opportunity to update it as there is a user of the command. Fixes: 13dd372834a4 ("docs/designs: re-work the xenstore migration document...") Signed-off-by: Julien Grall Reviewed-by: Paul Durrant Reviewed-by: Juergen Gross Reviewed-by: Ian Jackson Release-Acked-by: Ian Jackson --- diff --git a/docs/misc/xenstore.txt b/docs/misc/xenstore.txt index 1480742330..334dc8b6fd 100644 --- a/docs/misc/xenstore.txt +++ b/docs/misc/xenstore.txt @@ -294,6 +294,22 @@ IS_DOMAIN_INTRODUCED | T| or F| ie, if INTRODUCE for the domain has not yet been followed by domain destruction or explicit RELEASE. +RESUME | + + Arranges that @releaseDomain events will once more be + generated when the domain becomes shut down. This might have + to be used if a domain were to be shut down (generating one + @releaseDomain) and then subsequently restarted, since the + state-sensitive algorithm in xenstored will not otherwise send + further watch event notifications if the domain were to be + shut down again. + + This command will be issued in place such as resume because + Xen will "shutdown" the domain on suspend. + + xenstored prevents the use of RESUME other than by dom0. + + SET_TARGET || Notifies xenstored that domain is targeting domain . This grants domain full access to paths