From 0a8546395451f01032058a2a97857ed99a12b004 Mon Sep 17 00:00:00 2001 From: Jan Beulich Date: Tue, 19 Jul 2022 11:16:02 +0200 Subject: [PATCH] Revert "tools/xenstore: add documentation for ..." This reverts commits 3db29e8fac3f874aba0198f398e8eeaad9a091b8, 6574f387791f18c85c64399ed83b4391adcb4881, and 1a564e4b3b4fcb9a49fa09ade689ba38c0a890e8. They were committed by mistake (newer version pending). --- docs/misc/xenstore-ring.txt | 3 --- docs/misc/xenstore.txt | 40 +++---------------------------------- 2 files changed, 3 insertions(+), 40 deletions(-) diff --git a/docs/misc/xenstore-ring.txt b/docs/misc/xenstore-ring.txt index a1e6c7bb3a..2792d13530 100644 --- a/docs/misc/xenstore-ring.txt +++ b/docs/misc/xenstore-ring.txt @@ -69,9 +69,6 @@ Bit Description ----------------------------------------------------------------- 0 Ring reconnection (see the ring reconnection feature below) 1 Connection error indicator (see connection error feature below) -2 GET_FEATURE and SET_FEATURE Xenstore wire commands are available -3 GET_QUOTA and SET_QUOTA Xenstore wire commands are available -4 WATCH can take a third parameter limiting its scope 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 ee0b51394f..334dc8b6fd 100644 --- a/docs/misc/xenstore.txt +++ b/docs/misc/xenstore.txt @@ -176,7 +176,7 @@ SET_PERMS ||+? ---------- Watches ---------- -WATCH ||[|]? +WATCH ||? Adds a watch. When a is modified (including path creation, removal, @@ -187,11 +187,7 @@ WATCH ||[|]? matching watch results in a WATCH_EVENT message (see below). The event's path matches the watch's if it is an child - 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.). + of . can be a to watch or @. In the latter case may have any syntax but it matches @@ -202,13 +198,7 @@ WATCH ||[|]? shutdown, and also on RELEASE and domain destruction events are sent to privileged callers or explicitly - 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. + via SET_PERMS enabled domains only. When a watch is first set up it is triggered once straight away, with equal to . Watches may be triggered @@ -330,30 +320,6 @@ SET_TARGET || xenstored prevents the use of SET_TARGET other than by dom0. -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. - -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 ---------- CONTROL |[|] -- 2.30.2