summaryrefslogtreecommitdiff
path: root/docs/man/xenstore-ls.1.pod
blob: a9f8b326532605b8dfc9e22cb186a99bad737bd6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
=head1 NAME

xenstore-ls - list Xenstore keys and values

=head1 SYNOPSIS

B<xenstore-ls> [I<OPTION>]... [I<PATH>]...

=head1 DESCRIPTION

List keys, values and permissions of one or more Xenstore I<PATH>s,
using a nested, tree-like view.

=over

=item B<-f>

Show the full path for all keys.

=item B<-p>

Show permissions of all the listed keys as comma separated list.  The
format of each permission is I<LD>, where I<L> is a letter for the
type of permission and I<D> is the corresponding domain ID.

The types of permission are:

=over

=item B<r>

read

=item B<w>

write

=item B<b>

read and write (both)

=item B<n>

no access

=back

The first permission entry is the domain owning the key (the owner)
I<and> the permissions for any domain not explicitly listed in
subsequent entries.  The key owner always has full access (read,
write, and set permissions).

=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.