From nobody Sat May 4 19:18:14 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=1659528013; cv=none; d=zohomail.com; s=zohoarc; b=JiE0Unn7X95lTQ98PGu4Gjyaq3buhKg7DTMH1N+f/zm4Loxf775zfVQPy12hx84knpK8e5DHfwD+1YDSgln84zDkjoqqT/l63Hm6dbmN+7xiONdT469JAJTmz7Hjk3RfHPYfE347peoiW0UAgsnZjyDNb9q4Wey/bfqwNIWy7Vk= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1659528013; 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=9GJyqkGHB0z8ieAkwvJPlzfO0eLrNZxVu98Q0w0DzuE=; b=m5xBg0RlzTN7nTEgxY1NBQub1Yi/SHr+ZgKTwaB/DCoRU0P+r26jO6janzVQnEc03FfcjktOAPxLFM2GgUrwVnQOuk/7U3WAWEzpI4n8t17rZnalyDHWaKrYqvVDQedEj0VOcTWZhqvtrZQIqOjgTD1XcKjmVQxLB22DLe1yNjY= 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 1659528013483821.0050893912625; Wed, 3 Aug 2022 05:00:13 -0700 (PDT) Received: from list by lists.xenproject.org with outflank-mailman.379827.613625 (Exim 4.92) (envelope-from ) id 1oJD2a-0000CT-2B; Wed, 03 Aug 2022 11:59:56 +0000 Received: by outflank-mailman (output) from mailman id 379827.613625; Wed, 03 Aug 2022 11:59:55 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1oJD2Z-0000Ba-Qf; Wed, 03 Aug 2022 11:59:55 +0000 Received: by outflank-mailman (input) for mailman id 379827; Wed, 03 Aug 2022 11:59:54 +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 1oJD2Y-00008E-Jb for xen-devel@lists.xenproject.org; Wed, 03 Aug 2022 11:59:54 +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 c8f58012-1323-11ed-924f-1f966e50362f; Wed, 03 Aug 2022 13:59:53 +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 6491F3FF36; Wed, 3 Aug 2022 11:59:53 +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 25A6E13AE7; Wed, 3 Aug 2022 11:59:53 +0000 (UTC) Received: from dovecot-director2.suse.de ([192.168.254.65]) by imap2.suse-dmz.suse.de with ESMTPSA id 4MH2Bzlj6mKNUgAAMHmgww (envelope-from ); Wed, 03 Aug 2022 11:59: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: c8f58012-1323-11ed-924f-1f966e50362f DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=susede1; t=1659527993; 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=9GJyqkGHB0z8ieAkwvJPlzfO0eLrNZxVu98Q0w0DzuE=; b=Pz15mCl2nFRFfOrcaEpRtb2Z9kHgmW6spI5uPow+6JOlYkIwv4Ga9IFPdKGfJIdxsj2iCp mBpVpa4aMqvJQrnA6LxT7AudXStQML2PzD0HidceropneOVFEdeaR+HkKSTd2Dr0qTr7NO vDE/7onEAGt5dy2tbLWVhq8BUbQmi4o= From: Juergen Gross To: xen-devel@lists.xenproject.org Cc: Juergen Gross , Andrew Cooper , George Dunlap , Jan Beulich , Julien Grall , Stefano Stabellini , Wei Liu Subject: [PATCH v3 1/5] tools/xenstore: minor fix of the migration stream doc Date: Wed, 3 Aug 2022 13:59:46 +0200 Message-Id: <20220803115950.10904-2-jgross@suse.com> X-Mailer: git-send-email 2.35.3 In-Reply-To: <20220803115950.10904-1-jgross@suse.com> References: <20220803115950.10904-1-jgross@suse.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @suse.com) X-ZM-MESSAGEID: 1659528015271100001 Content-Type: text/plain; charset="utf-8" Drop mentioning the non-existent read-only socket in the migration stream description document. 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 Sat May 4 19:18:14 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=1659528019; cv=none; d=zohomail.com; s=zohoarc; b=UABOmY8EwLI8Ze+9onvCkQDHh9D4MAgZ+z7TQUbf4zyOVVScLZzcb/nWjwxo9I0BU9oU7KxDlpcDZwHUCBi7ym9dACIZ+2xQ7HJUVHn2cf5SuhCmfUdThURPcSpFRxiDy9vZcSfEn8oN9aFg21Yc5kM0/8LfCYwwRKFQUCTXt4w= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1659528019; 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=aEQopuLdWValM7nidZ9WkbS29HDB7GZW9XHtrUpHG2E=; b=N8ugMlj40p5m74XkjuOCI6jqGizL0yOm5iVUD8S8hBUcK2OQlbMYbYRO55Br+tIGDrCEu9lpJjIYTrsk70y9vZzehBwCrdruZl9q2zYs8hMGUkUzrWqbH8E1OSMI09teBUPaT9d40MWSUTfRGfiY8rVTbe2fZFBNeqmgrh+b28E= 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 1659528019884628.8235667724299; Wed, 3 Aug 2022 05:00:19 -0700 (PDT) Received: from list by lists.xenproject.org with outflank-mailman.379829.613646 (Exim 4.92) (envelope-from ) id 1oJD2b-0000js-NK; Wed, 03 Aug 2022 11:59:57 +0000 Received: by outflank-mailman (output) from mailman id 379829.613646; Wed, 03 Aug 2022 11:59:57 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1oJD2b-0000jc-GP; Wed, 03 Aug 2022 11:59:57 +0000 Received: by outflank-mailman (input) for mailman id 379829; Wed, 03 Aug 2022 11:59:55 +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 1oJD2Z-00008E-Ct for xen-devel@lists.xenproject.org; Wed, 03 Aug 2022 11:59:55 +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 c91c58bb-1323-11ed-924f-1f966e50362f; Wed, 03 Aug 2022 13:59:53 +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 A607E3FF38; Wed, 3 Aug 2022 11:59:53 +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 6B60313AD8; Wed, 3 Aug 2022 11:59:53 +0000 (UTC) Received: from dovecot-director2.suse.de ([192.168.254.65]) by imap2.suse-dmz.suse.de with ESMTPSA id cJn7GDlj6mKNUgAAMHmgww (envelope-from ); Wed, 03 Aug 2022 11:59: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: c91c58bb-1323-11ed-924f-1f966e50362f DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=susede1; t=1659527993; 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=aEQopuLdWValM7nidZ9WkbS29HDB7GZW9XHtrUpHG2E=; b=ZzORzULIhMATytSzjLQiP1BXdg5NirLRZS4Ep079EugR2FMuCKeYWVJFlHt01FEU0IMNnu FvY+a9VmZ3+9PmLxySSNSw3qJBC0mAMb3ppeoGn7PMvRslEAXAJT6uLCrK4OPshmRaUXBv RkY6l0pTLAketVLSucjmDFgiz6jwRFM= From: Juergen Gross To: xen-devel@lists.xenproject.org Cc: Juergen Gross , Andrew Cooper , George Dunlap , Jan Beulich , Julien Grall , Stefano Stabellini , Wei Liu Subject: [PATCH v3 2/5] tools/xenstore: add documentation for new set/get-feature commands Date: Wed, 3 Aug 2022 13:59:47 +0200 Message-Id: <20220803115950.10904-3-jgross@suse.com> X-Mailer: git-send-email 2.35.3 In-Reply-To: <20220803115950.10904-1-jgross@suse.com> References: <20220803115950.10904-1-jgross@suse.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @suse.com) X-ZM-MESSAGEID: 1659528021335100001 Content-Type: text/plain; charset="utf-8" Add documentation for two new Xenstore wire commands SET_FEATURE and GET_FEATURE used to set or query the Xenstore features visible in the ring page of a given domain. Signed-off-by: Juergen Gross Reviewed-by: Julien Grall --- V2: - remove feature bit (Julien Grall) - GET_FEATURE without domid will return Xenstore supported features (triggered by Julien Grall) V3: - clarify that guest only sees a copy of features (Julien Grall) - add remark that SET_FEATURE will be rejected after INTRODUCE of a domain (Julien Grall) --- docs/misc/xenstore.txt | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/docs/misc/xenstore.txt b/docs/misc/xenstore.txt index a3d3da0a5b..9134cb7947 100644 --- a/docs/misc/xenstore.txt +++ b/docs/misc/xenstore.txt @@ -331,6 +331,23 @@ SET_TARGET || =20 xenstored prevents the use of SET_TARGET other than by dom0. =20 +GET_FEATURE [|] | +SET_FEATURE || + Returns or sets the contents of the "feature" field copied to + offset 2064 of the Xenstore ring page of the domain specified by + . is a decimal number being a logical or of the + feature bits as defined in docs/misc/xenstore-ring.txt. Trying + to set a bit for a feature not being supported by the running + Xenstore will be denied. Providing no with the + GET_FEATURE command will return the features which are supported + by Xenstore. + + SET_FEATURE for a domain will be rejected after the INTRODUCE + command for this domain has been sent to xenstored. + + xenstored prevents the use of GET_FEATURE and SET_FEATURE other + than by dom0. + ---------- Miscellaneous ---------- =20 CONTROL |[|] --=20 2.35.3 From nobody Sat May 4 19:18:14 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=1659528013; cv=none; d=zohomail.com; s=zohoarc; b=W2t4aLeP2w8RG53IyI2HqGgpnhohRXuQehg9XBGGDcfqnG2e5w3vDvmhLp48YtXm/E+Okz4YJOxfNZPe1K0TQkZJ+iMwrsQYeW9Tsd1ed/bZP9s7FlfPDTmacM6+4crzEo/DUbjX+Z6X3PYgdMsMS0zxGocEwNXeEaMRZ72uC90= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1659528013; 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=K6SEriJ/12Ptr9jCpA0LXPaM3BfUwfWAPckT8APK2Io=; b=GLy2H1r4p/JD5lcVjmeZstT13C0Hbl1MJsnJ6AZFusAK088fnRWCtgtfWL5n5ZbclHWRby528aU0WfZ6eLXnCm4G1GbzvUDsbBVrhMiDAuNyWkCNdClBmI7F74XcpQbOYjRHe8Ll+p8DbFyYUiBlddz6ZOKHfvvmBFxuQCvpZ10= 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 1659528013070848.5360267387128; Wed, 3 Aug 2022 05:00:13 -0700 (PDT) Received: from list by lists.xenproject.org with outflank-mailman.379828.613641 (Exim 4.92) (envelope-from ) id 1oJD2b-0000d7-71; Wed, 03 Aug 2022 11:59:57 +0000 Received: by outflank-mailman (output) from mailman id 379828.613641; Wed, 03 Aug 2022 11:59:57 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1oJD2b-0000c6-1e; Wed, 03 Aug 2022 11:59:57 +0000 Received: by outflank-mailman (input) for mailman id 379828; Wed, 03 Aug 2022 11:59:55 +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 1oJD2Z-0008VV-8p for xen-devel@lists.xenproject.org; Wed, 03 Aug 2022 11:59:55 +0000 Received: from smtp-out1.suse.de (smtp-out1.suse.de [195.135.220.28]) by se1-gles-sth1.inumbo.com (Halon) with ESMTPS id c94ea17a-1323-11ed-bd2d-47488cf2e6aa; Wed, 03 Aug 2022 13:59:54 +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 F31993FF3B; Wed, 3 Aug 2022 11:59:53 +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 B0CB013AD8; Wed, 3 Aug 2022 11:59:53 +0000 (UTC) Received: from dovecot-director2.suse.de ([192.168.254.65]) by imap2.suse-dmz.suse.de with ESMTPSA id SPvnKTlj6mKNUgAAMHmgww (envelope-from ); Wed, 03 Aug 2022 11:59: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: c94ea17a-1323-11ed-bd2d-47488cf2e6aa DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=susede1; t=1659527994; 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=K6SEriJ/12Ptr9jCpA0LXPaM3BfUwfWAPckT8APK2Io=; b=BYvUXsH1TGfMi7zg3aBERgMzGnXneQn1J8YlrmauID169x6K9i4Sy1nMg2RBM5kehqA0ZQ RTa842/QxJoRYDfjMXVaWdJB3QQ0HPDtEyTPlTucMfCd2dzZs632Du8swdIYr0qXZQtCET GS+piYVdiT+SGsrRfuEkQT1Jvzvt0no= From: Juergen Gross To: xen-devel@lists.xenproject.org Cc: Juergen Gross , Andrew Cooper , George Dunlap , Jan Beulich , Julien Grall , Stefano Stabellini , Wei Liu , Julien Grall Subject: [PATCH v3 3/5] tools/xenstore: add documentation for new set/get-quota commands Date: Wed, 3 Aug 2022 13:59:48 +0200 Message-Id: <20220803115950.10904-4-jgross@suse.com> X-Mailer: git-send-email 2.35.3 In-Reply-To: <20220803115950.10904-1-jgross@suse.com> References: <20220803115950.10904-1-jgross@suse.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @suse.com) X-ZM-MESSAGEID: 1659528015273100002 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 9134cb7947..4e0bdf5682 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 Sat May 4 19:18:14 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=1659528014; cv=none; d=zohomail.com; s=zohoarc; b=jmxHIhwamhSoRSHoCEI9+jMAYyxD5bpug/ws4ePHJBmFCOOY60ymW141p4GYCqyiJxbQDTHPM6nGBgzDAL2QxGKXJ8R7UHc0lxRDt+ChADwX7bBaqbvzRrtVZC4rVXvLTHKctR9S6Vt0ynGV17vjMOoNSu/4Rdck7W1Y2/mIh0k= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1659528014; 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=ChHwKYP+L7F9Vrp9r8qy3rRehupKBifaHrZsydUlfnM=; b=j/ZdcuoJ2dYtAm4ugDndVFxMbZxkqs5gXX8mdNDADfgkNyr8al4TCHch9sRew2oYXZc21gOXK39shJ8Jnn0dHrAnleJ1xRlU9+FmvW6RVgHDz5ujmzVYS7drgwpghQT3i56fyZXR/WJSdc3WV5tEuiVbsxH3SHFuD0jnH5f0m0c= 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 1659528014064465.66578222939233; Wed, 3 Aug 2022 05:00:14 -0700 (PDT) Received: from list by lists.xenproject.org with outflank-mailman.379830.613653 (Exim 4.92) (envelope-from ) id 1oJD2c-0000s9-54; Wed, 03 Aug 2022 11:59:58 +0000 Received: by outflank-mailman (output) from mailman id 379830.613653; Wed, 03 Aug 2022 11:59:58 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1oJD2b-0000qd-Uy; Wed, 03 Aug 2022 11:59:57 +0000 Received: by outflank-mailman (input) for mailman id 379830; Wed, 03 Aug 2022 11:59:56 +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 1oJD2a-0008VV-8t for xen-devel@lists.xenproject.org; Wed, 03 Aug 2022 11:59:56 +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 c97e00e5-1323-11ed-bd2d-47488cf2e6aa; Wed, 03 Aug 2022 13:59:54 +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 48EA2200EF; Wed, 3 Aug 2022 11:59: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 07CC613AD8; Wed, 3 Aug 2022 11:59:54 +0000 (UTC) Received: from dovecot-director2.suse.de ([192.168.254.65]) by imap2.suse-dmz.suse.de with ESMTPSA id kHWkADpj6mKNUgAAMHmgww (envelope-from ); Wed, 03 Aug 2022 11:59:54 +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: c97e00e5-1323-11ed-bd2d-47488cf2e6aa DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=susede1; t=1659527994; 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=ChHwKYP+L7F9Vrp9r8qy3rRehupKBifaHrZsydUlfnM=; b=PPWi8f543EvL+Zi3NEZ86z69HHLh0jGoyZChUBdhfYAawm7/HM8WgQblzA0LDi2kQoItC6 ayU1Lr+ip2PC2X6rq6JPj1G7rmOPPETxm2cDgcjaDYtkg+j5XA/9fo/0sdYMCaZL+eMa71 jIuqCJMlg2Zjml0imWMgwsUqvbNzf3U= From: Juergen Gross To: xen-devel@lists.xenproject.org Cc: Juergen Gross , Andrew Cooper , George Dunlap , Jan Beulich , Julien Grall , Stefano Stabellini , Wei Liu , Julien Grall Subject: [PATCH v3 4/5] tools/xenstore: add documentation for extended watch command Date: Wed, 3 Aug 2022 13:59:49 +0200 Message-Id: <20220803115950.10904-5-jgross@suse.com> X-Mailer: git-send-email 2.35.3 In-Reply-To: <20220803115950.10904-1-jgross@suse.com> References: <20220803115950.10904-1-jgross@suse.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @suse.com) X-ZM-MESSAGEID: 1659528015279100003 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 4e0bdf5682..949b53bcd7 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 Sat May 4 19:18:14 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=1659528023; cv=none; d=zohomail.com; s=zohoarc; b=HgLLYfUVu6u9XZew2PGbWOW9bli4cZE1kAoiRzkyKhmKDfNV3KZzcZXDaVJV90AHDF0zt4GixlZzkei9dB94awUo+/I8AVrV5pnxwRtjzGzu6qUUZXJts6hKRvXeg6fgcqGrbef+gXqoLyJkSc4uCNLR2XkoBZe8zI0ev1Em6kI= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1659528023; 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=Ju0t3oFAsoHUjJP7gCi/QFhOCou8Zc/2Mo8LMbRpRtE=; b=bDJjehUQS8qcILqVtzRwICRAKI7BR0El6xCxtitwP3YmC3Tem4wrbuanzsrCFwk+SbMLKWgoAyYb7+nTeD1NaB+aGC25+nO4EZtyzvfewAmgWT/EnxQm71EycDdmAffqzVW88r7WSOktY057QtIcNYo2PKmJVclF1JsOB7ZEW2U= 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 1659528023648260.88012582553347; Wed, 3 Aug 2022 05:00:23 -0700 (PDT) Received: from list by lists.xenproject.org with outflank-mailman.379831.613660 (Exim 4.92) (envelope-from ) id 1oJD2c-00010S-R7; Wed, 03 Aug 2022 11:59:58 +0000 Received: by outflank-mailman (output) from mailman id 379831.613660; Wed, 03 Aug 2022 11:59:58 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1oJD2c-0000y6-Ec; Wed, 03 Aug 2022 11:59:58 +0000 Received: by outflank-mailman (input) for mailman id 379831; Wed, 03 Aug 2022 11:59:56 +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 1oJD2a-00008E-DA for xen-devel@lists.xenproject.org; Wed, 03 Aug 2022 11:59:56 +0000 Received: from smtp-out1.suse.de (smtp-out1.suse.de [2001:67c:2178:6::1c]) by se1-gles-flk1.inumbo.com (Halon) with ESMTPS id c9a8122e-1323-11ed-924f-1f966e50362f; Wed, 03 Aug 2022 13:59:54 +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 903F33FF3C; Wed, 3 Aug 2022 11:59: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 5039C13AD8; Wed, 3 Aug 2022 11:59:54 +0000 (UTC) Received: from dovecot-director2.suse.de ([192.168.254.65]) by imap2.suse-dmz.suse.de with ESMTPSA id yM9fEjpj6mKNUgAAMHmgww (envelope-from ); Wed, 03 Aug 2022 11:59:54 +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: c9a8122e-1323-11ed-924f-1f966e50362f DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=susede1; t=1659527994; 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=Ju0t3oFAsoHUjJP7gCi/QFhOCou8Zc/2Mo8LMbRpRtE=; b=C/DcFG2LOTnim5byXtdo+TwyDc0Jf3YlnvvOv5ExkqRv2Uh5O9sr7B/ybIp1Qv6bkKjdji R/MpdbnT7y8cA5ffEjuI+XA53eJubS0If3qc1OuVn9FSYv1E8tZVRZxIkcdk++Mbiz42+B TI4HYub05eWynHf4GKd+ytESPPg6k34= From: Juergen Gross To: xen-devel@lists.xenproject.org Cc: Juergen Gross , Andrew Cooper , George Dunlap , Jan Beulich , Julien Grall , Stefano Stabellini , Wei Liu Subject: [PATCH v3 5/5] tools/xenstore: add migration stream extensions for new features Date: Wed, 3 Aug 2022 13:59:50 +0200 Message-Id: <20220803115950.10904-6-jgross@suse.com> X-Mailer: git-send-email 2.35.3 In-Reply-To: <20220803115950.10904-1-jgross@suse.com> References: <20220803115950.10904-1-jgross@suse.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @suse.com) X-ZM-MESSAGEID: 1659528025350100001 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 --- docs/designs/xenstore-migration.md | 85 ++++++++++++++++++++++++++++-- 1 file changed, 82 insertions(+), 3 deletions(-) diff --git a/docs/designs/xenstore-migration.md b/docs/designs/xenstore-mig= ration.md index efa526f420..b2b1d3d5c7 100644 --- a/docs/designs/xenstore-migration.md +++ b/docs/designs/xenstore-migration.md @@ -43,7 +43,13 @@ 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 without any explicitly | +| | mentioned version dependency are | +| | valid. | +| | 0x00000002: all fields valid for version 1 plus | +| | fields explicitly stated to be | +| | supported in version 2 are valid. | | | | | `flags` | 0 (LSB): Endianness: 0 =3D little, 1 =3D big | | | | @@ -117,7 +123,17 @@ xenstored state that needs to be restored. | rw-socket-fd | +-------------------------------+ | evtchn-fd | ++---------------+---------------+ +| n-dom-quota | n-glob-quota | ++---------------+---------------+ +| quota-val 1 | ++-------------------------------+ +... +-------------------------------+ +| quota-val N | ++-------------------------------+ +| quota-names +... ``` =20 =20 @@ -128,6 +144,22 @@ xenstored state that needs to be restored. | | | | `evtchn-fd` | The file descriptor used to communicate with | | | the event channel driver | +| | | +| `n-dom-quota` | Number of quota values which apply per | +| | domain. Valid only for version 2 and later. | +| | | +| `n-glob-quota` | Number of quota values which apply globally | +| | only. Valid only for version 2 and later. | +| | | +| `quota-val` | Quota values, first the ones applying per | +| | domain, then the ones applying globally. A | +| | value of 0 has the semantics of "unlimited". | +| | Valid only for version 2 and later. | +| | | +| `quota-names` | 0 delimited strings of the quota names in | +| | the same sequence as the `quota-val` values. | +| | Valid only for version 2 and later. | + =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 @@ -145,7 +177,7 @@ the domain being migrated. ``` 0 1 2 3 4 5 6 7 octet +-------+-------+-------+-------+-------+-------+-------+-------+ -| conn-id | conn-type | | +| conn-id | conn-type | n-quota | +-------------------------------+---------------+---------------+ | conn-spec ... @@ -154,6 +186,17 @@ the domain being migrated. +---------------+---------------+-------------------------------+ | data ... ++-------------------------------+ +| features | ++-------------------------------+ +| quota-val 1 | ++-------------------------------+ +... ++-------------------------------+ +| quota-val N | ++-------------------------------+ +| quota-names +... ``` =20 =20 @@ -167,6 +210,10 @@ the domain being migrated. | | 0x0001: socket | | | 0x0002 - 0xFFFF: reserved for future use | | | | +| `n-quota` | Number of quota values. | +| | Only for `conn-type` 0 (shared ring). | +| | Only valid for version 2 and later. | +| | | | `conn-spec` | See below | | | | | `in-data-len` | The length (in octets) of any data read | @@ -182,6 +229,22 @@ the domain being migrated. | `data` | Pending data: first in-data-len octets of | | | read data, then out-data-len octets of | | | written data (any of both may be empty) | +| | | +| `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 for `conn-type` 0 (shared ring). | +| | Only valid for version 2 and later. | +| | | +| `quota-val` | Quota values, a value of 0 has the semantics | +| | "unlimited". | +| | Only for `conn-type` 0 (shared ring). | +| | Only valid for version 2 and later. | +| | | +| `quota-names` | 0 delimited strings of the quota names in | +| | the same sequence as the `quota-val` values. | +| | Only for `conn-type` 0 (shared ring). | +| | Only valid for version 2 and later. | =20 In case of live update the connection record for the connection via which the live update command was issued will contain the response for the live @@ -247,7 +310,7 @@ by a connection for which there is `CONNECTION_DATA` re= cord previously present. =20 ``` 0 1 2 3 octet -+-------+-------+-------+-------+ ++---------------+---------------+ | conn-id | +---------------+---------------+ | wpath-len | token-len | @@ -256,6 +319,9 @@ by a connection for which there is `CONNECTION_DATA` re= cord previously present. ... | token ... ++---------------+---------------+ +| depth | | ++---------------+---------------+ ``` =20 =20 @@ -275,6 +341,13 @@ by a connection for which there is `CONNECTION_DATA` r= ecord previously present. | | | | `token` | The watch identifier token, as specified in the | | | `WATCH` operation | +| | | +| `depth` | The number of directory levels below the | +| | watched path to consider for a match. This | +| | field is aligned to the next 4 octet boundary. | +| | A value of 0xffff is used for unlimited depth. | +| | This field is valid only for version 2 and | +| | higher. | =20 \pagebreak =20 @@ -406,6 +479,12 @@ 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 + +### DOMAIN_DATA + + + * * * =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