From nobody Sat May 18 12:29:52 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=1647447087; cv=none; d=zohomail.com; s=zohoarc; b=CZnQaKKlFVZf43bzL4OIWns8ToPp40HkoErcKfH/TN009BY+oI9eJbrA4WWZoCS1l4lF2vPHaFMLlb9bCLnw2SSj0b4hZHJQeZzBHZJyxz+s6ZIZhFEIXn+3JLnRM97P63rGyHLT7yw9BEh+xY7EG8cypT8N/IETQtseuPBXqnI= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1647447087; 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=tN8OsMtRYtol/EJRpHheAzvEZdyyzUH3LNGhAdLsDFU=; b=l0BPGUBay7fVRDfEsGSZZzy5ftiCPRDajChNgJG2ztfukZ24cIT9vSzfyz0AeVzKmHl9L5e/bmhwExepFlSDUYwf6j3Y2AY+CrLn0h+l9OKC3fOgNqCkfQtiFPswI4ZQlokAOUtxbW6dQWr4Qi7AD57UQLV1jZ7XLfyFiLuVM+g= 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 1647447087583680.6223913540146; Wed, 16 Mar 2022 09:11:27 -0700 (PDT) Received: from list by lists.xenproject.org with outflank-mailman.291210.494126 (Exim 4.92) (envelope-from ) id 1nUWEC-0008Vp-0h; Wed, 16 Mar 2022 16:10:24 +0000 Received: by outflank-mailman (output) from mailman id 291210.494126; Wed, 16 Mar 2022 16:10:23 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1nUWEB-0008Vi-Sh; Wed, 16 Mar 2022 16:10:23 +0000 Received: by outflank-mailman (input) for mailman id 291210; Wed, 16 Mar 2022 16:10:21 +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 1nUWE9-0008Vc-Rw for xen-devel@lists.xenproject.org; Wed, 16 Mar 2022 16:10:21 +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 8feae865-a543-11ec-853c-5f4723681683; Wed, 16 Mar 2022 17:10:14 +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-out1.suse.de (Postfix) with ESMTPS id 4B3962112B; Wed, 16 Mar 2022 16:10:20 +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 0EE23139B5; Wed, 16 Mar 2022 16:10:20 +0000 (UTC) Received: from dovecot-director2.suse.de ([192.168.254.65]) by imap2.suse-dmz.suse.de with ESMTPSA id GLtmAuwLMmK2OwAAMHmgww (envelope-from ); Wed, 16 Mar 2022 16:10:20 +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: 8feae865-a543-11ec-853c-5f4723681683 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=susede1; t=1647447020; 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=tN8OsMtRYtol/EJRpHheAzvEZdyyzUH3LNGhAdLsDFU=; b=jXvFtHRCwGGc+K+fStsf6puXTNUkXP5sVl/a6vYyviLfp3LtU0HiYF8tk0Yqqe6e0/tsgH Mfp0r3Tp7S5NuozqOqGoVWPN5xgsk5FkCHFdjHXc3TGtS/wXMoVH8Qz0odPXhZWNNfjdLG oVus3b0Cp5NoSY9AFemVqLIYCeftbvw= 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 1/3] tools/xenstore: add documentation for new set/get-feature commands Date: Wed, 16 Mar 2022 17:10:15 +0100 Message-Id: <20220316161017.3579-2-jgross@suse.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20220316161017.3579-1-jgross@suse.com> References: <20220316161017.3579-1-jgross@suse.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @suse.com) X-ZM-MESSAGEID: 1647447088780100001 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: Luca Fancellu --- docs/misc/xenstore-ring.txt | 1 + docs/misc/xenstore.txt | 12 ++++++++++++ 2 files changed, 13 insertions(+) diff --git a/docs/misc/xenstore-ring.txt b/docs/misc/xenstore-ring.txt index f91accb5b0..bd000f694e 100644 --- a/docs/misc/xenstore-ring.txt +++ b/docs/misc/xenstore-ring.txt @@ -68,6 +68,7 @@ Mask Description ----------------------------------------------------------------- 1 Ring reconnection (see the ring reconnection feature below) 2 Connection error indicator (see connection error feature below) +4 GET_FEATURE and SET_FEATURE Xenstore wire commands are available =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 ea3d8be177..31e3d53c52 100644 --- a/docs/misc/xenstore.txt +++ b/docs/misc/xenstore.txt @@ -332,6 +332,18 @@ 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 located at + 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. + + xenstored prevents the use of GET_FEATURE and SET_FEATURE other + than by dom0. + ---------- Miscellaneous ---------- =20 CONTROL |[|] --=20 2.34.1 From nobody Sat May 18 12:29:52 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=1647447086; cv=none; d=zohomail.com; s=zohoarc; b=AhmB8GKkq1E3I8NF43vQq8oJ7g8xedC7wKUWCj1Y84+N3yyPrhhEAKEgXiRS3gW/5TMb80klVdDWr5wNhh10rsdeuP4oD3wjHsgtrgda31+iU441CrcUnk/mzNToq/vxtC2YzU5ZQPeuDxHNaGhU0WvmBAyFf+Zf/kqGfXODHXA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1647447086; 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=pkuTgxN7TeNQXPeaFQVVyGlZfccct+K6q4AfMKtVTGQ=; b=WbRV6IihgxFjNDF+/OQLzbNP6+VLULz4+r2NXNLoMpKazJE3W7mdo0ql6XMDmoIqvVtQGGtOMyIaYq2yFn5MAK9bnW4bboCOEJhQNzAXAy1pwJf5DCpj80vUHb2EMkN8eTWki7jJu3N2XlyvGcpmjXHrxkcvi8LLf8dc2n0BnDw= 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 164744708671585.8864626679748; Wed, 16 Mar 2022 09:11:26 -0700 (PDT) Received: from list by lists.xenproject.org with outflank-mailman.291211.494137 (Exim 4.92) (envelope-from ) id 1nUWEV-0000SY-BF; Wed, 16 Mar 2022 16:10:43 +0000 Received: by outflank-mailman (output) from mailman id 291211.494137; Wed, 16 Mar 2022 16:10:43 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1nUWEV-0000SR-8E; Wed, 16 Mar 2022 16:10:43 +0000 Received: by outflank-mailman (input) for mailman id 291211; Wed, 16 Mar 2022 16:10:42 +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 1nUWEU-0000RR-CB for xen-devel@lists.xenproject.org; Wed, 16 Mar 2022 16:10:42 +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 94030128-a543-11ec-8eba-a37418f5ba1a; Wed, 16 Mar 2022 17:10:39 +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 8B7401F391; Wed, 16 Mar 2022 16:10:20 +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 51DF5139B5; Wed, 16 Mar 2022 16:10:20 +0000 (UTC) Received: from dovecot-director2.suse.de ([192.168.254.65]) by imap2.suse-dmz.suse.de with ESMTPSA id oBO3EuwLMmK2OwAAMHmgww (envelope-from ); Wed, 16 Mar 2022 16:10:20 +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: 94030128-a543-11ec-8eba-a37418f5ba1a DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=susede1; t=1647447020; 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=pkuTgxN7TeNQXPeaFQVVyGlZfccct+K6q4AfMKtVTGQ=; b=pdBV5B0mbXbb1QqOCmmnh5ccCEQXXCH4k99Y6RH6YdeB6+5aBbfXEpX++TAiM63b/q+pif OcJ4xO88YFW7eFaMhekGiptKI/LwUsL/eJLk2nOWxJWLOolFz46LloKSWOorqMMP9x78Nq 8qMkaT7EzFhAKHDWxPMGjsrNt8zCfoE= 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 2/3] tools/xenstore: add documentation for new set/get-quota commands Date: Wed, 16 Mar 2022 17:10:16 +0100 Message-Id: <20220316161017.3579-3-jgross@suse.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20220316161017.3579-1-jgross@suse.com> References: <20220316161017.3579-1-jgross@suse.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @suse.com) X-ZM-MESSAGEID: 1647447088826100002 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 Xenstore quota of a given domain. Signed-off-by: Juergen Gross Reviewed-by: Luca Fancellu --- docs/misc/xenstore-ring.txt | 1 + docs/misc/xenstore.txt | 12 ++++++++++++ 2 files changed, 13 insertions(+) diff --git a/docs/misc/xenstore-ring.txt b/docs/misc/xenstore-ring.txt index bd000f694e..0cb72a3e35 100644 --- a/docs/misc/xenstore-ring.txt +++ b/docs/misc/xenstore-ring.txt @@ -69,6 +69,7 @@ Mask Description 1 Ring reconnection (see the ring reconnection feature below) 2 Connection error indicator (see connection error feature below) 4 GET_FEATURE and SET_FEATURE Xenstore wire commands are available +8 GET_QUOTA and SET_QUOTA Xenstore wire commands are available =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 31e3d53c52..dd75a81328 100644 --- a/docs/misc/xenstore.txt +++ b/docs/misc/xenstore.txt @@ -344,6 +344,18 @@ 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 + . is one of "nodes", "watches", "transactions", + "node-size" or "permissions". 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.34.1 From nobody Sat May 18 12:29:52 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=1647447087; cv=none; d=zohomail.com; s=zohoarc; b=cJBrltGfpjOAWQNyf2Tz+xKm1KBn8B7eIFx7/My+CXjogxNUvbdOlztsEUGfl7/fUG0RJT6C/qVNHfBYgmXZNLK2aT+1yfKY80nwb+WZ+k14qoHn3WjWSBz0uPkLnHZGdNTJd8klLxm3QI7MRz2FoF7jRHiXHK/pKzcyJ5yYurg= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1647447087; 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=LgNIQyH5+Xwv5DmZji7YTH5ZmS1Ip538z39IFfnqOPE=; b=T0HNmMisJHkc5dMj7kumpx/yfLUaDujX9VgfE+BqeheABMn4HjHuqYO7J4k2uFAvZzNp4P4wq0/SIlrFpMtknjkAr9N8lbWdZIrxsydBauWdOWEvKcSjMyLszHADDXHOsUiLEeNrEFVxVuUEUoO+4MPwavEHs3bhZpZgY/AC5n4= 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 16474470874281019.4147481452079; Wed, 16 Mar 2022 09:11:27 -0700 (PDT) Received: from list by lists.xenproject.org with outflank-mailman.291213.494157 (Exim 4.92) (envelope-from ) id 1nUWEW-0000wG-Tn; Wed, 16 Mar 2022 16:10:44 +0000 Received: by outflank-mailman (output) from mailman id 291213.494157; Wed, 16 Mar 2022 16:10:44 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1nUWEW-0000vB-QT; Wed, 16 Mar 2022 16:10:44 +0000 Received: by outflank-mailman (input) for mailman id 291213; Wed, 16 Mar 2022 16:10:43 +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 1nUWEV-0000RR-9D for xen-devel@lists.xenproject.org; Wed, 16 Mar 2022 16:10:43 +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 9434545b-a543-11ec-8eba-a37418f5ba1a; Wed, 16 Mar 2022 17:10:40 +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-out1.suse.de (Postfix) with ESMTPS id CB8E4212C6; Wed, 16 Mar 2022 16:10:20 +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 930DF139B5; Wed, 16 Mar 2022 16:10:20 +0000 (UTC) Received: from dovecot-director2.suse.de ([192.168.254.65]) by imap2.suse-dmz.suse.de with ESMTPSA id 2E2tIuwLMmK2OwAAMHmgww (envelope-from ); Wed, 16 Mar 2022 16:10:20 +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: 9434545b-a543-11ec-8eba-a37418f5ba1a DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=susede1; t=1647447020; 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=LgNIQyH5+Xwv5DmZji7YTH5ZmS1Ip538z39IFfnqOPE=; b=YkZYeQzdQsLlfTJZTh1fsGrn3xCSLeDEjKPXT+iJ22ANeLVauU7LwDzQG1YKHwDVBjMuli v6+rrvhB+6jbvIjuTx5mIW24tCry+Wt4Lo9gofxmHK7gg9qyjUdvEvQL/fh0zjwnsSFWDV 9NF/MowsvlBbroHve/UQV0eHK/n7eeU= 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 3/3] tools/xenstore: add documentation for extended watch command Date: Wed, 16 Mar 2022 17:10:17 +0100 Message-Id: <20220316161017.3579-4-jgross@suse.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20220316161017.3579-1-jgross@suse.com> References: <20220316161017.3579-1-jgross@suse.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @suse.com) X-ZM-MESSAGEID: 1647447100352100003 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: Luca Fancellu --- 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 0cb72a3e35..eaa6d0a1a3 100644 --- a/docs/misc/xenstore-ring.txt +++ b/docs/misc/xenstore-ring.txt @@ -70,6 +70,7 @@ Mask Description 2 Connection error indicator (see connection error feature below) 4 GET_FEATURE and SET_FEATURE Xenstore wire commands are available 8 GET_QUOTA and SET_QUOTA Xenstore wire commands are available +16 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 dd75a81328..f86c6d9757 100644 --- a/docs/misc/xenstore.txt +++ b/docs/misc/xenstore.txt @@ -188,7 +188,7 @@ SET_PERMS ||+? =20 ---------- Watches ---------- =20 -WATCH ||? +WATCH ||[|]? Adds a watch. =20 When a is modified (including path creation, removal, @@ -199,7 +199,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 @@ -210,7 +214,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.34.1