Re: [PATCH 2/4] docs: Document a xenstore path for PV driver version information...

[Andrew Cooper <andrew.cooper3@citrix.com>]

On 06/11/15 17:21, Paul Durrant wrote:
> ...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.durrant@citrix.com>
> Cc: Ian Campbell <ian.campbell@citrix.com>
> Cc: Ian Jackson <ian.jackson@eu.citrix.com>
> Cc: Jan Beulich <jbeulich@suse.com>
> Cc: Keir Fraser <keir@xen.org>
> Cc: Tim Deegan <tim@xen.org>
> ---
>  docs/misc/xenstore-paths.markdown | 10 ++++++++++
>  1 file changed, 10 insertions(+)
>
> diff --git a/docs/misc/xenstore-paths.markdown b/docs/misc/xenstore-paths.markdown
> index ec3cc5f..7701632 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,9 @@ 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 -- 2 or 3 integers, in decimal form separated by ".",
> +             specifying major version, minor version, and then
> +	     (optionally) micro version.

I am not sure version should come with a restriction like this.  For
debug builds, it might be common to have a suffix.  Furthermore, not all
software conforms to the $MAJOR.$MINOR.$MICRO scheme.

I would just leave it specified as a "string which identifies the
version of the driver", without any specific restrictions

~Andrew