From mboxrd@z Thu Jan 1 00:00:00 1970 From: "Jan Beulich" Subject: Re: [PATCH 2/2] docs: Introduce some hypercall page documentation Date: Thu, 23 May 2019 06:14:55 -0600 Message-ID: <5CE68EBF0200007800231B22@prv1-mh.provo.novell.com> References: <1558606816-17842-1-git-send-email-andrew.cooper3@citrix.com> <1558606816-17842-3-git-send-email-andrew.cooper3@citrix.com> <5CE67C5B0200007800231A83@prv1-mh.provo.novell.com> <701d553c-20a8-7b1a-6023-35ed1008ce65@citrix.com> <5CE686ED0200007800231AC4@prv1-mh.provo.novell.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from us1-rack-dfw2.inumbo.com ([104.130.134.6]) by lists.xenproject.org with esmtp (Exim 4.89) (envelope-from ) id 1hTmcd-0005TM-Pv for xen-devel@lists.xenproject.org; Thu, 23 May 2019 12:14:59 +0000 In-Reply-To: Content-Disposition: inline List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Errors-To: xen-devel-bounces@lists.xenproject.org Sender: "Xen-devel" To: Andrew Cooper Cc: Stefano Stabellini , Wei Liu , Konrad Rzeszutek Wilk , George Dunlap , Tim Deegan , Julien Grall , xen-devel , Ian Jackson List-Id: xen-devel@lists.xenproject.org Pj4+IE9uIDIzLjA1LjE5IGF0IDE0OjAyLCA8YW5kcmV3LmNvb3BlcjNAY2l0cml4LmNvbT4gd3Jv dGU6Cj4gT24gMjMvMDUvMjAxOSAxMjo0MSwgSmFuIEJldWxpY2ggd3JvdGU6Cj4+Pj4+IE9uIDIz LjA1LjE5IGF0IDEzOjAxLCA8YW5kcmV3LmNvb3BlcjNAY2l0cml4LmNvbT4gd3JvdGU6Cj4+PiBP biAyMy8wNS8yMDE5IDExOjU2LCBKYW4gQmV1bGljaCB3cm90ZToKPj4+Pj4+PiBPbiAyMy4wNS4x OSBhdCAxMjoyMCwgPGFuZHJldy5jb29wZXIzQGNpdHJpeC5jb20+IHdyb3RlOgo+Pj4+PiBUaGlz IGFsc28gaW50cm9kdWNlZCB0aGUgdG9wLWxldmVsIEd1ZXN0IERvY3VtZW50YXRpb24gc2VjdGlv bi4KPj4+Pj4KPj4+Pj4gU2lnbmVkLW9mZi1ieTogQW5kcmV3IENvb3BlciA8YW5kcmV3LmNvb3Bl cjNAY2l0cml4LmNvbT4KPj4+PiBMYXJnZSBwYXJ0cyBvZiB0aGlzIGFyZSBlbnRpcmVseSB4ODYt Y2VudHJpYywgeWV0IGh5cGVyY2FsbHMgZXhpc3QKPj4+PiBmb3IgQXJtIGFzIHdlbGwuIElmIHRo aXMgaXMgaW50ZW50aW9uYWwsIHRoZW4gSSB0aGluayB5b3Ugc2hvdWxkIHNheQo+Pj4+IHNvIGFi b3ZlLgo+Pj4gSXQgaXMgYWxsIHg4NiBzcGVjaWZpYywgd2hpY2ggaXMgd2h5IGl0IGlzIGdyb3Vw ZWQgdW5kZXIgIng4NiBndWVzdAo+Pj4gZG9jdW1lbnRhdGlvbiIuCj4+IE5laXRoZXIgdGhlIHBh dGggbm9yIGFueXRoaW5nIG5lYXIgdGhlIHRvcCBvZiB0aGUgYWRkZWQgZmlsZSBzdWdnZXN0Cj4+ IHRoaXMgaXMgIng4NiBndWVzdCBkb2N1bWVudGF0aW9uIi4gSG93IGlzIG9uZSB0byBtYWtlIHRo aXMKPj4gY29ubmVjdGlvbj8gT3IgYXJlIHlvdSByZWZlcnJpbmcgdG8gdGhlIHNvbGUgZW50cnkg dGhhdCBlbmRzIHVwIGluCj4+IGRvY3MvZ3Vlc3QtZ3VpZGUvaW5kZXgucnN0Pwo+IAo+IFllcywg YW5kIGJ5IHRoZSB3YXkgeW91IGFzayB0aGlzIHF1ZXN0aW9uLCBJIHByZXN1bWUgeW91IGhhdmVu J3Qgc2Vlbgo+IGhvdyBzcGhpbnggcmVuZGVycyBpdC4KCk5vciBkbyBJIHRoaW5rIEkgc2hvdWxk IG5lZWQgdG8sIGZvciB0aGUgcHVycG9zZSBvZiByZXZpZXdpbmcKdGhlIGNoYW5nZS4gSSdtIGlu IHBhcnRpY3VsYXIgY29uY2VybmVkIGFib3V0IGZ1cnRoZXIgYWRkaXRpb25zCmhlcmUgZG93biB0 aGUgcm9hZCwgd2hlbiBpdCB3b3VsZCB0aGVuIGJlIGV2ZW4gbGVzcyB2aXNpYmxlCnRoYXQgdGhp cyBpcyB4ODYtc3BlY2lmaWMgZG9jdW1lbnRhdGlvbi4KCj4gTmV2ZXJ0aGVsZXNzLCB0aGUgb2Jz ZXJ2YXRpb24gYmVsb3cgZG9lcyB3YXJyYW50IHNvbWUgY2hhbmdlcyBoZXJlLgoKUmlnaHQgLSBo ZW5jZSBtZSBtZW50aW9uaW5nICJwYXRoIiBpbiBteSBvcmlnaW5hbCByZXBseS4KCj4+IFBlb3Bs ZQo+PiB3cml0aW5nIGNvZGUgdGFyZ2V0aW5nIHRoZSBoeXBlcmNhbGwgaW50ZXJmYWNlLCBJIGFz c3VtZS4gVGhpcwo+PiBpbmNsdWRlcyBwZW9wbGUgd2hvIG1heSBub3QgYXQgYWxsIGJlIGZhbWls aWFyIHdpdGggdGhlIEFUJlQKPj4gcGVjdWxpYXJpdGllcyBvZiB0aGUgYXNzZW1ibHkgbGFuZ3Vh Z2UgdXNlZCAobWFpbmx5IGZvcgo+PiBuYW1pbmcgcmVnaXN0ZXJzKS4gSXQncyBlYXN5IGZvciB0 aGUgdG8gdW5kZXJzdGFuZCB3aGF0IGlzCj4+IG1lYW50IG5ldmVydGhlbGVzcywgYnV0IHRvIGJl IGhvbmVzdCBJJ2QgcHJlZmVyIGlmIHRoZSBTRE0gLwo+PiBQTSByZWdpc3RlciBuYW1lcyB3ZXJl IHVzZWQgaW5zdGVhZCwgaS5lLiBpbiBwYXJ0aWN1bGFyCj4+IHdpdGhvdXQgdGhlICUgcHJlZml4 ZXMgKGJ1dCBhbHNvIG9taXR0aW5nIHRoZSAkIG9uIHRoZSBJTlQKPj4gb3BlcmFuZCkuCj4gCj4g V2hpbGUgdGhpcyBjYXNlIGlzLCBkcm9wcGluZyB0aGUgQVQmVC1pc21zIGlzIGVhc3ksIEknbSBu b3QgY29udmluY2VkCj4gdGhhdCB3aWxsIGJlIHRoZSBjYXNlIGVsc2V3aGVyZS4KPiAKPiBBbHNv LCBJIGRvbid0IHdhbnQgdXMgdG8gYmUgaW4gYSBjYXNlIHdoZXJlIHdlIGRldmVsb3AgZXhjbHVz aXZlbHkgd2l0aAo+IEFUJlQsIGJ1dCBoYXZlIG91ciBkb2N1bWVudGF0aW9uIHdyaXR0ZW4gaW4g SW50ZWwgc3ludGF4LgoKRm9yIG9uZSBJIGRvbid0IHRoaW5rIGRvY3VtZW50YXRpb24gYW5kIHNv dXJjZSBuZWVkIHRvIGJlCmFsaWduZWQgaW4gdGhpcyByZWdhcmQuIEFsaWduaW5nIG91ciBkb2N1 bWVudGF0aW9uIHRvIHRoYXQKb2YgdGhlIENQVSB2ZW5kb3JzIHNlZW1zIG1vcmUgaW1wb3J0YW50 IHRvIG1lLiAoVGhhdApzYWlkLCBpbiBleGFtcGxlIGNvZGUgSSB0aGluayBhdCBsZWFzdCBvbmUg b2YgdGhlIHR3byBoYXZlCnN0YXJ0ZWQgbWl4aW5nIEludGVsIGFuZCBBVCZUIHN5bnRheC4pCgpB bmQgdGhlbiAtIGNhbid0IHdlIGdldCBhd2F5IHdpdGhvdXQgdXNpbmcgYW55IGFzc2VtYmx5CnN5 bnRheCBhdCBhbGwgaW4gZG9jdW1lbnRhdGlvbj8gU3VyZWx5IHRoaW5ncyBjYW4gYmUgd29yZGVk CmluIGEgbW9yZSBhYnN0cmFjdCB3YXkgKGxpa2UgIklOVCBpbnN0cnVjdGlvbiB3aXRoIGFuIGlt bWVkaWF0ZQpvZiAweDgyKS4KCkphbgoKCgpfX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fXwpYZW4tZGV2ZWwgbWFpbGluZyBsaXN0Clhlbi1kZXZlbEBsaXN0cy54 ZW5wcm9qZWN0Lm9yZwpodHRwczovL2xpc3RzLnhlbnByb2plY3Qub3JnL21haWxtYW4vbGlzdGlu Zm8veGVuLWRldmVs From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-4.0 required=3.0 tests=HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,SIGNED_OFF_BY,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id CE3B0C282DD for ; Thu, 23 May 2019 12:15:17 +0000 (UTC) Received: from lists.xenproject.org (lists.xenproject.org [192.237.175.120]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id A5FB420879 for ; Thu, 23 May 2019 12:15:17 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org A5FB420879 Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=suse.com Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=xen-devel-bounces@lists.xenproject.org Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.89) (envelope-from ) id 1hTmce-0005TR-N9; Thu, 23 May 2019 12:15:00 +0000 Received: from us1-rack-dfw2.inumbo.com ([104.130.134.6]) by lists.xenproject.org with esmtp (Exim 4.89) (envelope-from ) id 1hTmcd-0005TM-Pv for xen-devel@lists.xenproject.org; Thu, 23 May 2019 12:14:59 +0000 X-Inumbo-ID: 618a3023-7d54-11e9-8980-bc764e045a96 Received: from prv1-mh.provo.novell.com (unknown [137.65.248.33]) by us1-rack-dfw2.inumbo.com (Halon) with ESMTPS id 618a3023-7d54-11e9-8980-bc764e045a96; Thu, 23 May 2019 12:14:58 +0000 (UTC) Received: from INET-PRV1-MTA by prv1-mh.provo.novell.com with Novell_GroupWise; Thu, 23 May 2019 06:14:57 -0600 Message-Id: <5CE68EBF0200007800231B22@prv1-mh.provo.novell.com> X-Mailer: Novell GroupWise Internet Agent 18.1.0 Date: Thu, 23 May 2019 06:14:55 -0600 From: "Jan Beulich" To: "Andrew Cooper" References: <1558606816-17842-1-git-send-email-andrew.cooper3@citrix.com> <1558606816-17842-3-git-send-email-andrew.cooper3@citrix.com> <5CE67C5B0200007800231A83@prv1-mh.provo.novell.com> <701d553c-20a8-7b1a-6023-35ed1008ce65@citrix.com> <5CE686ED0200007800231AC4@prv1-mh.provo.novell.com> In-Reply-To: Mime-Version: 1.0 Content-Disposition: inline Subject: Re: [Xen-devel] [PATCH 2/2] docs: Introduce some hypercall page documentation X-BeenThere: xen-devel@lists.xenproject.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Xen developer discussion List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Cc: Stefano Stabellini , Wei Liu , Konrad Rzeszutek Wilk , George Dunlap , Tim Deegan , Julien Grall , xen-devel , Ian Jackson Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: base64 Errors-To: xen-devel-bounces@lists.xenproject.org Sender: "Xen-devel" Message-ID: <20190523121455.NSVsXas-q1S9tD1pAklDWhtWJ38tCR7Y5ZT92hjv3B4@z> Pj4+IE9uIDIzLjA1LjE5IGF0IDE0OjAyLCA8YW5kcmV3LmNvb3BlcjNAY2l0cml4LmNvbT4gd3Jv dGU6Cj4gT24gMjMvMDUvMjAxOSAxMjo0MSwgSmFuIEJldWxpY2ggd3JvdGU6Cj4+Pj4+IE9uIDIz LjA1LjE5IGF0IDEzOjAxLCA8YW5kcmV3LmNvb3BlcjNAY2l0cml4LmNvbT4gd3JvdGU6Cj4+PiBP biAyMy8wNS8yMDE5IDExOjU2LCBKYW4gQmV1bGljaCB3cm90ZToKPj4+Pj4+PiBPbiAyMy4wNS4x OSBhdCAxMjoyMCwgPGFuZHJldy5jb29wZXIzQGNpdHJpeC5jb20+IHdyb3RlOgo+Pj4+PiBUaGlz IGFsc28gaW50cm9kdWNlZCB0aGUgdG9wLWxldmVsIEd1ZXN0IERvY3VtZW50YXRpb24gc2VjdGlv bi4KPj4+Pj4KPj4+Pj4gU2lnbmVkLW9mZi1ieTogQW5kcmV3IENvb3BlciA8YW5kcmV3LmNvb3Bl cjNAY2l0cml4LmNvbT4KPj4+PiBMYXJnZSBwYXJ0cyBvZiB0aGlzIGFyZSBlbnRpcmVseSB4ODYt Y2VudHJpYywgeWV0IGh5cGVyY2FsbHMgZXhpc3QKPj4+PiBmb3IgQXJtIGFzIHdlbGwuIElmIHRo aXMgaXMgaW50ZW50aW9uYWwsIHRoZW4gSSB0aGluayB5b3Ugc2hvdWxkIHNheQo+Pj4+IHNvIGFi b3ZlLgo+Pj4gSXQgaXMgYWxsIHg4NiBzcGVjaWZpYywgd2hpY2ggaXMgd2h5IGl0IGlzIGdyb3Vw ZWQgdW5kZXIgIng4NiBndWVzdAo+Pj4gZG9jdW1lbnRhdGlvbiIuCj4+IE5laXRoZXIgdGhlIHBh dGggbm9yIGFueXRoaW5nIG5lYXIgdGhlIHRvcCBvZiB0aGUgYWRkZWQgZmlsZSBzdWdnZXN0Cj4+ IHRoaXMgaXMgIng4NiBndWVzdCBkb2N1bWVudGF0aW9uIi4gSG93IGlzIG9uZSB0byBtYWtlIHRo aXMKPj4gY29ubmVjdGlvbj8gT3IgYXJlIHlvdSByZWZlcnJpbmcgdG8gdGhlIHNvbGUgZW50cnkg dGhhdCBlbmRzIHVwIGluCj4+IGRvY3MvZ3Vlc3QtZ3VpZGUvaW5kZXgucnN0Pwo+IAo+IFllcywg YW5kIGJ5IHRoZSB3YXkgeW91IGFzayB0aGlzIHF1ZXN0aW9uLCBJIHByZXN1bWUgeW91IGhhdmVu J3Qgc2Vlbgo+IGhvdyBzcGhpbnggcmVuZGVycyBpdC4KCk5vciBkbyBJIHRoaW5rIEkgc2hvdWxk IG5lZWQgdG8sIGZvciB0aGUgcHVycG9zZSBvZiByZXZpZXdpbmcKdGhlIGNoYW5nZS4gSSdtIGlu IHBhcnRpY3VsYXIgY29uY2VybmVkIGFib3V0IGZ1cnRoZXIgYWRkaXRpb25zCmhlcmUgZG93biB0 aGUgcm9hZCwgd2hlbiBpdCB3b3VsZCB0aGVuIGJlIGV2ZW4gbGVzcyB2aXNpYmxlCnRoYXQgdGhp cyBpcyB4ODYtc3BlY2lmaWMgZG9jdW1lbnRhdGlvbi4KCj4gTmV2ZXJ0aGVsZXNzLCB0aGUgb2Jz ZXJ2YXRpb24gYmVsb3cgZG9lcyB3YXJyYW50IHNvbWUgY2hhbmdlcyBoZXJlLgoKUmlnaHQgLSBo ZW5jZSBtZSBtZW50aW9uaW5nICJwYXRoIiBpbiBteSBvcmlnaW5hbCByZXBseS4KCj4+IFBlb3Bs ZQo+PiB3cml0aW5nIGNvZGUgdGFyZ2V0aW5nIHRoZSBoeXBlcmNhbGwgaW50ZXJmYWNlLCBJIGFz c3VtZS4gVGhpcwo+PiBpbmNsdWRlcyBwZW9wbGUgd2hvIG1heSBub3QgYXQgYWxsIGJlIGZhbWls aWFyIHdpdGggdGhlIEFUJlQKPj4gcGVjdWxpYXJpdGllcyBvZiB0aGUgYXNzZW1ibHkgbGFuZ3Vh Z2UgdXNlZCAobWFpbmx5IGZvcgo+PiBuYW1pbmcgcmVnaXN0ZXJzKS4gSXQncyBlYXN5IGZvciB0 aGUgdG8gdW5kZXJzdGFuZCB3aGF0IGlzCj4+IG1lYW50IG5ldmVydGhlbGVzcywgYnV0IHRvIGJl IGhvbmVzdCBJJ2QgcHJlZmVyIGlmIHRoZSBTRE0gLwo+PiBQTSByZWdpc3RlciBuYW1lcyB3ZXJl IHVzZWQgaW5zdGVhZCwgaS5lLiBpbiBwYXJ0aWN1bGFyCj4+IHdpdGhvdXQgdGhlICUgcHJlZml4 ZXMgKGJ1dCBhbHNvIG9taXR0aW5nIHRoZSAkIG9uIHRoZSBJTlQKPj4gb3BlcmFuZCkuCj4gCj4g V2hpbGUgdGhpcyBjYXNlIGlzLCBkcm9wcGluZyB0aGUgQVQmVC1pc21zIGlzIGVhc3ksIEknbSBu b3QgY29udmluY2VkCj4gdGhhdCB3aWxsIGJlIHRoZSBjYXNlIGVsc2V3aGVyZS4KPiAKPiBBbHNv LCBJIGRvbid0IHdhbnQgdXMgdG8gYmUgaW4gYSBjYXNlIHdoZXJlIHdlIGRldmVsb3AgZXhjbHVz aXZlbHkgd2l0aAo+IEFUJlQsIGJ1dCBoYXZlIG91ciBkb2N1bWVudGF0aW9uIHdyaXR0ZW4gaW4g SW50ZWwgc3ludGF4LgoKRm9yIG9uZSBJIGRvbid0IHRoaW5rIGRvY3VtZW50YXRpb24gYW5kIHNv dXJjZSBuZWVkIHRvIGJlCmFsaWduZWQgaW4gdGhpcyByZWdhcmQuIEFsaWduaW5nIG91ciBkb2N1 bWVudGF0aW9uIHRvIHRoYXQKb2YgdGhlIENQVSB2ZW5kb3JzIHNlZW1zIG1vcmUgaW1wb3J0YW50 IHRvIG1lLiAoVGhhdApzYWlkLCBpbiBleGFtcGxlIGNvZGUgSSB0aGluayBhdCBsZWFzdCBvbmUg b2YgdGhlIHR3byBoYXZlCnN0YXJ0ZWQgbWl4aW5nIEludGVsIGFuZCBBVCZUIHN5bnRheC4pCgpB bmQgdGhlbiAtIGNhbid0IHdlIGdldCBhd2F5IHdpdGhvdXQgdXNpbmcgYW55IGFzc2VtYmx5CnN5 bnRheCBhdCBhbGwgaW4gZG9jdW1lbnRhdGlvbj8gU3VyZWx5IHRoaW5ncyBjYW4gYmUgd29yZGVk CmluIGEgbW9yZSBhYnN0cmFjdCB3YXkgKGxpa2UgIklOVCBpbnN0cnVjdGlvbiB3aXRoIGFuIGlt bWVkaWF0ZQpvZiAweDgyKS4KCkphbgoKCgpfX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fXwpYZW4tZGV2ZWwgbWFpbGluZyBsaXN0Clhlbi1kZXZlbEBsaXN0cy54 ZW5wcm9qZWN0Lm9yZwpodHRwczovL2xpc3RzLnhlbnByb2plY3Qub3JnL21haWxtYW4vbGlzdGlu Zm8veGVuLWRldmVs