From nobody Sun Mar 9 21:24:30 2025 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; dmarc=pass(p=quarantine dis=none) header.from=suse.com ARC-Seal: i=1; a=rsa-sha256; t=1741164749; cv=none; d=zohomail.com; s=zohoarc; b=Xbike5hrrQvuZSO4nq7OUs9fgfDhyTrlicPXkPDFucIZLH68NskYq6R5zevdgyzTxYnlT7UhDoit9Ef+tBebYtKv31lnQrPgiwIQlxPP162jTUR8zBeD+f32gZmFHWu2DJNFqqZy7NbSnuRJeU2gtX+WDNtq1s8FAgEhc21TogU= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1741164749; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:List-Subscribe:List-Post:List-Id:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=I5Bc9rU0KT2B8+T8rdQdBb6mywfIx5ZdefRDz/gR084=; b=jOrJD9dF7rUeeicQlt5xqdVYXj/yisFk7EbBRI/uQe8AaNK7dyDnuAcYCfYJx0HMTlno7ohzlvb+cN3H4VYRC2O5NSZzxDU44ua2rLRb7KAEHf/bBHf3SNYIdgZbwppGuUugeGg0GOfZAdYtAvtFvUKrtEi6M8/flDPO5pL/eXQ= 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; dmarc=pass header.from= (p=quarantine dis=none) Return-Path: Received: from lists.xenproject.org (lists.xenproject.org [192.237.175.120]) by mx.zohomail.com with SMTPS id 1741164749325144.9868535256801; Wed, 5 Mar 2025 00:52:29 -0800 (PST) Received: from list by lists.xenproject.org with outflank-mailman.901835.1309756 (Exim 4.92) (envelope-from ) id 1tpkU8-0000E0-D3; Wed, 05 Mar 2025 08:52:12 +0000 Received: by outflank-mailman (output) from mailman id 901835.1309756; Wed, 05 Mar 2025 08:52:12 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1tpkU8-0000Dt-A6; Wed, 05 Mar 2025 08:52:12 +0000 Received: by outflank-mailman (input) for mailman id 901835; Wed, 05 Mar 2025 08:52:10 +0000 Received: from se1-gles-flk1-in.inumbo.com ([94.247.172.50] helo=se1-gles-flk1.inumbo.com) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1tpkU6-0000Dn-QH for xen-devel@lists.xenproject.org; Wed, 05 Mar 2025 08:52:10 +0000 Received: from smtp-out1.suse.de (smtp-out1.suse.de [195.135.223.130]) by se1-gles-flk1.inumbo.com (Halon) with ESMTPS id 1d1dcd6e-f99f-11ef-9898-31a8f345e629; Wed, 05 Mar 2025 09:52:05 +0100 (CET) Received: from imap1.dmz-prg2.suse.org (imap1.dmz-prg2.suse.org [IPv6:2a07:de40:b281:104:10:150:64:97]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by smtp-out1.suse.de (Postfix) with ESMTPS id 27B3421199; Wed, 5 Mar 2025 08:52:05 +0000 (UTC) Received: from imap1.dmz-prg2.suse.org (localhost [127.0.0.1]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by imap1.dmz-prg2.suse.org (Postfix) with ESMTPS id CF2BC13939; Wed, 5 Mar 2025 08:52:04 +0000 (UTC) Received: from dovecot-director2.suse.de ([2a07:de40:b281:106:10:150:64:167]) by imap1.dmz-prg2.suse.org with ESMTPSA id 4kCsMLQQyGdSYAAAD6G6ig (envelope-from ); Wed, 05 Mar 2025 08:52:04 +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" X-Inumbo-ID: 1d1dcd6e-f99f-11ef-9898-31a8f345e629 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=susede1; t=1741164725; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version: content-transfer-encoding:content-transfer-encoding; bh=I5Bc9rU0KT2B8+T8rdQdBb6mywfIx5ZdefRDz/gR084=; b=cBnylPGgHI8W0cfwahhf1qDi1l+ltYs4y08oRp7U//Szs1bBLxlt+6hQK5t6cWaOOTvUn1 U0QeLjOWtqM57s1m2RjnOmkUislCDPoiiLL1QSuMtUYLEH0D/aFEfHl38oZiOfTV4x4Jwh bCIh9Y7AMw5lU1lCaJOeBG2v43dntNo= Authentication-Results: smtp-out1.suse.de; dkim=pass header.d=suse.com header.s=susede1 header.b=cBnylPGg DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=susede1; t=1741164725; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version: content-transfer-encoding:content-transfer-encoding; bh=I5Bc9rU0KT2B8+T8rdQdBb6mywfIx5ZdefRDz/gR084=; b=cBnylPGgHI8W0cfwahhf1qDi1l+ltYs4y08oRp7U//Szs1bBLxlt+6hQK5t6cWaOOTvUn1 U0QeLjOWtqM57s1m2RjnOmkUislCDPoiiLL1QSuMtUYLEH0D/aFEfHl38oZiOfTV4x4Jwh bCIh9Y7AMw5lU1lCaJOeBG2v43dntNo= From: Juergen Gross To: xen-devel@lists.xenproject.org Cc: Juergen Gross , Andrew Cooper , Anthony PERARD , Michal Orzel , Jan Beulich , Julien Grall , =?UTF-8?q?Roger=20Pau=20Monn=C3=A9?= , Stefano Stabellini Subject: [PATCH] docs: fix INTRODUCE description in xenstore.txt Date: Wed, 5 Mar 2025 09:52:01 +0100 Message-ID: <20250305085201.14258-1-jgross@suse.com> X-Mailer: git-send-email 2.43.0 MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Rspamd-Queue-Id: 27B3421199 X-Spam-Level: X-Spamd-Result: default: False [-3.01 / 50.00]; BAYES_HAM(-3.00)[99.99%]; NEURAL_HAM_LONG(-1.00)[-1.000]; MID_CONTAINS_FROM(1.00)[]; R_MISSING_CHARSET(0.50)[]; R_DKIM_ALLOW(-0.20)[suse.com:s=susede1]; NEURAL_HAM_SHORT(-0.20)[-1.000]; MIME_GOOD(-0.10)[text/plain]; MX_GOOD(-0.01)[]; DBL_BLOCKED_OPENRESOLVER(0.00)[suse.com:email,suse.com:dkim,suse.com:mid,imap1.dmz-prg2.suse.org:helo,imap1.dmz-prg2.suse.org:rdns]; RCVD_VIA_SMTP_AUTH(0.00)[]; FROM_EQ_ENVFROM(0.00)[]; ARC_NA(0.00)[]; MIME_TRACE(0.00)[0:+]; FROM_HAS_DN(0.00)[]; TO_MATCH_ENVRCPT_ALL(0.00)[]; FUZZY_BLOCKED(0.00)[rspamd.com]; RCVD_TLS_ALL(0.00)[]; RCVD_COUNT_TWO(0.00)[2]; RCPT_COUNT_SEVEN(0.00)[9]; DKIM_SIGNED(0.00)[suse.com:s=susede1]; TO_DN_SOME(0.00)[]; DKIM_TRACE(0.00)[suse.com:+] X-Rspamd-Server: rspamd2.dmz-prg2.suse.org X-Rspamd-Action: no action X-Spam-Score: -3.01 X-Spam-Flag: NO X-ZohoMail-DKIM: pass (identity @suse.com) X-ZM-MESSAGEID: 1741164752567019100 Content-Type: text/plain; charset="utf-8" The description of the Xenstore INTRODUCE command is still referencing xend. Fix that. While at it, make clear that the Xenstore implementation is allowed to ignore the specified gfn and use the Xenstore reserved grant id GNTTAB_RESERVED_XENSTORE instead. Signed-off-by: Juergen Gross --- docs/misc/xenstore.txt | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/misc/xenstore.txt b/docs/misc/xenstore.txt index 38015835b1..d894d24d11 100644 --- a/docs/misc/xenstore.txt +++ b/docs/misc/xenstore.txt @@ -286,7 +286,7 @@ TRANSACTION_END F| INTRODUCE |||? Notifies xenstored to communicate with this domain. =20 - INTRODUCE is currently only used by xend (during domain + INTRODUCE is currently only used by xen tools (during domain startup and various forms of restore and resume), and xenstored prevents its use other than by dom0. =20 @@ -299,6 +299,10 @@ INTRODUCE |||? for example passing a high-bit-set 32-bit gfn as an unsigned decimal will attempt to use 0x7fffffff instead (!). =20 + Xenstored might ignore the value and use the reserved + grant table entry GNTTAB_RESERVED_XENSTORE instead for mapping + the Xenstore interface page of the guest. + RELEASE | Manually requests that xenstored disconnect from the domain. The event channel is unbound at the xenstored end and the page --=20 2.43.0