From nobody Fri May 17 04:59:49 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=1662382101; cv=none; d=zohomail.com; s=zohoarc; b=IEQpufETJxiqn9+7fmhe1FdTjJMXNx/YnwwH9nPmK3GypaKaniRGrVG8p7FsHtAkLrjHx0NZAKPOuM2woYE0cnfrYq5N3mHsdMXNTMccsaf+CLC2bp1tOIePljI4n7kTQgI6n/H7y+cAs+6Q9GFZq6gROF+zYICas4tEJLpMeOE= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1662382101; 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=GSBCJ5cXL+X0Jz3TL0Sa1Pme0dCpqP3btKnhVhmZDqU=; b=K1Kc9r+1Da5bLjlsC4Jmvly1ISnC6ZJ0sNQeIzePIokS5mqi9hAN1PGx+uLbinzfxLjciu8w8zc6pmzTrb8LFOiY5M3cP8xwnm2QBOpR+ynwZ7Gh7OfjZkrQ8EQOEy7h6V76yvTD6z032b7ejYkdSNk6c1LLImN7bbtkyI50rlQ= 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 1662382101471228.01943421928843; Mon, 5 Sep 2022 05:48:21 -0700 (PDT) Received: from list by lists.xenproject.org with outflank-mailman.398800.639756 (Exim 4.92) (envelope-from ) id 1oVBW5-0000no-Ex; Mon, 05 Sep 2022 12:47:53 +0000 Received: by outflank-mailman (output) from mailman id 398800.639756; Mon, 05 Sep 2022 12:47:53 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1oVBW5-0000nK-B0; Mon, 05 Sep 2022 12:47:53 +0000 Received: by outflank-mailman (input) for mailman id 398800; Mon, 05 Sep 2022 12:47:52 +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 1oVBW4-0000jq-1Y for xen-devel@lists.xenproject.org; Mon, 05 Sep 2022 12:47:52 +0000 Received: from smtp-out1.suse.de (smtp-out1.suse.de [195.135.220.28]) by se1-gles-flk1.inumbo.com (Halon) with ESMTPS id f2f9e200-2d18-11ed-af93-0125da4c0113; Mon, 05 Sep 2022 14:47:49 +0200 (CEST) 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-out1.suse.de (Postfix) with ESMTPS id 8FD86388A0; Mon, 5 Sep 2022 12:47:49 +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 506FB13A66; Mon, 5 Sep 2022 12:47:49 +0000 (UTC) Received: from dovecot-director2.suse.de ([192.168.254.65]) by imap2.suse-dmz.suse.de with ESMTPSA id 4K1kEvXvFWO1DAAAMHmgww (envelope-from ); Mon, 05 Sep 2022 12:47:49 +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: f2f9e200-2d18-11ed-af93-0125da4c0113 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=susede1; t=1662382069; 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=GSBCJ5cXL+X0Jz3TL0Sa1Pme0dCpqP3btKnhVhmZDqU=; b=madmR9X2HnvDzzLMcsPf8usDofgrWHz4CA0yOvMIVF+BL+1ZptCB2QD0XHzC5fyvI2k2WZ FAgoFBBK3xjKvoBwTctzNw06fcQk2twT56PIPf38SD/pdyoMTa5YAiPe48rlxg3P9Dd9qY +D7AAYSkYy5TAiMRO+wvupSWkz8w13Y= From: Juergen Gross To: xen-devel@lists.xenproject.org Cc: Henry.Wang@arm.com, Juergen Gross , Andrew Cooper , George Dunlap , Jan Beulich , Julien Grall , Stefano Stabellini , Wei Liu Subject: [PATCH v4 1/4] tools/xenstore: minor fix of the migration stream doc Date: Mon, 5 Sep 2022 14:47:43 +0200 Message-Id: <20220905124746.1975-2-jgross@suse.com> X-Mailer: git-send-email 2.35.3 In-Reply-To: <20220905124746.1975-1-jgross@suse.com> References: <20220905124746.1975-1-jgross@suse.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @suse.com) X-ZM-MESSAGEID: 1662382102143100001 Content-Type: text/plain; charset="utf-8" Drop mentioning the non-existent read-only socket in the migration stream description document. The related record field was removed in commit 8868a0e3f674 ("docs: update the xenstore migration stream documentation). Signed-off-by: Juergen Gross Acked-by: Julien Grall --- V3: - new patch --- docs/designs/xenstore-migration.md | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/docs/designs/xenstore-migration.md b/docs/designs/xenstore-mig= ration.md index b94af7fd7c..efa526f420 100644 --- a/docs/designs/xenstore-migration.md +++ b/docs/designs/xenstore-migration.md @@ -129,11 +129,9 @@ xenstored state that needs to be restored. | `evtchn-fd` | The file descriptor used to communicate with | | | the event channel driver | =20 -xenstored will resume in the original process context. Hence `rw-socket-fd= ` and -`ro-socket-fd` simply specify the file descriptors of the sockets. Sockets -are not always used, however, and so -1 will be used to denote an unused -socket. - +xenstored will resume in the original process context. Hence `rw-socket-fd` +simply specifies the file descriptor of the socket. Sockets are not always +used, however, and so -1 will be used to denote an unused socket. =20 \pagebreak =20 --=20 2.35.3 From nobody Fri May 17 04:59:49 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=1662382101; cv=none; d=zohomail.com; s=zohoarc; b=h9ZuTTvvORwAXM5FL73OW9UAxh0S+mQt/XjgfJ8dtVuZFG0btXQgv7GkyN7entteMcvdGAcuFLjgNa9Npzw5701RpFinjGUfdtdm8T7kEpNwVDCEV4fLL75vRRV6KGWm/YxLEqpcJ7yOyduoY+148nX1e8MvTDt/wLHQmDU9DsA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1662382101; 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=NpHiptJcwGoAMGrSBmcUyjE7qCo40p2IN4dYlppaCrM=; b=e/IAhhMkaa6YbDqXzedB1fzhomVcExz6lp82dODBz0ZLUcO6osi40GlQKYY3zrkxkzs0S/E2Ml3v+N7k0ItdeWIdx18iqSHQAV24IK7mz2FrqAzdY+r+Jfg+K0G4VyczLcOKoZj4MBbjWfaG9RZ5uJPdTy5amrYc5PJOTUv+RL8= 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 1662382101941756.0834444393558; Mon, 5 Sep 2022 05:48:21 -0700 (PDT) Received: from list by lists.xenproject.org with outflank-mailman.398802.639768 (Exim 4.92) (envelope-from ) id 1oVBW6-00011I-1u; Mon, 05 Sep 2022 12:47:54 +0000 Received: by outflank-mailman (output) from mailman id 398802.639768; Mon, 05 Sep 2022 12:47:54 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1oVBW5-0000zz-S3; Mon, 05 Sep 2022 12:47:53 +0000 Received: by outflank-mailman (input) for mailman id 398802; Mon, 05 Sep 2022 12:47:52 +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 1oVBW4-0000jq-G3 for xen-devel@lists.xenproject.org; Mon, 05 Sep 2022 12:47:52 +0000 Received: from smtp-out2.suse.de (smtp-out2.suse.de [195.135.220.29]) by se1-gles-flk1.inumbo.com (Halon) with ESMTPS id f321b54b-2d18-11ed-af93-0125da4c0113; Mon, 05 Sep 2022 14:47:50 +0200 (CEST) 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 DEDC61FFD9; Mon, 5 Sep 2022 12:47:49 +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 98C2413A66; Mon, 5 Sep 2022 12:47:49 +0000 (UTC) Received: from dovecot-director2.suse.de ([192.168.254.65]) by imap2.suse-dmz.suse.de with ESMTPSA id QAn8I/XvFWO1DAAAMHmgww (envelope-from ); Mon, 05 Sep 2022 12:47:49 +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: f321b54b-2d18-11ed-af93-0125da4c0113 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=susede1; t=1662382069; 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=NpHiptJcwGoAMGrSBmcUyjE7qCo40p2IN4dYlppaCrM=; b=KcMQH7MMzfweSsHBfbp36uANpyg5uB6Wd0mtHzPylQMnAhey4flWR/yTY+1dpQEnVu/cCc RwpwevS06zGfKz7JBu9nEWNT4BpcxH8K9XJUfPZ4fSl8Qe6wJPf6pO1eMYJeKW17RlAX+M fFfsrBg525Pe3cqHcw2O/9mjUWX/pH0= From: Juergen Gross To: xen-devel@lists.xenproject.org Cc: Henry.Wang@arm.com, Juergen Gross , Andrew Cooper , George Dunlap , Jan Beulich , Julien Grall , Stefano Stabellini , Wei Liu , Julien Grall Subject: [PATCH v4 2/4] tools/xenstore: add documentation for new set/get-quota commands Date: Mon, 5 Sep 2022 14:47:44 +0200 Message-Id: <20220905124746.1975-3-jgross@suse.com> X-Mailer: git-send-email 2.35.3 In-Reply-To: <20220905124746.1975-1-jgross@suse.com> References: <20220905124746.1975-1-jgross@suse.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @suse.com) X-ZM-MESSAGEID: 1662382103954100005 Content-Type: text/plain; charset="utf-8" Add documentation for two new Xenstore wire commands SET_QUOTA and GET_QUOTA used to set or query the global Xenstore quota or those of a given domain. Signed-off-by: Juergen Gross Reviewed-by: Julien Grall --- V2: - remove feature bit (Julien Grall) - add possibility to access global quota and to query supported quotas --- docs/misc/xenstore.txt | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/docs/misc/xenstore.txt b/docs/misc/xenstore.txt index 33d8fc87f7..73670d7907 100644 --- a/docs/misc/xenstore.txt +++ b/docs/misc/xenstore.txt @@ -348,6 +348,23 @@ SET_FEATURE || xenstored prevents the use of GET_FEATURE and SET_FEATURE other than by dom0. =20 +GET_QUOTA [[|]|] | +SET_QUOTA [|]|| + Returns or sets a quota value for the domain being specified by + . Omitting will return or set the global quota + values, which are the default values for new domains. is + one of "nodes", "watches", "transactions", "node-size", + "permissions", or any other implementation defined value. For + GET_QUOTA it is possible to omit the parameter together + with the parameter, which will return a single string of + all supported values separated by blanks. is a + decimal number specifying the quota value, with "0" having the + special meaning of quota checks being disabled. The initial quota + settings for a domain are the global ones of Xenstore. + + xenstored prevents the use of GET_QUOTA and SET_QUOTA other + than by dom0. + ---------- Miscellaneous ---------- =20 CONTROL |[|] --=20 2.35.3 From nobody Fri May 17 04:59:49 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=1662382103; cv=none; d=zohomail.com; s=zohoarc; b=CVnKuFKASELZ0o5HRJ/EIkI5nycV/SZZ4ZK+CCdznbZB7UP7APfVl0X4ciAI2kkr3PmPGzYtCBJmWqTP/mNkIJYQ9AN9w6ucc9pc0s6QKNKbyE9gARDCr5rw59lxhrjc5CQWeIJm77UlCsji65tu2ZODeTXcUyZs4JVbQLTH8XY= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1662382103; 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=rGlCKEwcU/SZ0y9iAyqoydp7gF1Ss4+EyFvuwscMXI8=; b=DIOpqxf/DzICadB9WLK0kCFTSH7BidL0RggnFHeevlTJznQ5JUrDwx5+MJzkZlD78C8n9GTGRZ3DP64yIk23og5A97yvZ5OtwnEVCuEE4EGK5Qvbq0OdZHQKAIcAWXGYoJTCXQszsYT74awrFhF37OG5vZ2W5jXN+upwslCf1dE= 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 1662382103148630.781283812896; Mon, 5 Sep 2022 05:48:23 -0700 (PDT) Received: from list by lists.xenproject.org with outflank-mailman.398799.639751 (Exim 4.92) (envelope-from ) id 1oVBW5-0000kN-7W; Mon, 05 Sep 2022 12:47:53 +0000 Received: by outflank-mailman (output) from mailman id 398799.639751; Mon, 05 Sep 2022 12:47:53 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1oVBW5-0000kD-39; Mon, 05 Sep 2022 12:47:53 +0000 Received: by outflank-mailman (input) for mailman id 398799; Mon, 05 Sep 2022 12:47:52 +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 1oVBW3-0000jr-TR for xen-devel@lists.xenproject.org; Mon, 05 Sep 2022 12:47:52 +0000 Received: from smtp-out1.suse.de (smtp-out1.suse.de [2001:67c:2178:6::1c]) by se1-gles-sth1.inumbo.com (Halon) with ESMTPS id f3303210-2d18-11ed-a016-b9edf5238543; Mon, 05 Sep 2022 14:47:50 +0200 (CEST) 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-out1.suse.de (Postfix) with ESMTPS id 34494388A3; Mon, 5 Sep 2022 12:47:50 +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 E6C6613A66; Mon, 5 Sep 2022 12:47:49 +0000 (UTC) Received: from dovecot-director2.suse.de ([192.168.254.65]) by imap2.suse-dmz.suse.de with ESMTPSA id AN4IN/XvFWO1DAAAMHmgww (envelope-from ); Mon, 05 Sep 2022 12:47:49 +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: f3303210-2d18-11ed-a016-b9edf5238543 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=susede1; t=1662382070; 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=rGlCKEwcU/SZ0y9iAyqoydp7gF1Ss4+EyFvuwscMXI8=; b=D+XbUfY5DqhzDLv3fkIGTYgyJfygElHDI+FpD++HdkoM9dZxckoFGEPSLgkmnyt/imRwHn sj7Lkv74+vdmwoNnbEa71JHpO6xBmt8iTRlzY7Jtxgq/NjynElc0oPzZjhbagbIbqxpLii UaYwhim36MYw5I0k0D/QfcaSbbPale8= From: Juergen Gross To: xen-devel@lists.xenproject.org Cc: Henry.Wang@arm.com, Juergen Gross , Andrew Cooper , George Dunlap , Jan Beulich , Julien Grall , Stefano Stabellini , Wei Liu , Julien Grall Subject: [PATCH v4 3/4] tools/xenstore: add documentation for extended watch command Date: Mon, 5 Sep 2022 14:47:45 +0200 Message-Id: <20220905124746.1975-4-jgross@suse.com> X-Mailer: git-send-email 2.35.3 In-Reply-To: <20220905124746.1975-1-jgross@suse.com> References: <20220905124746.1975-1-jgross@suse.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @suse.com) X-ZM-MESSAGEID: 1662382104011100007 Content-Type: text/plain; charset="utf-8" Add documentation for an extension of the WATCH command used to limit the scope of watched paths. Additionally it enables to receive more information in the events related to special watches (@introduceDomain or @releaseDomain). Signed-off-by: Juergen Gross Reviewed-by: Julien Grall --- docs/misc/xenstore-ring.txt | 1 + docs/misc/xenstore.txt | 16 +++++++++++++--- 2 files changed, 14 insertions(+), 3 deletions(-) diff --git a/docs/misc/xenstore-ring.txt b/docs/misc/xenstore-ring.txt index 2792d13530..dbc7335e24 100644 --- a/docs/misc/xenstore-ring.txt +++ b/docs/misc/xenstore-ring.txt @@ -69,6 +69,7 @@ Bit Description ----------------------------------------------------------------- 0 Ring reconnection (see the ring reconnection feature below) 1 Connection error indicator (see connection error feature below) +2 WATCH can take a third parameter limiting its scope =20 The "Connection state" field is used to request a ring close and reconnect. The "Connection state" field only contains valid data if the server has diff --git a/docs/misc/xenstore.txt b/docs/misc/xenstore.txt index 73670d7907..da47d7bb16 100644 --- a/docs/misc/xenstore.txt +++ b/docs/misc/xenstore.txt @@ -187,7 +187,7 @@ SET_PERMS ||+? =20 ---------- Watches ---------- =20 -WATCH ||? +WATCH ||[|]? Adds a watch. =20 When a is modified (including path creation, removal, @@ -198,7 +198,11 @@ WATCH ||? matching watch results in a WATCH_EVENT message (see below). =20 The event's path matches the watch's if it is an child - of . + of . This match can be limited by specifying (a + decimal value of 0 or larger): it denotes the directory levels + below to consider for a match ("0" would not match for + a child of , "1" would match only for a direct child, + etc.). =20 can be a to watch or @. In the latter case may have any syntax but it matches @@ -209,7 +213,13 @@ WATCH ||? shutdown, and also on RELEASE and domain destruction events are sent to privileged callers or explicitly - via SET_PERMS enabled domains only. + via SET_PERMS enabled domains only. The semantics for a + specification of differ for generating + events: specifying "1" will report the related domid by using + @/ for the reported path. Other + values are not supported. + For @releaseDomain it is possible to watch only for a specific + domain by specifying @releaseDomain/ for the path. =20 When a watch is first set up it is triggered once straight away, with equal to . Watches may be triggered --=20 2.35.3 From nobody Fri May 17 04:59:49 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=1662382102; cv=none; d=zohomail.com; s=zohoarc; b=mRizPX2HuIjnJKr3axID4cG9k7BirDTYWwTU38pTpYZAxbv0wfxcfxA+dY5aCtjcASmCQ1Id6vV36+vHQt0B376gVRuthd4PWrY6YNJbKlK9vhjE3nN2NY2PrARgikiFHa3BgMGUTMMgJXc0oWwL1mCD4y3T8iw9oZswSsz1teo= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1662382102; 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=VlJ/HKfnDfMr+Qyu9LFLpf4AfrG79Ga4xwdEyjPTosw=; b=S8u/IvFHbHZqsiWX8eyr4MWrg0gYGAfCuSoptW5rr+VzyepTjEzFrODd+ly5gpHDPfjFV2ebqwGGgt+Z17J6krVcTTgfaiHyrU1qTeGxL7EK9bGrNQ9b/DoSdzpxJv+dTKX2Is7oUZGsPLdRB9oTE0xpTyOB3hN3HbElylsWxxA= 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 1662382102144126.34310913373338; Mon, 5 Sep 2022 05:48:22 -0700 (PDT) Received: from list by lists.xenproject.org with outflank-mailman.398803.639778 (Exim 4.92) (envelope-from ) id 1oVBW6-0001BQ-Fa; Mon, 05 Sep 2022 12:47:54 +0000 Received: by outflank-mailman (output) from mailman id 398803.639778; Mon, 05 Sep 2022 12:47:54 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1oVBW6-00018e-81; Mon, 05 Sep 2022 12:47:54 +0000 Received: by outflank-mailman (input) for mailman id 398803; Mon, 05 Sep 2022 12:47:53 +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 1oVBW4-0000jq-Uc for xen-devel@lists.xenproject.org; Mon, 05 Sep 2022 12:47:53 +0000 Received: from smtp-out1.suse.de (smtp-out1.suse.de [195.135.220.28]) by se1-gles-flk1.inumbo.com (Halon) with ESMTPS id f3785bfc-2d18-11ed-af93-0125da4c0113; Mon, 05 Sep 2022 14:47:50 +0200 (CEST) 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-out1.suse.de (Postfix) with ESMTPS id 76AE8388A4; Mon, 5 Sep 2022 12:47:50 +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 3C18513A66; Mon, 5 Sep 2022 12:47:50 +0000 (UTC) Received: from dovecot-director2.suse.de ([192.168.254.65]) by imap2.suse-dmz.suse.de with ESMTPSA id 4DyADfbvFWO1DAAAMHmgww (envelope-from ); Mon, 05 Sep 2022 12:47:50 +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: f3785bfc-2d18-11ed-af93-0125da4c0113 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=susede1; t=1662382070; 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=VlJ/HKfnDfMr+Qyu9LFLpf4AfrG79Ga4xwdEyjPTosw=; b=j7Ae712dtB3caWIdV+8Zumb/9QfV01+4kmqe968UZlkyj4mD5k3mOyZyNbouu0PldNByAe HVmJ411vtQlzmvAwV6XXPTZG9zD2QisJ2IXoPCx90NFGHzS8wyu/a+bOW735PcndUcUaCf zbxJB/LdYI0E0y9QTZ4F/jpLhQt/W9k= From: Juergen Gross To: xen-devel@lists.xenproject.org Cc: Henry.Wang@arm.com, Juergen Gross , Andrew Cooper , George Dunlap , Jan Beulich , Julien Grall , Stefano Stabellini , Wei Liu Subject: [PATCH v4 4/4] tools/xenstore: add migration stream extensions for new features Date: Mon, 5 Sep 2022 14:47:46 +0200 Message-Id: <20220905124746.1975-5-jgross@suse.com> X-Mailer: git-send-email 2.35.3 In-Reply-To: <20220905124746.1975-1-jgross@suse.com> References: <20220905124746.1975-1-jgross@suse.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @suse.com) X-ZM-MESSAGEID: 1662382103831100003 Content-Type: text/plain; charset="utf-8" Extend the definition of the Xenstore migration stream to cover new features: - per domain features - extended watches (watch depth) - per domain quota Signed-off-by: Juergen Gross --- V3: - new patch V4: - add new record types instead of modifying the existing ones (Julien Grall) --- docs/designs/xenstore-migration.md | 160 ++++++++++++++++++++++++++++- 1 file changed, 155 insertions(+), 5 deletions(-) diff --git a/docs/designs/xenstore-migration.md b/docs/designs/xenstore-mig= ration.md index efa526f420..c70505c43a 100644 --- a/docs/designs/xenstore-migration.md +++ b/docs/designs/xenstore-migration.md @@ -43,7 +43,14 @@ the setting of the endianness bit. |-----------|---------------------------------------------------| | `ident` | 0x78656e73746f7265 ('xenstore' in ASCII) | | | | -| `version` | 0x00000001 (the version of the specification) | +| `version` | The version of the specification, defined values: | +| | 0x00000001: all fields and records without any | +| | explicitly mentioned version | +| | dependency are valid. | +| | 0x00000002: all fields and records valid for | +| | version 1 plus fields and records | +| | explicitly stated to be supported in | +| | version 2 are valid. | | | | | `flags` | 0 (LSB): Endianness: 0 =3D little, 1 =3D big | | | | @@ -77,7 +84,10 @@ NOTE: padding octets here and in all subsequent format s= pecifications must be | | 0x00000003: WATCH_DATA | | | 0x00000004: TRANSACTION_DATA | | | 0x00000005: NODE_DATA | -| | 0x00000006 - 0xFFFFFFFF: reserved for future use | +| | 0x00000006: GLOBAL_QUOTA_DATA | +| | 0x00000007: DOMAIN_DATA | +| | 0x00000008: WATCH_DATA_EXTENDED (version 2 and up) | +| | 0x00000009 - 0xFFFFFFFF: reserved for future use | | | | | `len` | The length (in octets) of `body` | | | | @@ -129,6 +139,7 @@ xenstored state that needs to be restored. | `evtchn-fd` | The file descriptor used to communicate with | | | the event channel driver | =20 + xenstored will resume in the original process context. Hence `rw-socket-fd` simply specifies the file descriptor of the socket. Sockets are not always used, however, and so -1 will be used to denote an unused socket. @@ -241,9 +252,9 @@ the file descriptor of the socket connection. =20 ### WATCH_DATA =20 -The image format will contain a `WATCH_DATA` record for each watch registe= red -by a connection for which there is `CONNECTION_DATA` record previously pre= sent. - +The image format will contain either a `WATCH_DATA` or a `WATCH_DATA_EXTEN= DED` +record for each watch registered by a connection for which there is +`CONNECTION_DATA` record previously present. =20 ``` 0 1 2 3 octet @@ -406,6 +417,145 @@ A node permission specifier has the following format: Note that perm1 defines the domain owning the node. See [4] for more explanation of node permissions. =20 +\pagebreak + +### GLOBAL_QUOTA_DATA + +This record is only relevant for live update. It contains the global setti= ngs +of xenstored quota. + +``` + 0 1 2 3 octet ++-------+-------+-------+-------+ +| n-dom-quota | n-glob-quota | ++---------------+---------------+ +| quota-val 1 | ++-------------------------------+ +... ++-------------------------------+ +| quota-val N | ++-------------------------------+ +| quota-names +... +``` + + +| Field | Description | +|----------------|----------------------------------------------| +| `n-dom-quota` | Number of quota values which apply per | +| | domain. | +| | | +| `n-glob-quota` | Number of quota values which apply globally | +| | only. | +| | | +| `quota-val` | Quota values, first the ones applying per | +| | domain, then the ones applying globally. A | +| | value of 0 has the semantics of "unlimited". | +| | | +| `quota-names` | 0 delimited strings of the quota names in | +| | the same sequence as the `quota-val` values. | + + +Allowed quota names are those explicitly named in [2] for the `GET_QUOTA` +and `SET_QUOTA` commands, plus implementation specific ones. Quota names n= ot +recognized by the receiving side must be ignored. + +\pagebreak + +### DOMAIN_DATA + +This record is optional and can be present once for each domain. + + +``` + 0 1 2 3 octet ++-------+-------+-------+-------+ +| domain-id | n-quota | ++---------------+---------------+ +| features | ++-------------------------------+ +| quota-val 1 | ++-------------------------------+ +... ++-------------------------------+ +| quota-val N | ++-------------------------------+ +| quota-names +... +``` + + +| Field | Description | +|----------------|----------------------------------------------| +| `domain-id` | The domain-id of the domain this record | +| | belongs to. | +| | | +| `n-quota` | Number of quota values. | +| | | +| `features` | Value of the feature field visible by the | +| | guest at offset 2064 of the ring page. | +| | Aligned to the next 4 octet boundary. | +| | Only valid for version 2 and later. | +| | | +| `quota-val` | Quota values, a value of 0 has the semantics | +| | "unlimited". | +| | | +| `quota-names` | 0 delimited strings of the quota names in | +| | the same sequence as the `quota-val` values. | + +Allowed quota names are those explicitly named in [2] for the `GET_QUOTA` +and `SET_QUOTA` commands, plus implementation specific ones. Quota names n= ot +recognized by the receiving side must be ignored. + +\pagebreak + +### WATCH_DATA_EXTENDED + +The image format will contain either a `WATCH_DATA` or a `WATCH_DATA_EXTEN= DED` +record for each watch registered by a connection for which there is +`CONNECTION_DATA` record previously present. The `WATCH_DATA_EXTENDED` rec= ord +type is valid only in version 2 and later. + +``` + 0 1 2 3 octet ++-------+-------+-------+-------+ +| conn-id | ++---------------+---------------+ +| wpath-len | token-len | ++---------------+---------------+ +| depth | | ++---------------+---------------+ +| wpath +... +| token +... +``` + + +| Field | Description | +|-------------|-------------------------------------------------| +| `conn-id` | The connection that issued the `WATCH` | +| | operation [2] | +| | | +| `wpath-len` | The length (in octets) of `wpath` including the | +| | NUL terminator | +| | | +| `token-len` | The length (in octets) of `token` including the | +| | NUL terminator | +| | | +| `depth` | The number of directory levels below the | +| | watched path to consider for a match. | +| | A value of 0xffff is used for unlimited depth. | +| | | +| `wpath` | The watch path, as specified in the `WATCH` | +| | operation | +| | | +| `token` | The watch identifier token, as specified in the | +| | `WATCH` operation | + +\pagebreak + + * * * =20 [1] See https://xenbits.xen.org/gitweb/?p=3Dxen.git;a=3Dblob;f=3Ddocs/desi= gns/non-cooperative-migration.md --=20 2.35.3