From mboxrd@z Thu Jan 1 00:00:00 1970 From: George Dunlap Subject: [PATCH v3 8/9] docs: Document block-script protocol Date: Thu, 24 Mar 2016 17:22:39 +0000 Message-ID: <1458840160-26733-9-git-send-email-george.dunlap@citrix.com> References: <1458840160-26733-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: <1458840160-26733-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 LS0KQ2hhbmdlcyBzaW5jZSB2MjoKLSBOb3RlIHRoYXQgdGhlICJJbnB1dHMiIGRlc2NyaWJlIExp bnV4IG9ubHkKCkNoYW5nZXMgc2luY2UgdjE6Ci0gQXR0ZW1wdCB0byBtYWtlIGEgY2xlYXIgZGlz dGluY3Rpb24gYmV0d2VlbiBjdXN0b20gaG90cGx1ZyBzY3JpcHRzCmFuZCB0aGUgc2NyaXB0IGNh bGxlZCBmb3IgcmF3IHBoeXNpY2FsIGRldmljZXMgYW5kIGZpbGVzCgpDQzogSWFuIEphY2tzb24g PGlhbi5qYWNrc29uQGNpdHJpeC5jb20+CkNDOiBXZWkgTGl1IDx3ZWkubGl1MkBjaXRyaXguY29t PgpDQzogUm9nZXIgUGF1IE1vbm5lIDxyb2dlci5wYXVAY2l0cml4LmNvbT4KLS0tCiBkb2NzL21p c2MvYmxvY2stc2NyaXB0cy50eHQgfCAxMTIgKysrKysrKysrKysrKysrKysrKysrKysrKysrKysr KysrKysrKysrKysrKysKIDEgZmlsZSBjaGFuZ2VkLCAxMTIgaW5zZXJ0aW9ucygrKQoKZGlmZiAt LWdpdCBhL2RvY3MvbWlzYy9ibG9jay1zY3JpcHRzLnR4dCBiL2RvY3MvbWlzYy9ibG9jay1zY3Jp cHRzLnR4dApuZXcgZmlsZSBtb2RlIDEwMDY0NAppbmRleCAwMDAwMDAwLi5mOWEwMDFlCi0tLSAv ZGV2L251bGwKKysrIGIvZG9jcy9taXNjL2Jsb2NrLXNjcmlwdHMudHh0CkBAIC0wLDAgKzEsMTEy IEBACitCbG9jayBzY3JpcHRzCis9PT09PT09PT09PT09CisKK0Jsb2NrIHNjcmlwdHMgYXJlIGNh bGxlZCBhdCB0aGUgbW9tZW50IGFueXRpbWUgYmxrYmFjayBpcyBkaXJlY3RseQoraW52b2x2ZWQg aW4gcHJvdmlkaW5nIGFjY2VzcyB0byBhIGJhY2tlbmQuICBUaGVyZSBhcmUgdGhyZWUgZ2VuZXJh bAorY2FzZXMgdGhpcyBoYXBwZW5zOgorCisxLiBXaGVuIGEgdXNlciBwYXNzZXMgYSBibG9jayBk ZXZpY2UgaW4gdGhlICd0YXJnZXQnIGZpZWxkIG9mIHRoZSBkaXNrCitzcGVjaWZpY2F0aW9uCisK KzIuIFdoZW4gYSB1c2VyIHBhc3NlcyBhIGZpbGUgaW4gdGhlICd0YXJnZXQnIGZpZWxkIG9mIHRo ZSBkaXNrCitzcGVjaWZpY2F0aW9uCisKKzMuIFdoZW4gYSB1c2VyIHNwZWNpZmllcyBhIGN1c3Rv bSBob3RwbHVnIHNjcmlwdC4KKworU2V0dXAKKy0tLS0tCisKK0l0IGlzIGhpZ2hseSByZWNvbW1l bmRlZCB0aGF0IGN1c3RvbSBob3RwbHVnIHNjcmlwdHMgYXMgbXVjaCBhcworcG9zc2libGUgaW5j bHVkZSBhbmQgdXNlIHRoZSBjb21tb24gWGVuIGZ1bmN0aW9uYWxpdHkuICBJZiB0aGUgc2NyaXB0 CitpcyBydW4gZnJvbSB0aGUgbm9ybWFsIGJsb2NrIHNjcmlwdCBsb2NhdGlvbiAoL2V0Yy94ZW4v c2NyaXB0cyBieQorZGVmYXVsdCksIHRoZW4gdGhpcyBjYW4gYmUgZG9uZSBieSBhZGRpbmcgdGhl IGZvbGxvd2luZyB0byB0aGUgdG9wIG9mCit0aGUgc2NyaXB0OgorCitkaXI9JChkaXJuYW1lICIk MCIpCisuICIkZGlyL2Jsb2NrLWNvbW1vbi5zaCIKKworCitJbnB1dHMKKy0tLS0tLQorCitVbmZv cnR1bmF0ZWx5IHRoZSBpbnB1dHMgdG8gdGhlIGJsb2NrIHNjcmlwdHMgbG9vayBjb21wbGV0ZWx5 CitkaWZmZXJlbnQgZm9yIGVhY2ggb3BlcmF0aW5nIHN5c3RlbS4KKworSW5wdXRzIChMaW51eCkK Ky0tLS0tLS0tLS0tLS0tCisKK0luIGFsbCBjYXNlcywgdGhlIHNjcmlwdHMgYXJlIGNhbGxlZCB3 aXRoIGVpdGhlciAiYWRkIiBvciAicmVtb3ZlIiBhcwordGhlIGNvbW1hbmQuICBGb3IgY3VzdG9t IHNjcmlwdHMsIHRoZSBjb21tYW5kIHdpbGwgYmUgdGhlIGZpcnN0Cithcmd1bWVudCBvZiB0aGUg c2NyaXB0IChpLmUuICQxKS4KKworVGhlIGVudmlyb25tZW50IHZhcmlhYmxlIFhFTkJVU19QQVRI IHdpbGwgYmUgc2V0IHRvIHRoZQorcGF0aCBmb3IgdGhlIGJsb2NrIGRldmljZSB0byBiZSBjcmVh dGVkLgorCitXaGVuIHRoZSBzY3JpcHQgaXMgcnVuLCB0aGUgZm9sbG93aW5nIG5vZGVzIHNoYWxs IGFscmVhZHkgaGF2ZSBiZWVuCit3cml0dGVuIGludG8geGVuc3RvcmU6CisKKyAkWEVOQlVTL3Bh cmFtcyAgICBUaGUgY29udGVudHMgb2YgdGhlICd0YXJnZXQnIHNlY3Rpb24gb2YgdGhlIGRpc2sg c3BlY2lmaWNhdGlvbiB2ZXJiYXRpbS4KKyAkWEVOQlVTL21vZGUgICAgICAncicgKGZvciByZWFk b25seSkgb3IgJ3cnIChmb3IgcmVhZC13cml0ZSkKKworSW5wdXRzIChOZXRCU0QpCistLS0tLS0t LS0tLS0tLS0KKworVE9ETworCitPdXRwdXQKKy0tLS0tLS0KKworQmxvY2sgc2NyaXB0cyBhcmUg cmVzcG9uc2libGUgZm9yIG1ha2luZyBzdXJlIHRoYXQgaWYgYSBmaWxlIGlzCitwcm92aWRlZCB0 byBhIFZNIHJlYWQvd3JpdGUsIHRoYXQgaXQgaXMgbm90IHByb3ZpZGVkIHRvIGFueSBvdGhlciBW TS4KKworRnJlZUJTRCBibG9jayBob3RwbHVnIHNjcmlwdHMgbXVzdCB3cml0ZQorIiRYRU5CVVNf UEFUSC9waHlzaWNhbC1kZXZpY2UtcGF0aCIgd2l0aCB0aGUgcGF0aCB0byB0aGUgcGh5c2ljYWwK K2RldmljZSBvciBmaWxlLiAgTGludXggYW5kIE5ldEJTRCBibG9jayBob3RwbHVnIHNjcmlwdHMg KnNob3VsZCogYWxzbword3JpdGUgdGhpcyBub2RlLgorCitGb3IgdGhlIHRpbWUgYmVpbmcsIExp bnV4IGFuZCBOZXRCU0QgYmxvY2sgaG90cGx1ZyBzY3JpcHRzIG11c3Qgd3JpdGUKKyIkWEVOQlVT X1BBVEgvcGh5c2ljYWwtZGV2aWNlIiB3aXRoIHRoZSBkZXZpY2UncyBtYWpvciBhbmQgbWlub3IK K251bWJlcnMsIHdyaXR0ZW4gaW4gaGV4LCBhbmQgc2VwYXJhdGVkIGJ5IGEgY29sb24uCisKK1Nj cmlwdHMgd2hpY2ggaW5jbHVkZSBibG9jay1jb21tb24uc2ggY2FuIHNpbXBseSBjYWxsIHdyaXRl X2RldiAiJGRldiIKK3dpdGggYSBwYXRoIHRvIHRoZSBkZXZpY2UsIGFuZCB3cml0ZV9kZXYgd2ls bCBkbyB0aGUgcmlnaHQgdGhpbmcsIG5vdworYW5kIGdvaW5nIGZvcndhcmQuICAoU2VlIHRoZSBk aXNjdXNzaW9uIGJlbG93LikKKworUmF0aW9uYWxlIGFuZCBmdXR1cmUgd29yaworLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLQorCitIaXN0b3JpY2FsbHksIHRoZSBibG9jayBzY3JpcHRzIHdyb3Rl IGEgbm9kZSBjYWxsZWQgInBoeXNpY2FsLWRldmljZSIsCit3aGljaCBjb250YWlucyB0aGUgbWFq b3IgYW5kIG1pbm9yIG51bWJlcnMsIHdyaXR0ZW4gaW4gaGV4LCBhbmQKK3NlcGFyYXRlZCBieSBh IGNvbG9uIChlLmcuLCAiMWE6MiIpLiAgVGhpcyBpcyByZXF1aXJlZCBieSB0aGUgTGludXgKK2Js a2JhY2sgZHJpdmVyLgorCitGcmVlQlNEIGJsa2JhY2ssIG9uIHRoZSBvdGhlciBoYW5kLCBkb2Vz IG5vdCBoYXZlIHRoZSBjb25jZXB0IG9mCittYWpvci9taW5vciBudW1iZXJzLCBhbmQgY2FuIGdp dmUgZGlyZWN0IGFjY2VzcyB0byBhIGZpbGUgd2l0aG91dAorZ29pbmcgdGhyb3VnaCBsb29wYmFj azsgc28gaXRzIGRyaXZlciB3aWxsIGNvbnN1bWUKK3BoeXNpY2FsLWRldmljZS1wYXRoLgorCitP biBMaW51eCwgdGhlIGRldmljZSBtb2RlbCAocWVtdSkgbmVlZHMgYWNjZXNzIHRvIGEgZmlsZSBp dCBjYW4KK2ludGVycHJldCB0byBwcm92aWRlIGVtdWxhdGVkIGRpc2tzIGJlZm9yZSBwYXJhdmly dHVhbGl6ZWQgZHJpdmVycyBhcmUKK21hcmtlZCBhcyB1cC4gIFRoZSBlYXNpZXN0IHdheSB0byBh Y2NvbXBsaXNoIHRoaXMgaXMgdG8gYWxsb3cgcWVtdSB0bworY29uc3VtZSBwaHlzaWNhbC1kZXZp Y2UtcGF0aCAocmF0aGVyIHRoYW4sIHNheSwgaGF2aW5nIGRvbTAgYWN0IGFzCitib3RoIGEgZnJv bnRlbmQgYW5kIGEgYmFja2VuZCkuCisKK0dvaW5nIGZvcndhcmQsIHRoZSBwbGFuIGlzIGF0IHNv bWUgcG9pbnQgdG8gaGF2ZSBhbGwgYmxvY2sgc2NyaXB0cworc2ltcGx5IHdyaXRlICJwaHlzaWNh bC1kZXZpY2UtcGF0aCIsIGFuZCB0aGVuIGhhdmUgbGlieGwgd3JpdGUgdGhlCitvdGhlciBub2Rl cy4gIFRoZSByZWFzb24gd2UgaGF2ZW4ndCBkb25lIHRoaXMgeWV0IGlzIHRoYXQgdGhlIG1haW4K K2Jsb2NrIHNjcmlwdCB3YW50cyB0byBjaGVjayB0byBtYWtlIHN1cmUgdGhlICptYWpvci9taW5v ciogbnVtYmVyCitoYXNuJ3QgYmVlbiByZS11c2VkLCByYXRoZXIgdGhhbiBqdXN0IGNoZWNraW5n IHRoYXQgdGhlICpzcGVjaWZpYworZGV2aWNlIG5vZGUqIGlzbid0IHJlLXVzZWQuICBUbyBkbyB0 aGlzIGl0IGN1cnJlbnRseSB1c2VzCitwaHlzaWNhbC1kZXZpY2U7IGFuZCB0byBkbyB0aGlzICpz YWZlbHkqIGl0IG5lZWRzIHBoeXNpY2FsLWRldmljZSB0bworYmUgd3JpdHRlbiB3aXRoIHRoZSBs b2NrIGhlbGQuCisKK1RoZSBzaW1wbGVzdCBzb2x1dGlvbiBmb3Igc29ydGluZyB0aGlzIG91dCB3 b3VsZCBiZSB0byBoYXZlIHRoZSBibG9jaworc2NyaXB0IHVzZSBwaHlzaWNhbC1kZXZpY2UgaWYg aXQncyBwcmVzZW50LCBidXQgaWYgbm90LCB0byBkaXJlY3RseQorc3RhdCBwaHlzaWNhbC1kZXZp Y2UtcGF0aC4gIEJ1dCB0aGVyZSdzIG5vdCB0aW1lIGJlZm9yZSB0aGUgNC43CityZWxlYXNlIHRv IG1ha2Ugc3VyZSBhbGwgdGhhdCB3b3Jrcy4KKworQW5vdGhlciBwb3NzaWJpbGl0eSB3b3VsZCBi ZSB0byBvbmx5IGNhbGwgb3V0IHRvIHNjcmlwdHMgd2hlbiB1c2luZworY3VzdG9tIGhvdHBsdWcg c2NyaXB0czsgYW5kIHdoZW4gZG9pbmcgZmlsZXMgb3IgcGh5c2ljYWwgZGV2aWNlcywgdG8KK2Rv IHRoZSBkdXBsaWNhdGUgY2hlY2tpbmcgaW5zaWRlIG9mIGxpYnhsIGluc3RlYWQuICBUaGUgcmF0 aW9uYWxlIGZvcgorZG9pbmcgdGhpcyBpbiBibG9jayBzY3JpcHRzIHJhdGhlciB0aGFuIGluIGxp YnhsIGlzbid0IGNsZWFyIGF0IHRoZXMKK3BvaW50LgotLSAKMi4xLjQKCgpfX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fXwpYZW4tZGV2ZWwgbWFpbGluZyBsaXN0 Clhlbi1kZXZlbEBsaXN0cy54ZW4ub3JnCmh0dHA6Ly9saXN0cy54ZW4ub3JnL3hlbi1kZXZlbAo=