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, 11 Dec 2015 17:14:06 +0000 Message-ID: <1449854046.30975.78.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> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: In-Reply-To: <1449680885.9759.34.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 , wei.liu2@citrix.com, xen-devel@lists.xen.org List-Id: xen-devel@lists.xenproject.org T24gV2VkLCAyMDE1LTEyLTA5IGF0IDE3OjA4ICswMDAwLCBJYW4gQ2FtcGJlbGwgd3JvdGU6Cj4g T24gV2VkLCAyMDE1LTEyLTA5IGF0IDE2OjI4ICswMDAwLCBJYW4gSmFja3NvbiB3cm90ZToKPiA+ IElhbiBDYW1wYmVsbCB3cml0ZXMgKCJSZTogW1BBVENIIFhFTiB2NiAyNS8zMl0gdG9vbHMvbGli cy9nbnR0YWI6Cj4gPiBFeHRlbnNpdmUgdXBkYXRlcyB0byBBUEkgZG9jdW1lbnRhdGlvbi4iKToK PiA+ID4gT24gV2VkLCAyMDE1LTEyLTA5IGF0IDE2OjA5ICswMDAwLCBJYW4gSmFja3NvbiB3cm90 ZToKPiA+ID4gPiBJcyB0aGlzIGFjdHVhbGx5IHRydWUgP8KgwqBOb3JtYWxseSBjbG9zZSgpIG9u IGFuIGZkIGRvZXMgbm90IG11bm1hcAo+ID4gPiA+IGFueXRoaW5nIG1tYXBwZWQgZnJvbSB0aGUg ZmQuCj4gPiA+IAo+ID4gPiBVaCB5ZXMsIEkgd2FzIHRhbGtpbmcgcnViYmlzaCBoZXJlLCB1bmxl c3MgdGhlIGRyaXZlcnMgYXJlIG1vcmUgbWFnaWMKPiA+ID4gdGhhbgo+ID4gPiBJIHRoaW5rIHRo ZXkgYXJlLgo+ID4gPiAKPiA+ID4gU28gd2hhdCBpcyB0aGUgYW5zd2VyPyBUaGF0IHN1Y2ggbWVt b3J5IGlzIHdhc3RlZCBhbmQgaXJyZWNvdmFibGUKPiA+ID4gdW50aWwKPiA+ID4gZXhlYz8KPiA+ IAo+ID4gSSBkb24ndCBrbm93LsKgwqBXaGF0IHdvdWxkIGhhcHBlbiBpZiB5b3UgbXVubWFwcGVk IGl0ID8KPiAKPiBXZSBkaXNjdXNzZWQgYWxsIHRoaXMgSVJMIGFuZCBjb25jbHVkZWQgYWZ0ZXIg bXVjaCBiYWNrIGFuZCBmb3J0aCB0aGF0Cj4gdGhlcmUgaXMgbm90aGluZyB3ZSBjYW4gZG8gaGVy ZSBvdGhlciB0aGFuIHJlcXVpcmUgYSBjYWxsIHRvIGVhY2ggcmVsZXZhbnQKPiBsaWJyYXJ5J3Mg X2Nsb3NlKCkgbWV0aG9kIGJ5IGNhbGxlcnMgb2YgZm9yaygpIHdobyBkbyBub3QgZXhlYyBidXQg d2hvIGNhcmUKPiBhYm91dCB0aGUgKHVzdWFsbHkgbW9kZXN0KSByZXNvdXJjZXMgY29uc3VtZWQg YnkgdGhlc2Ugc29ydHMgb2YgbWFwcGluZ3MuCj4gCj4gVGhlIF9jbG9zZSBjYWxsIGFmdGVyIGZv cmsgc2hvdWxkIGJlIGRvY3VtZW50ZWQgYXMgcG90ZW50aWFsbHkgbm90IGFjdHVhbGx5Cj4gYWNo aWV2aW5nIGFueXRoaW5nIGFuZCB3ZSBkZWNpZGVkIHRvIHRyZWF0IHRoaXMgYXMgYSBmdXR1cmUg YnVnIGlmL3doZW4gaXQKPiBoYXMgYSByZWFsIHdvcmxkIGltcGFjdCBieSBmaXhpbmcuCgpIZXJl IGlzIHdoYXQgSSBjYW0gdXAgd2l0aC4KCi8qCsKgKiBSZXR1cm5zIGEgaGFuZGxlIG9udG8gdGhl IGdyYW50IHRhYmxlIGRyaXZlci7CoMKgTG9ncyBlcnJvcnMuCsKgKgrCoCogTm90ZTogQWZ0ZXIg Zm9yaygyKSBhIGNoaWxkIHByb2Nlc3MgbXVzdCBub3QgdXNlIGFueSBvcGVuZWQgZ250dGFiCsKg KiBoYW5kbGUgaW5oZXJpdGVkIGZyb20gdGhlaXIgcGFyZW50LCBub3IgYWNjZXNzIGFueSBncmFu dCBtYXBwZWQKwqAqIGFyZWFzIGFzc29jaWF0ZWQgd2l0aCB0aGF0IGhhbmRsZS4KwqAqCsKgKiBU aGUgY2hpbGQgbXVzdCBvcGVuIGEgbmV3IGhhbmRsZSBpZiB0aGV5IHdhbnQgdG8gaW50ZXJhY3Qg d2l0aArCoCogZ250dGFiLgrCoCoKwqAqIENhbGxpbmcgZXhlYygyKSBpbiBhIGNoaWxkIHdpbGwg c2FmZWx5IChhbmQgcmVsaWFibHkpIHJlY2xhaW0gYW55CsKgKiBhbGxvY2F0ZWQgcmVzb3VyY2Vz IHZpYSBhIHhlbmdudHRhYl9oYW5kbGUgaW4gdGhlIHBhcmVudC4KwqAqCsKgKiBBIGNoaWxkIHdo aWNoIGRvZXMgbm90IGNhbGwgZXhlYygyKSBtYXkgc2FmZWx5IGNhbGwKwqAqIHhlbmdudHRhYl9j bG9zZSgpIG9uIGEgeGVuZ250dGFiX2hhbmRsZSBpbmhlcml0ZWQgZnJvbSB0aGVpcgrCoCogcGFy ZW50LiBUaGlzIHdpbGwgYXR0ZW1wdCB0byByZWNsYWltIGFueSByZXNvdXJjZXMgYXNzb2NpYXRl ZCB3aXRoCsKgKiB0aGF0IGhhbmRsZS4gTm90ZSB0aGF0IGluIHNvbWUgaW1wbGVtZW50YXRpb25z IHRoaXMgcmVjbGFtYXRpb24gbWF5CsKgKiBub3QgYmUgY29tcGxldGVseSBlZmZlY3RpdmUsIGlu IHRoaXMgY2FzZSBhbnkgYWZmZWN0ZWQgcmVzb3VyY2VzCsKgKiByZW1haW4gYWxsb2NhdGVkLgrC oCoKwqAqIENhbGxpbmcgeGVuZ250dGFiX2Nsb3NlKCkgaXMgdGhlIG9ubHkgc2FmZSBvcGVyYXRp b24gb24gYQrCoCogeGVuZ250dGFiX2hhbmRsZSB3aGljaCBoYXMgYmVlbiBpbmhlcml0ZWQuCsKg Ki8KCkknbSBjdXJyZW50bHkgaW50ZW5kaW5nIHRvIHdyaXRlIHNvbWV0aGluZyB2ZXJ5IHNpbWls YXIgZm9yIGVhY2ggb2YgdGhlCnhlbipfb3BlbiAoZ250c2hyLCBnbnR0YWIsIGZvcmVpZ25tZW1v cnksIGV2dGNobiBhbmQgcHJvYmFibHkgY2FsbCB0b28pCmZ1bmN0aW9ucy4gSSBkb24ndCByZWFs bHkgbGlrZSByZXBlYXRpbmcgdGhlIHNhbWUgdGhpbmcgbGlrZSB0aGlzLCBidXQgSQphbHNvIGRv bid0IHJlYWxseSBsaWtlIEFQSSBkb2N1bWVudGF0aW9uIHdoaWNoIG1ha2VzIHlvdSBwbGF5IGZv bGxvdyB0aGUKcGllY2Ugb2Ygc3RyaW5nIHRvIHRoZSBkb2NzIG9mIG90aGVyIGxpYnJhcmllcyB0 byBmaW5kIG91dCB3aGF0IGlzIGdvaW5nCm9uLgoKSSdtIGFsc28gY29uc2lkZXJpbmcgd2hldGhl ciBvbiB0aGUgX2Nsb3NlIGZ1bmN0aW9uIEkgc2hvdWxkIHdyaXRlCnNvbWV0aGluZyB0byB0aGUg ZWZmZWN0IHRoYXQgaW4gbm9uLWZvcmtlZCBjb250ZXh0cyB0aGUgYXBwbGljYXRpb24gc2hvdWxk CmNhbGwgdGhlIGFzc29jaWF0ZWQgX3VubWFwKCkgb24gYW55IGFjdGl2ZSBtYXBwaW5ncyBiZWZv cmUgY2FsbGluZyBfY2xvc2UoKQppbiBvcmRlciB0byBlbnN1cmUgYWxsIHJlc291cmNlcyBoYXZl IGJlZW4gZnJlZWQuIEFuZCByZWl0ZXJhdGUgdGhhdApjYWxsaW5nIF91bm1hcCBhZnRlciBmb3Jr KCkgaXMgbm90IHNhZmUuCgpJYW4uCgpfX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fXwpYZW4tZGV2ZWwgbWFpbGluZyBsaXN0Clhlbi1kZXZlbEBsaXN0cy54ZW4u b3JnCmh0dHA6Ly9saXN0cy54ZW4ub3JnL3hlbi1kZXZlbAo=