tools/xenstore: add documentation for new set/get-quota commands
authorJuergen Gross <jgross@suse.com>
Mon, 18 Jul 2022 15:47:04 +0000 (17:47 +0200)
committerJan Beulich <jbeulich@suse.com>
Mon, 18 Jul 2022 15:47:04 +0000 (17:47 +0200)
Add documentation for two new Xenstore wire commands SET_QUOTA and
GET_QUOTA used to set or query the Xenstore quota of a given domain.

Signed-off-by: Juergen Gross <jgross@suse.com>
Reviewed-by: Luca Fancellu <luca.fancellu@arm.com>
docs/misc/xenstore-ring.txt
docs/misc/xenstore.txt

index fe06af32fee437c5704153ac8158d8c199626c92..aa71c56e4c3aca6d6e403ca2524ffc572b85ea87 100644 (file)
@@ -70,6 +70,7 @@ Bit     Description
 0       Ring reconnection (see the ring reconnection feature below)
 1       Connection error indicator (see connection error feature below)
 2       GET_FEATURE and SET_FEATURE Xenstore wire commands are available
+3       GET_QUOTA and SET_QUOTA Xenstore wire commands are available
 
 The "Connection state" field is used to request a ring close and reconnect.
 The "Connection state" field only contains valid data if the server has
index 5f4c5c6a55d6fceeb75e92da30e1ac77daa97d74..629f962bb579f30e7594f11d10bf17227e2f9b87 100644 (file)
@@ -332,6 +332,18 @@ SET_FEATURE                <domid>|<value>|
        xenstored prevents the use of GET_FEATURE and SET_FEATURE other
        than by dom0.
 
+GET_QUOTA              <domid>|<quota>|        <value>|
+SET_QUOTA              <domid>|<quota>|<value>|
+       Returns or sets a quota value for the domain being specified by
+       <domid>. <quota> is one of "nodes", "watches", "transactions",
+       "node-size" or "permissions". <value> is a decimal number
+       specifying the quota value, with "0" having the special meaning
+       of quota checks being disabled. The initial quota settings for
+       a domain are the global ones of Xenstore.
+
+       xenstored prevents the use of GET_QUOTA and SET_QUOTA other
+       than by dom0.
+
 ---------- Miscellaneous ----------
 
 CONTROL                        <command>|[<parameters>|]