Skip to contentSkip to conversation

docs: add DIRECTORY_PART specification do xenstore protocol doc

PATCH RESEND In review Juergen Gross 2 participants 2 messages Jan 27, 2020

lore
Share & tools
lore
#0 lore raw

PATCH RESEND 1/1 docs: add DIRECTORY_PART specification do xenstore protocol doc

DIRECTORY_PART was missing in docs/misc/xenstore.txt. Add it.

---
 docs/misc/xenstore.txt | 9 +++++++++
 1 file changed, 9 insertions(+)
docs/misc/xenstore.txt +9 -0
index ae1b6a8c6e..65570183b6 100644
@@ -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
Signature · 7 lines
2.16.4


_______________________________________________
Xen-devel mailing list
[email protected]
https://lists.xenproject.org/mailman/listinfo/xen-devel
Reviewed-by Paul Durrant on v1 1/1
#1 lore raw
Quoted 13 lines

-----Original Message-----
From: Xen-devel <[email protected]> On Behalf Of Juergen Gross
Sent: 27 January 2020 16:51
To: [email protected]
Cc: Juergen Gross <[email protected]>; Stefano Stabellini <[email protected]>; Julien Grall <[email protected]>; Wei Liu <[email protected]>; Konrad Rzeszutek Wilk <[email protected]>; George Dunlap <[email protected]>; Andrew Cooper <[email protected]>; Ian Jackson <[email protected]>
Subject: [Xen-devel] [PATCH resend] docs: add DIRECTORY_PART specification do xenstore protocol doc

Quoted 3 lines

DIRECTORY_PART was missing in docs/misc/xenstore.txt. Add it.

Quoted 30 lines
---
 docs/misc/xenstore.txt | 9 +++++++++
 1 file changed, 9 insertions(+)
docs/misc/xenstore.txt +0 -0
index ae1b6a8c6e..65570183b6 100644
@@ -152,6 +152,15 @@ DIRECTORY		<path>|			<child-

leaf-name>|*

docs/misc/xenstore.txt +1 -0
 	leafnames.  The resulting children are each named
 	<path>/<child-leaf-name>.
 
+DIRECTORY_PART		<path>|<offset>		<gencnt>|<child-leaf-

name>|*

docs/misc/xenstore.txt +8 -1
+	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

Quoted 4 lines

_______________________________________________
Xen-devel mailing list
[email protected]
https://lists.xenproject.org/mailman/listinfo/xen-devel

_______________________________________________
Xen-devel mailing list
[email protected]
https://lists.xenproject.org/mailman/listinfo/xen-devel