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 14:03:24 +0000 Message-ID: <1449669804.16124.250.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> <1449666034.16124.220.camel@citrix.com> <566831BE.4040809@citrix.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: In-Reply-To: <566831BE.4040809@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: Andrew Cooper , Wei Liu Cc: Daniel De Graaf , ian.jackson@eu.citrix.com, xen-devel@lists.xen.org List-Id: xen-devel@lists.xenproject.org T24gV2VkLCAyMDE1LTEyLTA5IGF0IDEzOjUwICswMDAwLCBBbmRyZXcgQ29vcGVyIHdyb3RlOgo+ IE9uIDA5LzEyLzE1IDEzOjAwLCBJYW4gQ2FtcGJlbGwgd3JvdGU6Cj4gPiBPbiBXZWQsIDIwMTUt MTItMDkgYXQgMTI6NDEgKzAwMDAsIFdlaSBMaXUgd3JvdGU6Cj4gPiA+ID4gKyAqLwo+ID4gPiA+ ICsKPiA+ID4gPiArLyoKPiA+ID4gPiDCoCAqIEdyYW50IFRhYmxlIEludGVyZmFjZSAobWFraW5n IHVzZSBvZiBncmFudHMgZnJvbSBvdGhlciBkb21haW5zKQo+ID4gPiA+IMKgICovCj4gPiA+ID4g wqAKPiA+ID4gPiDCoHR5cGVkZWYgc3RydWN0IHhlbmdudGRldl9oYW5kbGUgeGVuZ250dGFiX2hh bmRsZTsKPiA+ID4gPiDCoAo+ID4gPiA+IMKgLyoKPiA+ID4gPiAtICogTm90ZToKPiA+ID4gPiAt ICogQWZ0ZXIgZm9yayBhIGNoaWxkIHByb2Nlc3MgbXVzdCBub3QgdXNlIGFueSBvcGVuZWQgeGMg Z250dGFiCj4gPiA+ID4gLSAqIGhhbmRsZSBpbmhlcml0ZWQgZnJvbSB0aGVpciBwYXJlbnQuIFRo ZXkgbXVzdCBvcGVuIGEgbmV3IGhhbmRsZQo+ID4gPiA+IGlmCj4gPiA+ID4gLSAqIHRoZXkgd2Fu dCB0byBpbnRlcmFjdCB3aXRoIHhjLgo+ID4gPiA+ICsgKiBSZXR1cm5zIGEgaGFuZGxlIG9udG8g dGhlIGdyYW50IHRhYmxlIGRyaXZlci7CoMKgTG9ncyBlcnJvcnMuCj4gPiA+ID4gKyAqCj4gPiA+ ID4gKyAqIE5vdGU6IEFmdGVyIGZvcmsgYSBjaGlsZCBwcm9jZXNzIG11c3Qgbm90IHVzZSBhbnkg b3BlbmVkIGdudHRhYgo+ID4gPiA+ICsgKiBoYW5kbGUgaW5oZXJpdGVkIGZyb20gdGhlaXIgcGFy ZW50LCBtb3JlIGFjY2VzcyBhbnkgZ3JhbnQKPiA+ID4gPiBtYXBwZWQKPiA+ID4gPiArICogYXJl YXMgYXNzb2NpYXRlZCB3aXRoIHRoYXQgaGFuZGxlLgo+ID4gPiA+ICsgKgo+ID4gPiBBbmQgdGhp cyBjb3VsZCB1c2UgdGhlIHNhbWUgY2xvZXhlYyB0cmljayBhcyB5b3UgZG8gaW4gb3RoZXIgcGF0 Y2gKPiA+ID4gZm9yCj4gPiA+IHByaXZjbWQuCj4gPiBJIHRoaW5rIHRoaXMgc3RhdGVtZW50ICJk byBub3QgdXNlIHRoZSBoYW5kbGUiIHN0aWxsIHN0YW5kcyByZWdhcmRsZXNzCj4gPiBvZgo+ID4g dGhlIHVuZGVybHlpbmcgZmQgYmVpbmcgY2xvZXhlYydkLgo+ID4gCj4gPiBIb3dldmVyLCB0aGlz IGRpZCBtYWtlIG1lIHRoaW5rIGFib3V0IGEgY29tbWVudCBlbHNld2hlcmUsIHNwZWNpZmljYWxs eQo+ID4gdGhlCj4gPiB2YXJpb3VzIGluc3RhbmNlcyBvZjoKPiA+IMKgKiBUaGlzIGlzIHRoZSBv bmx5IGZ1bmN0aW9uIHdoaWNoIG1heSBiZSBzYWZlbHkgY2FsbGVkIG9uIGEKPiA+IMKgKiB4ZW48 Zm9vPl9oYW5kbGUgaW4gYSBjaGlsZCBhZnRlciBhIGZvcmsuCj4gPiBmb3Igc2V2ZXJhbCB4ZW48 Zm9vPl9jbG9zZSgpIGZ1bmN0aW9ucy4KPiA+IAo+ID4gVGhpcyBpcyBub3QgcmVhbGx5IHRydWUg aWYgdGhlIGZkIGlzIGNsb2V4ZWMsIHNpbmNlIHRoZW4gX2Nsb3NlKCkgd2lsbAo+ID4gZWl0aGVy IGZhaWwgKEVCQURGKSBvciwgd29yc2UsIGNsb3NlIHNvbWUgb3RoZXIgZnJlc2hseSBvcGVuZWQg ZmlsZQo+ID4gZGVzY3JpcHRvci4KPiA+IAo+ID4gVGhlcmUgc2VlbXMgdG8gYmUgdHdvIGNob2lj ZXMgaGVyZSwgZWl0aGVyIHJlcXVpcmUgYWxsIG9zZGVwIGJhY2tlbmRzCj4gPiB0bwo+ID4gbWFr ZSB0aGVpciBmZHMgT19DTE9FWEVDICh3aGljaCBtaWdodCBpbnZvbHZlIHRvbGVyYXRpbmcgYSBy YWN5Cj4gPiBmY250bCtGRF9DTE9FWEVDIHBhdHRlcm4gYWZ0ZXIgb3BlbiBvbiBzb21lIHBsYXRm b3Jtcykgb3IgZG9uJ3Qgc2V0Cj4gPiBPX0NMT0VYRUMgZXZlciBhbmQgZGVjbGFyZSB0aGF0IHRo ZSBhcHBsaWNhdGlvbiBpcyByZXNwb25zaWJsZSBmb3IKPiA+IGNsb3NpbmcKPiA+IGFmdGVyIGZv cmssIGFuZCBmb3IgdGFraW5nIGNhcmUgb2YgdGhlIGNvcm5lciBjYXNlcyB0aGVtc2VsdmVzIGlu Cj4gPiBtdWx0aXRocmVhZGVkIGFwcGxpY2F0aW9ucy4KPiA+IAo+ID4gVGhlIGZvcm1lciBzZWVt cyBmcmllbmRsaWVyIHRvIG1lLCBldmVuIGlmIHNvbWUgcGxhdGZvcm1zIG5lZWQgdG8gdXNlCj4g PiBGRF9DTE9FWEVDLgo+ID4gCj4gPiBIcm0sIG1heWJlIEkgY2FuIGV4dGVuZCB0aGUgYXRmb3Jr IHRyaWNrIHRvIGNvdmVyIHRoZSBvcGVuK2ZjbnRsIGJpdHMuCj4gPiBIb3BlZnVsbHkgdGhlcmUg aXMgbm8gaXNzdWUgd2l0aCB1c2luZyBwdGhyZWFkcyBmcm9tIGVhY2ggb2YgdGhlCj4gPiBhZmZl Y3RlZAo+ID4gbGlicmFyaWVzLgo+ID4gCj4gPiBTbywgSSB0aGluayB0aGUgYWR2aWNlIGluIHRo ZSBjb21tZW50IHdvdWxkIHRoZW4gYmU6Cj4gPiAKPiA+IMKgwqDCoMKgSWYgeW91IGZvcmsgYW5k IHRoZW4gZXhlYyB0aGVuIHlvdSBtdXN0IG5vdCAoYW5kIG5lZWQgbm90KSBjYWxsCj4gPiBfY2xv c2UoKQo+ID4gwqDCoMKgwqBvciBhbnkgb3RoZXIgZnVuY3Rpb24gb24gdGhlIGhhbmRsZS4KPiA+ IAo+ID4gwqDCoMKgwqBJZiB5b3UgZm9yayBidXQgZG8gbm90IGV4ZWMgdGhlbiBpdCBpcyBwZXJt aXNzaWJsZSB0byBjYWxsCj4gPiBfY2xvc2UoKSwgYnV0Cj4gPiDCoMKgwqDCoGl0IGlzIG5vdCBw ZXJtaXNzaWJsZSB0byBjYWxsIGFueSBvdGhlciBmdW5jdGlvbiBvbiB0aGUgaGFuZGxlLgo+ID4g Cj4gPiBOZWVkIHRvIHRoaW5rIGFib3V0IHRoYXQgd29yZGluZy4KPiAKPiBUaGlzIGlzIHJpc2t5 LsKgwqBXaGF0IGlmICRGT09fb3BlbigpIGFsbG9jYXRlZCBtb3JlIHJlc291cmNlIHRoYW4ganVz dAo+IHRoZSBDTE9FWEVDIGZkPwoKQW55IGFsbG9jYXRlZCBtZW1vcnkgKHRoZSBvdGhlciBtYWlu IGNsYXNzIG9mIHN1Y2ggcmVzb3VyY2UpIHdpbGwgYmUKYWJvbGlzaGVkIGJ5IGFuIGV4ZWMsIGhl bmNlIHRoZSBkaXN0aW5jdGlvbiBtYWRlIGFib3ZlIGJldHdlZW4gZm9yayBhbmQKZm9yaytleGVj LgoKV2hhdCBvdGhlciBzb3J0cyBvZiByZXNvdXJjZXMgYXJlIHlvdSB3b3JyaWVkIGFib3V0PwoK PiBBbiBfb3BlbigpIGNhbGwgbXVzdCBiZSBtYXRjaGVkIHdpdGggYSBfY2xvc2UoKSBjYWxsLgoK VGhpcyBpcyBub3Qgc2FmZSBhZnRlciBhbiBleGVjIHRob3VnaCwgc2luY2UgdGhlIGZkIHdpbGwg YmUgY2xvc2VkLCBvcgpwZXJoYXBzIGV2ZW4gcmVvcGVuZWQgYWxyZWFkeSAoYWx0aG91Z2ggdGhl IHJlcXVpcmVtZW50IGNvdWxkIGJlIHRvIGNhbGwKX2Nsb3NlIGJlZm9yZSBkb2luZyBzdWNoIHRo aW5ncyBhcyBvcGVuaW5nIGFueSBmZHMsIGF0IHdoaWNoIHBvaW50IGNsb3NlCmNvdWxkIHNpbGVu dGx5IGhhbmRsZSBFQkFERikuCgo+IEluIHRoZSBjYXNlIG9mIGZvcmsgYnV0IG5vIGV4ZWMsIHRo ZXJlIHNob3VsZCBiZSBhIF9jbG9zZSgpIGNhbGwgaW4gYm90aAo+IHRoZSBwYXJlbnQgYW5kIGNo aWxkLCB0byBmcmVlIG90aGVyIHJlc291cmNlcy4KCkluIHRoZSBwYXJlbnQgSSBhc3N1bWUgeW91 IG1lYW4gImF0IHNvbWUgcG9pbnQgKG9yIGNhbGwgZXhpdCgpKSIgcmF0aGVyCnRoYW4gaW4gc29t ZSB3YXkgYXNzb2NpYXRlZCB3aXRoIHRoZSBmb3JraW5nLCBiZWNhdXNlIHRoZSBwYXJlbnQgaXMK ZW50aXRsZWQgdG8ga2VlcCB1c2luZyB0aGUgaGFuZGxlLgoKSWFuLgoKX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX18KWGVuLWRldmVsIG1haWxpbmcgbGlzdApY ZW4tZGV2ZWxAbGlzdHMueGVuLm9yZwpodHRwOi8vbGlzdHMueGVuLm9yZy94ZW4tZGV2ZWwK