Re: [Xen-devel] [PATCH] docs: retrospectively add XS_DIRECTORY_PART to the xenstore protocol...

[Ian Jackson <ian.jackson@xxxxxxxxxx>]

Paul Durrant writes ("[PATCH] 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.

Thanks for documenting this.  A docs fix like this should be
backported if it applies, IMO.

Acked-by: Ian Jackson <ian.jackson@xxxxxxxxxxxxx>
Backport: 4.9+

I will commit it to staging momentarily.

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

I wonder if it should be somehow made more explicit that `index' is a
count of directory entries, not bytes.  Maybe this is obvious.

Ian.

_______________________________________________
Xen-devel mailing list
Xen-devel@xxxxxxxxxxxxxxxxxxxx
https://lists.xenproject.org/mailman/listinfo/xen-devel