From patchwork Wed Jun 21 09:30:39 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jan Beulich X-Patchwork-Id: 9801321 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id 06FA460329 for ; Wed, 21 Jun 2017 09:32:46 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id E745D1FF12 for ; Wed, 21 Jun 2017 09:32:45 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id DB79A20243; Wed, 21 Jun 2017 09:32:45 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-4.2 required=2.0 tests=BAYES_00, RCVD_IN_DNSWL_MED autolearn=ham version=3.3.1 Received: from lists.xenproject.org (lists.xenproject.org [192.237.175.120]) (using TLSv1.2 with cipher AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id 5B6FB1FF12 for ; Wed, 21 Jun 2017 09:32:45 +0000 (UTC) Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dNbyH-0007i8-25; Wed, 21 Jun 2017 09:30:45 +0000 Received: from mail6.bemta6.messagelabs.com ([193.109.254.103]) by lists.xenproject.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dNbyG-0007i0-6E for xen-devel@lists.xenproject.org; Wed, 21 Jun 2017 09:30:44 +0000 Received: from [85.158.143.35] by server-3.bemta-6.messagelabs.com id C8/FB-03058-3CC3A495; Wed, 21 Jun 2017 09:30:43 +0000 X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFjrJIsWRWlGSWpSXmKPExsXS6fjDS/eQjVe kwfJtuhbft0xmcmD0OPzhCksAYxRrZl5SfkUCa8a7pmbmggapijs/97I0ME4T62Lk5BASyJPo fbeDGcTmFbCT+LzjBZgtIWAocXrhTRYQm0VAVWLdmptMIDabgLpE27PtrF2MHBwiAgYS544md TFycTALrGWSuDjrLliNsICrxOqdz9kh5hdJbD2wGszmFLCXmLPsNRtIL6+AoMTfHcIgYWagtY 1zfrBMYOSZhZCZhSQDYWtJPPx1C8rWlli28DUzSDmzgLTE8n8cEGFDiZ5f/xlRlYDYNhJt3Q/ ZFjByrGJUL04tKkst0jXVSyrKTM8oyU3MzNE1NDDTy00tLk5MT81JTCrWS87P3cQIDFYGINjB OP2y/yFGSQ4mJVHeC7JekUJ8SfkplRmJxRnxRaU5qcWHGDU4OAS27Vp9gVGKJS8/L1VJgveuN VCdYFFqempFWmYOMJ5gSiU4eJREeJeZA6V5iwsSc4sz0yFSpxgVpcR5O0D6BEASGaV5cG2wGL 7EKCslzMsIdJQQT0FqUW5mCar8K0ZxDkYlYd53VkBTeDLzSuCmvwJazAS0+MURD5DFJYkIKak GRu4PeycK9c/LUpv+4LrTY62O4CyWzqsnvsXFhDi+YFU0mfv6TKWNmXmcrQmX+KSOAy995m1t Yyn7/biqJ/FUuOHTs69dd26pZPh9Z2KYvOaVd9GeiTXvl/y+ErnD//XajMXna2xSpH323c6QK 5S5E8GlVfVa/m/7qgmxOuuzmJvWv287YCvVp8RSnJFoqMVcVJwIAJGqY8HcAgAA X-Env-Sender: JBeulich@suse.com X-Msg-Ref: server-2.tower-21.messagelabs.com!1498037440!61009516!1 X-Originating-IP: [137.65.248.74] X-SpamReason: No, hits=0.0 required=7.0 tests= X-StarScan-Received: X-StarScan-Version: 9.4.19; banners=-,-,- X-VirusChecked: Checked Received: (qmail 36799 invoked from network); 21 Jun 2017 09:30:42 -0000 Received: from prv-mh.provo.novell.com (HELO prv-mh.provo.novell.com) (137.65.248.74) by server-2.tower-21.messagelabs.com with DHE-RSA-AES256-GCM-SHA384 encrypted SMTP; 21 Jun 2017 09:30:42 -0000 Received: from INET-PRV-MTA by prv-mh.provo.novell.com with Novell_GroupWise; Wed, 21 Jun 2017 03:30:40 -0600 Message-Id: <594A58DF0200007800165034@prv-mh.provo.novell.com> X-Mailer: Novell GroupWise Internet Agent 14.2.2 Date: Wed, 21 Jun 2017 03:30:39 -0600 From: "Jan Beulich" To: "xen-devel" References: <594A57B10200007800165012@prv-mh.provo.novell.com> <594A57B10200007800165012@prv-mh.provo.novell.com> In-Reply-To: <594A57B10200007800165012@prv-mh.provo.novell.com> Mime-Version: 1.0 Cc: Stefano Stabellini , Wei Liu , George Dunlap , Andrew Cooper , Ian Jackson , Tim Deegan Subject: [Xen-devel] [PATCH 01/11] public: adjust documentation following XSA-217 X-BeenThere: xen-devel@lists.xen.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Xen developer discussion List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Errors-To: xen-devel-bounces@lists.xen.org Sender: "Xen-devel" X-Virus-Scanned: ClamAV using ClamSMTP Signed-off-by: Jan Beulich public: adjust documentation following XSA-217 Signed-off-by: Jan Beulich --- 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); /* - * GNTTABOP_transfer_grant_ref: Transfer to a foreign domain. The - * foreign domain has previously registered its interest in the transfer via - * . + * GNTTABOP_transfer: Transfer to a foreign domain. The foreign domain + * has previously registered its interest in the transfer via . * * 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 == @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 { Reviewed-by: Andrew Cooper --- 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); /* - * GNTTABOP_transfer_grant_ref: Transfer to a foreign domain. The - * foreign domain has previously registered its interest in the transfer via - * . + * GNTTABOP_transfer: Transfer to a foreign domain. The foreign domain + * has previously registered its interest in the transfer via . * * 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 == @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 {