From mboxrd@z Thu Jan 1 00:00:00 1970 From: Paul Durrant Subject: [PATCH RFC] docs/designs: PV stats interface Date: Wed, 23 Nov 2016 14:14:27 +0000 Message-ID: <1479910467-464-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.bemta6.messagelabs.com ([193.109.254.103]) by lists.xenproject.org with esmtp (Exim 4.84_2) (envelope-from ) id 1c9YJr-0001mZ-NF for xen-devel@lists.xenproject.org; Wed, 23 Nov 2016 14:14:39 +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: Paul Durrant List-Id: xen-devel@lists.xenproject.org VGhpcyBwYXRjaCBpbnRyb2R1Y2VzIGEgZGVzaWduIHByb3Bvc2FsIGZvciBhbiBpbnRlcmZhY2Ug dG8gdXNlZCBieQpndWVzdCBQViBkcml2ZXJzIG9yIGFnZW50cyB0byBjb252ZXkgc3RhdGlzdGlj cyB0byBhIG1vbml0b3JpbmcgYWdlbnQKcnVubmluZyBpbiBhIHRvb2xzdGFjayBkb21haW4uCgpT aWduZWQtb2ZmLWJ5OiBQYXVsIER1cnJhbnQgPHBhdWwuZHVycmFudEBjaXRyaXguY29tPgotLS0K UkZDIGF0IHRoZSBtb21lbnQgc2luY2UgdGhpcyBpcyBhIGZpcnN0IGRyYWZ0IGFuZCBpdCBpcyBu b3QgeWV0CnByb3RvdHlwZWQKLS0tCiBkb2NzL2Rlc2lnbnMvcHZfc3RhdHMubWFya2Rvd24gfCAx MTYgKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysKIDEgZmlsZSBjaGFu Z2VkLCAxMTYgaW5zZXJ0aW9ucygrKQogY3JlYXRlIG1vZGUgMTAwNzU1IGRvY3MvZGVzaWducy9w dl9zdGF0cy5tYXJrZG93bgoKZGlmZiAtLWdpdCBhL2RvY3MvZGVzaWducy9wdl9zdGF0cy5tYXJr ZG93biBiL2RvY3MvZGVzaWducy9wdl9zdGF0cy5tYXJrZG93bgpuZXcgZmlsZSBtb2RlIDEwMDc1 NQppbmRleCAwMDAwMDAwLi40MTg5MzY5Ci0tLSAvZGV2L251bGwKKysrIGIvZG9jcy9kZXNpZ25z L3B2X3N0YXRzLm1hcmtkb3duCkBAIC0wLDAgKzEsMTE2IEBACisjIFN0YXRpc3RpY3MgSW50ZXJm YWNlIGZvciBQViBEcml2ZXJzL0FnZW50cworCisjIyBCYWNrZ3JvdW5kCisKK0l0IGlzIGNvbW1v biBmb3IgZ3Vlc3QgUFYgZHJpdmVycyBvciBhZ2VudHMgdG8gY29tbXVuaWNhdGUgc3RhdGlzdGlj cyB0byBhbgorYWdlbnQgcnVubmluZyBpbiBhIHRvb2xzdGFjayBkb21haW4gc28gdGhhdCB0aGVz ZSBjYW4gYmUgZGlzcGxheWVkIHZpYSBhIFVJLAorb3IgZXZlbiBpbmZsdWVuY2UgZ3Vlc3QgcGxh Y2VtZW50IGV0Yy4gVGhlIG1lY2hhbmlzbSBmb3IgY29udmV5aW5nIHRoZXNlCitzdGF0aXN0aWNz IGlzIGN1cnJlbnRseSBhZC1ob2MsIHVuZG9jdW1lbnRlZCwgYW5kIHVzdWFsbHkgYmFzZWQgb24g eGVuc3RvcmUuCisKK1doaWxzdCB4ZW5zdG9yZSBkb2VzIGluZGVlZCBwcm92aWRlIGEgY29udmVu aWVudCBtZWNoYW5pc20sIHRoZSBsYWNrIG9mCitkb2N1bWVudGF0aW9uIGFuZCBzdGFuZGFyZGlz YXRpb24gb2YgdGhlIHByb3RvY29scyB1c2VkIGNyZWF0ZXMKK2NvbXBhdGliaWxpdHkgaXNzdWVz IGZvciBQViBkcml2ZXJzIG9yIGFnZW50cyBub3QgdGllZCB0byBhIHNwZWNpZmljCitwcm9kdWN0 IG9yIGVudmlyb25tZW50LiBBbHNvLCB0aGUgZ3Vlc3QgeGVuc3RvcmUgcXVvdGEgYW5kIHRoZSBz aW5nbGUKK2luc3RhbmNlIG9mIHhlbnN0b3JlZCBjYW4gZWFzaWx5IGJlY29tZSBzY2FsYWJpbGl0 eSBpc3N1ZXMuCisKKyMjIFByb3Bvc2FsCisKK1RoZSBwcm9wb3NlZCBpbnRlcmZhY2UgaXMgaW50 ZW5kZWQgdG8gYmUgdXNlZCBvbmx5IGZvciB0aGUgcHVycG9zZXMgb2YKK2NvbnZleWluZyBzdGF0 aXN0aWNzIGZyb20gZ3Vlc3QgUFYgZHJpdmVycyBvciBhZ2VudHMgdG8gYW4gYWdlbnQgb3IgYWdl bnRzCitydW5uaW5nIGluIGEgdG9vbHN0YWNrIGRvbWFpbi4gSXQgaXMgbm90IGludGVuZGVkIGZv ciBidWxrIGRhdGEgdHJhbnNmZXIsCitub3IgYXMgYW5vdGhlciBtZWFucyBvZiBjb250cm9sIG9m IHRoZSBQViBkcml2ZXJzIG9yIGFnZW50cyBieSB0aGUKK3Rvb2xzdGFjayBkb21haW4uCisKK1BW IGRyaXZlcnMgb3IgYWdlbnRzIHR5cGljYWxseSBwdWJsaXNoIG11bHRpcGxlIHJlbGF0ZWQgc2V0 cyBvZiBzdGF0aXN0aWNzLgorRm9yIGV4YW1wbGUsIGEgUFYgbmV0d29yayBmcm9udGVuZCBtYXkg cHVibGlzaCBzdGF0aXN0aWNzIHJlbGF0aW5nIHRvCityZWNlaXZlZCB0cmFmZmljIGFuZCB0cmFu c21pdHRlZCB0cmFmZmljLiBUaGVzZSBzZXRzIGFyZSBsaWtlbHkgdG8gYmUKK3VwZGF0ZWQgYXN5 bmNocm9ub3VzbHkgZnJvbSBlYWNoIG90aGVyIGFuZCB0aGVyZWZvcmUgaXQgbWFrZXMgc2Vuc2Ug dGhhdAordGhleSBjYW4gYmUgc2VwYXJhdGVkIHN1Y2ggdGhhdCBhIG1vbml0b3JpbmcgYWdlbnQg Y2FuIHJlZnJlc2ggaXRzIHZpZXcgb2YKK3RoZW0gYXN5bmNocm9ub3VzbHkuIEl0IGlzIHRoZXJl Zm9yZSBwcm9wb3NlZCB0aGF0IGEgdHdvLWxldmVsIGhpZXJhcmNoeSBvZgoreGVuc3RvcmUga2V5 cyBpcyB1c2VkIHRvIGFkdmVydGlzZSBzZXRzIG9mIGd1ZXN0IHN0YXRpc3RpY3MuCisKK1RoZSB0 b29sc3RhY2sgd2lsbCBjcmVhdGUgYSB3cml0ZWFibGUgdG9wLWxldmVsIGBzdGF0c2Aga2V5IGlu IHRoZSBndWVzdAorc3BhY2UuIFVuZGVyIHRoaXMgZWFjaCBndWVzdCBzdGF0aXN0aWNzICpwcm92 aWRlciogY3JlYXRlcyBhIGtleSBpdHMgbmFtZSwKK2UuZy4gYE5ldHdvcmsgIzBgLiBUaGlzIGtl eSBhY3RzIGFzIGEgcGFyZW50IHRvIGtleXMgdGhhdCB0aGVuIG5hbWUgZWFjaAorc2V0IG9mIHN0 YXRpc3RpY3MgdGhhdCBpdCBwcm92aWRlcywgZS5nLiBgVHhgLiBVbmRlciB0aGUga2V5IGZvciBh CitwYXJ0aWN1bGFyIHNldCB0aGUgcHJvdmlkZXIgdGhlbiB3cml0ZXMgZW50cmllcyBjb250YWlu aW5nIGdyYW50IHJlZmVyZW5jZXMKK29mIHBhZ2VzIGNvbnRhaW5pbmcgdGhlIG5hbWVzIGFuZCB2 YWx1ZXMgb2YgdGhlIHN0YXRpc3RpY3MgaW4gdGhhdCBzZXQsIGFuZAorYW4gZXZlbnQgY2hhbm5l bCB0byBiZSB1c2VkIGZvciBzaWduYWxsaW5nIGUuZy46CisKKyAgICBuYW1lLXR5cGUtcmVmMCA9 IDEwCisgICAgbmFtZS10eXBlLXJlZjEgPSAxMQorICAgIHZhbC1yZWYwID0gMTIKKyAgICB2YWwt cmVmMSA9IDEzCisgICAgZXZlbnQtY2hhbm5lbCA9IDEwCisKK1RoZSBwcm92aWRlciBtdXN0IGFs d2F5cyB3cml0ZSB0aGUgYGV2ZW50LWNoYW5uZWxgIGtleSBhZnRlciBhbGwgdGhlIG90aGVyCitr ZXlzIGhhdmUgYmVlbiB3cml0dGVuIHN1Y2ggdGhhdCBhIG1vbml0b3JpbmcgYWdlbnQgd2l0aCBh IHdhdGNoIG9uIHRoZQorZ3Vlc3QncyB0b3AtbGV2ZWwgYHN0YXRzYCBrZXkgY2FuIG1ha2UgdGhl IGFzc3VtcHRpb24gdGhhdCBpdCBpcyBzYWZlIHRvCitzYW1wbGUgYWxsIG90aGVyIGtleXMgb25j ZSB0aGF0IGtleSBoYXMgYmVlbiB3cml0dGVuLiBUaHVzIG5vIGV4cGxpY2l0Citgc3RhdGVgIGtl eSBpcyByZXF1aXJlZC4KKworVGhlcmUgYXJlIHNlcGFyYXRlIHJlZmVyZW5jZXMgZm9yIHBhZ2Vz IGNvbnRhaW5pbmcgdGhlIG5hbWVzIGFuZCB0eXBlcyBvZgordGhlIHN0YXRpc3RpY3MgYW5kIHRo ZSB2YWx1ZXMgb2YgdGhvc2Ugc3RhdGlzdGljcyBzaW5jZSBpdCBpcyByZXF1aXJlZCB0aGF0Cit0 aGUgbmFtZXMgYW5kIHR5cGVzIGRvIG5vdCBjaGFuZ2UgYW5kIGhlbmNlIGEgbW9uaXRvcmluZyBh Z2VudCBuZWVkIG9ubHkKK3NhbXBsZSB0aGVtIG9uY2UgYW5kIGNhbiBkbyBzbyBhcyBzb29uIGFz IHRoZSBhcyB0aGUgYG5hbWUtcmVmYCBrZXlzIGFyZQordmFsaWQuIFRoZSBmb3JtYXQgb2YgZWFj aCAoKm5hbWUsIHR5cGUqKSB0dXBsZSBpcyBhcyBmb2xsb3dzOgorCisgICAgc3RydWN0IHN0YXRz X25hbWVfdHlwZSB7CisJdWludDhfdCB0eXBlOworCWNoYXIgbmFtZVs2M107CisgICAgfTsKKwor YW5kIHRoZSBwb3NzaWJsZSB0eXBlcyBhcmU6CisKKyAgICAjZGVmaW5lIFNUQVRTX1RZUEVfUzY0 CQkxCisgICAgI2RlZmluZSBTVEFUU19UWVBFX1U2NAkJMgorICAgICNkZWZpbmUgU1RBVFNfVFlQ RV9ET1VCTEUJMworICAgICNkZWZpbmUgU1RBVFNfVFlQRV9BU0NJSQk0CisKK1RoZSBgbmFtZWAg bXVzdCBiZSBhIE5VTCB0ZXJtaW5hdGVkIEFTQ0lJIHN0cmluZyBjb250YWluaW5nIG9ubHkKK2Fs cGhhbnVtZXJpYyBjaGFyYWN0ZXJzLCBwcmludGFibGUgbm9uLWFscGhhbnVtZXJpYyBjaGFyYWN0 ZXJzIG9yIGEgc3BhY2UKK2NoYXJhY3RlciwgaS5lLiB0aGUgZXhwcmVzc2lvbjoKKworICAgIChp c2FsbnVtKG5hbWVbaV0pIHx8IGlzcHVuY3QobmFtZVtpXSkgfHwgbmFtZVtpXSA9PSAnICcpCisK K211c3QgYmUgdHJ1ZSBmb3IgZWFjaCB2YWx1ZSBvZiBgaWAgdW50aWwgYG5hbWVbaV0gPT0gJ1ww J2AKKworV2hlbiBpdGVyYXRpbmcgdGhyb3VnaCB0aGUgYHN0YXRzX25hbWVfdHlwZWAgc3RydWN0 dXJlcyBhIG1vbml0b3JpbmcgYWdlbnRzCitjYW4gZGV0ZXJtaW5lIHRoYXQgaXQgaGFzIGZpbmlz aGVkIHdoZW4gaXQgZWl0aGVyIGVuY291bnRlcnMgYSBgdHlwZWAgdmFsdWUKK29mIDAsIG9yIGl0 IGhhcyBpdGVyYXRlZCB0aHJvdWdoIGFsbCA2NCBzdHJ1Y3R1cmVzIGluIHRoZSBncmFudGVkIHBh Z2UgYW5kCit0aGVyZSBhcmUgbm8gZnVydGhlciBgbmFtZS10eXBlLXJlZmAga2V5cy4KKworQSBt b25pdG9yaW5nIGFnZW50IGNhbiBmaW5kIHRoZSB2YWx1ZSBvZiBhIHN0YXRpc3RpYyBieSBub3Rp bmcgdGhlCitgbmFtZS10eXBlLXJlZmAgaW5kZXggYW5kIHRoZSBvZmZzZXQgaW50byB0aGUgcGFn ZSB3aGVyZSB0aGUKK2BzdGF0c19uYW1lX3R5cGVgIHdhcyBmb3VuZCBhbmQgdGhlIGxvb2tpbmcg YXQgdGhlIHNhbWUgb2Zmc2V0IGluIHRoZQorY29ycmVzcG9uZGluZyBgdmFsLXJlZmAgcGFnZS4g VmFsdWVzIGFyZSB0aGVyZWZvcmUgYWxzbyA2NCBvY3RldHMKK2luIGxlbmd0aCBhbmQgY29udGFp bjoKKworKiBgU1RBVFNfVFlQRV9TNjRgIDogQSBzaWduZWQgNjQtYml0IGludGVnZXIgaW4gbGl0 dGxlIGVuZGlhbiBmb3JtIGluCisJCSAgICAgb2N0ZXRzIDAuLjcKKyogYFNUQVRTX1RZUEVfVTY0 YCA6IEFuIHVuc2lnbmVkIDY0LWJpdCBpbnRlZ2VyIGluIGxpdHRsZSBlbmRpYW4gZm9ybSBpbgor CQkgICAgIG9jdGV0cyAwLi43CisqIGBTVEFUU19UWVBFX0RPVUJMRWAgOiBBIGRvdWJsZSBwcmVj aXNpb24gZmxvYXRpbmcgcG9pbnQgdmFsdWUgaW4gbGl0dGxlCisJCQllbmRpYW4gZm9ybSBpbgor CQkJb2N0ZXRzIDAuLjcKKyogYFNUQVRTX1RZUEVfQVNDSUlgIDogQSBOVUwgdGVybWluYXRlZCBB U0NJSSBzdHJpbmcgbWVldGluZyB0aGUgc2FtZQorCQkgICAgICAgY3JpdGVyaWEgYXMgYG5hbWVg CisKK0Egc3RhdGlzdGljcyBwcm92aWRlciBzaG91bGQgbm90IHVwZGF0ZSBhbnkgb2YgdGhlIHN0 YXRpc3RpY3MgaW4gYSBzZXQKK3VudGlsIHRoZSBgZXZlbnQtY2hhbm5lbGAgaXMgc2lnbmFsbGVk IGluZGljYXRpbmcgdGhhdCBhIG1vbml0b3JpbmcgYWdlbnQKK3dpc2hlcyB0byBzYW1wbGUgdGhl bS4gVGh1cyB0aGUgcmF0ZSBvZiB1cGRhdGUgaXMgbm9taW5hbGx5IHVuZGVyIGNvbnRyb2wKK29m IHRoZSBtb25pdG9yaW5nIGFnZW50LgorCitXaGVuIHN1Y2ggYSBzaWduYWwgaXMgcmVjZWl2ZWQs IGFsbCBzdGF0aXN0aWNzIGluIHRoZSBzZXQgc2hvdWxkIHRoZW4gYmUKK3VwZGF0ZWQgYW5kIGEg c2lnbmFsIHNldCBiYWNrIHRvIHRoZSBtb25pdG9yaW5nIGFnZW50IHZpYSB0aGUKK2BldmVudC1j aGFubmVsYCB0byBzYXkgdGhhdCB0aGUgdXBkYXRlIGlzIGNvbXBsZXRlLiBUaGUgbW9uaXRvcmlu ZyBhZ2VudAorY2FuIHRoZW4gc2FtcGxlIHRoZSB3aG9sZSBzZXQsIGtub3dpbmcgdGhhdCBpdCBp cyBzZWxmLWNvbnNpc3RlbnQsIGFzIGxvbmcKK2FzIHRoZSBwcm92aWRlciBpcyBub3QgbWlzYmVo YXZpbmcuCisKK1doZW4gYSBwcm92aWRlciB3aXNoZXMgdG8gd2l0aGRyYXcgYSBzZXQgb2Ygc3Rh dGlzdGljcywgZS5nLiB3aGVuIGl0IGlzCitzaHV0dGluZyBkb3duLCBpdCBub3RpZmllcyBhIG1v bml0b3JpbmcgYWdlbnQgYnkgZGVsZXRpbmcgdGhlCitgZXZlbnQtY2hhbm5lbGAga2V5IGZyb20g eGVuc3RvcmUuIFRodXMgYSBtb25pdG9yaW5nIGFnZW50IG11c3QgbWFpbnRhaW4gYQord2F0Y2gg b24gdGhhdCBrZXkgYW5kIHJlc3BvbmQgaW4gYSB0aW1lbHkgbWFubmVyIGJ5IGNsb3NpbmcgaXRz IHBvcnQuIE9uY2UKK3RoZSBwcm92aWRlciBkZXRlY3RzIHRoYXQgY2hhbm5lbCBpcyBubyBsb25n ZXIgYm91bmQgdGhlbiBpdCBjYW4gcmVtb3ZlIHRoZQord2hvbGUgc2V0IG9mIGtleXMgY29ycmVz cG9uZGluZyB0byB0aGUgc2V0LiBXaGVuIHRoZSBwcm92aWRlciBpcyBubyBsb25nZXIKK2FkdmVy dGlzaW5nIGFueSBzZXRzIGl0IGNhbiB0aGVuIHJlbW92ZSBpdHMgdG9wLWxldmVsIGtleS4KLS0g CjIuNS4zCgoKX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX18K WGVuLWRldmVsIG1haWxpbmcgbGlzdApYZW4tZGV2ZWxAbGlzdHMueGVuLm9yZwpodHRwczovL2xp c3RzLnhlbi5vcmcveGVuLWRldmVsCg==