From mboxrd@z Thu Jan 1 00:00:00 1970 From: George Dunlap Subject: [PATCH 7/8] docs: Document block-script protocol Date: Wed, 16 Mar 2016 16:09:16 +0000 Message-ID: <1458144557-29070-8-git-send-email-george.dunlap@citrix.com> References: <1458144557-29070-1-git-send-email-george.dunlap@citrix.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: In-Reply-To: <1458144557-29070-1-git-send-email-george.dunlap@citrix.com> List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Errors-To: xen-devel-bounces@lists.xen.org Sender: "Xen-devel" To: xen-devel@lists.xen.org Cc: Ian Jackson , Wei Liu , George Dunlap , Roger Pau Monne List-Id: xen-devel@lists.xenproject.org U2lnbmVkLW9mZi1ieTogR2VvcmdlIER1bmxhcCA8Z2VvcmdlLmR1bmxhcEBjaXRyaXguY29tPgot LS0KQ0M6IElhbiBKYWNrc29uIDxpYW4uamFja3NvbkBjaXRyaXguY29tPgpDQzogV2VpIExpdSA8 d2VpLmxpdTJAY2l0cml4LmNvbT4KQ0M6IFJvZ2VyIFBhdSBNb25uZSA8cm9nZXIucGF1QGNpdHJp eC5jb20+Ci0tLQogZG9jcy9taXNjL2Jsb2NrLXNjcmlwdHMudHh0IHwgMTAwICsrKysrKysrKysr KysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrCiAxIGZpbGUgY2hhbmdlZCwgMTAwIGlu c2VydGlvbnMoKykKCmRpZmYgLS1naXQgYS9kb2NzL21pc2MvYmxvY2stc2NyaXB0cy50eHQgYi9k b2NzL21pc2MvYmxvY2stc2NyaXB0cy50eHQKbmV3IGZpbGUgbW9kZSAxMDA2NDQKaW5kZXggMDAw MDAwMC4uZWYxOTIwNwotLS0gL2Rldi9udWxsCisrKyBiL2RvY3MvbWlzYy9ibG9jay1zY3JpcHRz LnR4dApAQCAtMCwwICsxLDEwMCBAQAorQmxvY2sgc2NyaXB0cworPT09PT09PT09PT09PQorCitC bG9jayBzY3JpcHRzIGFyZSBjYWxsZWQgYXQgdGhlIG1vbWVudCBhbnl0aW1lIGJsa2JhY2sgaXMg ZGlyZWN0bHkKK2ludm9sdmVkIGluIHByb3ZpZGluZyBhY2Nlc3MgdG8gYSBiYWNrZW5kLiAgVGhl cmUgYXJlIHRocmVlIGdlbmVyYWwKK2Nhc2VzIHRoaXMgaGFwcGVuczoKKworMS4gV2hlbiBhIHVz ZXIgcGFzc2VzIGEgYmxvY2sgZGV2aWNlIGluIHRoZSAndGFyZ2V0JyBmaWVsZCBvZiB0aGUgZGlz aworc3BlY2lmaWNhdGlvbgorCisyLiBXaGVuIGEgdXNlciBwYXNzZXMgYSBmaWxlIGluIHRoZSAn dGFyZ2V0JyBmaWVsZCBvZiB0aGUgZGlzaworc3BlY2lmaWNhdGlvbgorCiszLiBXaGVuIGEgdXNl ciBzcGVjaWZpZXMgYSBjdXN0b20gc2NyaXB0LgorCitTZXR1cAorLS0tLS0KKworSXQgaXMgaGln aGx5IHJlY29tbWVuZGVkIHRoYXQgY3VzdG9tIHNjcmlwdHMgYXMgbXVjaCBhcyBwb3NzaWJsZQor aW5jbHVkZSBhbmQgdXNlIHRoZSBjb21tb24gWGVuIGZ1bmN0aW9uYWxpdHkuICBJZiB0aGUgc2Ny aXB0IGlzIHJ1bgorZnJvbSB0aGUgbm9ybWFsIGJsb2NrIHNjcmlwdCBsb2NhdGlvbiAoL2V0Yy94 ZW4vc2NyaXB0cyBieSBkZWZhdWx0KSwKK3RoZW4gdGhpcyBjYW4gYmUgZG9uZSBieSBhZGRpbmcg dGhlIGZvbGxvd2luZyB0byB0aGUgdG9wIG9mIHRoZQorc2NyaXB0OgorCitkaXI9JChkaXJuYW1l ICIkMCIpCisuICIkZGlyL2Jsb2NrLWNvbW1vbi5zaCIKKworCitJbnB1dHMKKy0tLS0tLQorCitJ biBhbGwgY2FzZXMsIHRoZSBzY3JpcHRzIGFyZSBjYWxsZWQgd2l0aCBlaXRoZXIgImFkZCIgb3Ig InJlbW92ZSIgYXMKK3RoZSBjb21tYW5kLiAgRm9yIGN1c3RvbSBzY3JpcHRzLCB0aGUgY29tbWFu ZCB3aWxsIGJlIHRoZSBmaXJzdAorYXJndW1lbnQgb2YgdGhlIHNjcmlwdCAoaS5lLiAkMSkuCisK K1RoZSBlbnZpcm9ubWVudCB2YXJpYWJsZSBYRU5CVVNfUEFUSCB3aWxsIGJlIHNldCB0byB0aGUK K3BhdGggZm9yIHRoZSBibG9jayBkZXZpY2UgdG8gYmUgY3JlYXRlZC4KKworV2hlbiB0aGUgc2Ny aXB0IGlzIHJ1biwgdGhlIGZvbGxvd2luZyBub2RlcyBzaGFsbCBhbHJlYWR5IGhhdmUgYmVlbgor d3JpdHRlbiBpbnRvIHhlbnN0b3JlOgorCisgJFhFTkJVUy9wYXJhbXMgICAgVGhlIGNvbnRlbnRz IG9mIHRoZSAndGFyZ2V0JyBzZWN0aW9uIG9mIHRoZSBkaXNrIHNwZWNpZmljYXRpb24gdmVyYmF0 aW0uCisgJFhFTkJVUy9tb2RlICAgICAgJ3InIChmb3IgcmVhZG9ubHkpIG9yICd3JyAoZm9yIHJl YWQtd3JpdGUpCisKK091dHB1dAorLS0tLS0tLQorCitCbG9jayBzY3JpcHRzIGFyZSByZXNwb25z aWJsZSBmb3IgbWFraW5nIHN1cmUgdGhhdCBpZiBhIGZpbGUgaXMKK3Byb3ZpZGVkIHRvIGEgVk0g cmVhZC93cml0ZSwgdGhhdCBpdCBpcyBub3QgcHJvdmlkZWQgdG8gYW55IG90aGVyIFZNLgorCitG cmVlQlNEIGJsb2NrIGhvdHBsdWcgc2NyaXB0cyBtdXN0IHdyaXRlCisiJFhFTkJVU19QQVRIL3Bo eXNpY2FsLWRldmljZS1wYXRoIiB3aXRoIHRoZSBwYXRoIHRvIHRoZSBwaHlzaWNhbAorZGV2aWNl IG9yIGZpbGUuICBMaW51eCBhbmQgTmV0QlNEIGJsb2NrIGhvdHBsdWcgc2NyaXB0cyAqc2hvdWxk KiBhbHNvCit3cml0ZSB0aGlzIG5vZGUuCisKK0ZvciB0aGUgdGltZSBiZWluZywgTGludXggYW5k IE5ldEJTRCBibG9jayBob3RwbHVnIHNjcmlwdHMgbXVzdCB3cml0ZQorIiRYRU5CVVNfUEFUSC9w aHlzaWNhbC1kZXZpY2UiIHdpdGggdGhlIGRldmljZSdzIG1ham9yIGFuZCBtaW5vcgorbnVtYmVy cywgd3JpdHRlbiBpbiBoZXgsIGFuZCBzZXBhcmF0ZWQgYnkgYSBjb2xvbi4KKworU2NyaXB0cyB3 aGljaCBpbmNsdWRlIGJsb2NrLWNvbW1vbi5zaCBjYW4gc2ltcGx5IGNhbGwgd3JpdGVfZGV2ICIk ZGV2Igord2l0aCBhIHBhdGggdG8gdGhlIGRldmljZSwgYW5kIHdyaXRlX2RldiB3aWxsIGRvIHRo ZSByaWdodCB0aGluZywgbm93CithbmQgZ29pbmcgZm9yd2FyZC4gIChTZWUgdGhlIGRpc2N1c3Np b24gYmVsb3cuKQorCitSYXRpb25hbGUgYW5kIGZ1dHVyZSB3b3JrCistLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tCisKK0hpc3RvcmljYWxseSwgdGhlIGJsb2NrIHNjcmlwdHMgd3JvdGUgYSBub2Rl IGNhbGxlZCAicGh5c2ljYWwtZGV2aWNlIiwKK3doaWNoIGNvbnRhaW5zIHRoZSBtYWpvciBhbmQg bWlub3IgbnVtYmVycywgd3JpdHRlbiBpbiBoZXgsIGFuZAorc2VwYXJhdGVkIGJ5IGEgY29sb24g KGUuZy4sICIxYToyIikuICBUaGlzIGlzIHJlcXVpcmVkIGJ5IHRoZSBMaW51eAorYmxrYmFjayBk cml2ZXIuCisKK0ZyZWVCU0QgYmxrYmFjaywgb24gdGhlIG90aGVyIGhhbmQsIGRvZXMgbm90IGhh dmUgdGhlIGNvbmNlcHQgb2YKK21ham9yL21pbm9yIG51bWJlcnMsIGFuZCBjYW4gZ2l2ZSBkaXJl Y3QgYWNjZXNzIHRvIGEgZmlsZSB3aXRob3V0Citnb2luZyB0aHJvdWdoIGxvb3BiYWNrOyBzbyBp dHMgZHJpdmVyIHdpbGwgY29uc3VtZQorcGh5c2ljYWwtZGV2aWNlLXBhdGguCisKK09uIExpbnV4 LCB0aGUgZGV2aWNlIG1vZGVsIChxZW11KSBuZWVkcyBhY2Nlc3MgdG8gYSBmaWxlIGl0IGNhbgor aW50ZXJwcmV0IHRvIHByb3ZpZGUgZW11bGF0ZWQgZGlza3MgYmVmb3JlIHBhcmF2aXJ0dWFsaXpl ZCBkcml2ZXJzIGFyZQorbWFya2VkIGFzIHVwLiAgVGhlIGVhc2llc3Qgd2F5IHRvIGFjY29tcGxp c2ggdGhpcyBpcyB0byBhbGxvdyBxZW11IHRvCitjb25zdW1lIHBoeXNpY2FsLWRldmljZS1wYXRo IChyYXRoZXIgdGhhbiwgc2F5LCBoYXZpbmcgZG9tMCBhY3QgYXMKK2JvdGggYSBmcm9udGVuZCBh bmQgYSBiYWNrZW5kKS4KKworR29pbmcgZm9yd2FyZCwgdGhlIHBsYW4gaXMgYXQgc29tZSBwb2lu dCB0byBoYXZlIGFsbCBibG9jayBzY3JpcHRzCitzaW1wbHkgd3JpdGUgInBoeXNpY2FsLWRldmlj ZS1wYXRoIiwgYW5kIHRoZW4gaGF2ZSBsaWJ4bCB3cml0ZSB0aGUKK290aGVyIG5vZGVzLiAgVGhl IHJlYXNvbiB3ZSBoYXZlbid0IGRvbmUgdGhpcyB5ZXQgaXMgdGhhdCB0aGUgbWFpbgorYmxvY2sg c2NyaXB0IHdhbnRzIHRvIGNoZWNrIHRvIG1ha2Ugc3VyZSB0aGUgKm1ham9yL21pbm9yKiBudW1i ZXIKK2hhc24ndCBiZWVuIHJlLXVzZWQsIHJhdGhlciB0aGFuIGp1c3QgY2hlY2tpbmcgdGhhdCB0 aGUgKnNwZWNpZmljCitkZXZpY2Ugbm9kZSogaXNuJ3QgcmUtdXNlZC4gIFRvIGRvIHRoaXMgaXQg Y3VycmVudGx5IHVzZXMKK3BoeXNpY2FsLWRldmljZTsgYW5kIHRvIGRvIHRoaXMgKnNhZmVseSog aXQgbmVlZHMgcGh5c2ljYWwtZGV2aWNlIHRvCitiZSB3cml0dGVuIHdpdGggdGhlIGxvY2sgaGVs ZC4KKworVGhlIHNpbXBsZXN0IHNvbHV0aW9uIGZvciBzb3J0aW5nIHRoaXMgb3V0IHdvdWxkIGJl IHRvIGhhdmUgdGhlIGJsb2NrCitzY3JpcHQgdXNlIHBoeXNpY2FsLWRldmljZSBpZiBpdCdzIHBy ZXNlbnQsIGJ1dCBpZiBub3QsIHRvIGRpcmVjdGx5CitzdGF0IHBoeXNpY2FsLWRldmljZS1wYXRo LiAgQnV0IHRoZXJlJ3Mgbm90IHRpbWUgYmVmb3JlIHRoZSA0LjcKK3JlbGVhc2UgdG8gbWFrZSBz dXJlIGFsbCB0aGF0IHdvcmtzLgorCitBbm90aGVyIHBvc3NpYmlsaXR5IHdvdWxkIGJlIHRvIGRv IGF3YXkgd2l0aCB0aGUgYmxvY2sgc2NyaXB0cworYWx0b2dldGhlciB3aGVuIG5vdCBhY3R1YWxs eSBydW5uaW5nIGFueSBzY3JpcHRzLCBhbmQgZG8gdGhlIGR1cGxpY2F0ZQorY2hlY2tpbmcgaW5z aWRlIG9mIGxpYnhsLiAgVGhlIHJhdGlvbmFsZSBmb3IgZG9pbmcgdGhpcyBpbiBibG9jaworc2Ny aXB0cyByYXRoZXIgdGhhbiBpbiBsaWJ4bCBpc24ndCBjbGVhciBhdCB0aGVzIHBvaW50LgotLSAK Mi4xLjQKCgpfX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fXwpY ZW4tZGV2ZWwgbWFpbGluZyBsaXN0Clhlbi1kZXZlbEBsaXN0cy54ZW4ub3JnCmh0dHA6Ly9saXN0 cy54ZW4ub3JnL3hlbi1kZXZlbAo=