[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [Xen-devel] [PATCH v4 2/4] docs: Introduce xenstore paths for PV driver information
For domain management purposes it is convenient to be able to see information about PV drivers 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@xxxxxxxxxx> Cc: Ian Campbell <ian.campbell@xxxxxxxxxx> Cc: Ian Jackson <ian.jackson@xxxxxxxxxxxxx> Cc: Jan Beulich <jbeulich@xxxxxxxx> Cc: Keir Fraser <keir@xxxxxxx> Cc: Tim Deegan <tim@xxxxxxx> --- v4: - Rather than just version information, expand the definition of paths under ~/drivers to include full distribution information, including vendor name. v2: - Modify version specifier to allow for single-part version numbers and also arbitrary string suffix (e.g. '-debug') --- docs/misc/xenstore-paths.markdown | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/docs/misc/xenstore-paths.markdown b/docs/misc/xenstore-paths.markdown index 2d2ce46..808e3a0 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 +* $INDEX -- an integer used as part of a path when listing a set of + values. Typically these integers are contiguous. VALUES are strings and can take the following forms: @@ -51,6 +53,23 @@ 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 ")". +* DISTRIBUTION -- information about a software distribution, comprised + of 3 or 4 space separated fields as follows: + + VENDOR -- Commonly used vendor short name, + e.g "Citrix" rather than "Citrix Systems + Inc." + + PRODUCT -- Commonly used product (e.g. driver) name + without version information. + + VERSION -- A version number that will sort properly + under coreutils version sorting (sort -V) + rules. + + ATTRIBUTES -- Optional human readable text enclosed in + parentheses to denote attributes of the + software, e.g. "(debug)" Additional TAGS may follow as a comma separated set of the following tags enclosed in square brackets. @@ -380,6 +399,11 @@ protocol definition. A domain writable path. Available for arbitrary domain use. +#### ~/drivers/$INDEX = DISTRIBUTION [w] + +A domain may write information about installed PV drivers using +paths of this form. + ### Paths private to the toolstack #### ~/device-model/$DOMID/state [w] -- 2.1.4 _______________________________________________ Xen-devel mailing list Xen-devel@xxxxxxxxxxxxx http://lists.xen.org/xen-devel
|
Lists.xenproject.org is hosted with RackSpace, monitoring our |