1=head1 NAME
2
3xenstore-ls - list Xenstore keys and values
4
5=head1 SYNOPSIS
6
7B<xenstore-ls> [I<OPTION>]... [I<PATH>]...
8
9=head1 DESCRIPTION
10
11List keys, values and permissions of one or more Xenstore I<PATH>s,
12using a nested, tree-like view.
13
14=over
15
16=item B<-f>
17
18Show the full path for all keys.
19
20=item B<-p>
21
22Show permissions of all the listed keys as comma separated list.  The
23format of each permission is I<LD>, where I<L> is a letter for the
24type of permission and I<D> is the corresponding domain ID.
25
26The types of permission are:
27
28=over
29
30=item B<r>
31
32read
33
34=item B<w>
35
36write
37
38=item B<b>
39
40read and write (both)
41
42=item B<n>
43
44no access
45
46=back
47
48The first permission entry is the domain owning the key (the owner)
49I<and> the permissions for any domain not explicitly listed in
50subsequent entries.  The key owner always has full access (read,
51write, and set permissions).
52
53=item B<-s>
54
55Connect to the Xenstore daemon using a local socket only.
56
57=back
58
59=head1 BUGS
60
61Send bugs to xen-devel@lists.xen.org, see
62http://wiki.xen.org/xenwiki/ReportingBugs on how to send bug reports.
63