| Message ID | 20200127165050.29413-1-jgross@suse.com (mailing list archive) |
|---|---|
| State | New, archived |
| Headers | show |
| Series | [resend] docs: add DIRECTORY_PART specification do xenstore protocol doc | expand |
> -----Original Message----- > From: Xen-devel <xen-devel-bounces@lists.xenproject.org> On Behalf Of > Juergen Gross > Sent: 27 January 2020 16:51 > To: xen-devel@lists.xenproject.org > Cc: Juergen Gross <jgross@suse.com>; Stefano Stabellini > <sstabellini@kernel.org>; Julien Grall <julien@xen.org>; Wei Liu > <wl@xen.org>; Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>; George > Dunlap <George.Dunlap@eu.citrix.com>; Andrew Cooper > <andrew.cooper3@citrix.com>; Ian Jackson <ian.jackson@eu.citrix.com> > Subject: [Xen-devel] [PATCH resend] docs: add DIRECTORY_PART specification > do xenstore protocol doc > > DIRECTORY_PART was missing in docs/misc/xenstore.txt. Add it. > > Signed-off-by: Juergen Gross <jgross@suse.com> Reviewed-by: Paul Durrant <pdurrant@amazon.com> > --- > docs/misc/xenstore.txt | 9 +++++++++ > 1 file changed, 9 insertions(+) > > diff --git a/docs/misc/xenstore.txt b/docs/misc/xenstore.txt > index ae1b6a8c6e..65570183b6 100644 > --- a/docs/misc/xenstore.txt > +++ b/docs/misc/xenstore.txt > @@ -152,6 +152,15 @@ DIRECTORY <path>| <child- > leaf-name>|* > leafnames. The resulting children are each named > <path>/<child-leaf-name>. > > +DIRECTORY_PART <path>|<offset> <gencnt>|<child-leaf- > name>|* > + Same as DIRECTORY, but to be used for children lists longer than > + XENSTORE_PAYLOAD_MAX. Input are <path> and the byte offset into > + the list of children to return. Return values are the generation > + count <gencnt> of the node (to be used to ensure the node hasn't > + changed between two reads: <gencnt> being the same for multiple > + reads guarantees the node hasn't changed) and the list of children > + starting at the specified <offset> of the complete list. > + > GET_PERMS <path>| <perm-as-string>|+ > SET_PERMS <path>|<perm-as-string>|+? > <perm-as-string> is one of the following > -- > 2.16.4 > > > _______________________________________________ > Xen-devel mailing list > Xen-devel@lists.xenproject.org > https://lists.xenproject.org/mailman/listinfo/xen-devel
diff --git a/docs/misc/xenstore.txt b/docs/misc/xenstore.txt index ae1b6a8c6e..65570183b6 100644 --- a/docs/misc/xenstore.txt +++ b/docs/misc/xenstore.txt @@ -152,6 +152,15 @@ DIRECTORY <path>| <child-leaf-name>|* leafnames. The resulting children are each named <path>/<child-leaf-name>. +DIRECTORY_PART <path>|<offset> <gencnt>|<child-leaf-name>|* + Same as DIRECTORY, but to be used for children lists longer than + XENSTORE_PAYLOAD_MAX. Input are <path> and the byte offset into + the list of children to return. Return values are the generation + count <gencnt> of the node (to be used to ensure the node hasn't + changed between two reads: <gencnt> being the same for multiple + reads guarantees the node hasn't changed) and the list of children + starting at the specified <offset> of the complete list. + GET_PERMS <path>| <perm-as-string>|+ SET_PERMS <path>|<perm-as-string>|+? <perm-as-string> is one of the following
DIRECTORY_PART was missing in docs/misc/xenstore.txt. Add it. Signed-off-by: Juergen Gross <jgross@suse.com> --- docs/misc/xenstore.txt | 9 +++++++++ 1 file changed, 9 insertions(+)