From mboxrd@z Thu Jan 1 00:00:00 1970 From: Ian Campbell Subject: Re: [PATCH XEN v6 25/32] tools/libs/gnttab: Extensive updates to API documentation. Date: Mon, 14 Dec 2015 11:29:06 +0000 Message-ID: <1450092546.16856.38.camel@citrix.com> References: <1449141675.4424.125.camel@citrix.com> <1449141749-14940-1-git-send-email-ian.campbell@citrix.com> <1449141749-14940-26-git-send-email-ian.campbell@citrix.com> <22120.21030.865818.976753@mariner.uk.xensource.com> <1449678352.9759.26.camel@citrix.com> <22120.22201.162598.224018@mariner.uk.xensource.com> <1449680885.9759.34.camel@citrix.com> <1449854046.30975.78.camel@citrix.com> <22123.1467.78535.285723@mariner.uk.xensource.com> <1449855359.30975.90.camel@citrix.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: In-Reply-To: <1449855359.30975.90.camel@citrix.com> List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Sender: xen-devel-bounces@lists.xen.org Errors-To: xen-devel-bounces@lists.xen.org To: Ian Jackson Cc: Daniel De Graaf , Roger Pau Monne , wei.liu2@citrix.com, xen-devel@lists.xen.org List-Id: xen-devel@lists.xenproject.org T24gRnJpLCAyMDE1LTEyLTExIGF0IDE3OjM1ICswMDAwLCBJYW4gQ2FtcGJlbGwgd3JvdGU6Cj4g T24gRnJpLCAyMDE1LTEyLTExIGF0IDE3OjE5ICswMDAwLCBJYW4gSmFja3NvbiB3cm90ZToKPiA+ IElhbiBDYW1wYmVsbCB3cml0ZXMgKCJSZTogW1hlbi1kZXZlbF0gW1BBVENIIFhFTiB2NiAyNS8z Ml0KPiA+IHRvb2xzL2xpYnMvZ250dGFiOiBFeHRlbnNpdmUgdXBkYXRlcyB0byBBUEkgZG9jdW1l bnRhdGlvbi4iKToKPiA+ID4gSSdtIGN1cnJlbnRseSBpbnRlbmRpbmcgdG8gd3JpdGUgc29tZXRo aW5nIHZlcnkgc2ltaWxhciBmb3IgZWFjaCBvZgo+ID4gPiB0aGUKPiA+ID4geGVuKl9vcGVuIChn bnRzaHIsIGdudHRhYiwgZm9yZWlnbm1lbW9yeSwgZXZ0Y2huIGFuZCBwcm9iYWJseSBjYWxsCj4g PiA+IHRvbykKPiA+ID4gZnVuY3Rpb25zLiBJIGRvbid0IHJlYWxseSBsaWtlIHJlcGVhdGluZyB0 aGUgc2FtZSB0aGluZyBsaWtlIHRoaXMsCj4gPiA+IGJ1dAo+ID4gPiBJCj4gPiA+IGFsc28gZG9u J3QgcmVhbGx5IGxpa2UgQVBJIGRvY3VtZW50YXRpb24gd2hpY2ggbWFrZXMgeW91IHBsYXkgZm9s bG93Cj4gPiA+IHRoZQo+ID4gPiBwaWVjZSBvZiBzdHJpbmcgdG8gdGhlIGRvY3Mgb2Ygb3RoZXIg bGlicmFyaWVzIHRvIGZpbmQgb3V0IHdoYXQgaXMKPiA+ID4gZ29pbmcKPiA+ID4gb24uCj4gPiAK PiA+IFRoYXQgd291bGQgYmUgZmluZSBieSBtZS7CoMKgQnV0IGRvIHRoZXNlIG90aGVyIGZ1bmN0 aW9ucyBzdWZmZXIgZnJvbQo+ID4gdGhlIHNhbWUgcHJvYmxlbSA/Cj4gPiAKPiA+IEllLCBjYW4g d2UgZm9yIGdudHNociBldCBhbCwgdGVsbCB0aGUgdXNlciB0aGF0IHRoZXkgc2hvdWxkIGNhbGwK PiA+IGJsYWhfdW5tYXAgP8KgwqBUaGlzIGlzIG5vdCBwcmFjdGljYWwgaW4gYSBtdWx0aXRocmVh ZGVkIHByb2dyYW0gZm9yCj4gPiBoeXBlcmNhbGwgbWVtb3J5IGJ1dCBpdCBtaWdodCB3ZWxsIGJl IHByYWN0aWNhbCBmb3Igb3RoZXIga2luZHMgb2YKPiA+IGJvcnJvd2VkIG1lbW9yeS4KPiAKPiBH b29kIHBvaW50LCBJIHRoaW5rIG1vc3Qgb2YgdGhlIHJlc3Qgb2YgdGhlbSBwcm9iYWJseSBjYW4g c3VwcG9ydCB1bm1hcAo+IGFmdGVyIGZvcmssIGJ1dCBJJ3ZlwqBub3QgY2hlY2tlZCAoSSB3aWxs IGJlZm9yZSBJIHdyaXRlIGFueXRoaW5nKS4KCkdvb2QgdGhpbmcgSSBkaWQuCgpPbiBMaW51eCBi b3RoIHRoZSBnbnR0YWIgYW5kIHByaXZjbWQgZm9yZWlnbiBtYXBwaW5ncyBzZXQgVk1BX0RPTlRD T1BZIG9uCnRoZSBtYXBwaW5ncyBmcm9tIHRoZSBkcml2ZXIsIHdoaWNoIGlzIHRoZSBzYW1lIGVm ZmVjdCBhcyB0aGUKbWFkdmlzZShET05URk9SSykgaW4gdGhlIGh5cGVyY2FsbCBidWZmZXIgYWxs b2NhdGlvbiBoYXMuCgpGb3IgZ250dGFiIHRoaXMgaXMgb2J2aW91cyBub3cgSSB0aGluayBhYm91 dCBpdCwgc2luY2UgeW91IGNhbm5vdCB1bm1hcCBvcgpvdGhlcndpc2Ugb3BlcmF0ZSBvbiBhIGdu dG1hcCB3aXRoIG5vcm1hbCBQVEUgdXBkYXRlcywgeW91IGhhdmUgdG8gdXNlCmdudG1hcCBoeXBl cmNhbGxzLCB3aGljaCBjb3JlIE9TIGNvZGUgbGlrZSBDb1cgaGFuZGxpbmcgb2J2aW91c2x5IHdv bid0LgoKVGhlIHNhbWUgY291bGQgYmUgdHJ1ZSBmb3IgcHJpdmNtZCBmb3JlaWduIG1hcHBpbmdz IGZvciBQViBndWVzdHMsIEkgdGhpbmssCnNpbmNlIHRoZSBQVEUgdXBkYXRlIGh5cGVyY2FsbCBu ZWVkcyB0aGUgZm9yZWlnbiBkb21pZCBpbiBpdCwgd2hpY2ggY29tbW9uCmNvZGUgd291bGRuJ3Qg aGF2ZS4KClNvIHRob3NlIG1lbW9yeSByZWdpb25zIHNpbXBseSB3b24ndCBleGlzdCBpbiB0aGUg Y2hpbGQsIGFuZCBtdW5tYXAgd291bGQKdGhlcmVmb3JlIGVpdGhlciBmYWlsIG9yIHVubWFwIHdo YXRldmVyIG5ldyB0aGluZyBoYXMgc2hvd24gdXAgYXQgYW4KYWRkcmVzcy4KClNvIEkgdGhpbmsg YXQgbGVhc3QgY2FsbCwgZm9yZWlnbm1lbW9yeSBhbmQgZ250dGFiIG5lZWQgYQpyZXN0cmljdGlv bi9jYXZlYXQgbGlrZSB0aGUgYWJvdmUsIHdoaWNoIGlzIHRoYXQgb24gZm9yayBidXQgbm90IGV4 ZWMgeW91CmNhbiBjYWxsIGNsb3NlKCkgYW5kIGhvcGUgaXQgZG9lcyBzb21ldGhpbmcsIGJ1dCB1 bm1hcCBpcyBvZmYgdGhlIHRhYmxlLgoKZ250c2hyIG1pZ2h0IGJlIG9rLCBhbHRob3VnaCBUQkgg SSdtIG5vdCByZWFsbHkgc3VyZSB3aGF0IHRoZSBlZmZlY3Qgb2YKY293LXdpbmcgbWVtb3J5IHdo aWNoIGhhcyBiZWVuIGdyYW50ZWQsIG5vciBob3cgb25lIGVuc3VyZXMgdGhlIGRlc2lyZWQKY2hp bGQvcGFyZW50IGVuZHMgdXAgd2l0aCB0aGUgYWN0dWFsbHkgZ3JhbnRlZCBtZW1vcnkgYW5kIG5v dCBhIGNvcHkgKElPVwppdCdzIG5vdCBjbGVhciB3aHkgVk1BX0RPTlRDT1BZIGlzbid0IGFwcGxp ZWQgaGVyZSB0b28pLiBPbiB0aGF0IGJhc2lzIEknZApiZSBpbmNsaW5lZCB0byBnaXZlIGdudHNo ciB0aGUgc2FtZSBzZW1hbnRpY3MgYXMgdGhlIG90aGVycy4KCmV2dGNobiBkb2Vzbid0IGFjdHVh bGx5IGludm9sdmUgYW55IG1lbW9yeSBtYXBwaW5ncywgYW5kIGluIHRoYXQgY2FzZQpjbG9zaW5n IHRoZSBmZCBpcyBhbHdheXMgZmluZSBhbmQgc3VmZmljaWVudCBBRkFJQ1QsIG5vIG5lZWQgdG8g ZGlzYWJsZQppbmRpdmlkdWFsIGlycXMgZmlyc3QuIEknbSBub3QgZW50aXJlbHkgc3VyZSB3aGF0 IHRoZSBzZW1hbnRpY3Mgb2YgYSBwb2xsCm9yIHJlYWQgZnJvbSBib3RoIHBhcmVudCBhbmQgY2hp bGQgd291bGQgYmUuIEknbSBzbGlnaHRseSBpbmNsaW5lZCB0bwpvdXRsYXcgdXNlIGluIHRoZSBj aGlsZCBhdCB0aGUgbGlicmFyeSBBUEkgbGV2ZWwuIEEgc2xpZ2h0bHkgbGVzcyBkcmFjb25pYW4K cnVsZSB3b3VsZCBiZSBvbmUgb3IgdGhlIG90aGVyIG1heSBjb250aW51ZSB0byB1c2UgaXQsIGJ1 dCBuZXZlciBib3RoLgoKVGhhdCdzIGFsbCBiYXNlZCBvbiB0aGUgTGludXggaW1wbGVtZW50YXRp b24sIGJ1dCB0aGUgbGlicmFyaWVzIG5lZWQgdG8gYmUKTENEIGFuZCBzbyBmYXIgdGhhdCdzIHBy ZXR0eSBsb3cuLi4gSSBsb29rZWQgYXQgdGhlIEZyZWVCU0QgcHJpdmNtZCwgYW5kIGl0CmRpZG4n dCBzZWVtIHRvIGhhdmUgYW55IG9idmlvdXMgZXF1aXZhbGVudCB0byBWTUFfRE9OVENPUFksIGJ1 dCBJIG1pZ2h0IGJlCm1pc3Npbmcgc29tZXRoaW5nIChhbmQgaXQgZG9lc24ndCByZWFsbHkgbWF0 dGVyIGZvciB0aGUgbGlicmFyeSBBUEkgZ2l2ZW4KTGludXgpLgoKSWFuLgoKX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX18KWGVuLWRldmVsIG1haWxpbmcgbGlz dApYZW4tZGV2ZWxAbGlzdHMueGVuLm9yZwpodHRwOi8vbGlzdHMueGVuLm9yZy94ZW4tZGV2ZWwK