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: Fri, 4 Dec 2015 10:06:49 +0000 Message-ID: <1449223609.4424.166.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> <56608513.5090305@tycho.nsa.gov> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: In-Reply-To: <56608513.5090305@tycho.nsa.gov> List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Sender: xen-devel-bounces@lists.xen.org Errors-To: xen-devel-bounces@lists.xen.org To: Daniel De Graaf Cc: wei.liu2@citrix.com, ian.jackson@eu.citrix.com, xen-devel@lists.xen.org List-Id: xen-devel@lists.xenproject.org T24gVGh1LCAyMDE1LTEyLTAzIGF0IDEzOjA4IC0wNTAwLCBEYW5pZWwgRGUgR3JhYWYgd3JvdGU6 Cj4gT24gMDMvMTIvMTUgMDY6MjIsIElhbiBDYW1wYmVsbCB3cm90ZToKPiA+IEluIHBhcnRpY3Vs YXIgYXJvdW5kIGVycm9yIGhhbmRsaW5nLCBiZWhhdmlvdXIgb24gZm9yayBhbmQgdGhlIHVubWFw Cj4gPiBub3RpZmljYXRpb24gbWVjaGFuaXNtLgo+ID4gCj4gPiBCZWhhdmlvdXIgb2YgeGVuZ250 dGFiX21hcF8qZ3JhbnRfcmVmcyBhbmQgeGVuZ250c2hyX3NoYXJlX3BhZ2VzIG9uCj4gPiBwYXJ0 aWFsIGZhaWx1cmUgaGFzIGJlZW4gY29uZmlybWVkL2luZmVycmVkIChieSBpbnNwZWN0aW9uKSBv biBMaW51eAo+ID4gYW5kIE1pbmktb3MgKHRoZSBvbmx5IHR3byBrbm93biBpbXBsZW1lbnRhdGlv bnMuIExpa2V3aXNlIHRoZQo+ID4gYmVoYXZpb3VyIG9mIHRoZSBub3RpZmljYXRpb24gbWVjaGFu aXNtIGhhcyBiZWVuIGNvbmZpcm1lZC9pbmZlcnJlZAo+ID4gKGJ5IGluc3BlY3Rpb24pIG9mIHRo ZSBMaW51eCBpbXBsZW1lbnRhdGlvbiAoY3VycmVudGx5IHRoZSBvbmx5Cj4gPiBpbXBsZW1lbnRh dGlvbikgYW5kIGxpYnZjaGFuIChwcmltYXJ5IGtub3duIHVzZXIpLgo+ID4gCj4gPiBUaGVzZSB1 cGRhdGVzIGFyZSBub3QgZm9sZGVkIGludG8gInRvb2xzOiBSZWZhY3Rvcgo+ID4gL2Rldi94ZW4v Z250e2RldixzaHJ9IHdyYXBwZXJzIGludG8gbGlieGVuZ250dGFiLiIgdG8gdHJ5IGFuZCByZWR1 Y2UKPiA+IHRoZSBhbW91bnQgb2Ygbm9uLW1vdmVtZW50IGNoYW5nZXMgaW4gdGhhdCBwYXRjaC4K PiA+IAo+ID4gV2hpbGUgSSdtIG5vdCBjb252aW5jZWQgYnkgamF2YWRvYy9kb3h5Z2VuIGNhdXNl IHRoZSBleGlzdGluZyBjb21tZW50cwo+ID4gd2hpY2ggYXBwZWFyIHRvIHVzZSB0aGF0IHN5bnRh eCB0byBoYXZlIHRoZSBhcHByb3ByaWF0ZSAvKiogbWFya2VyLgo+ID4gCj4gPiBBbHNvIGZpeCBh IHR5cG8gaW4gYSBjb2RlIGNvbW1lbnQuCj4gPiAKPiA+IFNpZ25lZC1vZmYtYnk6IElhbiBDYW1w YmVsbCA8aWFuLmNhbXBiZWxsQGNpdHJpeC5jb20+Cj4gPiBDYzogRGFuaWVsIERlIEdyYWFmIDxk Z2RlZ3JhQHR5Y2hvLm5zYS5nb3Y+Cj4gPiAtLS0KPiA+IERhbmllbCwgeW91IGlucHV0IG9uIHRo ZSBkZXNjcmlwdGlvbiBvZiB0aGUgdW5tYXAgbm90aWZpY2F0aW9uIHN0dWZmCj4gPiB3b3VsZCBi ZSBtdWNoIGFwcHJlY2lhdGVkLgo+IAo+IFRoZSBkZXNjcmlwdGlvbiBsb29rcyBjb21wbGV0ZSBh bmQgY29ycmVjdCB0byBtZS7CoMKgVGhlIHN0YXRlbWVudCB0aGF0Cj4gdGhlIGludGVyZmFjZXMg b3BlcmF0ZSBvbiBhIHNpbmdsZSBwYWdlIG9ubHkgbWlnaHQgYmUgbWlzbGVhZGluZyAtIHRoZQo+ IGludGVyZmFjZSB3aWxsIHdvcmsgb24gbXVsdGktcGFnZSBtYXBwaW5ncywgYnV0IG9ubHkgYWxs b3dzIG9uZSBub3RpZnkKPiBvbiB0aGUgbWFwcGluZy7CoMKgSSdtIG5vdCBzdXJlIHRoaXMgZGlz dGluY3Rpb24gaXMgaW1wb3J0YW50IGZvciBtb3N0Cj4gdXNlcnMgb2YgdGhlIGludGVyZmFjZSwg c2luY2UgdGhlIG5vdGlmeSBpcyBhbG1vc3QgYWx3YXlzIHVzZWQgb24gYQo+IG9uZS1wYWdlIG1h cHBpbmcuCgpJIHRoaW5rIEkgY29uY2x1ZGVkIHRoYXQgaXQgd2FzIGEgc2luZ2xlIHBhZ2UgYmVj YXVzZSB0aGUgbGlicmFyeQppbnRlcmZhY2VzIHdoaWNoIGFsbG93IGEgbWFwcGluZyB0byBoYXZl IGEgbm90aWZ5IGF0dGFjaGVkIG9ubHkgdGFrZS9yZXR1cm4KYSBzaW5nbGUgZ3JlZjoKCnZvaWQg KnhlbmdudHRhYl9tYXBfZ3JhbnRfcmVmX25vdGlmeSh4ZW5nbnR0YWJfaGFuZGxlICp4Z3QsCsKg wqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDC oMKgwqDCoMKgwqDCoMKgdWludDMyX3QgZG9taWQsCsKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKg wqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgdWludDMyX3Qg cmVmLArCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKg wqDCoMKgwqDCoMKgwqDCoMKgwqDCoGludCBwcm90LArCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDC oMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoHVpbnQzMl90 IG5vdGlmeV9vZmZzZXQsCsKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDC oMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgZXZ0Y2huX3BvcnRfdCBub3RpZnlfcG9y dCk7CnZvaWQgKnhlbmdudHNocl9zaGFyZV9wYWdlX25vdGlmeSh4ZW5nbnRzaHJfaGFuZGxlICp4 Z3MsIHVpbnQzMl90IGRvbWlkLArCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDC oMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoHVpbnQzMl90ICpyZWYsIGludCB3cml0YWJs ZSwKwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKg wqDCoMKgwqDCoMKgwqB1aW50MzJfdCBub3RpZnlfb2Zmc2V0LArCoMKgwqDCoMKgwqDCoMKgwqDC oMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoMKgwqDCoGV2dGNobl9w b3J0X3Qgbm90aWZ5X3BvcnQpOwoKVGhlIG9mZnNldCBpbiB0aGUgdW5kZXJseWluZyBpb2N0bCBp biB0aGUgTGludXggaW1wbGVtZW50YXRpb24gaXMgYQp1aW50NjRfdCwgc28geW91IGFyZSByaWdo dCB0aGF0IGluIHByaW5jaXBhbCBpdCBjb3VsZCBzdXBwb3J0IGEgbGFyZ2VyCm9mZnNldC4KCkkg dGhpbmsgSSBhbSBpbmNsaW5lZCB0byB0aGVyZWZvcmUgbGVhdmUgdGhpbmdzIGFzIHRoZXkgYXJl LCB0aGUKYWx0ZXJuYXRpdmUgd291bGQgYmUgdG8gZXhwYW5kIHRob3NlIHR3byBmdW5jdGlvbnMg bm93IHRvIHN1cHBvcnQgbXVsdGktCmdyZWYgbWFwcGluZ3MuCgpJIHRoaW5rIGdpdmVuIHRoZSBj dXJyZW50IHNldCBvZiB1c2UgY2FzZXMgSSB3b3VsZCBwcmVmZXIgdG8gYWRkIG11bHRpcGFnZQp2 YXJpYW50cyBpbiB0aGUgZnV0dXJlIHNob3VsZCB0aGUgbmVlZCBhcmlzZS4KCkkgc3VwcG9zZSB0 aGUgYXJndW1lbnQgZm9yIG1ha2luZyB0aGUgY2hhbmdlIHJpZ2h0IG5vIHdvdWxkIGJlIHRoZQpw cmVkaWN0aW9uIG9mIGEgdXNlcnNwYWNlIG11bHRpcGFnZSByaW5nIGltcGxlbWVudGF0aW9uLgoK PiBSZXZpZXdlZC1ieTogRGFuaWVsIERlIEdyYWFmIDxkZ2RlZ3JhQHR5Y2hvLm5zYS5nb3Y+CgpU aGFua3MuCgo+IAo+ID4gQEAgLTcxLDYgKzE1NCwxMCBAQCB2b2lkICp4ZW5nbnR0YWJfbWFwX2dy YW50X3JlZih4ZW5nbnR0YWJfaGFuZGxlCj4gPiAqeGd0LAo+ID4gwqDCoMKgKiBjb250aWd1b3Vz IGxvY2FsIGFkZHJlc3MgcmFuZ2UuIE1hcHBpbmdzIHNob3VsZCBiZSB1bm1hcHBlZCB3aXRoCj4g PiDCoMKgwqAqIHhlbmdudHRhYl9tdW5tYXAuwqDCoExvZ3MgZXJyb3JzLgo+ID4gwqDCoMKgKgo+ ID4gKyAqIE9uIGZhaWx1cmUgc2V0cyBlcnJubyBhbmQgcmV0dXJucyBOVUxMLgo+ID4gKyAqCj4g PiArICogSWYgbm90aWZ5X29mZnNldCBvciBub3RpZnlfcG9ydCBhIHJlcXVlc3RlZCBhbmQgY2Fu bm90IGJlIHNldCB1cCBhbgo+ID4gKyAqIGVycm9yIHdpbGwgYmUgcmV0dXJuZWQgYW5kIG5vIG1h cHBpbmcgd2lsbCBiZSBtYWRlLgo+IAo+IFR5cG86ICJhIHJlcXVlc3RlZCIgPT4gImFyZSByZXF1 ZXN0ZWQiCgpZZXMsIHRoYW5rcy4KCgpfX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fXwpYZW4tZGV2ZWwgbWFpbGluZyBsaXN0Clhlbi1kZXZlbEBsaXN0cy54ZW4u b3JnCmh0dHA6Ly9saXN0cy54ZW4ub3JnL3hlbi1kZXZlbAo=