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: Wed, 9 Dec 2015 13:00:34 +0000 Message-ID: <1449666034.16124.220.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> <20151209124112.GM23818@citrix.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: In-Reply-To: <20151209124112.GM23818@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: Wei Liu Cc: Daniel De Graaf , ian.jackson@eu.citrix.com, xen-devel@lists.xen.org List-Id: xen-devel@lists.xenproject.org T24gV2VkLCAyMDE1LTEyLTA5IGF0IDEyOjQxICswMDAwLCBXZWkgTGl1IHdyb3RlOgo+ID4gKyAq Lwo+ID4gKwo+ID4gKy8qCj4gPiDCoCAqIEdyYW50IFRhYmxlIEludGVyZmFjZSAobWFraW5nIHVz ZSBvZiBncmFudHMgZnJvbSBvdGhlciBkb21haW5zKQo+ID4gwqAgKi8KPiA+IMKgCj4gPiDCoHR5 cGVkZWYgc3RydWN0IHhlbmdudGRldl9oYW5kbGUgeGVuZ250dGFiX2hhbmRsZTsKPiA+IMKgCj4g PiDCoC8qCj4gPiAtICogTm90ZToKPiA+IC0gKiBBZnRlciBmb3JrIGEgY2hpbGQgcHJvY2VzcyBt dXN0IG5vdCB1c2UgYW55IG9wZW5lZCB4YyBnbnR0YWIKPiA+IC0gKiBoYW5kbGUgaW5oZXJpdGVk IGZyb20gdGhlaXIgcGFyZW50LiBUaGV5IG11c3Qgb3BlbiBhIG5ldyBoYW5kbGUgaWYKPiA+IC0g KiB0aGV5IHdhbnQgdG8gaW50ZXJhY3Qgd2l0aCB4Yy4KPiA+ICsgKiBSZXR1cm5zIGEgaGFuZGxl IG9udG8gdGhlIGdyYW50IHRhYmxlIGRyaXZlci7CoMKgTG9ncyBlcnJvcnMuCj4gPiArICoKPiA+ ICsgKiBOb3RlOiBBZnRlciBmb3JrIGEgY2hpbGQgcHJvY2VzcyBtdXN0IG5vdCB1c2UgYW55IG9w ZW5lZCBnbnR0YWIKPiA+ICsgKiBoYW5kbGUgaW5oZXJpdGVkIGZyb20gdGhlaXIgcGFyZW50LCBt b3JlIGFjY2VzcyBhbnkgZ3JhbnQgbWFwcGVkCj4gPiArICogYXJlYXMgYXNzb2NpYXRlZCB3aXRo IHRoYXQgaGFuZGxlLgo+ID4gKyAqCj4gCj4gQW5kIHRoaXMgY291bGQgdXNlIHRoZSBzYW1lIGNs b2V4ZWMgdHJpY2sgYXMgeW91IGRvIGluIG90aGVyIHBhdGNoIGZvcgo+IHByaXZjbWQuCgpJIHRo aW5rIHRoaXMgc3RhdGVtZW50ICJkbyBub3QgdXNlIHRoZSBoYW5kbGUiIHN0aWxsIHN0YW5kcyBy ZWdhcmRsZXNzIG9mCnRoZSB1bmRlcmx5aW5nIGZkIGJlaW5nIGNsb2V4ZWMnZC4KCkhvd2V2ZXIs IHRoaXMgZGlkIG1ha2UgbWUgdGhpbmsgYWJvdXQgYSBjb21tZW50IGVsc2V3aGVyZSwgc3BlY2lm aWNhbGx5IHRoZQp2YXJpb3VzIGluc3RhbmNlcyBvZjoKwqAqIFRoaXMgaXMgdGhlIG9ubHkgZnVu Y3Rpb24gd2hpY2ggbWF5IGJlIHNhZmVseSBjYWxsZWQgb24gYQrCoCogeGVuPGZvbz5faGFuZGxl IGluIGEgY2hpbGQgYWZ0ZXIgYSBmb3JrLgpmb3Igc2V2ZXJhbCB4ZW48Zm9vPl9jbG9zZSgpIGZ1 bmN0aW9ucy4KClRoaXMgaXMgbm90IHJlYWxseSB0cnVlIGlmIHRoZSBmZCBpcyBjbG9leGVjLCBz aW5jZSB0aGVuIF9jbG9zZSgpIHdpbGwKZWl0aGVyIGZhaWwgKEVCQURGKSBvciwgd29yc2UsIGNs b3NlIHNvbWUgb3RoZXIgZnJlc2hseSBvcGVuZWQgZmlsZQpkZXNjcmlwdG9yLgoKVGhlcmUgc2Vl bXMgdG8gYmUgdHdvIGNob2ljZXMgaGVyZSwgZWl0aGVyIHJlcXVpcmUgYWxsIG9zZGVwIGJhY2tl bmRzIHRvCm1ha2UgdGhlaXIgZmRzIE9fQ0xPRVhFQyAod2hpY2ggbWlnaHQgaW52b2x2ZSB0b2xl cmF0aW5nIGEgcmFjeQpmY250bCtGRF9DTE9FWEVDIHBhdHRlcm4gYWZ0ZXIgb3BlbiBvbiBzb21l IHBsYXRmb3Jtcykgb3IgZG9uJ3Qgc2V0Ck9fQ0xPRVhFQyBldmVyIGFuZCBkZWNsYXJlIHRoYXQg dGhlIGFwcGxpY2F0aW9uIGlzIHJlc3BvbnNpYmxlIGZvciBjbG9zaW5nCmFmdGVyIGZvcmssIGFu ZCBmb3IgdGFraW5nIGNhcmUgb2YgdGhlIGNvcm5lciBjYXNlcyB0aGVtc2VsdmVzIGluCm11bHRp dGhyZWFkZWQgYXBwbGljYXRpb25zLgoKVGhlIGZvcm1lciBzZWVtcyBmcmllbmRsaWVyIHRvIG1l LCBldmVuIGlmIHNvbWUgcGxhdGZvcm1zIG5lZWQgdG8gdXNlCkZEX0NMT0VYRUMuCgpIcm0sIG1h eWJlIEkgY2FuIGV4dGVuZCB0aGUgYXRmb3JrIHRyaWNrIHRvIGNvdmVyIHRoZSBvcGVuK2ZjbnRs IGJpdHMuCkhvcGVmdWxseSB0aGVyZSBpcyBubyBpc3N1ZSB3aXRoIHVzaW5nIHB0aHJlYWRzIGZy b20gZWFjaCBvZiB0aGUgYWZmZWN0ZWQKbGlicmFyaWVzLgoKU28sIEkgdGhpbmsgdGhlIGFkdmlj ZSBpbiB0aGUgY29tbWVudCB3b3VsZCB0aGVuIGJlOgoKICAgIElmIHlvdSBmb3JrIGFuZCB0aGVu IGV4ZWMgdGhlbiB5b3UgbXVzdCBub3QgKGFuZCBuZWVkIG5vdCkgY2FsbCBfY2xvc2UoKQogICAg b3IgYW55IG90aGVyIGZ1bmN0aW9uIG9uIHRoZSBoYW5kbGUuCgogICAgSWYgeW91IGZvcmsgYnV0 IGRvIG5vdCBleGVjIHRoZW4gaXQgaXMgcGVybWlzc2libGUgdG8gY2FsbCBfY2xvc2UoKSwgYnV0 CiAgICBpdCBpcyBub3QgcGVybWlzc2libGUgdG8gY2FsbCBhbnkgb3RoZXIgZnVuY3Rpb24gb24g dGhlIGhhbmRsZS4KCk5lZWQgdG8gdGhpbmsgYWJvdXQgdGhhdCB3b3JkaW5nLgoKSWFuLgoKX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX18KWGVuLWRldmVsIG1h aWxpbmcgbGlzdApYZW4tZGV2ZWxAbGlzdHMueGVuLm9yZwpodHRwOi8vbGlzdHMueGVuLm9yZy94 ZW4tZGV2ZWwK