From nobody Fri Apr 19 04:12:09 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) client-ip=192.237.175.120; envelope-from=xen-devel-bounces@lists.xenproject.org; helo=lists.xenproject.org; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) smtp.mailfrom=xen-devel-bounces@lists.xenproject.org ARC-Seal: i=1; a=rsa-sha256; t=1616695607; cv=none; d=zohomail.com; s=zohoarc; b=bezlnb+r4sYxCXlE88l4ZfFajcnn9xNsZtvEGDTVIwAttCu7dS1+t6YZW89PkGjgVGF5ZI/M64SPyjBNFMAWLWp7QA9er4WHgn8a6damFO0ltjIVM8r0wvGT3l3Mj+cAtNPTvW3zKtKHBqNUKkPUzoAWe5LlfJth9ei4MvZDCVk= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1616695607; h=Cc:Date:From:List-Subscribe:List-Post:List-Id:List-Help:List-Unsubscribe:Message-ID:Sender:Subject:To; bh=qRNFWzZA5VgpVn9HQse1rowwm85yesvKUlr0ASDLAfU=; b=G+vtlFh/Fa2wpvBEys3qdaUB54gHzqRSoeLjzkLCDQJ6V258Mmoh1GDrWOCeThR9mj0vNAVnI8hJAImac2BuwUAmDX3QfdOD/s84ktNTswTsyeBBYc8nxrmRj55CoFNz0wYseEIb6N4SFOZuGAMnwtiJJyHK0/75LXu5Wyguu9c= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) smtp.mailfrom=xen-devel-bounces@lists.xenproject.org Return-Path: Received: from lists.xenproject.org (lists.xenproject.org [192.237.175.120]) by mx.zohomail.com with SMTPS id 1616695607085802.8507969285606; Thu, 25 Mar 2021 11:06:47 -0700 (PDT) Received: from list by lists.xenproject.org with outflank-mailman.101509.194253 (Exim 4.92) (envelope-from ) id 1lPUN3-00083z-NB; Thu, 25 Mar 2021 18:06:13 +0000 Received: by outflank-mailman (output) from mailman id 101509.194253; Thu, 25 Mar 2021 18:06:13 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1lPUN3-00083s-K5; Thu, 25 Mar 2021 18:06:13 +0000 Received: by outflank-mailman (input) for mailman id 101509; Thu, 25 Mar 2021 18:06:12 +0000 Received: from mail.xenproject.org ([104.130.215.37]) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1lPUN2-00083n-B3 for xen-devel@lists.xenproject.org; Thu, 25 Mar 2021 18:06:12 +0000 Received: from xenbits.xenproject.org ([104.239.192.120]) by mail.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1lPUN1-0001K7-5H; Thu, 25 Mar 2021 18:06:11 +0000 Received: from 54-240-197-235.amazon.com ([54.240.197.235] helo=ufe34d9ed68d054.ant.amazon.com) by xenbits.xenproject.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1lPUN0-0007BL-MF; Thu, 25 Mar 2021 18:06:10 +0000 X-Outflank-Mailman: Message body and most headers restored to incoming version X-BeenThere: xen-devel@lists.xenproject.org List-Id: Xen developer discussion List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Errors-To: xen-devel-bounces@lists.xenproject.org Precedence: list Sender: "Xen-devel" DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=xen.org; s=20200302mail; h=Message-Id:Date:Subject:Cc:To:From; bh=qRNFWzZA5VgpVn9HQse1rowwm85yesvKUlr0ASDLAfU=; b=jFVTTcOfMI1HxtnCk/3SII8Ysi CnHOTAjC/jTOXea+ihRTtvxpDgAzw24zZjdb0OJP0LPyGv+rPXfT+Yrg/qVttMixkDIhpR1dNt11Q 7Gazvnq9YUhGIo1uqbR/kavzxXVRIzGMr8WUd4QEqN26EhT+gb162g9m82J0gym2Emo0=; From: Julien Grall To: xen-devel@lists.xenproject.org Cc: julien@xen.org, Julien Grall , Andrew Cooper , George Dunlap , Ian Jackson , Jan Beulich , Stefano Stabellini , Wei Liu , raphning@gmail.com, jgross@suse.com, paul@xen.org Subject: [PATCH for-4.15?] docs/misc: xenstored: Re-instate and tweak the documentation for XS_RESUME Date: Thu, 25 Mar 2021 18:06:06 +0000 Message-Id: <20210325180607.13158-1-julien@xen.org> X-Mailer: git-send-email 2.17.1 X-ZohoMail-DKIM: pass (identity @xen.org) Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" From: Julien Grall 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: Ian Jackson Reviewed-by: Juergen Gross Reviewed-by: Paul Durrant --- Cc: raphning@gmail.com Cc: jgross@suse.com Cc: paul@xen.org Ian, would you still consider documentation update for 4.15? I looked at the implementation of domain_resume() in Xen, it doesn't look like we can get away with XS_RESUME because Xen will not send VIRQ_DOM_EXC on resume. --- docs/misc/xenstore.txt | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/docs/misc/xenstore.txt b/docs/misc/xenstore.txt index 148074233001..334dc8b6fdf5 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. =20 +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 --=20 2.17.1