All of lore.kernel.org
 help / color / mirror / Atom feed
From: Juergen Gross <jgross@suse.com>
To: xen-devel@lists.xenproject.org
Cc: Juergen Gross <jgross@suse.com>,
	Andrew Cooper <andrew.cooper3@citrix.com>,
	George Dunlap <george.dunlap@citrix.com>,
	Jan Beulich <jbeulich@suse.com>, Julien Grall <julien@xen.org>,
	Stefano Stabellini <sstabellini@kernel.org>, Wei Liu <wl@xen.org>
Subject: [PATCH v2 2/4] tools/xenstore: add documentation for new set/get-feature commands
Date: Fri, 27 May 2022 09:24:25 +0200	[thread overview]
Message-ID: <20220527072427.20327-3-jgross@suse.com> (raw)
In-Reply-To: <20220527072427.20327-1-jgross@suse.com>

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@suse.com>
---
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



  parent reply	other threads:[~2022-05-27  7:24 UTC|newest]

Thread overview: 18+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2022-05-27  7:24 [PATCH v2 0/4] tools/xenstore: add some new features to the documentation Juergen Gross
2022-05-27  7:24 ` [PATCH v2 1/4] tools/xenstore: modify feature bit specification in xenstore-ring.txt Juergen Gross
2022-06-23 18:14   ` Julien Grall
2022-05-27  7:24 ` Juergen Gross [this message]
2022-06-23 18:27   ` [PATCH v2 2/4] tools/xenstore: add documentation for new set/get-feature commands Julien Grall
2022-06-24  4:13     ` Juergen Gross
2022-06-24 17:34       ` Julien Grall
2022-05-27  7:24 ` [PATCH v2 3/4] tools/xenstore: add documentation for new set/get-quota commands Juergen Gross
2022-06-23 18:34   ` Julien Grall
2022-06-24  5:24     ` Juergen Gross
2022-05-27  7:24 ` [PATCH v2 4/4] tools/xenstore: add documentation for extended watch command Juergen Gross
2022-06-23 18:42   ` Julien Grall
2022-06-17  3:24 ` [PATCH v2 0/4] tools/xenstore: add some new features to the documentation Henry Wang
2022-07-18 16:12 ` Jan Beulich
2022-07-18 16:28   ` Julien Grall
2022-07-19  1:28     ` Henry Wang
2022-07-19  5:58     ` Jan Beulich
2022-07-19  7:59       ` Julien Grall

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20220527072427.20327-3-jgross@suse.com \
    --to=jgross@suse.com \
    --cc=andrew.cooper3@citrix.com \
    --cc=george.dunlap@citrix.com \
    --cc=jbeulich@suse.com \
    --cc=julien@xen.org \
    --cc=sstabellini@kernel.org \
    --cc=wl@xen.org \
    --cc=xen-devel@lists.xenproject.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.