From nobody Fri May 10 04:46:34 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; dmarc=pass(p=quarantine dis=none) header.from=suse.com ARC-Seal: i=1; a=rsa-sha256; t=1675941855; cv=none; d=zohomail.com; s=zohoarc; b=Bbe6iD7V9hwhsk/qy3RkUVSgMn9j6icZ1SG/0+dJfGKIU+RklKnlMnfDsxkualsmGWXYi/sjGDamFsFfWNR35ndSogS+rhbaDkKCvlzIl9ETM7fh2Q8bdEFFIzoEOddZ02c8zHIPWCjV+ibvnk4ZCnejwU0wBZTYRwdfMv9cfbM= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1675941855; h=Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=PIKqSOQIHwMFBZvx0nM7IWyLZBtpfrkRHMl2wjqjT3E=; b=SVwTo7Y1njzQ4So2Jh/vViI4UCqeb4/AcUOI7GyAYpArID9tDZiFqn9sziS6M/uuu2nSXVSsrSp1/8lQ6hor6uOcs2g2lRfRlUWU+yQd4iF715HIB0I60bS0aMmMFVOFguZW9MOzSY2KAD0xgvvEs6y1+I7E5h1ZAD1AzcE5dYk= 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 1675941855761851.978513436416; Thu, 9 Feb 2023 03:24:15 -0800 (PST) Received: from list by lists.xenproject.org with outflank-mailman.492344.761859 (Exim 4.92) (envelope-from ) id 1pQ51s-0002af-4V; Thu, 09 Feb 2023 11:23:52 +0000 Received: by outflank-mailman (output) from mailman id 492344.761859; Thu, 09 Feb 2023 11:23:52 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1pQ51s-0002aT-15; Thu, 09 Feb 2023 11:23:52 +0000 Received: by outflank-mailman (input) for mailman id 492344; Thu, 09 Feb 2023 11:23:50 +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 1pQ51q-0002Zd-Fg for xen-devel@lists.xenproject.org; Thu, 09 Feb 2023 11:23:50 +0000 Received: from smtp-out2.suse.de (smtp-out2.suse.de [2001:67c:2178:6::1d]) by se1-gles-flk1.inumbo.com (Halon) with ESMTPS id 38fe8b53-a86c-11ed-93b5-47a8fe42b414; Thu, 09 Feb 2023 12:23:48 +0100 (CET) Received: from imap2.suse-dmz.suse.de (imap2.suse-dmz.suse.de [192.168.254.74]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (P-521) server-digest SHA512) (No client certificate requested) by smtp-out2.suse.de (Postfix) with ESMTPS id 56FF35C833; Thu, 9 Feb 2023 11:23:48 +0000 (UTC) Received: from imap2.suse-dmz.suse.de (imap2.suse-dmz.suse.de [192.168.254.74]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (P-521) server-digest SHA512) (No client certificate requested) by imap2.suse-dmz.suse.de (Postfix) with ESMTPS id 1A1451339E; Thu, 9 Feb 2023 11:23:48 +0000 (UTC) Received: from dovecot-director2.suse.de ([192.168.254.65]) by imap2.suse-dmz.suse.de with ESMTPSA id dFbyBMTX5GN9PAAAMHmgww (envelope-from ); Thu, 09 Feb 2023 11:23:48 +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: 38fe8b53-a86c-11ed-93b5-47a8fe42b414 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=susede1; t=1675941828; 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: in-reply-to:in-reply-to:references:references; bh=PIKqSOQIHwMFBZvx0nM7IWyLZBtpfrkRHMl2wjqjT3E=; b=IwewnNqTk3JobxZe6TSwZ4V1BTOCmwaP1HnJByDYdSpVU7YFTBJlqOkOijfcEgVvpmbQQ8 hNmMqF5h4Ri9IoPsuUjYpPv7IvbuAR5GzjZFpTTkUFbdx0Ns9SzLstxiS2eOhvTdYwG15K CzNoCFenAB/ZF+d+BbtDTdAlsQKSFAY= From: Juergen Gross To: xen-devel@lists.xenproject.org Cc: andrew.cooper3@citrix.com, george.dunlap@citrix.com, jbeulich@suse.com, julien@xen.org, sstabellini@kernel.org, wl@xen.org, Juergen Gross Subject: [PATCH v4 1/2 RESEND] xen/public: fix 9pfs Xenstore entry documentation Date: Thu, 9 Feb 2023 12:23:37 +0100 Message-Id: <20230209112338.26287-2-jgross@suse.com> X-Mailer: git-send-email 2.35.3 In-Reply-To: <20230209112338.26287-1-jgross@suse.com> References: <20230209112338.26287-1-jgross@suse.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @suse.com) X-ZM-MESSAGEID: 1675941856881100001 Content-Type: text/plain; charset="utf-8" In xen/include/public/io/9pfs.h the documentation regarding the Xenstore entries isn't reflecting reality: the "tag" Xenstore entry is on the frontend side, not on the backend one. Signed-off-by: Juergen Gross Reviewed-by: Stefano Stabellini --- V4: - patch split off (Julien Grall) --- xen/include/public/io/9pfs.h | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/xen/include/public/io/9pfs.h b/xen/include/public/io/9pfs.h index 5dad0db869..617ad9afd7 100644 --- a/xen/include/public/io/9pfs.h +++ b/xen/include/public/io/9pfs.h @@ -64,12 +64,6 @@ * * Host filesystem path to share. * - * tag - * Values: - * - * Alphanumeric tag that identifies the 9pfs share. The client nee= ds - * to know the tag to be able to mount it. - * * security-model * Values: "none" * @@ -106,6 +100,12 @@ * map a page with information to setup a share ring. One for each * ring. * + * tag + * Values: + * + * Alphanumeric tag that identifies the 9pfs share. The client nee= ds + * to know the tag to be able to mount it. + * *************************************************************************= ***** * State Machine *************************************************************************= ***** --=20 2.35.3 From nobody Fri May 10 04:46:34 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; dmarc=pass(p=quarantine dis=none) header.from=suse.com ARC-Seal: i=1; a=rsa-sha256; t=1675941856; cv=none; d=zohomail.com; s=zohoarc; b=Tp2SZqrAA5BDguDoMPr9lc+iFYhLT05Cb688NHT+b0ER6gkiCX7WymD50WCHwb+bh3COSMaxpJxZ24PmmB4Wali87diWaYyCmp5+vnMVBOHM7PmEqGhzOG7VJmR4rC7+LJh/2HB6zLEpVCyYOsWGiMqgnZM4F+xNMI5JVl8SYcI= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1675941856; h=Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=l9hWyX1xxO2Hr5xWFMrMhIclyrLkWDLxq1LOLbj+I4I=; b=RYZqPBhChfcDo17g7CpyC9dSsIYKgAT8xK1p0dr8ruJ0Ys4HlflXlURreF5mc0JriSm2O1ElnriD+WRtvG9+XKfuZQjObJF97xN0uzZuhPzkePgOqwnDJ399bwdmkQHgroJ+JTz6/BK21Xiw0cB3SCl4oKOgYUGH9l1WSkLAd7E= 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 1675941856510607.2638681172693; Thu, 9 Feb 2023 03:24:16 -0800 (PST) Received: from list by lists.xenproject.org with outflank-mailman.492345.761870 (Exim 4.92) (envelope-from ) id 1pQ51w-0002tM-CR; Thu, 09 Feb 2023 11:23:56 +0000 Received: by outflank-mailman (output) from mailman id 492345.761870; Thu, 09 Feb 2023 11:23:56 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1pQ51w-0002tF-9V; Thu, 09 Feb 2023 11:23:56 +0000 Received: by outflank-mailman (input) for mailman id 492345; Thu, 09 Feb 2023 11:23:54 +0000 Received: from se1-gles-sth1-in.inumbo.com ([159.253.27.254] helo=se1-gles-sth1.inumbo.com) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1pQ51u-0002J1-Q2 for xen-devel@lists.xenproject.org; Thu, 09 Feb 2023 11:23:54 +0000 Received: from smtp-out2.suse.de (smtp-out2.suse.de [195.135.220.29]) by se1-gles-sth1.inumbo.com (Halon) with ESMTPS id 3c5783f4-a86c-11ed-933c-83870f6b2ba8; Thu, 09 Feb 2023 12:23:54 +0100 (CET) Received: from imap2.suse-dmz.suse.de (imap2.suse-dmz.suse.de [192.168.254.74]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (P-521) server-digest SHA512) (No client certificate requested) by smtp-out2.suse.de (Postfix) with ESMTPS id 055735C830; Thu, 9 Feb 2023 11:23:54 +0000 (UTC) Received: from imap2.suse-dmz.suse.de (imap2.suse-dmz.suse.de [192.168.254.74]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (P-521) server-digest SHA512) (No client certificate requested) by imap2.suse-dmz.suse.de (Postfix) with ESMTPS id C222E1339E; Thu, 9 Feb 2023 11:23:53 +0000 (UTC) Received: from dovecot-director2.suse.de ([192.168.254.65]) by imap2.suse-dmz.suse.de with ESMTPSA id 4G8qLsnX5GONPAAAMHmgww (envelope-from ); Thu, 09 Feb 2023 11:23:53 +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: 3c5783f4-a86c-11ed-933c-83870f6b2ba8 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=susede1; t=1675941834; 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: in-reply-to:in-reply-to:references:references; bh=l9hWyX1xxO2Hr5xWFMrMhIclyrLkWDLxq1LOLbj+I4I=; b=cnhgXp3QLOM22dAa7iRHOVdKpkMg18w1JaOg3jmcq2AVgi8YWHZcTkRa1ICbbL190fAENl ToyEe2sNNx6IUFhuH49oVwBp/dCk0HRnTCxLSUjzcmJB348wrE/2pESJP9WwSqV1PXYBs8 GJAh7ysO0cVYdUy1dsEGJ+znJl0Bttc= From: Juergen Gross To: xen-devel@lists.xenproject.org Cc: andrew.cooper3@citrix.com, george.dunlap@citrix.com, jbeulich@suse.com, julien@xen.org, sstabellini@kernel.org, wl@xen.org, Juergen Gross Subject: [PATCH v4 2/2 RESEND] xen/public: fix 9pfs documentation of connection sequence Date: Thu, 9 Feb 2023 12:23:38 +0100 Message-Id: <20230209112338.26287-3-jgross@suse.com> X-Mailer: git-send-email 2.35.3 In-Reply-To: <20230209112338.26287-1-jgross@suse.com> References: <20230209112338.26287-1-jgross@suse.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @suse.com) X-ZM-MESSAGEID: 1675941857025100003 Content-Type: text/plain; charset="utf-8" The documented connection sequence in xen/include/public/io/9pfs.h has a bug: the frontend needs to wait for the backend to have published its features before being able to allocate its rings and event-channels. While correcting that, make it clear that there might be multiple rings and event-channels by adding "(s)". Signed-off-by: Juergen Gross Reviewed-by: Stefano Stabellini --- V4: - patch split off (Julien Grall) --- xen/include/public/io/9pfs.h | 32 ++++++++++++++++++++++---------- 1 file changed, 22 insertions(+), 10 deletions(-) diff --git a/xen/include/public/io/9pfs.h b/xen/include/public/io/9pfs.h index 617ad9afd7..a0ce82d0a8 100644 --- a/xen/include/public/io/9pfs.h +++ b/xen/include/public/io/9pfs.h @@ -114,14 +114,26 @@ * * *Front* *Back* * XenbusStateInitialising XenbusStateInitialising - * - Query virtual device - Query backend device - * properties. identification data. - * - Setup OS device instance. - Publish backend features - * - Allocate and initialize the and transport parameters - * request ring. | - * - Publish transport parameters | - * that will be in effect during V - * this connection. XenbusStateInitWait + * - Query backend device + * identification data. + * - Publish backend features + * and transport parameters. + * | + * | + * V + * XenbusStateInitWait + * + * - Query virtual device + * properties. + * - Query backend features and + * transport parameters. + * - Setup OS device instance. + * - Allocate and initialize the + * request ring(s) and + * event-channel(s). + * - Publish transport parameters + * that will be in effect during + * this connection. * | * | * V @@ -129,8 +141,8 @@ * * - Query frontend transport * parameters. - * - Connect to the request ring = and - * event channel. + * - Connect to the request ring(= s) + * and event channel(s). * | * | * V --=20 2.35.3