From mboxrd@z Thu Jan 1 00:00:00 1970 From: Konrad Rzeszutek Wilk Subject: Re: [PATCH 2 of 4 v3] blkif.h: Provide more complete documentation of the blkif interface Date: Tue, 21 Feb 2012 16:36:23 -0500 Message-ID: <20120221213623.GB28154@phenom.dumpdata.com> References: <20120221141041.GC11950@phenom.dumpdata.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Content-Disposition: inline In-Reply-To: List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Sender: xen-devel-bounces@lists.xen.org Errors-To: xen-devel-bounces@lists.xen.org To: "Justin T. Gibbs" Cc: xen-devel@lists.xensource.com, Keir Fraser List-Id: xen-devel@lists.xenproject.org T24gVHVlLCBGZWIgMjEsIDIwMTIgYXQgMDE6NTk6MTVQTSAtMDcwMCwgSnVzdGluIFQuIEdpYmJz IHdyb3RlOgo+IE9uIEZlYiAyMSwgMjAxMiwgYXQgNzoxMCBBTSwgS29ucmFkIFJ6ZXN6dXRlayBX aWxrIHdyb3RlOgo+IAo+ID4gT24gTW9uLCBGZWIgMjAsIDIwMTIgYXQgMTE6MDc6MjNBTSAtMDcw MCwgSnVzdGluIFQuIEdpYmJzIHdyb3RlOgo+ID4+ICBvIERvY3VtZW50IHRoZSBYZW5CdXMgbm9k ZXMgdXNlZCBpbiB0aGlzIHByb3RvY29sLgo+ID4+ICBvIEFkZCBhIHN0YXRlIGRpYWdyYW0gaWxs dXN0cmF0aW5nIHRoZSByb2xlcyBhbmQgcmVzcG9uc2liaWxpdGllcwo+ID4+ICAgIG9mIGJvdGgg dGhlIGZyb250IGFuZCBiYWNrZW5kIGR1cmluZyBzdGFydHVwLgo+ID4+ICBvIENvcnJlY3QgbWlz c2VkIEJMS0lGX09QX1RSSU0gPT4gQkxLSUZfT1BfRElTQ0FSRCBjb252ZXJzaW9uIGluIGEgY29t bWVudC4KPiA+PiAKPiA+PiBObyBmdW5jdGlvbmFsIGNoYW5nZXMuCj4gPiAKPiA+IFNvbWUgY29t bWVudHMgYmVsb3cuCj4gCj4g4oCmCj4gCj4gPj4gKyAqLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LSBCYWNrZW5kIERldmljZSBQcm9wZXJ0aWVzIC0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0KPiA+ PiArICoKPiA+PiArICogZGlzY2FyZC1hbGlnbWVudAo+ID4+ICsgKiAgICAgIFZhbHVlczogICAg ICAgICA8dWludDMyX3Q+Cj4gPj4gKyAqICAgICAgRGVmYXVsdCBWYWx1ZTogIDAKPiA+PiArICog ICAgICBOb3RlczogICAgICAgICAgMSwgMgo+ID4+ICsgKgo+ID4+ICsgKiAgICAgIFRoZSBvZmZz ZXQsIGluIGJ5dGVzIGZyb20gdGhlIGJlZ2lubmluZyBvZiB0aGUgdmlydHVhbCBibG9jayBkZXZp Y2UsCj4gPj4gKyAqICAgICAgdG8gdGhlIGZpcnN0LCBhZGRyZXNzYWJsZSwgZGlzY2FyZCBleHRl bnQgb24gdGhlIHVuZGVybHlpbmcgZGV2aWNlLgo+ID4gCj4gPiBZb3UgYXJlIGFsc28gbWlzc2lu ZyB0aGUgcmVzdCBvZiB0aGUgaW5mb3JtYXRpb24gYWJvdXQgaXQuIFBsZWFzZSBpbmNsdWRlIHRo ZQo+ID4gZGV0YWlscyB0aGF0IHRoZSBwcmV2aW91cyBjb21tZW50IGhhZC4KPiAKPiBUaGUgc3Ry YXRlZ3kgSSBoYXZlIGVtcGxveWVkIGluIGFsbCBvZiB0aGlzIGRvY3VtZW50YXRpb24gaXMgdG8K PiB0cmVhdCBibGtpZi5oIGFzIGEgZm9ybWFsIHNwZWMuICBUaGlzIG1lYW5zIHRoYXQgYmxraWYg bmVlZHMgdG8KCk9LLgo+IGRlc2NyaWJlIGhvdyBpdHMgdGVybWlub2xvZ3kgbWFwcyB0byBpbmR1 c3RyeSBzdGFuZGFyZHMgKGUuZy4gZGlzY2FyZAo+IG1lYW5zIHRyaW0vdW5tYXApIGFuZCBob3cg dGhlc2UgcmVxdWVzdHMgY2FuIGJlIGNvbW11bmljYXRlZCBiZXR3ZWVuCj4gZnJvbnQgYW5kIGJh Y2sgZHJpdmVyLiAgSXQgc2hvdWxkIG5vdCwgaW4gbXkgb3BpbmlvbiwgYXR0ZW1wdCB0bwo+IGRv Y3VtZW50IGluZm9ybWF0aW9uIHRoYXQgaXMgbWFuYWdlZCBpbiBvdGhlciBzcGVjcyAoZS5nLiBU MTAvVDEzKQo+IGFuZCBjb3VsZCBlYXNpbHkgYmVjb21lIHN0YWxlIGluIGJsa2lmLmguICBJdCBh bHNvIHNob3VsZCBhdm9pZAo+IHN0YXRpbmcgaW5mb3JtYXRpb24gdGhhdCBzb21lb25lIHJlYXNv bmFibHkgcHJvZmljaWVudCBpbiB3cml0aW5nCj4gKHN0b3JhZ2UpIGRldmljZSBkcml2ZXJzIGlz IGV4cGVjdGVkIHRvIGtub3cgKGUuZy4gZG9uJ3Qgc2F5IHlvdQo+IHN1cHBvcnQgc29tZXRoaW5n IHRoYXQgeW91IGRvbid0KS4KCkFuZCB0aGF0IGlzIHdoYXQgSSBoYXRlIGFib3V0IHNwZWNzLiBU aGV5IGRvbid0IHByb3ZpZGUgZW5vdWdoIGRldGFpbHMKb24gdGhlIGNvcm5lciBjYXNlcyBvciB3 aGF0IGFuIGltcGxlbnRhdGlvbiBjb3VsZCBsb29rIGxpa2UuCgo+IAo+IFdpdGggdGhhdCBpbiBt aW5kLCBJIGJlbGlldmUgdGhhdCBhbGwgb2YgdGhlIHJlcXVpcmVkIGluZm9ybWF0aW9uCj4gYWJv dXQgZGlzY2FyZCBpcyBzdGlsbCBwcmVzZW50IGluIGJsa2lmLmgsIGJ1dCBwZXJoYXBzIHByZXNl bnRlZAo+IGRpZmZlcmVudGx5IG9yIG1vdmVkIHRvIGRpZmZlcmVudCBzZWN0aW9ucy4gIENhbiB5 b3UgYmUgbW9yZQo+IHNwZWNpZmljIGFib3V0IHRoZSBpbmZvcm1hdGlvbiB0aGF0IHlvdSBmZWVs IGlzIG1pc3NpbmcgaGVyZSBhbmQKPiBpbiB0aGUgb3RoZXIgcGxhY2VzIHlvdSBub3RlZCBiZWxv dz8KClRoZSBvcmlnaW5hbCBzdGF0ZW1lbnQgYWJvdXQgaG93IHRoZSBiYWNrZW5kIHdvdWxkIGRl dGVybWluZSBob3cKdG8gZXhwb3NlIHRoaXMgaW5mb3JtYXRpb24uCgo+IAo+ID4+ICsgKgo+ID4+ ICsgKiBkaXNjYXJkLXNlY3VyZQo+ID4+ICsgKiAgICAgIFZhbHVlczogICAgICAgICAwLzEgKGJv b2xlYW4pCj4gPj4gKyAqICAgICAgRGVmYXVsdCBWYWx1ZTogIDAKPiA+PiArICoKPiA+PiArICog ICAgICBBIHZhbHVlIG9mICIxIiBpbmRpY2F0ZXMgdGhhdCB0aGUgYmFja2VuZCBjYW4gcHJvY2Vz cyBCTEtJRl9PUF9ESVNDQVJECj4gPj4gKyAqICAgICAgcmVxdWVzdHMgd2l0aCB0aGUgQkxLSUZf RElTQ0FSRF9TRUNVUkUgZmxhZyBzZXQuCj4gPiAKPiA+IAo+ID4gVGhhdCBpcyBub3QgdmVyeSBz cGVjaWZpYyB0byB3aGF0IHRoaXMgZG9lcy4gSXQganVzdCBzYXlzIFggd2lsbCBkbyBZLgo+IAo+ IERpZCB5b3UgbWVhbiwgIlRoYXQgaXMgbm90IHZlcnkgc3BlY2lmaWMgdG8gd2hhdCBCTEtJRl9E SVNDQVJEX1NFQ1VSRQo+IGRvZXMuIj8gIEJMS0lGX0RJU0NBUkRfU0VDVVJFIGlzIGRvY3VtZW50 ZWQgaW4gdGhlIGNvbW1lbnQgc2VjdGlvbgo+IGZvciBCTEtJRl9PUF9ESVNDQVJELiAgVGhlIHBl cnRpbmVudCB0ZXh0IGlzOiAiSWYgIHRoZSBCTEtJRl9ESVNDQVJEX1NFQ1VSRQo+IGZsYWcgaXMg c2V0IG9uIHRoZSByZXF1ZXN0LCBhbGwgY29waWVzIG9mIHRoZSBkaXNjYXJkZWQgcmVnaW9uIG9u Cj4gdGhlIGRldmljZSBtdXN0IGJlIHJlbmRlcmVkIHVucmVjb3ZlcmFibGUgYmVmb3JlIHRoZSBj b21tYW5kIHJldHVybnMuIgo+IElzIHRoZXJlIGEgY29tcGVsbGluZyByZWFzb24gdG8gZG9jdW1l bnQgaXQgaGVyZSBpbnN0ZWFkPwoKSSBqdXN0IHRoaW5rIHRoYXQgaGF2aW5nIG1vcmUgaW5mb3Jt YXRpb24gKGV2ZW4gZHVwbGljYXRlKSBpcwpiZXR0ZXIuIEJ1dCB0aGF0IGhhcyB0aGUgZGlzYWR2 YW50YWdlIHRoYXQgaXQgY2FuIGdldCBvdXQgb2Ygc3luYy4KCj4gCj4gVGhlIGNvbW1lbnQgYmxv Y2sgaGVyZSBtaXJyb3JzIHRoZSBsYW5ndWFnZSBvZiBhbGwgdGhlIG90aGVyIGZlYXR1cmUKPiBm bGFncy4gIERvIHlvdSBiZWxpZXZlIHRoZXkgc2hvdWxkIGJlIGNoYW5nZWQgaW4gc29tZSB3YXkg dG9vPwoKV2VsbCwgdGhlIGRlc2lyZSAobWluZSkgaXMgdG8gaW5jbHVkZSBhcyBtdWNoIGRldGFp bHMgKG9yIGV2ZW4gbW9yZSkgaW4gdGhlCnNwZWMgc28gdGhhdCBpdCBjYW4gYmUgcmVhZCBhcyBh IG5vdmVsIGlmIGRlc2lyZWQuCgpCdXQgSSB3aWxsIGRlZmVyIHRvIElhbiAtIGlmIGhlIGlzIE9L IHRoZW4gdGhpcyBzaG91bGRuJ3QgZ2F0ZQp0aGUgYWNjZXB0YW5jZSBvZiB0aGlzIHBhdGNoIHdo aWNoIGlzIGEgc3RlcCBmb3J3YXJkLgoKLi4gc25pcC4uCj4gPj4gKyAqIGNvbW1hbmQgb24gYSBu YXRpdmUgZGV2aWNlLgo+ID4gCj4gPiBBbmQgeW91IG1pZ2h0IHdhbnQgdG8gbWVudGlvbiB3aGF0 IHRoZSBwcmV2aW91cyBjb21tZW50IGRpZCAtIHRoYXQgdGhpcyBpcwo+ID4gYSBoaW50IHRvIHRo ZSBiYWNrZW5kLgo+IAo+IFRoZSBwcm9wb3NlZCB0ZXh0IGFscmVhZHkgZG9lcyB0aGlzOgo+IAo+ ICAgICAiSW5kaWNhdGUgdG8gdGhlIGJhY2tlbmQgZGV2aWNlIHRoYXQgYSByZWdpb24gb2Ygc3Rv cmFnZSBpcyBubwo+ICAgICAgbG9uZ2VyIGluIHVzZSwgYW5kIG1heSBiZSBkaXNjYXJkZWQgYXQg YW55IHRpbWUgd2l0aG91dCBpbXBhY3QKPiAgICAgIHRvIHRoZSBjbGllbnQuIgo+IAo+IElmIHRo ZSBiYWNrZW5kIHdhcyByZXF1aXJlZCB0byBkaXNjYXJkIHRoZSByZWdpb24sIEkgd291bGQgaGF2 ZQo+IHVzZWQgInNoYWxsIiBvciAibXVzdCIsIG5vdCAibWF5Ii4gIFRoaXMgaXMgdGhlIHR5cGlj YWwgbGFuZ3VhZ2UKPiBjb252ZW50aW9uIG9mIHN0YW5kYXJkcyBkb2N1bWVudHMuCgpGYWlyIGVu b3VnaC4KCj4gCj4gLS0KPiBKdXN0aW4KCl9fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fClhlbi1kZXZlbCBtYWlsaW5nIGxpc3QKWGVuLWRldmVsQGxpc3RzLnhl bi5vcmcKaHR0cDovL2xpc3RzLnhlbi5vcmcveGVuLWRldmVsCg==