From mboxrd@z Thu Jan 1 00:00:00 1970 From: George Dunlap Subject: Re: [PATCH 7/8] docs: Document block-script protocol Date: Thu, 17 Mar 2016 09:55:49 +0000 Message-ID: References: <1458144557-29070-1-git-send-email-george.dunlap@citrix.com> <1458144557-29070-8-git-send-email-george.dunlap@citrix.com> <56E9E4DC.2050909@suse.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: In-Reply-To: <56E9E4DC.2050909@suse.com> List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Errors-To: xen-devel-bounces@lists.xen.org Sender: "Xen-devel" To: Jim Fehlig Cc: Ian Jackson , Roger Pau Monne , Wei Liu , George Dunlap , "xen-devel@lists.xen.org" List-Id: xen-devel@lists.xenproject.org T24gV2VkLCBNYXIgMTYsIDIwMTYgYXQgMTA6NTcgUE0sIEppbSBGZWhsaWcgPGpmZWhsaWdAc3Vz ZS5jb20+IHdyb3RlOgo+IE9uIDAzLzE2LzIwMTYgMTA6MDkgQU0sIEdlb3JnZSBEdW5sYXAgd3Jv dGU6Cj4+IFNpZ25lZC1vZmYtYnk6IEdlb3JnZSBEdW5sYXAgPGdlb3JnZS5kdW5sYXBAY2l0cml4 LmNvbT4KPj4gLS0tCj4+IENDOiBJYW4gSmFja3NvbiA8aWFuLmphY2tzb25AY2l0cml4LmNvbT4K Pj4gQ0M6IFdlaSBMaXUgPHdlaS5saXUyQGNpdHJpeC5jb20+Cj4+IENDOiBSb2dlciBQYXUgTW9u bmUgPHJvZ2VyLnBhdUBjaXRyaXguY29tPgo+PiAtLS0KPj4gIGRvY3MvbWlzYy9ibG9jay1zY3Jp cHRzLnR4dCB8IDEwMCArKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysr Kwo+PiAgMSBmaWxlIGNoYW5nZWQsIDEwMCBpbnNlcnRpb25zKCspCj4+Cj4+IGRpZmYgLS1naXQg YS9kb2NzL21pc2MvYmxvY2stc2NyaXB0cy50eHQgYi9kb2NzL21pc2MvYmxvY2stc2NyaXB0cy50 eHQKPj4gbmV3IGZpbGUgbW9kZSAxMDA2NDQKPj4gaW5kZXggMDAwMDAwMC4uZWYxOTIwNwo+PiAt LS0gL2Rldi9udWxsCj4+ICsrKyBiL2RvY3MvbWlzYy9ibG9jay1zY3JpcHRzLnR4dAo+PiBAQCAt MCwwICsxLDEwMCBAQAo+PiArQmxvY2sgc2NyaXB0cwo+PiArPT09PT09PT09PT09PQo+PiArCj4+ ICtCbG9jayBzY3JpcHRzIGFyZSBjYWxsZWQgYXQgdGhlIG1vbWVudCBhbnl0aW1lIGJsa2JhY2sg aXMgZGlyZWN0bHkKPj4gK2ludm9sdmVkIGluIHByb3ZpZGluZyBhY2Nlc3MgdG8gYSBiYWNrZW5k LiAgVGhlcmUgYXJlIHRocmVlIGdlbmVyYWwKPj4gK2Nhc2VzIHRoaXMgaGFwcGVuczoKPj4gKwo+ PiArMS4gV2hlbiBhIHVzZXIgcGFzc2VzIGEgYmxvY2sgZGV2aWNlIGluIHRoZSAndGFyZ2V0JyBm aWVsZCBvZiB0aGUgZGlzawo+PiArc3BlY2lmaWNhdGlvbgo+PiArCj4+ICsyLiBXaGVuIGEgdXNl ciBwYXNzZXMgYSBmaWxlIGluIHRoZSAndGFyZ2V0JyBmaWVsZCBvZiB0aGUgZGlzawo+PiArc3Bl Y2lmaWNhdGlvbgo+PiArCj4+ICszLiBXaGVuIGEgdXNlciBzcGVjaWZpZXMgYSBjdXN0b20gc2Ny aXB0Lgo+PiArCj4+ICtTZXR1cAo+PiArLS0tLS0KPj4gKwo+PiArSXQgaXMgaGlnaGx5IHJlY29t bWVuZGVkIHRoYXQgY3VzdG9tIHNjcmlwdHMgYXMgbXVjaCBhcyBwb3NzaWJsZQo+PiAraW5jbHVk ZSBhbmQgdXNlIHRoZSBjb21tb24gWGVuIGZ1bmN0aW9uYWxpdHkuICBJZiB0aGUgc2NyaXB0IGlz IHJ1bgo+PiArZnJvbSB0aGUgbm9ybWFsIGJsb2NrIHNjcmlwdCBsb2NhdGlvbiAoL2V0Yy94ZW4v c2NyaXB0cyBieSBkZWZhdWx0KSwKPj4gK3RoZW4gdGhpcyBjYW4gYmUgZG9uZSBieSBhZGRpbmcg dGhlIGZvbGxvd2luZyB0byB0aGUgdG9wIG9mIHRoZQo+PiArc2NyaXB0Ogo+PiArCj4+ICtkaXI9 JChkaXJuYW1lICIkMCIpCj4+ICsuICIkZGlyL2Jsb2NrLWNvbW1vbi5zaCIKPj4gKwo+PiArCj4+ ICtJbnB1dHMKPj4gKy0tLS0tLQo+PiArCj4+ICtJbiBhbGwgY2FzZXMsIHRoZSBzY3JpcHRzIGFy ZSBjYWxsZWQgd2l0aCBlaXRoZXIgImFkZCIgb3IgInJlbW92ZSIgYXMKPj4gK3RoZSBjb21tYW5k LiAgRm9yIGN1c3RvbSBzY3JpcHRzLCB0aGUgY29tbWFuZCB3aWxsIGJlIHRoZSBmaXJzdAo+PiAr YXJndW1lbnQgb2YgdGhlIHNjcmlwdCAoaS5lLiAkMSkuCj4+ICsKPj4gK1RoZSBlbnZpcm9ubWVu dCB2YXJpYWJsZSBYRU5CVVNfUEFUSCB3aWxsIGJlIHNldCB0byB0aGUKPj4gK3BhdGggZm9yIHRo ZSBibG9jayBkZXZpY2UgdG8gYmUgY3JlYXRlZC4KPj4gKwo+PiArV2hlbiB0aGUgc2NyaXB0IGlz IHJ1biwgdGhlIGZvbGxvd2luZyBub2RlcyBzaGFsbCBhbHJlYWR5IGhhdmUgYmVlbgo+PiArd3Jp dHRlbiBpbnRvIHhlbnN0b3JlOgo+PiArCj4+ICsgJFhFTkJVUy9wYXJhbXMgICAgVGhlIGNvbnRl bnRzIG9mIHRoZSAndGFyZ2V0JyBzZWN0aW9uIG9mIHRoZSBkaXNrIHNwZWNpZmljYXRpb24gdmVy YmF0aW0uCj4+ICsgJFhFTkJVUy9tb2RlICAgICAgJ3InIChmb3IgcmVhZG9ubHkpIG9yICd3JyAo Zm9yIHJlYWQtd3JpdGUpCj4+ICsKPj4gK091dHB1dAo+PiArLS0tLS0tLQo+PiArCj4+ICtCbG9j ayBzY3JpcHRzIGFyZSByZXNwb25zaWJsZSBmb3IgbWFraW5nIHN1cmUgdGhhdCBpZiBhIGZpbGUg aXMKPj4gK3Byb3ZpZGVkIHRvIGEgVk0gcmVhZC93cml0ZSwgdGhhdCBpdCBpcyBub3QgcHJvdmlk ZWQgdG8gYW55IG90aGVyIFZNLgo+PiArCj4+ICtGcmVlQlNEIGJsb2NrIGhvdHBsdWcgc2NyaXB0 cyBtdXN0IHdyaXRlCj4+ICsiJFhFTkJVU19QQVRIL3BoeXNpY2FsLWRldmljZS1wYXRoIiB3aXRo IHRoZSBwYXRoIHRvIHRoZSBwaHlzaWNhbAo+PiArZGV2aWNlIG9yIGZpbGUuICBMaW51eCBhbmQg TmV0QlNEIGJsb2NrIGhvdHBsdWcgc2NyaXB0cyAqc2hvdWxkKiBhbHNvCj4+ICt3cml0ZSB0aGlz IG5vZGUuCj4+ICsKPj4gK0ZvciB0aGUgdGltZSBiZWluZywgTGludXggYW5kIE5ldEJTRCBibG9j ayBob3RwbHVnIHNjcmlwdHMgbXVzdCB3cml0ZQo+PiArIiRYRU5CVVNfUEFUSC9waHlzaWNhbC1k ZXZpY2UiIHdpdGggdGhlIGRldmljZSdzIG1ham9yIGFuZCBtaW5vcgo+PiArbnVtYmVycywgd3Jp dHRlbiBpbiBoZXgsIGFuZCBzZXBhcmF0ZWQgYnkgYSBjb2xvbi4KPj4gKwo+PiArU2NyaXB0cyB3 aGljaCBpbmNsdWRlIGJsb2NrLWNvbW1vbi5zaCBjYW4gc2ltcGx5IGNhbGwgd3JpdGVfZGV2ICIk ZGV2Igo+PiArd2l0aCBhIHBhdGggdG8gdGhlIGRldmljZSwgYW5kIHdyaXRlX2RldiB3aWxsIGRv IHRoZSByaWdodCB0aGluZywgbm93Cj4+ICthbmQgZ29pbmcgZm9yd2FyZC4gIChTZWUgdGhlIGRp c2N1c3Npb24gYmVsb3cuKQo+PiArCj4+ICtSYXRpb25hbGUgYW5kIGZ1dHVyZSB3b3JrCj4+ICst LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tCj4+ICsKPj4gK0hpc3RvcmljYWxseSwgdGhlIGJsb2Nr IHNjcmlwdHMgd3JvdGUgYSBub2RlIGNhbGxlZCAicGh5c2ljYWwtZGV2aWNlIiwKPj4gK3doaWNo IGNvbnRhaW5zIHRoZSBtYWpvciBhbmQgbWlub3IgbnVtYmVycywgd3JpdHRlbiBpbiBoZXgsIGFu ZAo+PiArc2VwYXJhdGVkIGJ5IGEgY29sb24gKGUuZy4sICIxYToyIikuICBUaGlzIGlzIHJlcXVp cmVkIGJ5IHRoZSBMaW51eAo+PiArYmxrYmFjayBkcml2ZXIuCj4+ICsKPj4gK0ZyZWVCU0QgYmxr YmFjaywgb24gdGhlIG90aGVyIGhhbmQsIGRvZXMgbm90IGhhdmUgdGhlIGNvbmNlcHQgb2YKPj4g K21ham9yL21pbm9yIG51bWJlcnMsIGFuZCBjYW4gZ2l2ZSBkaXJlY3QgYWNjZXNzIHRvIGEgZmls ZSB3aXRob3V0Cj4+ICtnb2luZyB0aHJvdWdoIGxvb3BiYWNrOyBzbyBpdHMgZHJpdmVyIHdpbGwg Y29uc3VtZQo+PiArcGh5c2ljYWwtZGV2aWNlLXBhdGguCj4+ICsKPj4gK09uIExpbnV4LCB0aGUg ZGV2aWNlIG1vZGVsIChxZW11KSBuZWVkcyBhY2Nlc3MgdG8gYSBmaWxlIGl0IGNhbgo+PiAraW50 ZXJwcmV0IHRvIHByb3ZpZGUgZW11bGF0ZWQgZGlza3MgYmVmb3JlIHBhcmF2aXJ0dWFsaXplZCBk cml2ZXJzIGFyZQo+PiArbWFya2VkIGFzIHVwLiAgVGhlIGVhc2llc3Qgd2F5IHRvIGFjY29tcGxp c2ggdGhpcyBpcyB0byBhbGxvdyBxZW11IHRvCj4+ICtjb25zdW1lIHBoeXNpY2FsLWRldmljZS1w YXRoIChyYXRoZXIgdGhhbiwgc2F5LCBoYXZpbmcgZG9tMCBhY3QgYXMKPj4gK2JvdGggYSBmcm9u dGVuZCBhbmQgYSBiYWNrZW5kKS4KPj4gKwo+PiArR29pbmcgZm9yd2FyZCwgdGhlIHBsYW4gaXMg YXQgc29tZSBwb2ludCB0byBoYXZlIGFsbCBibG9jayBzY3JpcHRzCj4+ICtzaW1wbHkgd3JpdGUg InBoeXNpY2FsLWRldmljZS1wYXRoIiwgYW5kIHRoZW4gaGF2ZSBsaWJ4bCB3cml0ZSB0aGUKPj4g K290aGVyIG5vZGVzLiAgVGhlIHJlYXNvbiB3ZSBoYXZlbid0IGRvbmUgdGhpcyB5ZXQgaXMgdGhh dCB0aGUgbWFpbgo+PiArYmxvY2sgc2NyaXB0IHdhbnRzIHRvIGNoZWNrIHRvIG1ha2Ugc3VyZSB0 aGUgKm1ham9yL21pbm9yKiBudW1iZXIKPj4gK2hhc24ndCBiZWVuIHJlLXVzZWQsIHJhdGhlciB0 aGFuIGp1c3QgY2hlY2tpbmcgdGhhdCB0aGUgKnNwZWNpZmljCj4+ICtkZXZpY2Ugbm9kZSogaXNu J3QgcmUtdXNlZC4gIFRvIGRvIHRoaXMgaXQgY3VycmVudGx5IHVzZXMKPj4gK3BoeXNpY2FsLWRl dmljZTsgYW5kIHRvIGRvIHRoaXMgKnNhZmVseSogaXQgbmVlZHMgcGh5c2ljYWwtZGV2aWNlIHRv Cj4+ICtiZSB3cml0dGVuIHdpdGggdGhlIGxvY2sgaGVsZC4KPj4gKwo+PiArVGhlIHNpbXBsZXN0 IHNvbHV0aW9uIGZvciBzb3J0aW5nIHRoaXMgb3V0IHdvdWxkIGJlIHRvIGhhdmUgdGhlIGJsb2Nr Cj4+ICtzY3JpcHQgdXNlIHBoeXNpY2FsLWRldmljZSBpZiBpdCdzIHByZXNlbnQsIGJ1dCBpZiBu b3QsIHRvIGRpcmVjdGx5Cj4+ICtzdGF0IHBoeXNpY2FsLWRldmljZS1wYXRoLiAgQnV0IHRoZXJl J3Mgbm90IHRpbWUgYmVmb3JlIHRoZSA0LjcKPj4gK3JlbGVhc2UgdG8gbWFrZSBzdXJlIGFsbCB0 aGF0IHdvcmtzLgo+PiArCj4+ICtBbm90aGVyIHBvc3NpYmlsaXR5IHdvdWxkIGJlIHRvIGRvIGF3 YXkgd2l0aCB0aGUgYmxvY2sgc2NyaXB0cwo+PiArYWx0b2dldGhlciB3aGVuIG5vdCBhY3R1YWxs eSBydW5uaW5nIGFueSBzY3JpcHRzLAo+Cj4gSnVzdCB0byBjbGFyaWZ5LCBkbyB5b3UgbWVhbiBk cm9wIHN1cHBvcnQgZm9yIGFsbCBibG9jayBzY3JpcHRzPwoKTm8gLS0gYWx0aG91Z2ggSSBjYW4g c2VlIHdoeSAiZG8gYXdheSB3aXRoIGJsb2NrIHNjcmlwdHMgd2hlbiBub3QKcnVubmluZyBhbnkg c2NyaXB0cyIgaXMgYSBiaXQgY29uZnVzaW5nLiA6LSkKCldoYXQgSSBtZWFudCB3YXMgdGhpczog YXQgdGhlIG1vbWVudCwgd2hlbiB3ZSAqYXJlbid0KiB1c2luZyBjdXN0b20KaG90cGx1ZyBzY3Jp cHRzLCBidXQgd2UgYXJlIHVzaW5nIHBoeXNpY2FsIGRldmljZXMgb3IgZmlsZXMsIHdlIGNhbGwg YQpzY3JpcHQgY2FsbGVkICJibG9jayIuICBXaGF0IEkgbWVhbnQgd2FzLCB0byBvbmx5IHJ1biBh IHNjcmlwdCB3aGVuIGEKY3VzdG9tIGhvdHBsdWcgc2NyaXB0IGlzIGFjdHVhbGx5IHJlcXVlc3Rl ZDsgYW5kIGluIHRoZSBjYXNlIG9mCnBoeXNpY2FsIGRldmljZXMgb3IgZmlsZXMsIGdldCByaWQg b2YgdGhlIGN1cnJlbnQgYmxvY2sgc2NyaXB0IGFuZCBkbwphbGwgdGhlIG5lY2Vzc2FyeSB3b3Jr IGluIGxpYnhsIGluc3RlYWQuCgpIYXZpbmcgY3VzdG9tIGJsb2NrIHNjcmlwdHMgKGxpa2UgYmxv Y2staXNjc2kgYW5kIGJsb2NrLWRyYmQpIGlzIGEKZmVhdHVyZSBJIGRlZmluaXRlbHkgdGhpbmsg d2Ugc2hvdWxkIGtlZXAuCgpJJ2xsIGNsYXJpZnkgdGhlIHdvcmRpbmcgaGVyZS4KCj4+ICBhbmQg ZG8gdGhlIGR1cGxpY2F0ZQo+PiArY2hlY2tpbmcgaW5zaWRlIG9mIGxpYnhsLiAgVGhlIHJhdGlv bmFsZSBmb3IgZG9pbmcgdGhpcyBpbiBibG9jawo+PiArc2NyaXB0cyByYXRoZXIgdGhhbiBpbiBs aWJ4bCBpc24ndCBjbGVhciBhdCB0aGVzIHBvaW50Lgo+Cj4gQmxvY2sgc2NyaXB0cyBsaWtlIGJs b2NrLWlzY3NpIGFuZCBibG9jay1kcmJkIGFsc28gImNvb2siICRYRU5CVVMvcGFyYW1zIGludG8K PiAkWEVOQlVTX1BBVEgvcGh5c2ljYWwtZGV2aWNleywtcGF0aH0gcmlnaHQ/CgpibG9jay1pc2Nz aSBjYWxscyB3cml0ZV9kZXYgKGFzIHJlY29tbWVuZGVkIGluIHRoaXMgZG9jdW1lbnQpLCBzbyBp dAp3aWxsIGFsd2F5cyBEVFJULiAgYmxvY2stZHJiZCBtdXN0IGN1cnJlbnRseSBhdCBsZWFzdCB3 cml0ZQpwaHlzaWNhbC1kZXZpY2UsIG9yIGl0IHdvdWxkbid0IHdvcmsuICAoVGhlICJMaW51eCBi bG9jayBzY3JpcHRzIG11c3QKd3JpdGUgcGh5c2ljYWwtZGV2aWNlIiBpcyBkZXNjcmliaW5nIHRo ZSBpbXBsaWNpdCBjdXJyZW50IHByb3RvY29sLikKQW5kIGF0IGxlYXN0IGluIHRoaXMgdmVyc2lv biBvZiB0aGUgc2NyaXB0LCBibG9jay1kcmJkIGFsc28gY2FsbHMKd3JpdGVfZGV2LCBzbyBpdCB3 aWxsIGF1dG9tYXRpY2FsbHkgYmUgdXBkYXRlZCB0byB0aGUgbmV3IGJlaGF2aW9yIGFzCndlbGw6 CgpodHRwczovL3d3dy5tZWIudW5pLWJvbm4uZGUvaW1iaWUvZG9rdXMvZGF0ZWllbi94ZW4tc2Ny aXB0ZS9zY3JpcHRzL2Jsb2NrLWRyYmQKCk5vbmV0aGVsZXNzLCB3ZSBhbHdheXMgbmVlZCB0byBz dXBwb3J0IHNjcmlwdHMgdGhhdCBvbmx5IHdyaXRlCnBoeXNpY2FsLWRldmljZSAtLSBhdCBsZWFz dCBhcyB3ZWxsIGFzIHRoZXkgaGF2ZSBldmVyIHdvcmtlZCAod2hpY2gKZm9yIHRoZSB0aW1lIGJl aW5nIGlzIHB2LW9ubHkpLiAgSSdsbCB0cnkgdG8gbWFrZSB0aGlzIGNsZWFyIGluIHRoZQpkb2N1 bWVudC4KCiAtR2VvcmdlCgpfX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fXwpYZW4tZGV2ZWwgbWFpbGluZyBsaXN0Clhlbi1kZXZlbEBsaXN0cy54ZW4ub3JnCmh0 dHA6Ly9saXN0cy54ZW4ub3JnL3hlbi1kZXZlbAo=