From mboxrd@z Thu Jan 1 00:00:00 1970 From: Bob Liu Subject: Re: [RFC PATCH] blkif.h: document scsi/0x12/0x83 node Date: Wed, 16 Mar 2016 21:59:02 +0800 Message-ID: <56E966A6.5070902@oracle.com> References: <1458097745-554-1-git-send-email-bob.liu@oracle.com> <22249.21297.924145.426969@mariner.uk.xensource.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: In-Reply-To: <22249.21297.924145.426969@mariner.uk.xensource.com> List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Errors-To: xen-devel-bounces@lists.xen.org Sender: "Xen-devel" To: Ian Jackson Cc: jgross@suse.com, xen-devel@lists.xen.org, annie.li@oracle.com, Paul.Durrant@citrix.com, roger.pau@citrix.com List-Id: xen-devel@lists.xenproject.org Ck9uIDAzLzE2LzIwMTYgMDg6MzYgUE0sIElhbiBKYWNrc29uIHdyb3RlOgo+IEJvYiBMaXUgd3Jp dGVzICgiW1JGQyBQQVRDSF0gYmxraWYuaDogZG9jdW1lbnQgc2NzaS8weDEyLzB4ODMgbm9kZSIp Ogo+PiBTb21ldGltZXMsIHdlIG5lZWQgdG8gcXVlcnkgVlBEIHBhZ2U9MHg4MyBkYXRhIGZyb20g dW5kZXJseWluZwo+PiBzdG9yYWdlIHNvIHRoYXQgdmVuZG9yIHN1cHBsaWVkIHNvZnR3YXJlIGNh biBydW4gaW5zaWRlIHRoZSBWTSBhbmQKPj4gYmVsaWV2ZSBpdCdzIHRhbGtpbmcgdG8gdGhlIHZl bmRvcidzIG93biBzdG9yYWdlLiAgQnV0IGRpZmZlcmVudAo+PiB2ZW5kb3JzIG1heSBoYXZlIGRp ZmZlcmVudCBzcGVjaWFsIGZlYXR1cmVzLCBzbyBpdCdzIG5vdCBzdWl0YWJsZSB0bwo+PiBleHBv cnQgdGhyb3VnaCAiZmVhdHVyZS14eHh4Ii4KPj4KPj4gT25lIHNvbHV0aW9uIGlzIHF1ZXJ5IHRo ZSB3aG9sZSBWUEQgcGFnZSB0aHJvdWdoIFhlbnN0b3JlIG5vZGUsIHdoaWNoIGhhcwo+PiBhbHJl YWR5IGJlZW4gdXNlZCBieSB3aW5kb3dzIHB2IGRyaXZlci4KPj4gaHR0cDovL3hlbmJpdHMueGVu Lm9yZy9naXR3ZWIvP3A9cHZkcml2ZXJzL3dpbi94ZW52YmQuZ2l0O2E9YmxvYjtmPXNyYy94ZW52 YmQvcGRvaW5xdWlyeS5jCj4gCj4gVGhhbmtzIGZvciB5b3VyIGNvbnRyaWJ1dGlvbi4KPiAKPiBU aGFua3MgYWxzbyB0byBLb25yYWQgZm9yIGRlY29kaW5nIHRoZSBudW1iZXJzLCB3aGljaCByZWFs bHkgaGVscHMgbWUKPiB1bmRlcnN0YW5kIHdoYXQgaXMgZ29pbmcgb24gaGVyZSBhbmQgaGVscGVk IG1lIGZpbmQgdGhlIHJlbGV2YW50Cj4gcmVmZXJlbmNlcy4KPiAKPiAoRm9yIGJhY2tncm91bmQ6 IEkgaGF2ZSBqdXN0IGRvdWJsZS1jaGVja2VkIHRoZSBTQ1NJIHNwZWMgYW5kOiBJTlFVSVJZCj4g bGV0cyB5b3UgcXVlcnkgZWl0aGVyIHRoZSBzdGFuZGFyZCBwYWdlLCBvciBvbmUgb2YgYSBudW1i ZXIgb2YgYHZpdGFsCj4gcHJvZHVjdCBkYXRhJyBwYWdlcywgZWFjaCBpZGVudGlmaWVkIGJ5IGFu IDgtYml0IHBhZ2UgbnVtYmVyLiAgVGhlIFZQRAo+IHBhZ2VzIGFyZSBtb3N0bHkgZnVsbCBvZiB2 ZW5kb3Itc3BlY2lmaWMgZGF0YSBpbiB2ZW5kb3Itc3BlY2lmaWMKPiBmb3JtYXQuKQo+IAo+IEkg aGF2ZSBzb21lIHF1YWxtcyBhYm91dCB0aGUgYXBwcm9hY2ggeW91IGhhdmUgYWRvcHRlZC4gIEl0 IGlzCj4gZGlmZmljdWx0IHRvIHNlZSBob3cgdGhpcyBmZWF0dXJlIGNvdWxkIGJlIHVzZWQgc2Fm ZWx5IHdpdGhvdXQKPiBrbm93bGVkZ2Ugc3BlY2lmaWMgdG8gdGhlIHN0b3JhZ2UgdmVuZG9yLgo+ IAo+IEJ1dCBJIHRoaW5rIGl0IGlzIHByb2JhYmx5IE9LIHRvIGRlZmluZSBhIHNwZWNpZmljYXRp b24gYWxvbmcgdGhlc2UKPiBsaW5lcyBwcm92aWRlZCB0aGF0IGl0IGlzIHZlcnkgY2xlYXIgdGhh dCBpZiB5b3UgYXJlbid0IHRoZSBzdG9yYWdlCj4gdmVuZG9yIGFuZCB5b3UgdXNlIHRoaXMgYW5k IHNvbWV0aGluZyBicmVha3MsIHlvdSBnZXQgdG8ga2VlcCBhbGwgdGhlCj4gcGllY2VzLgo+IAo+ PiArICogc2NzaS8weDEyLzB4ODMKPj4gKyAqIAlWYWx1ZXM6CXN0cmluZwo+PiArICogCUEgYmFz ZTY0IGZvcm1hdHRlZCBzdHJpbmcgcHJvdmlkaW5nIFZQRCBwYWdlcyByZWFkIG91dCBmcm9tIGJh Y2tlbmQKPj4gKyAqIAlkZXZpY2UuCj4gCj4gSSB0aGluayB0aGlzIHByb2JhYmx5IGlzbid0IHRo ZSBwcmV0dGllc3QgbmFtZSBmb3IgdGhpcyBub2RlIG9yCj4gbmVjZXNzYXJpbHkgdGhlIGJlc3Qg Zm9ybWF0IGJ1dCBnaXZlbiB0aGF0IHRoaXMgcHJvdG9jb2wgaXMgYWxyZWFkeQo+IGRlcGxveWVk LCBhbmQgdGhpcyBzeW50YXggd2lsbCBkbywgSSBkb24ndCB3YW50IHRvIHF1aWJibGUuCj4gCj4g SSB3b3VsZCBsaWtlIHRoZSBiYXNlNjQgZW5jb2RpbmcgdG8gc3BlY2lmaWVkIG11Y2ggbW9yZSBl eHBsaWNpdGx5Lgo+IEp1c3QgYGJhc2U2NCBmb3JtYXR0ZWQnIGlzIHRvbyB2YWd1ZS4KPiAKPiAK Pj4gKyAqIAlUaGUgYmFja2VuZCBkcml2ZXIgb3IgdGhlIHRvb2xzdGFjayBzaG91bGQgd3JpdGUg dGhpcyBub2RlIHdpdGggVlBECj4+ICsgKiAJaW5mb3JtYXRpb25zIHdoZW4gYXR0YWNoaW5nIGRl dmljZXMuCj4gCj4gSSB0aGluayB0aGlzIGlzIHRoZSB3cm9uZyBzZW1hbnRpY3MuICBJIGNlcnRh aW5seSBkb24ndCB3YW50IHRvCj4gZW5jb3VyYWdlIGJhY2tlbmRzIHRvIHVzZSB0aGlzIGZlYXR1 cmUuCj4gCj4gUmF0aGVyLCBJIHdvdWxkIHByZWZlciBzb21ldGhpbmcgbGlrZSB0aGlzOgo+IAo+ ICAqIHNjc2kvMHgxMi8weDxOTj4KPiAKPiAgICBUaGlzIG9wdGlvbmFsIG5vZGUgY29udGFpbnMg U0NTSSBJTlFVSVJZIFZQRCBpbmZvcm1hdGlvbi4KPiAgICA8Tk4+IGlzIHRoZSBoZXhhZGVjaW1h bCByZXByZXNlbnRhdGlvbiBvZiB0aGUgVlBEIHBhZ2UgY29kZS4KPiAKPiAgICBBIGZyb250ZW5k IHdoaWNoIHJlcHJlc2VudHMgYSBYZW4gVkJEIHRvIGl0cyBjb250YWluaW5nIG9wZXJhdGluZwo+ ICAgIHN5c3RlbSBhcyBhICh2aXJ0dWFsKSBTQ1NJIHRhcmdldCBtYXkgcmV0dXJuIHRoZSBzcGVj aWZpZWQgZGF0YSBpbgo+ICAgIHJlc3BvbnNlIHRvIElOUVVJUlkgY29tbWFuZHMgZnJvbSBpdHMg Y29udGFpbmluZyBPUy4KPiAKPiAgICBBIGZyb250ZW5kIHdoaWNoIHN1cHBvcnRzIHRoaXMgZmVh dHVyZSBtdXN0IHJldHVybiB0aGUgYmFja2VuZC0KPiAgICBzcGVjaWZpZWQgZGF0YSBmb3IgZXZl cnkgSU5RVUlSWSBjb21tYW5kIHdpdGggdGhlIEVWUEQgYml0IHNldC4KPiAgICBGb3IgRVZQRD0x IElOUVVJUlkgY29tbWFuZHMgd2hlcmUgdGhlIGNvcnJlc3BvbmRpbmcgeGVuc3RvcmUgbm9kZQo+ ICAgIGRvZXMgbm90IGV4aXN0LCB0aGUgZnJvbnRlbmQgbXVzdCByZXBvcnQgKHRvIGl0cyBjb250 YWluaW5nIE9TKSBhbgo+ICAgIGFwcHJvcHJpYXRlIGZhaWx1cmUgY29uZGl0aW9uLgo+IAo+ICAg IEEgZnJvbnRlbmQgd2hpY2ggZG9lcyBub3Qgc3VwcG9ydCB0aGlzIGZlYXR1cmUgKGllLCB3aGlj aCBkb2VzIG5vdAo+ICAgIHVzZSB0aGVzZSB4ZW5zdG9yZSBub2RlcyksIGFuZCB3aGljaCBwcmVz ZW50cyBhcyBhIFNDU0kgdGFyZ2V0IHRvCj4gICAgaXRzIGNvbnRhaW5pbmcgT1MsIHNob3VsZCBz dXBwb3J0IGFuZCBwcm92aWRlIHdoYXRldmVyIFZQRAo+ICAgIGluZm9ybWF0aW9uIGl0IGNvbnNp ZGVycyBhcHByb3ByaWF0ZSwgYW5kIHNob3VsZCBkaXNyZWdhcmQgdGhlc2UKPiAgICB4ZW5zdG9y ZSBub2Rlcy4KPiAKPiAgICBBIGZyb250ZW5kIG5lZWQgbm90IC0gYW5kIG9mdGVuIHdpbGwgbm90 IC0gcHJlc2VudCB0byBpdHMKPiAgICBjb250YWluaW5nIE9TIGFzIGEgZGV2aWNlIGFkZHJlc3Nh YmxlIHdpdGggU0NTSSBDREJzLiAgU3VjaCBhCj4gICAgZnJvbnRlbmQgaGFzIG5vIHVzZSBmb3Ig U0NTSSBJTlFVSVJZIFZQRCBpbmZvcm1hdGlvbi4KPiAKPiAgICBBIGJhY2tlbmQgc2hvdWxkIHNl dCB0aGlzIGluZm9ybWF0aW9uIHdpdGggY2F1dGlvbi4gIFBhZ2VzCj4gICAgY29udGFpbmluZyBk ZXZpY2UtdmVuZG9yLXNwZWNpZmljIGluZm9ybWF0aW9uIHNob3VsZCBub3QgYmUKPiAgICBzcGVj aWZpZWQgd2l0aG91dCB0aGUgYXBwcm9wcmlhdGUgZGV2aWNlLXZlbmRvci1zcGVjaWZpYyBrbm93 bGVkZ2UuCj4gCgpUaGF0J3MgbXVjaCBtb3JlIGNsZWFyLCB0aGFuayB5b3UgdmVyeSBtdWNoIQoK PiAKPiBBbHNvIEkgaGF2ZSB0d28gb3RoZXIgb2JzZXJ2YXRpb25zOgo+IAo+IEZpcnN0bHksIEFG QUlDVCB5b3UgaGF2ZSBub3QgcHJvdmlkZWQgYW55IHdheSB0byBzZXQgdGhlIHN0YW5kYXJkCj4g SU5RVUlSWSByZXNwb25zZS4gIElzIGl0IG5vdCBuZWNlc3NhcnkgaW4geW91ciBhcHBsaWNhdGlv biB0byBwcm92aWRlCgpJZiBiYWNrZW5kcyBhcmUgbm90IGVuY291cmFnZWQgdG8gdXNlIHRoaXMg bm9kZSwgdGhlbiB3ZSBtdXN0IGhhdmUgdGhlIHRvb2xzdGFjayB3cml0ZSB0aGlzIG5vZGUgd2l0 aCB0aGUgcmlnaHQgVlBEIGluZm9ybWF0aW9uLgpQYXVsIG1lbnRpb25lZCB0aGVyZSBzaG91bGQg YmUgY29ycmVzcG9uZGluZyBjb2RlIGluIHRoZSB4YXBpIHByb2plY3QsIGJ1dCBJIGhhdmVuJ3Qg Zm91bmQgb3V0IHdoZXJlLgoKCj4gc3ludGhldGljIHZlbmRvcmlkIGFuZCBwcm9kdWN0aWQsIGF0 IHRoZSB2ZXJ5IGxlYXN0ID8KPiAKPiBTZWNvbmRseSwgSSB0aGluayB5b3VyIGhvcGUgdGhhdAo+ IAo+PiBibGtmcm9udCBpbiBMaW51eCAuLi4gY2FuIHVzZSB0aGUgc2FtZSBtZWNoYW5pc20uCj4g Cj4gaXMgSSB0aGluayBtaXNndWlkZWQuICBibGtmcm9udCBkb2VzIG5vdCBwcmVzZW50IHRoZSBk aXNrICh0byB0aGUgcmVzdAo+IG9mIHRoZSBMaW51eCBzdG9yYWdlIHN5c3RlbSkgYXMgYSBTQ1NJ IGRldmljZS4gIFJhdGhlciwgTGludXggYWxsb3dzCj4gYmxrZnJvbnQgdG8gcHJlc2VudCBhcyBh IGJsb2NrIGRldmljZSwgZGlyZWN0bHksIGFuZCB0aGlzIGlzIHdoYXQKPiBibGtmcm9udCBkb2Vz Lgo+IAoKQnV0IHdlJ2QgbGlrZSB0byBnZXQgdGhlIFZQRCBpbmZvcm1hdGlvbihvZiB1bmRlcmx5 aW5nIHN0b3JhZ2UgZGV2aWNlKSBhbHNvIGluIExpbnV4IGJsa2Zyb250LCBldmVuIGJsa2Zyb250 IGlzIG5vdCBhIFNDU0kgZGV2aWNlLgoKVGhhdCdzIGJlY2F1c2Ugb3VyIHVuZGVybHlpbmcgc3Rv cmFnZSBkZXZpY2UgaGFzIHNvbWUgdmVuZG9yLXNwZWNpZmljIGZlYXR1cmVzIHdoaWNoIGNhbiBi ZSByZWNvZ25pemVkIHRocm91Z2ggaW5mb3JtYXRpb25zIGluIFZQRCBwYWdlcy4KQW5kIE91ciBh cHBsaWNhdGlvbnMgaW4gZ3Vlc3Qgd2FudCB0byBhd2FyZSBvZiB0aGVzZSB2ZW5kb3Itc3BlY2lm aWMgZmVhdHVyZXMuCgpSZWdhcmRzLApCb2IKCgoKX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fX18KWGVuLWRldmVsIG1haWxpbmcgbGlzdApYZW4tZGV2ZWxAbGlz dHMueGVuLm9yZwpodHRwOi8vbGlzdHMueGVuLm9yZy94ZW4tZGV2ZWwK