From mboxrd@z Thu Jan 1 00:00:00 1970 From: Paul Durrant Subject: [PATCH v2] docs/designs: PV stats interface Date: Thu, 26 Jan 2017 10:35:13 +0000 Message-ID: <1485426913-12738-1-git-send-email-paul.durrant@citrix.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from mail6.bemta5.messagelabs.com ([195.245.231.135]) by lists.xenproject.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cWhOg-0000kc-SL for xen-devel@lists.xenproject.org; Thu, 26 Jan 2017 10:35:18 +0000 List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Errors-To: xen-devel-bounces@lists.xen.org Sender: "Xen-devel" To: xen-devel@lists.xenproject.org Cc: Andrew Cooper , Paul Durrant , Jan Beulich List-Id: xen-devel@lists.xenproject.org VGhpcyBwYXRjaCBpbnRyb2R1Y2VzIGEgZGVzaWduIHByb3Bvc2FsIGZvciBhbiBpbnRlcmZhY2Ug dG8gYmUgdXNlZCBieQpndWVzdCBQViBkcml2ZXJzIG9yIGFnZW50cyB0byBjb252ZXkgc3RhdGlz dGljcyB0byBhIG1vbml0b3JpbmcgYWdlbnQKcnVubmluZyBpbiBhIHRvb2xzdGFjayBkb21haW4u CgpTaWduZWQtb2ZmLWJ5OiBQYXVsIER1cnJhbnQgPHBhdWwuZHVycmFudEBjaXRyaXguY29tPgot LS0KQ2M6IEphbiBCZXVsaWNoIDxqYmV1bGljaEBzdXNlLmNvbT4KQ2M6IEFuZHJldyBDb29wZXIg PGFuZHJldy5jb29wZXIzQGNpdHJpeC5jb20+Cgp2MjoKLSBQcm90b2NvbCBjaGFuZ2VzIG1hZGUg ZHVyaW5nIFBvQyBpbXBsZW1lbnRhdGlvbgotIE1hZGUgZXZlbnQtY2hhbm5lbCBvcHRpb25hbCB0 byBhbGxvdyBmb3IgJ2ZyZWUgcnVubmluZycgc2V0cyAoc3VnZ2VzdGVkCiAgYnkgQW5kcmV3KS4K LSBBZGRyZXNzZWQgc29tZSBjb21tZW50cyBmcm9tIEphbgotLS0KIGRvY3MvZGVzaWducy9wdl9z dGF0cy5tYXJrZG93biB8IDEzNCArKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysr KysrKwogMSBmaWxlIGNoYW5nZWQsIDEzNCBpbnNlcnRpb25zKCspCiBjcmVhdGUgbW9kZSAxMDA3 NTUgZG9jcy9kZXNpZ25zL3B2X3N0YXRzLm1hcmtkb3duCgpkaWZmIC0tZ2l0IGEvZG9jcy9kZXNp Z25zL3B2X3N0YXRzLm1hcmtkb3duIGIvZG9jcy9kZXNpZ25zL3B2X3N0YXRzLm1hcmtkb3duCm5l dyBmaWxlIG1vZGUgMTAwNzU1CmluZGV4IDAwMDAwMDAuLmI3OTYxY2IKLS0tIC9kZXYvbnVsbAor KysgYi9kb2NzL2Rlc2lnbnMvcHZfc3RhdHMubWFya2Rvd24KQEAgLTAsMCArMSwxMzQgQEAKKyMg U3RhdGlzdGljcyBJbnRlcmZhY2UgZm9yIFBWIERyaXZlcnMvQWdlbnRzCisKKyMjIEJhY2tncm91 bmQKKworSXQgaXMgY29tbW9uIGZvciBndWVzdCBQViBkcml2ZXJzIG9yIGFnZW50cyB0byBjb21t dW5pY2F0ZSBzdGF0aXN0aWNzIHRvIGFuCithZ2VudCBydW5uaW5nIGluIGEgdG9vbHN0YWNrIGRv bWFpbiBzbyB0aGF0IHRoZXNlIGNhbiBiZSBkaXNwbGF5ZWQgdmlhIGEgVUksCitvciBldmVuIGlu Zmx1ZW5jZSBndWVzdCBwbGFjZW1lbnQgZXRjLiBUaGUgbWVjaGFuaXNtIGZvciBjb252ZXlpbmcg dGhlc2UKK3N0YXRpc3RpY3MgaXMgY3VycmVudGx5IGFkLWhvYywgdW5kb2N1bWVudGVkLCBhbmQg dXN1YWxseSBiYXNlZCBvbiB4ZW5zdG9yZS4KKworV2hpbHN0IHhlbnN0b3JlIGRvZXMgaW5kZWVk IHByb3ZpZGUgYSBjb252ZW5pZW50IG1lY2hhbmlzbSwgdGhlIGxhY2sgb2YKK2RvY3VtZW50YXRp b24gYW5kIHN0YW5kYXJkaXNhdGlvbiBvZiB0aGUgcHJvdG9jb2xzIHVzZWQgY3JlYXRlcworY29t cGF0aWJpbGl0eSBpc3N1ZXMgZm9yIFBWIGRyaXZlcnMgb3IgYWdlbnRzIG5vdCB0aWVkIHRvIGEg c3BlY2lmaWMKK3Byb2R1Y3Qgb3IgZW52aXJvbm1lbnQuIEFsc28sIHRoZSBndWVzdCB4ZW5zdG9y ZSBxdW90YSBhbmQgdGhlIHNpbmdsZQoraW5zdGFuY2Ugb2YgeGVuc3RvcmVkIGNhbiBlYXNpbHkg YmVjb21lIHNjYWxhYmlsaXR5IGlzc3Vlcy4KKworIyMgUHJvcG9zYWwKKworVGhlIHByb3Bvc2Vk IGludGVyZmFjZSBpcyBpbnRlbmRlZCB0byBiZSB1c2VkIG9ubHkgZm9yIHRoZSBwdXJwb3NlcyBv ZgorY29udmV5aW5nIHN0YXRpc3RpY3MgZnJvbSBndWVzdCBQViBkcml2ZXJzIG9yIGFnZW50cyB0 byBhbiBhZ2VudCBvciBhZ2VudHMKK3J1bm5pbmcgaW4gYSB0b29sc3RhY2sgZG9tYWluLiBJdCBp cyBub3QgaW50ZW5kZWQgZm9yIGJ1bGsgZGF0YSB0cmFuc2ZlciwKK25vciBhcyBhbm90aGVyIG1l YW5zIG9mIGNvbnRyb2wgb2YgdGhlIFBWIGRyaXZlcnMgb3IgYWdlbnRzIGJ5IHRoZQordG9vbHN0 YWNrIGRvbWFpbi4gSXQgaXMgYWxzbyBhc3N1bWVkIHRoYXQgc29mdHdhcmUgcnVubmluZyBpbiB0 aGUgdG9vbHN0YWNrCitkb21haW4gd2lsbCBlbnN1cmUgdGhhdCBvbmx5IGEgc2luZ2xlIGluc3Rh bmNlIG9mIGFuIGFnZW50IHdpbGwgYXR0ZW1wdCB0bworbW9uaXRvciBhIHNldCBvZiBzdGF0aXN0 aWNzOyB0aGUgcHJvdG9jb2wgaXMgbm90IGludGVuZGVkIHRvIGhhbmRsZQorbXVsdGlwbGUgbW9u aXRvcmluZyBhZ2VudHMuCisKK1BWIGRyaXZlcnMgb3IgYWdlbnRzIHR5cGljYWxseSBwdWJsaXNo IG11bHRpcGxlIHJlbGF0ZWQgc2V0cyBvZiBzdGF0aXN0aWNzLgorRm9yIGV4YW1wbGUsIGEgUFYg bmV0d29yayBmcm9udGVuZCBtYXkgcHVibGlzaCBzdGF0aXN0aWNzIHJlbGF0aW5nIHRvCityZWNl aXZlZCB0cmFmZmljIGFuZCB0cmFuc21pdHRlZCB0cmFmZmljLiBUaGVzZSBzZXRzIGFyZSBsaWtl bHkgdG8gYmUKK3VwZGF0ZWQgYXN5bmNocm9ub3VzbHkgZnJvbSBlYWNoIG90aGVyIGFuZCB0aGVy ZWZvcmUgaXQgbWFrZXMgc2Vuc2UgdGhhdAordGhleSBjYW4gYmUgc2VwYXJhdGVkIHN1Y2ggdGhh dCBhIG1vbml0b3JpbmcgYWdlbnQgY2FuIHJlZnJlc2ggaXRzIHZpZXcgb2YKK3RoZW0gYXN5bmNo cm9ub3VzbHkuIEl0IGlzIHRoZXJlZm9yZSBwcm9wb3NlZCB0aGF0IGEgdHdvLWxldmVsIGhpZXJh cmNoeSBvZgoreGVuc3RvcmUga2V5cyBpcyB1c2VkIHRvIGFkdmVydGlzZSBzZXRzIG9mIGd1ZXN0 IHN0YXRpc3RpY3MuCisKK1RoZSB0b29sc3RhY2sgd2lsbCBjcmVhdGUgYSB3cml0ZWFibGUgdG9w LWxldmVsIGBzdGF0c2Aga2V5IGluIHRoZSBndWVzdAorc3BhY2UuIFVuZGVyIHRoaXMgZWFjaCBn dWVzdCBzdGF0aXN0aWNzICpwcm92aWRlciogY3JlYXRlcyBhIGtleSBpdHMgbmFtZSwKK2UuZy4g YHZpZjBgLiBUaGlzIGtleSBhY3RzIGFzIGEgcGFyZW50IHRvIGtleXMgdGhhdCB0aGVuIG5hbWUg ZWFjaAorc2V0IG9mIHN0YXRpc3RpY3MgdGhhdCBpdCBwcm92aWRlcywgZS5nLiBgdHhgLgorCitJ ZiBhbiBhZ2VudCBydW5uaW5nIGluIHRoZSB0b29sc3RhY2sgZG9tYWluIHdpc2hlcyB0byBtb25p dG9yIHRoZSBzZXQgb2YKK3N0YXRpc3RpY3MsIGl0IG11c3Qgd3JpdGUgaXRzIGRvbWlkIHVuZGVy IHRoZSBrZXkgZS5nLjoKKworICAgIG1vbml0b3ItaWQgPSAwCisKK1RoZSBwcm92aWRlciBzaG91 bGQgc2V0IHVwIGEgd2F0Y2ggc28gdGhhdCBpdCBpcyBub3RpZmllZCB3aGVuIHRoaXMga2V5Citp cyB3cml0dGVuLiBJdCB0aGVuIHJlc3BvbmRzIGJ5IHdyaXRpbmcga2V5cyBjb250YWluaW5nIGdy YW50IHJlZmVyZW5jZXMKK29mIHBhZ2VzIGNvbnRhaW5pbmcgdGhlIG5hbWVzIGFuZCB2YWx1ZXMg b2YgdGhlIHN0YXRpc3RpY3MgaW4gdGhhdCBzZXQsIGFuZAorYW4gb3B0aW9uYWwgZXZlbnQgY2hh bm5lbCB0byBiZSB1c2VkIGZvciBzaWduYWxsaW5nIGUuZy46CisKKyAgICBuYW1lLXR5cGUtcmVm MCA9IDEwCisgICAgbmFtZS10eXBlLXJlZjEgPSAxMQorICAgIHZhbC1yZWYwID0gMTIKKyAgICB2 YWwtcmVmMSA9IDEzCisgICAgZXZlbnQtY2hhbm5lbCA9IDEwCisKK0ZpbmFsbHkgdGhlIHByb3Zp ZGVyIHNob3VsZCB3cml0ZToKKworICAgIHJlYWR5ID0gMQorCitUaGUgcHJvdmlkZXIgbXVzdCBh bHdheXMgd3JpdGUgdGhlIGByZWFkeWAga2V5IGFmdGVyIGFsbCB0aGUgb3RoZXIKK2tleXMgaGF2 ZSBiZWVuIHdyaXR0ZW4gc3VjaCB0aGF0IGEgbW9uaXRvcmluZyBhZ2VudCBjYW4ga25vdyB3aGVu IGl0IGlzCitzYWZlIHRvIHNhbXBsZSB0aGUgb3RoZXIga2V5cy4KKworVGhlcmUgYXJlIHNlcGFy YXRlIHJlZmVyZW5jZXMgZm9yIHBhZ2VzIGNvbnRhaW5pbmcgdGhlIG5hbWVzIGFuZCB0eXBlcyBv ZgordGhlIHN0YXRpc3RpY3MgYW5kIHRoZSB2YWx1ZXMgb2YgdGhvc2Ugc3RhdGlzdGljcyBzaW5j ZSBpdCBpcyByZXF1aXJlZCB0aGF0Cit0aGUgbmFtZXMgYW5kIHR5cGVzIGRvIG5vdCBjaGFuZ2Ug YW5kIGhlbmNlIGEgbW9uaXRvcmluZyBhZ2VudCBuZWVkIG9ubHkKK3NhbXBsZSB0aGVtIG9uY2Ug YW5kIGNhbiBkbyBzbyBhcyBzb29uIGFzIHRoZSBhcyB0aGUgYG5hbWUtdHlwZS1yZWZgIGtleXMK K2FyZSB2YWxpZC4gVGhlIGZvcm1hdCBvZiBlYWNoICgqbmFtZSwgdHlwZSopIHR1cGxlIGlzIGFz IGZvbGxvd3M6CisKKyAgICBzdHJ1Y3Qgc3RhdHNfbmFtZV90eXBlIHsKKwl1aW50OF90IHR5cGU7 CisJY2hhciBuYW1lWzYzXTsKKyAgICB9OworCithbmQgdGhlIHBvc3NpYmxlIHR5cGVzIGFyZToK KworICAgICNkZWZpbmUgU1RBVFNfVFlQRV9JTlZBTElECTAKKyAgICAjZGVmaW5lIFNUQVRTX1RZ UEVfUzY0CQkxCisgICAgI2RlZmluZSBTVEFUU19UWVBFX1U2NAkJMgorICAgICNkZWZpbmUgU1RB VFNfVFlQRV9ET1VCTEUJMworICAgICNkZWZpbmUgU1RBVFNfVFlQRV9BU0NJSQk0CisKK1RoZSBg bmFtZWAgbXVzdCBiZSBhIE5VTCB0ZXJtaW5hdGVkIEFTQ0lJIHN0cmluZyBjb250YWluaW5nIG9u bHkKK2FscGhhbnVtZXJpYyBjaGFyYWN0ZXJzLCBwcmludGFibGUgbm9uLWFscGhhbnVtZXJpYyBj aGFyYWN0ZXJzIG9yIGEgc3BhY2UKK2NoYXJhY3RlciwgaS5lLiB0aGUgQyBleHByZXNzaW9uOgor CisgICAgKGlzYWxudW0obmFtZVtpXSkgfHwgaXNwdW5jdChuYW1lW2ldKSB8fCBuYW1lW2ldID09 ICcgJykKKworbXVzdCBiZSB0cnVlIGZvciBlYWNoIHZhbHVlIG9mIGBpYCB1bnRpbCBgbmFtZVtp XSA9PSAnXDAnYCAoYXNzdW1pbmcgdGhlICdDJworbG9jYWxlKS4KKworV2hlbiBpdGVyYXRpbmcg dGhyb3VnaCB0aGUgYHN0YXRzX25hbWVfdHlwZWAgc3RydWN0dXJlcyBhIG1vbml0b3JpbmcgYWdl bnQKK2NhbiBkZXRlcm1pbmUgdGhhdCBpdCBoYXMgZmluaXNoZWQgd2hlbiBpdCBlaXRoZXIgZW5j b3VudGVycyBhIGB0eXBlYCB2YWx1ZQorb2YgYFNUQVRTX1RZUEVfSU5WQUxJRGAsIG9yIGl0IGhh cyBpdGVyYXRlZCB0aHJvdWdoIGFsbCA2NCBzdHJ1Y3R1cmVzIGluIHRoZQorIGdyYW50ZWQgcGFn ZSBhbmQgdGhlcmUgYXJlIG5vIGZ1cnRoZXIgYG5hbWUtdHlwZS1yZWZgIGtleXMuCisKK0EgbW9u aXRvcmluZyBhZ2VudCBjYW4gZmluZCB0aGUgdmFsdWUgb2YgYSBzdGF0aXN0aWMgYnkgbm90aW5n IHRoZQorYG5hbWUtdHlwZS1yZWZgIGluZGV4IGFuZCB0aGUgb2Zmc2V0IGludG8gdGhlIHBhZ2Ug d2hlcmUgdGhlCitgc3RhdHNfbmFtZV90eXBlYCB3YXMgZm91bmQgYW5kIHRoZSBsb29raW5nIGF0 IHRoZSBzYW1lIG9mZnNldCBpbiB0aGUKK2NvcnJlc3BvbmRpbmcgYHZhbC1yZWZgIHBhZ2UuIFZh bHVlcyBhcmUgdGhlcmVmb3JlIGFsc28gNjQgb2N0ZXRzCitpbiBsZW5ndGggYW5kIGNvbnRhaW46 CisKKyogYFNUQVRTX1RZUEVfUzY0YCA6IEEgc2lnbmVkIDY0LWJpdCBpbnRlZ2VyIGluIGxpdHRs ZSBlbmRpYW4gZm9ybSBpbgorCQkgICAgIG9jdGV0cyAwLi43CisqIGBTVEFUU19UWVBFX1U2NGAg OiBBbiB1bnNpZ25lZCA2NC1iaXQgaW50ZWdlciBpbiBsaXR0bGUgZW5kaWFuIGZvcm0gaW4KKwkJ ICAgICBvY3RldHMgMC4uNworKiBgU1RBVFNfVFlQRV9ET1VCTEVgIDogQSBkb3VibGUgcHJlY2lz aW9uIGZsb2F0aW5nIHBvaW50IHZhbHVlIGluIGxpdHRsZQorCQkJZW5kaWFuIGZvcm0gaW4KKwkJ CW9jdGV0cyAwLi43CisqIGBTVEFUU19UWVBFX0FTQ0lJYCA6IEEgTlVMIHRlcm1pbmF0ZWQgQVND SUkgc3RyaW5nIG1lZXRpbmcgdGhlIHNhbWUKKwkJICAgICAgIGNyaXRlcmlhIGFzIGBuYW1lYAor CitJZiB0aGUgc3RhdGlzdGljcyBwcm92aWRlciB3cm90ZSBhbiBgZXZlbnQtY2hhbm5lbGAga2V5 IHRoZW4gaXQgc2hvdWxkCitub3QgdXBkYXRlIGFueSBvZiB0aGUgc3RhdGlzdGljcyBpbiBhIHNl dCB1bnRpbCB0aGUgYGV2ZW50LWNoYW5uZWxgIGlzCitzaWduYWxsZWQgaW5kaWNhdGluZyB0aGF0 IGEgbW9uaXRvcmluZyBhZ2VudCB3aXNoZXMgdG8gc2FtcGxlIHRoZW0uCitXaGVuIHN1Y2ggYSBz aWduYWwgaXMgcmVjZWl2ZWQsIGFsbCBzdGF0aXN0aWNzIGluIHRoZSBzZXQgc2hvdWxkIGJlCit1 cGRhdGVkIGluIGEgY29uc2lzdGVudCBtYW5uZXIgYW5kIGEgc2lnbmFsIHNlbnQgYmFjayB0byB0 aGUgbW9uaXRvcmluZworYWdlbnQgdmlhIHRoZSBgZXZlbnQtY2hhbm5lbGAgdG8gc2F5IHRoYXQg dGhlIHVwZGF0ZSBpcyBjb21wbGV0ZS4gVGhlCittb25pdG9yaW5nIGFnZW50IGNhbiB0aGVuIHNh bXBsZSB0aGUgd2hvbGUgc2V0LgorCitJZiB0aGUgc3RhdGlzdGljcyBwcm92aWRlciBkaWQgbm90 IHdyaXRlIGFuIGBldmVudC1jaGFubmVsYCBrZXkgdGhlbiB0aGUKK3N0YXRzdGljcyBhcmUgY29u c2lkZXJlZCAqZnJlZSBydW5uaW5nKiBpLmUuIHRoZXJlIGlzIG5vIGV4cGVjdGF0aW9uIG9mCitj b25zaXN0ZW5jeSBiZXR3ZWVuIHRoZSB2YWx1ZXMgYW5kIGEgbW9uaXRvcmluZyBhZ2VudCBpcyBh dCBsaWJlcnR5IHRvCitzYW1wbGUgYW4gYXJiaXRyYXJ5IHN1YnNldCBhdCBhbnkgdGltZS4KKwor V2hlbiBhIHByb3ZpZGVyIHdpc2hlcyB0byB3aXRoZHJhdyBhIHNldCBvZiBzdGF0aXN0aWNzLCBl LmcuIHdoZW4gaXQgaXMKK3NodXR0aW5nIGRvd24sIGl0IG5vdGlmaWVzIGEgbW9uaXRvcmluZyBh Z2VudCBieSByZW1vdmluZyB0aGUgYHJlYWR5YCBrZXkKK2Zyb20geGVuc3RvcmUuIFRodXMgYSBt b25pdG9yaW5nIGFnZW50IG11c3QgbWFpbnRhaW4gYSB3YXRjaCBvbiB0aGF0IGtleQorYW5kIHJl c3BvbmQgaW4gYSB0aW1lbHkgbWFubmVyIGJ5IGNsb3NpbmcgYW55IGV2ZW50IGNoYW5uZWwgYW5k IHJlbGVhc2luZworYWxsIGdyYW50IHJlZmVyZW5jZXMgKHdoaWNoIGl0IG1heSBoYXZlIG1hcHBl ZCkuCitPbmNlIHRoZSBhZ2VudCBoYXMgZG9uZSB0aGlzLCBpdCBtdXN0IHJlbW92ZSBpdHMgYG1v bml0b3ItaWRgIGtleSBzbyB0aGF0Cit0aGUgcHJvdmlkZXIgY2FuIGNsb3NlIGFueSBldmVudCBj aGFubmVsLCByZXZva2UgYWxsIGdyYW50cyBhbmQgcmVtb3ZlIHRoZQorcmVtYWluaW5nIGtleXMg Y29ycmVzcG9uZGluZyB0byB0aGUgc2V0LiBXaGVuIHRoZSBwcm92aWRlciBpcyBubyBsb25nZXIK K2FkdmVydGlzaW5nIGFueSBzZXRzIGl0IGNhbiB0aGVuIHJlbW92ZSBpdHMgdG9wLWxldmVsIGtl eS4KLS0gCjIuMS40CgoKX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX18KWGVuLWRldmVsIG1haWxpbmcgbGlzdApYZW4tZGV2ZWxAbGlzdHMueGVuLm9yZwpodHRw czovL2xpc3RzLnhlbi5vcmcveGVuLWRldmVsCg==