From mboxrd@z Thu Jan 1 00:00:00 1970 From: Paul Durrant Subject: [PATCH 2/4] docs: Document a xenstore path for PV driver version information... Date: Fri, 6 Nov 2015 17:21:45 +0000 Message-ID: <1446830507-4233-4-git-send-email-paul.durrant@citrix.com> References: <1446830507-4233-1-git-send-email-paul.durrant@citrix.com> Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Return-path: Received: from mail6.bemta3.messagelabs.com ([195.245.230.39]) by lists.xen.org with esmtp (Exim 4.72) (envelope-from ) id 1Zukk2-0000a1-Tg for xen-devel@lists.xenproject.org; Fri, 06 Nov 2015 17:23:59 +0000 In-Reply-To: <1446830507-4233-1-git-send-email-paul.durrant@citrix.com> List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Sender: xen-devel-bounces@lists.xen.org Errors-To: xen-devel-bounces@lists.xen.org To: xen-devel@lists.xenproject.org Cc: Keir Fraser , Ian Campbell , Tim Deegan , Ian Jackson , Paul Durrant , Jan Beulich List-Id: xen-devel@lists.xenproject.org ...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 Cc: Ian Campbell Cc: Ian Jackson Cc: Jan Beulich Cc: Keir Fraser Cc: Tim Deegan --- 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. Additional TAGS may follow as a comma separated set of the following tags enclosed in square brackets. @@ -377,6 +382,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