Files
xen/docs/man/xenstore-watch.1.pod
T
Juergen Gross 464b7f4f26 tools/xs-clients: support depth with xenstore-watch
Add a "-d <depth>" parameter to xenstore-watch, allowing to specify
the depth parameter of the XS_WATCH command.

Using "-d" without support of depth by xenstored will refuse to set
the watch(es).

Signed-off-by: Juergen Gross <jgross@suse.com>
Reviewed-by: Jason Andryuk <jason.andryuk@amd.com>
2026-04-22 08:59:03 +02:00

39 lines
949 B
INI

=head1 NAME
xenstore-watch - wait for Xenstore watch events
=head1 SYNOPSIS
B<xenstore-watch> [I<OPTION>]... [I<PATH>]...
=head1 DESCRIPTION
Set Xenstore watches to the specified I<PATH>s and print the path for each
event happening.
=over
=item B<-h>
Show the usage information for xenstore-watch and exit the program.
=item B<-d> B<depth>
Limit the number of sub-directories below the specified I<PATH>s to be
watched. A B<depth> of 0 will watch only the specified nodes, a B<depth>
of 1 will watch the specified nodes and their direct children, etc.
Using this option requires xenstored to support the Xenstore watch depth
feature. In case it is not supported, the B<-d> usage will be rejected.
=item B<-n> B<NR>
Stop waiting after having received B<NR> watch events.
=back
=head1 BUGS
Send bugs to xen-devel@lists.xenproject.org, see
https://wiki.xenproject.org/wiki/Reporting_Bugs_against_Xen_Project on how to send bug reports.