[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[xen stable-4.12] docs: add DIRECTORY_PART specification do xenstore protocol doc



commit 5c1b607e8a4de32fc2238f4d29d477007eb5822c
Author:     Juergen Gross <jgross@xxxxxxxx>
AuthorDate: Mon Jan 27 17:50:50 2020 +0100
Commit:     Ian Jackson <ian.jackson@xxxxxxxxxxxxx>
CommitDate: Tue May 5 15:13:40 2020 +0100

    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@xxxxxxxx>
    Reviewed-by: Paul Durrant <pdurrant@xxxxxxxxxx>
    Acked-by: Wei Liu <wl@xxxxxxx>
    Backport: 4.9+
    (cherry picked from commit 94a0252c10cb9938bdee98cc456c23e17b28eafb)
---
 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
--
generated by git-patchbot for /home/xen/git/xen.git#stable-4.12



 


Rackspace

Lists.xenproject.org is hosted with RackSpace, monitoring our
servers 24x7x365 and backed by RackSpace's Fanatical Support®.