[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[PATCH v2 2/4] tools/xenstore: add documentation for new set/get-feature commands



Add documentation for two new Xenstore wire commands SET_FEATURE and
GET_FEATURE used to set or query the Xenstore features visible in the
ring page of a given domain.

Signed-off-by: Juergen Gross <jgross@xxxxxxxx>
---
Do we need support in the migration protocol for the features?
V2:
- remove feature bit (Julien Grall)
- GET_FEATURE without domid will return Xenstore supported features
  (triggered by Julien Grall)
---
 docs/misc/xenstore.txt | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/docs/misc/xenstore.txt b/docs/misc/xenstore.txt
index a3d3da0a5b..00f6969202 100644
--- a/docs/misc/xenstore.txt
+++ b/docs/misc/xenstore.txt
@@ -331,6 +331,20 @@ SET_TARGET         <domid>|<tdomid>|
 
        xenstored prevents the use of SET_TARGET other than by dom0.
 
+GET_FEATURE            [<domid>|]              <value>|
+SET_FEATURE            <domid>|<value>|
+       Returns or sets the contents of the "feature" field located at
+       offset 2064 of the Xenstore ring page of the domain specified by
+       <domid>. <value> is a decimal number being a logical or of the
+       feature bits as defined in docs/misc/xenstore-ring.txt. Trying
+       to set a bit for a feature not being supported by the running
+       Xenstore will be denied. Providing no <domid> with the
+       GET_FEATURE command will return the features which are supported
+       by Xenstore.
+
+       xenstored prevents the use of GET_FEATURE and SET_FEATURE other
+       than by dom0.
+
 ---------- Miscellaneous ----------
 
 CONTROL                        <command>|[<parameters>|]
-- 
2.35.3




 


Rackspace

Lists.xenproject.org is hosted with RackSpace, monitoring our
servers 24x7x365 and backed by RackSpace's Fanatical Support®.