From mboxrd@z Thu Jan 1 00:00:00 1970 From: Joao Martins Subject: Re: [DRAFT 1] XenSock protocol design document Date: Mon, 11 Jul 2016 15:51:37 +0100 Message-ID: <5783B279.3050801@oracle.com> References: Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from mail6.bemta6.messagelabs.com ([85.158.143.247]) by lists.xenproject.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bMcXi-0001Un-Qh for xen-devel@lists.xenproject.org; Mon, 11 Jul 2016 14:50:42 +0000 In-Reply-To: List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Errors-To: xen-devel-bounces@lists.xen.org Sender: "Xen-devel" To: Stefano Stabellini Cc: jgross@suse.com, lars.kurth@citrix.com, wei.liu2@citrix.com, david.vrabel@citrix.com, xen-devel@lists.xenproject.org, boris.ostrovsky@oracle.com, roger.pau@citrix.com List-Id: xen-devel@lists.xenproject.org T24gMDcvMDgvMjAxNiAxMjoyMyBQTSwgU3RlZmFubyBTdGFiZWxsaW5pIHdyb3RlOgo+IEhpIGFs bCwKPiAKSGV5IQoKWy4uLl0KCj4gCj4gIyMgRGVzaWduCj4gCj4gIyMjIFhlbnN0b3JlCj4gCj4g VGhlIGZyb250ZW5kIGFuZCB0aGUgYmFja2VuZCBjb25uZWN0IHRvIGVhY2ggb3RoZXIgZXhjaGFu Z2luZyBpbmZvcm1hdGlvbiB2aWEKPiB4ZW5zdG9yZS4gVGhlIHRvb2xzdGFjayBjcmVhdGVzIGZy b250IGFuZCBiYWNrIG5vZGVzIHdpdGggc3RhdGUKPiBYZW5idXNTdGF0ZUluaXRpYWxpc2luZy4g VGhlcmUgY2FuIG9ubHkgYmUgb25lIFhlblNvY2sgZnJvbnRlbmQgcGVyIGRvbWFpbi4KPiAKPiAj IyMjIEZyb250ZW5kIFhlbkJ1cyBOb2Rlcwo+IAo+IHBvcnQKPiAgICAgIFZhbHVlczogICAgICAg ICA8dWludDMyX3Q+Cj4gCj4gICAgICBUaGUgaWRlbnRpZmllciBvZiB0aGUgWGVuIGV2ZW50IGNo YW5uZWwgdXNlZCB0byBzaWduYWwgYWN0aXZpdHkKPiAgICAgIGluIHRoZSByaW5nIGJ1ZmZlci4K PiAKPiByaW5nLXJlZgo+ICAgICAgVmFsdWVzOiAgICAgICAgIDx1aW50MzJfdD4KPiAKPiAgICAg IFRoZSBYZW4gZ3JhbnQgcmVmZXJlbmNlIGdyYW50aW5nIHBlcm1pc3Npb24gZm9yIHRoZSBiYWNr ZW5kIHRvIG1hcAo+ICAgICAgdGhlIHNvbGUgcGFnZSBpbiBhIHNpbmdsZSBwYWdlIHNpemVkIHJp bmcgYnVmZmVyLgoKV291bGQgaXQgbWFrZSBzZW5zZSB0byBleHBvcnQgbWluaW11bSwgZGVmYXVs dCBhbmQgbWF4aW11bSBzaXplIG9mIHRoZSBzb2NrZXQgb3Zlcgp4ZW5zdG9yZSBlbnRyaWVzPyBJ dCBub3JtYWxseSBmb2xsb3dzIGEgY29udmVudGlvbiBkZXBlbmRpbmcgb24gdGhlIHR5cGUgb2Yg c29ja2V0CihhbmQgT1MpIHlvdSBoYXZlLCBvciB0aGVuIHRocm91Z2ggc2V0dGFibGVzIG9uIHNv Y2tldCBvcHRpb25zLgoKCj4gIyMjIENvbW1hbmRzIFJpbmcKPiAKPiBUaGUgc2hhcmVkIHJpbmcg aXMgdXNlZCBieSB0aGUgZnJvbnRlbmQgdG8gZm9yd2FyZCBzb2NrZXQgQVBJIGNhbGxzIHRvIHRo ZQo+IGJhY2tlbmQuIEknbGwgcmVmZXIgdG8gdGhpcyByaW5nIGFzICoqY29tbWFuZHMgcmluZyoq IHRvIGRpc3Rpbmd1aXNoIGl0IGZyb20KPiBvdGhlciByaW5ncyB3aGljaCB3aWxsIGJlIGNyZWF0 ZWQgbGF0ZXIgaW4gdGhlIGxpZmVjeWNsZSBvZiB0aGUgcHJvdG9jb2wgKGRhdGEKPiByaW5ncyku IFRoZSByaW5nIGZvcm1hdCBpcyBkZWZpbmVkIHVzaW5nIHRoZSBmYW1pbGlhciBgREVGSU5FX1JJ TkdfVFlQRVNgIG1hY3JvCj4gKGB4ZW4vaW5jbHVkZS9wdWJsaWMvaW8vcmluZy5oYCkuIEZyb250 ZW5kIHJlcXVlc3RzIGFyZSBhbGxvY2F0ZWQgb24gdGhlIHJpbmcKPiB1c2luZyB0aGUgYFJJTkdf R0VUX1JFUVVFU1RgIG1hY3JvLgo+IAo+IFRoZSBmb3JtYXQgaXMgZGVmaW5lZCBhcyBmb2xsb3dz Ogo+IAo+ICAgICAjZGVmaW5lIFhFTlNPQ0tfREFUQVJJTkdfT1JERVIgNgo+ICAgICAjZGVmaW5l IFhFTlNPQ0tfREFUQVJJTkdfUEFHRVMgKDEgPDwgWEVOU09DS19EQVRBUklOR19PUkRFUikKPiAg ICAgI2RlZmluZSBYRU5TT0NLX0RBVEFSSU5HX1NJWkUgKFhFTlNPQ0tfREFUQVJJTkdfUEFHRVMg PDwgUEFHRV9TSElGVCkKPiAgICAgCj4gICAgICNkZWZpbmUgWEVOU09DS19DT05ORUNUICAgICAg ICAwCj4gICAgICNkZWZpbmUgWEVOU09DS19SRUxFQVNFICAgICAgICAzCj4gICAgICNkZWZpbmUg WEVOU09DS19CSU5EICAgICAgICAgICA0Cj4gICAgICNkZWZpbmUgWEVOU09DS19MSVNURU4gICAg ICAgICA1Cj4gICAgICNkZWZpbmUgWEVOU09DS19BQ0NFUFQgICAgICAgICA2Cj4gICAgICNkZWZp bmUgWEVOU09DS19QT0xMICAgICAgICAgICA3Cj4gICAgIAo+ICAgICBzdHJ1Y3QgeGVuX3hlbnNv Y2tfcmVxdWVzdCB7Cj4gICAgICAgICB1aW50MzJfdCBpZDsgICAgIC8qIHByaXZhdGUgdG8gZ3Vl c3QsIGVjaG9lZCBpbiByZXNwb25zZSAqLwo+ICAgICAgICAgdWludDMyX3QgY21kOyAgICAvKiBj b21tYW5kIHRvIGV4ZWN1dGUgKi8KPiAgICAgICAgIHVpbnQ2NF90IHNvY2tpZDsgLyogaWQgb2Yg dGhlIHNvY2tldCAqLwo+ICAgICAgICAgdW5pb24gewo+ICAgICAgICAgICAgIHN0cnVjdCB4ZW5f eGVuc29ja19jb25uZWN0IHsKPiAgICAgICAgICAgICAgICAgdWludDhfdCBhZGRyWzI4XTsKPiAg ICAgICAgICAgICAgICAgdWludDMyX3QgbGVuOwo+ICAgICAgICAgICAgICAgICB1aW50MzJfdCBm bGFnczsKPiAgICAgICAgICAgICAgICAgZ3JhbnRfcmVmX3QgcmVmW1hFTlNPQ0tfREFUQVJJTkdf UEFHRVNdOwo+ICAgICAgICAgICAgICAgICB1aW50MzJfdCBldnRjaG47Cj4gICAgICAgICAgICAg fSBjb25uZWN0Owo+ICAgICAgICAgICAgIHN0cnVjdCB4ZW5feGVuc29ja19iaW5kIHsKPiAgICAg ICAgICAgICAgICAgdWludDhfdCBhZGRyWzI4XTsgLyogaXB2NiByZWFkeSAqLwo+ICAgICAgICAg ICAgICAgICB1aW50MzJfdCBsZW47Cj4gICAgICAgICAgICAgfSBiaW5kOwo+ICAgICAgICAgICAg IHN0cnVjdCB4ZW5feGVuc29ja19hY2NlcHQgewo+ICAgICAgICAgICAgICAgICB1aW50NjRfdCBz b2NraWQ7Cj4gICAgICAgICAgICAgICAgIGdyYW50X3JlZl90IHJlZltYRU5TT0NLX0RBVEFSSU5H X1BBR0VTXTsKPiAgICAgICAgICAgICAgICAgdWludDMyX3QgZXZ0Y2huOwo+ICAgICAgICAgICAg IH0gYWNjZXB0Owo+ICAgICAgICAgfSB1Owo+ICAgICB9Owo+IAo+IFRoZSBmaXJzdCB0aHJlZSBm aWVsZHMgYXJlIGNvbW1vbiBmb3IgZXZlcnkgY29tbWFuZC4gVGhlaXIgYmluYXJ5IGxheW91dAo+ IGlzOgo+IAo+ICAgICAwICAgICAgIDQgICAgICAgOCAgICAgICAxMiAgICAgIDE2Cj4gICAgICst LS0tLS0tKy0tLS0tLS0rLS0tLS0tLSstLS0tLS0tKwo+ICAgICB8ICBpZCAgIHwgIGNtZCAgfCAg ICAgc29ja2lkICAgIHwKPiAgICAgKy0tLS0tLS0rLS0tLS0tLSstLS0tLS0tKy0tLS0tLS0rCj4g Cj4gLSAqKmlkKiogaXMgZ2VuZXJhdGVkIGJ5IHRoZSBmcm9udGVuZCBhbmQgaWRlbnRpZmllcyBv bmUgc3BlY2lmaWMgcmVxdWVzdAo+IC0gKipjbWQqKiBpcyB0aGUgY29tbWFuZCByZXF1ZXN0ZWQg YnkgdGhlIGZyb250ZW5kOgo+ICAgICAtIGBYRU5TT0NLX0NPTk5FQ1RgOiAwCj4gICAgIC0gYFhF TlNPQ0tfUkVMRUFTRWA6IDMKPiAgICAgLSBgWEVOU09DS19CSU5EYDogICAgNAo+ICAgICAtIGBY RU5TT0NLX0xJU1RFTmA6ICA1Cj4gICAgIC0gYFhFTlNPQ0tfQUNDRVBUYDogIDYKPiAgICAgLSBg WEVOU09DS19QT0xMYDogICAgNwo+IC0gKipzb2NraWQqKiBpcyBnZW5lcmF0ZWQgYnkgdGhlIGZy b250ZW5kIGFuZCBpZGVudGlmaWVzIHRoZSBzb2NrZXQgdG8gY29ubmVjdCwKPiAgIGJpbmQsIGV0 Yy4gQSBuZXcgc29ja2lkIGlzIHJlcXVpcmVkIG9uIGBYRU5TT0NLX0NPTk5FQ1RgIGFuZCBgWEVO U09DS19CSU5EYAo+ICAgY29tbWFuZHMuIEEgbmV3IHNvY2tpZCBpcyBhbHNvIHJlcXVpcmVkIG9u IGBYRU5TT0NLX0FDQ0VQVGAsIGZvciB0aGUgbmV3Cj4gICBzb2NrZXQuCj4gICAKSW50ZXJlc3Rp bmcgLSBIYXZlIHlvdSBjb25zaWRlciBzZXRzb2Nrb3B0IGFuZCBnZXRzb2Nrb3B0IHRvIGJlIHBh cnQgb2YgdGhpcz8gVGhlcmUKYXJlIHNvbWUgY29tbW9uIG9wdGlvbnMgKGFzIGluIFBPU0lYIGRl ZmluZWQpIGFuZCB0aGVuIHNvbWUgbW9yZSBleG90aWMgZmxhdm9ycyBMaW51eApvciBGcmVlQlNE IHNwZWNpZmljLiBTYXkgU09fUkVVU0VQT1JUIHVzZWQgb24gbmdpbnggdGhhdCBpcyBnb29kIGZv ciBsb2FkIGJhbGFuY2luZwphY3Jvc3MgYSBzZXQgb2Ygd29ya2VycyBvciBMaW51eCBTT19CVVNZ X1BPTEwgZm9yIGxvdyBsYXRlbmN5IHNvY2tldHMuIFRob3VnaCBub3QKc3VyZSBob3cgc2Vuc2li bGUgaXQgaXMgdG8gc3RhcnQgZXhwb3NpbmcgYWxsIG9mIHRoZXNlIHNvY2tldCBvcHRpb25zIGJ1 dCB0byBsaW1pdCB0bwphIHNwZWNpZmljIHN1YnNldD8gT3IgbWF5YmUgZG9lc24ndCBtYWtlIHNl bnNlIGZvciB5b3VyIGNhc2UgLSBzZWUgZnVydGhlciBzdWdnZXN0aW9uCnJlZ2FyZGluZyBkYXRh IHJpbmcgcGFydC4KCj4gQWxsIHRocmVlIGZpZWxkcyBhcmUgZWNob2VkIGJhY2sgYnkgdGhlIGJh Y2tlbmQuCj4gCj4gQXMgZm9yIHRoZSBvdGhlciBYZW4gcmluZyBiYXNlZCBwcm90b2NvbHMsIGFm dGVyIHdyaXRpbmcgYSByZXF1ZXN0IHRvIHRoZSByaW5nLAo+IHRoZSBmcm9udGVuZCBjYWxscyBg UklOR19QVVNIX1JFUVVFU1RTX0FORF9DSEVDS19OT1RJRllgIGFuZCBpc3N1ZXMgYW4gZXZlbnQK PiBjaGFubmVsIG5vdGlmaWNhdGlvbiB3aGVuIGEgbm90aWZpY2F0aW9uIGlzIHJlcXVpcmVkLgo+ IAo+IEJhY2tlbmQgcmVzcG9uc2VzIGFyZSBhbGxvY2F0ZWQgb24gdGhlIHJpbmcgdXNpbmcgdGhl IGBSSU5HX0dFVF9SRVNQT05TRWAgbWFjcm8uCj4gVGhlIGZvcm1hdCBpcyB0aGUgZm9sbG93aW5n Ogo+IAo+ICAgICBzdHJ1Y3QgeGVuX3hlbnNvY2tfcmVzcG9uc2Ugewo+ICAgICAgICAgdWludDMy X3QgaWQ7Cj4gICAgICAgICB1aW50MzJfdCBjbWQ7Cj4gICAgICAgICB1aW50NjRfdCBzb2NraWQ7 Cj4gICAgICAgICBpbnQzMl90IHJldDsKPiAgICAgfTsKPiAgICAKPiAgICAgMCAgICAgICA0ICAg ICAgIDggICAgICAgMTIgICAgICAxNiAgICAgIDIwCj4gICAgICstLS0tLS0tKy0tLS0tLS0rLS0t LS0tLSstLS0tLS0tKy0tLS0tLS0rCj4gICAgIHwgIGlkICAgfCAgY21kICB8ICAgICBzb2NraWQg ICAgfCAgcmV0ICB8Cj4gICAgICstLS0tLS0tKy0tLS0tLS0rLS0tLS0tLSstLS0tLS0tKy0tLS0t LS0rCj4gCj4gLSAqKmlkKio6IGVjaG9lZCBiYWNrIGZyb20gcmVxdWVzdAo+IC0gKipjbWQqKjog ZWNob2VkIGJhY2sgZnJvbSByZXF1ZXN0Cj4gLSAqKnNvY2tpZCoqOiBlY2hvZWQgYmFjayBmcm9t IHJlcXVlc3QKPiAtICoqcmV0Kio6IHJldHVybiB2YWx1ZSwgaWRlbnRpZmllcyBzdWNjZXNzIG9y IGZhaWx1cmUKPiAKQXJlIHRoZXNlIGZpZWxkcyB0YWtlbiBmcm9tIGEgc3BlY2lmaWMgT1MgKEkg YXNzdW1lZCBMaW51eCk/IFByb2JhYmx5IGlkcywgY21kIGFuZApyZXQgc2l6ZSBjb3VsZCBiZSBs ZXNzIGJpZyBvdmVyYWxsIG9yIG1heSBiZSBub3QgLSBpbiB3aGljaCBjYXNlIGNvdWxkIGJlIHVz ZWZ1bApzcGVjaWZ5aW5nIGluIHRoZSBzcGVjIGlmIGl0J3MgZm9sbG93aW5nIGEgc3BlY2lmaWMg T1MuCgpbLi4uXQoKPiBUaGUgZGVzaWduIGlzIGZsZXhpYmxlIGFuZCBjYW4gc3VwcG9ydCBkaWZm ZXJlbnQgcmluZyBzaXplcyAoYXQgY29tcGlsZSB0aW1lKS4KPiBUaGUgZm9sbG93aW5nIGRlc2Ny aXB0aW9uIGlzIGJhc2VkIG9uIG9yZGVyIDYgcmluZ3MsIGNob3NlbiBiZWNhdXNlIHRoZXkgcHJv dmlkZQo+IGV4Y2VsbGVudCBwZXJmb3JtYW5jZS4KPiAKPiAtICoqaW4qKiBpcyBhbiBhcnJheSBv ZiA2NTUzNiBieXRlcywgdXNlZCBhcyBjaXJjdWxhciBidWZmZXIKPiAgIEl0IGNvbnRhaW5zIGRh dGEgcmVhZCBmcm9tIHRoZSBzb2NrZXQuIFRoZSBwcm9kdWNlciBpcyB0aGUgYmFja2VuZCwgdGhl Cj4gICBjb25zdW1lciBpcyB0aGUgZnJvbnRlbmQuCj4gLSAqKm91dCoqIGlzIGFuIGFycmF5IG9m IDEzMTA3MiBieXRlcywgdXNlZCBhcyBjaXJjdWxhciBidWZmZXIKPiAgIEl0IGNvbnRhaW5zIGRh dGEgdG8gYmUgd3JpdHRlbiB0byB0aGUgc29ja2V0LiBUaGUgcHJvZHVjZXIgaXMgdGhlIGZyb250 ZW5kLAo+ICAgdGhlIGNvbnN1bWVyIGlzIHRoZSBiYWNrZW5kLgpDb3VsZCB0aGlzIHNpemUgYmUg YSB0dW5hYmxlIGludGVyY2VwdGluZyBSQ1ZCVUYgYW5kIFNOREJVRiBzb2Nrb3B0IGFkanVzdG1l bnRzCih0aGVzZSB0d28gYXJlIFBPU0lYIGRlZmluZWQpIG9mYyB1bmRlciB0aGUgYXNzdW1wdGlv biB0aGF0IGluIHRoaXMgcHJvcG9zYWwgeW91IHdhbnQKdG8gcmVwbGljYXRlIGxvY2FsIGFuZCBy ZW1vdGUgc29ja2V0PyBJT1cgdG8gZHluYW1pY2FsbHkgYWxsb2NhdGUgaG93IG11Y2ggdGhlIHNv Y2tldAp3aWxsIHVzZSBmb3Igc2VuZGluZy9yZWNlaXZpbmcgd2hpY2ggd291bGQgdHVybiBpbnRv IHRoZSBhbW91bnQgb2YgZ3JhbnRzIGluIHVzZT8KRXZlbiBkb2luZyB3aXRoIHhlbnN0b3JlIGVu dHJpZXMgaW4gdGhlIGJhY2tlbmQgaXMgYmV0dGVyIC0gZXZlbiB0aG91Z2ggdXNlciBtYXkgd2Fu dAp0byBhZGp1c3Qgc2VuZC9yZWNlaXZlIGJ1ZmZlciBmb3Igd2hhdGV2ZXIgYXBsaWNhdGlvbiBu ZWVkcy4gSWRlYWxseSB0aGlzIHdvdWxkIGJlCmR5bmFtaWMgcGVyIHNvY2tldCwgaW5zdGVhZCBv ZiBjb21waWxlLXRpbWUgZGVmaW5lZCAtIGFuZCB3b3VsZCBhbGxvdyBtb3JlIHNvY2tldHMgb24K dGhlIHNhbWUgVk0gd2l0aG91dCBvdmVyc2hvb3RpbmcgdGhlIGdyYW50IHRhYmxlIGxpbWl0cy4K CkpvYW8KCl9fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fClhl bi1kZXZlbCBtYWlsaW5nIGxpc3QKWGVuLWRldmVsQGxpc3RzLnhlbi5vcmcKaHR0cHM6Ly9saXN0 cy54ZW4ub3JnL3hlbi1kZXZlbAo=