...to be advertised by a guest.
For domain management purposes it is convenient to be able to see
PV driver version information in xenstore. The XAPI toolstack in
XenServer has always created a ~/drivers path for this purpose.
This patch documents that path and also adds a specification of how
it should be used.
Signed-off-by: Paul Durrant <paul.durr...@citrix.com>
Cc: Ian Campbell <ian.campb...@citrix.com>
Cc: Ian Jackson <ian.jack...@eu.citrix.com>
Cc: Jan Beulich <jbeul...@suse.com>
Cc: Keir Fraser <k...@xen.org>
Cc: Tim Deegan <t...@xen.org>
---
v2:
- Modify version specifier to allow for single-part version numbers
and also arbitrary string suffix (e.g. '-debug')
---
docs/misc/xenstore-paths.markdown | 12 ++++++++++++
1 file changed, 12 insertions(+)
diff --git a/docs/misc/xenstore-paths.markdown
b/docs/misc/xenstore-paths.markdown
index ec3cc5f..5c0a519 100644
--- a/docs/misc/xenstore-paths.markdown
+++ b/docs/misc/xenstore-paths.markdown
@@ -37,6 +37,8 @@ before regexp expansion:
the "other" domain. i.e. ~ refers to the domain providing a service
while $DOMID is the consumer of that service.
* $UUID -- a UUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+* $NAME -- a string identifying an object within a domain. Typically
+ comprising only alphanumeric characters.
VALUES are strings and can take the following forms:
@@ -51,6 +53,11 @@ VALUES are strings and can take the following forms:
* (VALUE | VALUE | ... ) -- a set of alternatives. Alternatives are
separated by a "|" and all the alternatives are enclosed in "(" and
")".
+* VERSION -- 1, 2 or 3 integers, in decimal form separated by "."
+ followed by a STRING suffix (starting with the first
+ non-numeric character).
+ The integers are a version number of the form MAJOR,
+ MAJOR.MINOR or MAJOR.MINOR.MICRO respectively.
Additional TAGS may follow as a comma separated set of the following
tags enclosed in square brackets.
@@ -377,6 +384,11 @@ protocol definition.
A domain writable path. Available for arbitrary domain use.
+#### ~/drivers/$NAME/version = VERSION [w]
+
+A domain may write version information for PV driver $NAME using
+this path.
+
### Paths private to the toolstack
#### ~/device-model/$DOMID/state [w]
--
2.1.4
_______________________________________________
Xen-devel mailing list
Xen-devel@lists.xen.org
http://lists.xen.org/xen-devel
