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

[Jürgen Groß <jgross@xxxxxxxx>]

On 27.01.20 16:19, Paul Durrant wrote:
> ... 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>
> ---
> Cc: Juergen Gross <jgross@xxxxxxxx>
> Cc: Andrew Cooper <andrew.cooper3@xxxxxxxxxx>
> Cc: George Dunlap <George.Dunlap@xxxxxxxxxxxxx>
> Cc: Ian Jackson <ian.jackson@xxxxxxxxxxxxx>
> Cc: Jan Beulich <jbeulich@xxxxxxxx>
> Cc: Julien Grall <julien@xxxxxxx>
> Cc: Konrad Rzeszutek Wilk <konrad.wilk@xxxxxxxxxx>
> Cc: Stefano Stabellini <sstabellini@xxxxxxxxxx>
> Cc: Wei Liu <wl@xxxxxxx>
> ---
>   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.
> +
Hmm, not quite.

I did send this some years ago:

https://lists.xen.org/archives/html/xen-devel/2017-05/msg00650.html

Ian wanted to suggest something better, but he never did.


Juergen

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