From mboxrd@z Thu Jan  1 00:00:00 1970
From: "Jan Beulich" <JBeulich@suse.com>
Subject: [PATCH 01/11] public: adjust documentation following
	XSA-217
Date: Wed, 21 Jun 2017 03:30:39 -0600
Message-ID: <594A58DF0200007800165034@prv-mh.provo.novell.com>
References: <594A57B10200007800165012@prv-mh.provo.novell.com>
 <594A57B10200007800165012@prv-mh.provo.novell.com>
Mime-Version: 1.0
Content-Type: multipart/mixed; boundary="=__PartE8D0F6AF.3__="
Return-path: <xen-devel-bounces@lists.xen.org>
Received: from mail6.bemta6.messagelabs.com ([193.109.254.103])
 by lists.xenproject.org with esmtp (Exim 4.84_2)
 (envelope-from <JBeulich@suse.com>) id 1dNbyG-0007i0-6E
 for xen-devel@lists.xenproject.org; Wed, 21 Jun 2017 09:30:44 +0000
In-Reply-To: <594A57B10200007800165012@prv-mh.provo.novell.com>
List-Unsubscribe: <https://lists.xen.org/cgi-bin/mailman/options/xen-devel>,
 <mailto:xen-devel-request@lists.xen.org?subject=unsubscribe>
List-Post: <mailto:xen-devel@lists.xen.org>
List-Help: <mailto:xen-devel-request@lists.xen.org?subject=help>
List-Subscribe: <https://lists.xen.org/cgi-bin/mailman/listinfo/xen-devel>,
 <mailto:xen-devel-request@lists.xen.org?subject=subscribe>
Errors-To: xen-devel-bounces@lists.xen.org
Sender: "Xen-devel" <xen-devel-bounces@lists.xen.org>
To: xen-devel <xen-devel@lists.xenproject.org>
Cc: Stefano Stabellini <sstabellini@kernel.org>, Wei Liu <wei.liu2@citrix.com>, George Dunlap <George.Dunlap@eu.citrix.com>, Andrew Cooper <andrew.cooper3@citrix.com>, Ian Jackson <Ian.Jackson@eu.citrix.com>, Tim Deegan <tim@xen.org>
List-Id: xen-devel@lists.xenproject.org

This is a MIME message. If you are reading this text, you may want to 
consider changing to a mail reader or gateway that understands how to 
properly handle MIME multipart messages.

--=__PartE8D0F6AF.3__=
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: quoted-printable
Content-Disposition: inline

Signed-off-by: Jan Beulich <jbeulich@suse.com>

--- a/xen/include/public/grant_table.h
+++ b/xen/include/public/grant_table.h
@@ -411,12 +411,13 @@ typedef struct gnttab_dump_table gnttab_
 DEFINE_XEN_GUEST_HANDLE(gnttab_dump_table_t);
=20
 /*
- * GNTTABOP_transfer_grant_ref: Transfer <frame> to a foreign domain. The
- * foreign domain has previously registered its interest in the transfer =
via
- * <domid, ref>.
+ * GNTTABOP_transfer: Transfer <frame> to a foreign domain. The foreign =
domain
+ * has previously registered its interest in the transfer via <domid, =
ref>.
  *
  * Note that, even if the transfer fails, the specified page no longer =
belongs
  * to the calling domain *unless* the error is GNTST_bad_page.
+ *
+ * Note further that only PV guests can use this operation.
  */
 struct gnttab_transfer {
     /* IN parameters. */
--- a/xen/include/public/memory.h
+++ b/xen/include/public/memory.h
@@ -102,6 +102,8 @@ DEFINE_XEN_GUEST_HANDLE(xen_memory_reser
  * Returns zero on complete success, otherwise a negative error code.
  * On complete success then always @nr_exchanged =3D=3D @in.nr_extents.
  * On partial success @nr_exchanged indicates how much work was done.
+ *
+ * Note that only PV guests can use this operation.
  */
 #define XENMEM_exchange             11
 struct xen_memory_exchange {




--=__PartE8D0F6AF.3__=
Content-Type: text/plain; name="xsa217-doc.patch"
Content-Transfer-Encoding: quoted-printable
Content-Disposition: attachment; filename="xsa217-doc.patch"

public: adjust documentation following XSA-217=0A=0ASigned-off-by: Jan =
Beulich <jbeulich@suse.com>=0A=0A--- a/xen/include/public/grant_table.h=0A+=
++ b/xen/include/public/grant_table.h=0A@@ -411,12 +411,13 @@ typedef =
struct gnttab_dump_table gnttab_=0A DEFINE_XEN_GUEST_HANDLE(gnttab_dump_tab=
le_t);=0A =0A /*=0A- * GNTTABOP_transfer_grant_ref: Transfer <frame> to a =
foreign domain. The=0A- * foreign domain has previously registered its =
interest in the transfer via=0A- * <domid, ref>.=0A+ * GNTTABOP_transfer: =
Transfer <frame> to a foreign domain. The foreign domain=0A+ * has =
previously registered its interest in the transfer via <domid, ref>.=0A  =
*=0A  * Note that, even if the transfer fails, the specified page no =
longer belongs=0A  * to the calling domain *unless* the error is GNTST_bad_=
page.=0A+ *=0A+ * Note further that only PV guests can use this operation.=
=0A  */=0A struct gnttab_transfer {=0A     /* IN parameters. */=0A--- =
a/xen/include/public/memory.h=0A+++ b/xen/include/public/memory.h=0A@@ =
-102,6 +102,8 @@ DEFINE_XEN_GUEST_HANDLE(xen_memory_reser=0A  * Returns =
zero on complete success, otherwise a negative error code.=0A  * On =
complete success then always @nr_exchanged =3D=3D @in.nr_extents.=0A  * On =
partial success @nr_exchanged indicates how much work was done.=0A+ *=0A+ =
* Note that only PV guests can use this operation.=0A  */=0A #define =
XENMEM_exchange             11=0A struct xen_memory_exchange {=0A
--=__PartE8D0F6AF.3__=
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: base64
Content-Disposition: inline

X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX18KWGVuLWRldmVs
IG1haWxpbmcgbGlzdApYZW4tZGV2ZWxAbGlzdHMueGVuLm9yZwpodHRwczovL2xpc3RzLnhlbi5v
cmcveGVuLWRldmVsCg==

--=__PartE8D0F6AF.3__=--