docs: clarify Xenstore watch depth feature

Make it explicit that for watching the @releaseDomain/<domid> special
node, the XENSTORE_SERVER_FEATURE_WATCHDEPTH is needed.

Signed-off-by: Juergen Gross <jgross@suse.com>
Reviewed-by: Jason Andryuk <jason.andryuk@amd.com>
This commit is contained in:
Juergen Gross authored and Jan Beulich committed 2026-04-21 09:04:48 +02:00
1 parent 99912d3460
commit fbcf400e72
1 file changed
+4 -1
+4 -1
View File
@@ -266,7 +266,8 @@ WATCH <wpath>|<token>|[<depth>|]?
decimal value of 0 or larger): it denotes the directory levels
below <wpath> to consider for a match ("0" would not match for
a child of <wpath>, "1" would match only for a direct child,
etc.).
etc.). The depth specification is possible only, if the
XENSTORE_SERVER_FEATURE_WATCHDEPTH feature is available.
<wpath> can be a <path> to watch or @<wspecial>. In the
latter case <wspecial> may have any syntax but it matches
@@ -284,6 +285,8 @@ WATCH <wpath>|<token>|[<depth>|]?
values are not supported.
For @releaseDomain it is possible to watch only for a specific
domain by specifying @releaseDomain/<domid> for the path.
This requires the XENSTORE_SERVER_FEATURE_WATCHDEPTH to be
available.
When a watch is first set up it is triggered once straight
away, with <path> equal to <wpath>. Watches may be triggered
Reference in new issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.