[Xen-changelog] [xen staging] docs: retrospectively add XS_DIRECTORY_PART to the xenstore protocol...

[patchbot@xxxxxxx]

commit d34dc88098c974acbd4fe774dcdb2b8b631bc386
Author:     Paul Durrant <pdurrant@xxxxxxxxxx>
AuthorDate: Mon Jan 27 15:19:07 2020 +0000
Commit:     Ian Jackson <ian.jackson@xxxxxxxxxxxxx>
CommitDate: Mon Jan 27 15:34:04 2020 +0000

    docs: retrospectively add XS_DIRECTORY_PART to the xenstore protocol...
    
    ... specification.
    
    This was added by commit 0ca64ed8 "xenstore: add support for reading
    directory with many children" but not added to the specification at that
    point. A version of xenstored supporting the command was first released
    in Xen 4.9.
    
    Signed-off-by: Paul Durrant <pdurrant@xxxxxxxxxx>
    Acked-by: Ian Jackson <ian.jackson@xxxxxxxxxxxxx>
    Backport: 4.9+
---
 docs/misc/xenstore.txt | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/docs/misc/xenstore.txt b/docs/misc/xenstore.txt
index ae1b6a8c6e..bf42e9ec37 100644
--- a/docs/misc/xenstore.txt
+++ b/docs/misc/xenstore.txt
@@ -125,8 +125,9 @@ Values commonly included in payloads include:
 
 
 
-The following are the actual type values, including the request and
-reply payloads as applicable:
+The following are the actual type values defined in io/xs_wire.h
+(omitting the XS_ prefix), including the request and reply payloads
+as applicable:
 
 
 ---------- Database read, write and permissions operations ----------
@@ -152,6 +153,14 @@ DIRECTORY          <path>|                 
<child-leaf-name>|*
        leafnames.  The resulting children are each named
        <path>/<child-leaf-name>.
 
+DIRECTORY_PART         <path>|<index|>         <child-leaf-name>|*
+       Performs the same function as DIRECTORY, but returns a
+       sub-list of children starting at <index> in the overall
+       child list and less than or equal to XENSTORE_PAYLOAD_MAX
+       octets in length. If <index> is beyond the end of the
+       overall child list then the returned sub-list will be
+       empty.
+
 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#staging

_______________________________________________
Xen-changelog mailing list
Xen-changelog@xxxxxxxxxxxxxxxxxxxx
https://lists.xenproject.org/xen-changelog