From nobody Sun Mar 9 22:33:28 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=1741247310; cv=none; d=zohomail.com; s=zohoarc; b=c2/S7Iuyqj8NQE7U92yJ4KDV5c+N4/3OT8wEw4GfIvCAYrtbx3xBgJzawcQthE/cr7LfFBYXdKvu8W3bQ7HtirD8ax1tOPg+gEKSUQyutLXTv90nmF4kZqzxrpEJXsEC4Xfh/dGonewgBfisyTaJkBM6tPXGcoPQjHdKpXx8CiU= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1741247310; 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=IXajTnQR6rguwzjmxMX4Wjp94Ht5U2Pcz/IXQXqMUu8=; b=TPvXYUcO+z15rHpeBXNf57rZi4KKoY0c8AJqy8DluqAcfHKgeBvJoO4d+cMMADRy7qAUIB421vWduImtEYVpxs3Ybk0AhTlHqAYS/fdMHSx9ATqlHb1zZRAmCcbGLEjLsIwahzjoxEXHLVa+b9DSgRhOdtcpGDONQ32TmznV1C8= 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 1741247310801292.84333117425274; Wed, 5 Mar 2025 23:48:30 -0800 (PST) Received: from list by lists.xenproject.org with outflank-mailman.903017.1310933 (Exim 4.92) (envelope-from ) id 1tq5xX-0004Mw-S9; Thu, 06 Mar 2025 07:47:59 +0000 Received: by outflank-mailman (output) from mailman id 903017.1310933; Thu, 06 Mar 2025 07:47:59 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1tq5xX-0004Mp-Pb; Thu, 06 Mar 2025 07:47:59 +0000 Received: by outflank-mailman (input) for mailman id 903017; Thu, 06 Mar 2025 07:47:58 +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 1tq5xW-0004Mi-F9 for xen-devel@lists.xenproject.org; Thu, 06 Mar 2025 07:47:58 +0000 Received: from smtp-out2.suse.de (smtp-out2.suse.de [195.135.223.131]) by se1-gles-flk1.inumbo.com (Halon) with ESMTPS id 51364355-fa5f-11ef-9898-31a8f345e629; Thu, 06 Mar 2025 08:47:56 +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-out2.suse.de (Postfix) with ESMTPS id AD0081F385; Thu, 6 Mar 2025 07:47:55 +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 5E5F413A61; Thu, 6 Mar 2025 07:47:55 +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 fd8eFStTyWf+dAAAD6G6ig (envelope-from ); Thu, 06 Mar 2025 07:47:55 +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: 51364355-fa5f-11ef-9898-31a8f345e629 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=susede1; t=1741247275; 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=IXajTnQR6rguwzjmxMX4Wjp94Ht5U2Pcz/IXQXqMUu8=; b=FF7Les/tnzWnKSZnD5kBac+Z59P2OIaD9j+Az4jc2In4kHQ7t1i7rOEUosDZ0DKbxQ3pdx FvvhuoV8X7nbQDwMQPg/3lULgbqHEhrj1UUFInScPZ6XX3Zk8XRiJtHDlKGTSUA/1F656c W2i8zupzweTNS6HQlFAogM/wCs4GQhE= Authentication-Results: smtp-out2.suse.de; dkim=pass header.d=suse.com header.s=susede1 header.b="FF7Les/t" DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=susede1; t=1741247275; 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=IXajTnQR6rguwzjmxMX4Wjp94Ht5U2Pcz/IXQXqMUu8=; b=FF7Les/tnzWnKSZnD5kBac+Z59P2OIaD9j+Az4jc2In4kHQ7t1i7rOEUosDZ0DKbxQ3pdx FvvhuoV8X7nbQDwMQPg/3lULgbqHEhrj1UUFInScPZ6XX3Zk8XRiJtHDlKGTSUA/1F656c W2i8zupzweTNS6HQlFAogM/wCs4GQhE= 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 v2] docs: fix INTRODUCE description in xenstore.txt Date: Thu, 6 Mar 2025 08:47:52 +0100 Message-ID: <20250306074752.13208-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: AD0081F385 X-Spam-Level: X-Spamd-Result: default: False [-3.01 / 50.00]; BAYES_HAM(-3.00)[99.99%]; MID_CONTAINS_FROM(1.00)[]; NEURAL_HAM_LONG(-1.00)[-1.000]; 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)[imap1.dmz-prg2.suse.org:helo,imap1.dmz-prg2.suse.org:rdns,suse.com:email,suse.com:dkim,suse.com:mid]; ARC_NA(0.00)[]; RCVD_VIA_SMTP_AUTH(0.00)[]; RBL_SPAMHAUS_BLOCKED_OPENRESOLVER(0.00)[2a07:de40:b281:104:10:150:64:97:from]; FROM_HAS_DN(0.00)[]; TO_DN_SOME(0.00)[]; MIME_TRACE(0.00)[0:+]; TO_MATCH_ENVRCPT_ALL(0.00)[]; FROM_EQ_ENVFROM(0.00)[]; RCPT_COUNT_SEVEN(0.00)[9]; DKIM_SIGNED(0.00)[suse.com:s=susede1]; FUZZY_BLOCKED(0.00)[rspamd.com]; RCVD_COUNT_TWO(0.00)[2]; RCVD_TLS_ALL(0.00)[]; SPAMHAUS_XBL(0.00)[2a07:de40:b281:104:10:150:64:97:from]; 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: 1741247312887019000 Content-Type: text/plain; charset="utf-8" The description of the Xenstore INTRODUCE command is still referencing xend. Fix that. The description is starting with a grammatically wrong sentence. 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 --- V2: - fix description - reword vs. grant usage (Andrew Cooper) --- docs/misc/xenstore.txt | 21 +++++++++++++++++---- 1 file changed, 17 insertions(+), 4 deletions(-) diff --git a/docs/misc/xenstore.txt b/docs/misc/xenstore.txt index 38015835b1..7e1f031520 100644 --- a/docs/misc/xenstore.txt +++ b/docs/misc/xenstore.txt @@ -286,19 +286,32 @@ 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 must be a real domain id (not 0 and not a special DOMID_... value). must be a page in that domain - represented in signed decimal (!). must be event - channel is an unbound event channel in (likewise in - decimal), on which xenstored will call bind_interdomain. + represented in signed decimal (!). is an unbound + event channel in (likewise in decimal), on which + xenstored will call bind_interdomain. + Violations of these rules may result in undefined behaviour; for example passing a high-bit-set 32-bit gfn as an unsigned decimal will attempt to use 0x7fffffff instead (!). =20 + The field is used by xenstoreds which use foreign + mapping to access the ring page. + + Alternatively, Grant 1 (GNTTAB_RESERVED_XENSTORE) is reserved + for the same purpose, and is populated by the domain builder + on behalf of the guest. This mechanism is preferred because + it reduces the permissions that xenstored needs in order to + function. + + Both and Grant 1 need to agree, because implementations + of xenstored will use one and ignore the other. + 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