From mboxrd@z Thu Jan 1 00:00:00 1970 From: George Dunlap Subject: [PATCH v2] hvm/altp2m: Clarify the proper way to extend the altp2m interface Date: Mon, 23 Jul 2018 18:09:51 +0100 Message-ID: <20180723170951.6852-1-george.dunlap@citrix.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from all-amaz-eas1.inumbo.com ([34.197.232.57]) by lists.xenproject.org with esmtp (Exim 4.89) (envelope-from ) id 1fheLN-00005x-Gq for xen-devel@lists.xenproject.org; Mon, 23 Jul 2018 17:09:57 +0000 List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Errors-To: xen-devel-bounces@lists.xenproject.org Sender: "Xen-devel" To: xen-devel@lists.xenproject.org Cc: Lars Kurth , Stefano Stabellini , Wei Liu , Razvan Cojocaru , Andrew Cooper , Adrian Pop , Tim Deegan , George Dunlap , Julien Grall , Jan Beulich , Tamas K Lengyel , Ian Jackson List-Id: xen-devel@lists.xenproject.org VGhlIGFsdHAybSBmdW5jdGlvbmFsaXR5IHdhcyBvcmlnaW5hbGx5IGVudmlzaW9uZWQgdG8gYmUg dXNlZCBpbgpzZXZlcmFsIGRpZmZlcmVudCBjb25maWd1cmF0aW9ucywgb25lIG9mIHdoaWNoIHdh cyBhIHNpbmdsZSBpbi1ndWVzdAphZ2VudCB0aGF0IGhhZCBmdWxsIG9wZXJhdGlvbmFsIGNvbnRy b2wgb2YgYWx0cDJtLiAgVGhpcyByZXF1aXJlZCB0aGUKc2luZ2xlIGh5cGVyY2FsbCB0byBiZSBh biBIVk1PUCByYXRoZXIgdGhhbiBhIERPTUNUTCwgc2luY2UgSFZNIGd1ZXN0cwphcmUgbm90IGFs bG93ZWQgdG8gbWFrZSBET01DVExzLiAgQWNjZXNzIHRvIHRoaXMgSFZNT1AgaXMgY29udHJvbGxl ZApieSBhIHBlci1kb21haW4gSFZNX1BBUkFNLCBhbmQgZGVmYXVsdHMgdG8gJ29mZicuCgpFeHBv c2luZyB0aGUgYWx0cDJtIGZ1bmN0aW9uYWxpdHkgdG8gdGhlIGd1ZXN0IHdhcyBjb250cm92ZXJz aWFsIGF0CnRoZSB0aW1lLCBidXQgd2FzIHVsdGltYXRlbHkgYWNjZXB0ZWQuICBUaGUgZmFjdCB0 aGF0IGFsdHAybSBpcyBhbgpIVk1PUCByYXRoZXIgdGhhbiBhIERPTUNUTCBoYXMgY2F1c2VkIHNv bWUgcHJvYmxlbXMsIGhvd2V2ZXIsIGZvcgp0aG9zZSBtb3ZpbmcgZm9yd2FyZCB0cnlpbmcgdG8g ZXh0ZW5kIHRoZSBpbnRlcmZhY2U6IEV4dGVuZGluZyB0aGUKaW50ZXJmYWNlIGV2ZW4gZm9yIHRo ZSAnZXh0ZXJuYWwnIHVzZSBjYXNlIG5vdyBtZWFucyBleHRlbmRpbmcgYW4KSFZNT1AsIHdoaWNo IGltcGxpY2l0bHkgZXh0ZW5kcyB0aGUgc3VyZmFjZSBvZiBhdHRhY2sgZm9yIHRoZQonaW50ZXJu YWwnIHVzZSBjYXNlIGFzIHdlbGwuICBUaGUgcmVzdWx0IGhhcyBiZWVuIHRoYXQgZXZlcnkgYWRk aXRpb24KdG8gdGhpcyBpbnRlcmZhY2UgaGFzIGFsc28gYmVlbiBjb250cm92ZXJzaWFsLgoKU2V0 dGxlIHRoZSBjb250cm92ZXJzeSBvbmNlIGFuZCBmb3IgYWxsIGJ5IGRvY3VtZW50aW5nIDEpIHRo ZSBwdXJwb3NlCm9mIHRoZSBhbHRwMm0gaW50ZXJmYWNlLCBhbmQgMikgaG93IHRvIGV4dGVuZCBp dC4gIEluIHBhcnRpY3VsYXI6CgoqIFNwZWNpZnkgdGhhdCB0aGUgZnVsbHkgaW4tZ3Vlc3QgYWdl bnQgaXMgYSB0YXJnZXQgdXNlIGNhc2UKCiogU3BlY2lmeSB0aGF0IGFsbCBleHRlbnNpb25zIHRv IGFsdHAybSBmdW5jdGlvbmFsaXR5IHNob3VsZCBiZSBzdWJvcHMKICBvZiB0aGUgSFZNT1AgaHlw ZXJjYWxsCgoqIFNwZWNpZnkgdGhhdCBuZXcgc3Vib3BzIHNob3VsZCBiZSBlbmFibGVkIGluIEFM VFAyTV9taXhlZCBtb2RlIGJ5CiAgZGVmYXVsdCwgYnV0IHRoYXQgdGhpcyBtb2RlIGhhcyBub3Qg YmVlbiBldmFsdWF0ZWQgZm9yIHNhZmV0eS4KCkhvcGVmdWxseSB0aGlzIHdpbGwgYWxsb3cgdGhl IGFsdHAybSBpbnRlcmZhY2UgdG8gYmUgZGV2ZWxvcGVkIGZ1cnRoZXIKd2l0aG91dCB1bm5lY2Vz c2FyeSBjb250cm92ZXJzeS4KCkZ1cnRoZXIgZGlzY3Vzc2lvbjoKCkFzIGZhciBhcyBJIGNhbiB0 ZWxsIHRoZXJlIGFyZSB0aHJlZSBwb3NzaWJsZSBzb2x1dGlvbnMgdG8gdGhpcwpjb250cm92ZXJz eS4KCkEuIFJlbW92ZSB0aGUgJ2ludGVybmFsJyBmdW5jdGlvbmFsaXR5IGFzIGEgdGFyZ2V0IGJ5 IGNvbnZlcnRpbmcgdGhlCmN1cnJlbnQgSFZNT1AgaW50byBhIERPTUNUTC4KCkIuIEhhdmUgdHdv IGh5cGVyY2FsbHMgLS0gYW4gSFZNT1Agd2hpY2ggY29udGFpbnMgZnVuY3Rpb25hbGl0eQpleHBl Y3RlZCB0byBiZSB1c2VkIGJ5IHRoZSAnaW50ZXJuYWwnIGFnZW50LCBhbmQgYSBET01DVEwgZm9y CmZ1bmN0aW9uYWxpdHkgd2hpY2ggaXMgZXhwZWN0ZWQgdG8gYmUgdXNlZCBvbmx5IGJlIHRoZSAn ZXh0ZXJuYWwnCmFnZW50LgoKQy4gQWdyZWUgdG8gYWRkIGFsbCBuZXcgc3Vib3BzIHRvIHRoZSBj dXJyZW50IGh5cGVyY2FsbCAoSFZNT1ApLCBldmVuCmlmIHdlJ3JlIG5vdCBzdXJlIGlmIHRoZXkg c2hvdWxkIGJlIGV4cG9zZWQgdG8gdGhlIGd1ZXN0LgoKSSB0aGluayBBIGlzIGEgdGVycmlibGUg aWRlYS4gIEhhdmluZyBhIHNpbmdsZSBpbi1ndWVzdCBhZ2VudCBpcyBhCnJlYXNvbmFibGUgZGVz aWduIGNob2ljZSwgYW5kIGFwcGFyZW50bHkgaXQgd2FzIGV2ZW4gaW1wbGVtZW50ZWQgYXQKc29t ZSBwb2ludDsgd2Ugc2hvdWxkIG1ha2UgaXQgc3RyYWlnaHRmb3J3YXJkIGZvciBzb21lb25lIGlu IHRoZQpmdXR1cmUgdG8gcGljayB1cCB0aGUgd29yayBpZiB0aGV5IHdhbnQgdG8uCgpJIHRoaW5r IEIgaXMgYWxzbyBhIGJhZCBpZGVhLiAgVGhlIHBlb3BsZSBleHRlbmRpbmcgaXQgYXQgdGhlIG1v bWVudAphcmUgcHJpbWFyaWx5IGNvbmNlcm5lZCB3aXRoIHRoZSAnZXh0ZXJuYWwnIHVzZSBjYXNl LiAgVGhlcmUgaXMgbm9ib2R5CmFyb3VuZCB0byByZXByZXNlbnQgd2hldGhlciBuZXcgZnVuY3Rp b25hbGl0eSBzaG91bGQgZW5kIHVwIGluIHRoZQpIVk1PUCBvciB0aGUgRE9NQ1RMLCB3aGljaCBt ZWFucyB0aGF0IGJ5IGRlZmF1bHQgaXQgd2lsbCBlbmQgdXAgaW4gdGhlCkRPTUNUTC4gIElmIGl0 IGlzIGRpc2NvdmVyZWQsIGFmdGVyd2FyZHMsIHRoYXQgdGhlIG5ldyBvcGVyYXRpb25zCip3b3Vs ZCogYmUgc2FmZSBhbmQgdXNlZnVsIGZvciB0aGUgJ2ludGVybmFsJyB1c2UgY2FzZSwgdGhlbiB3 ZSB3aWxsCmVpdGhlciBoYXZlIHRvIGR1cGxpY2F0ZSB0aGVtIGluc2lkZSB0aGUgSFZNT1AgKHdo aWNoIHdvdWxkIGJlCnRlcnJpYmxlKSBvciBtb3ZlIHRoZSBvcGVyYXRpb24gZnJvbSB0aGUgRE9N Q1RMIHRvIHRoZSBIVk1PUCAod2hpY2gKd291bGQgbWFrZSBjb2RpbmcgYW4gYWdlbnQgYWdhaW5z dCBzZXZlcmFsIHZlcnNpb25zIGEgbWVzcykuCgpJdCBqdXN0IG1ha2VzIG1vcmUgc2Vuc2UgdG8g aGF2ZSBhbGwgdGhlIGFsdHAybSBvcGVyYXRpb25zIGluIGEgc2luZ2xlCnBsYWNlLCBhbmQgYSBz aW1wbGUgd2F5IHRvIGNvbnRyb2wgd2hldGhlciB0aGV5J3JlIGF2YWlsYWJsZSB0byB0aGUKJ2lu dGVybmFsJyB1c2UgY2FzZSBvciBub3QuICBBcyBzdWNoLCBJIGFtIHByb3Bvc2luZyAnQycuCgpF dmVuIHdpdGhpbiB0aGF0LCB3ZSBoYXZlIHNldmVyYWwgb3B0aW9ucyBhcyBmYXIgYXMgd2hhdCB0 byBkbyB3aXRoCnRoZSBjdXJyZW50IGludGVyZmFjZToKCkMxOiBBdWRpdCB0aGUgY3VycmVudCBz dWJvcHMgYW5kIG1ha2UgYSBibGFja2xpc3Qgb2Ygc3Vib3BzIG5vdApzdWl0YWJsZSBmb3IgZXhw b3N1cmUgdG8gdGhlIGd1ZXN0LiAgRnV0dXJlIHN1Ym9wcyBzaG91bGQgYmUgb24gdGhlCmJsYWNr bGlzdCB1bmxlc3MgdGhleSBoYXZlIGJlZW4gZXZhbHVhdGVkIGFzIHNhZmUgZm9yIGV4cG9zdXJl LgoKQzI6IERvbid0IGJsYWNrbGlzdCB0aGUgY3VycmVudCBzdWJvcHMsIGJ1dCByZXF1aXJlIHRo YXQgYWxsIGZ1dHVyZQpzdWJvcHMgYmUgYmxhY2tsaXN0ZWQgdW5sZXNzIHRoZXkgaGF2ZSBiZWVu IGV2YWx1YXRlZCBhcyBzYWZlIGZvcgpleHBvc3VyZS4KCkMzOiBEb24ndCBibGFja2xpc3QgY3Vy cmVudCBvciBmdXR1cmUgc3Vib3BzIGZvciB0aGUgcHJlc2VudDsganVzdApkb2N1bWVudCB0aGF0 IHRoZXkgbmVlZCB0byBiZSBldmFsdWF0ZWQgKGFuZCBzb21lIHBvdGVudGlhbGx5CmJsYWNrbGlz dGVkKSBiZWZvcmUgYmVpbmcgZXhwb3NlZCB0byBhIGd1ZXN0IGluIGEgc2FmZXR5LWNyaXRpY2Fs CmVudmlyb25tZW50LgoKQzEgd291bGQgYmUgaWRlYWwsIGJ1dCB0aGVyZSdzIG5vYm9keSBhdCBw cmVzZW50IHRvIGRvIHRoZSB3b3JrLgpHaXZlbiB0aGF0LCBDMyBoYXMgYmVlbiBzZWVuIGFzIHRo ZSBiZXN0IHNvbHV0aW9uIGluIGRpc2N1c3Npb24uCgpTaWduZWQtb2ZmLWJ5OiBHZW9yZ2UgRHVu bGFwIDxnZW9yZ2UuZHVubGFwQGNpdHJpeC5jb20+Ci0tLQpDaGFuZ2VzIHNpbmNlIHYxOgotIFBh dGNoIGRlc2NyaXB0aW9uOiBjbGFyaWZ5IHRoYXQgSFZNIGd1ZXN0IGNhbid0IG1ha2UgZG9tY3Rs cwotIE5vIGJsYWNrbGlzdCBmb3IgdGhlICdpbnRlcm5hbCcgdXNlIGNhc2U7IGluc3RlYWQgZG9j dW1lbnQgaXRzIHJpc2sKLSBNb3ZlIG1vcmUgb2YgdGhlIGRpc2N1c3Npb24gaW50byB0aGUgY29t bWl0IG1lc3NhZ2UuCgpDQzogSWFuIEphY2tzb24gPGlhbi5qYWNrc29uQGNpdHJpeC5jb20+CkND OiBXZWkgTGl1IDx3ZWkubGl1MkBjaXRyaXguY29tPgpDQzogQW5kcmV3IENvb3BlciA8YW5kcmV3 LmNvb3BlcjNAY2l0cml4LmNvbT4KQ0M6IEphbiBCZXVsaWNoIDxqYmV1bGljaEBzdXNlLmNvbT4K Q0M6IFRpbSBEZWVnYW4gPHRpbUB4ZW4ub3JnPgpDQzogS29ucmFkIFdpbGsgPGtvbnJhZC53aWxr QG9yYWNsZS5jb20+CkNDOiBTdGVmYW5vIFN0YWJlbGxpbmkgPHNzdGFiZWxsaW5pQGtlcm5lbC5v cmc+CkNDOiBKdWxpZW4gR3JhbGwgPGp1bGllbi5ncmFsbEBhcm0uY29tPgpDQzogVGFtYXMgSyBM ZW5neWVsIDx0YW1hcy5sZW5neWVsQHplbnRpZmljLmNvbT4KQ0M6IFJhenZhbiBDb2pvY2FydSA8 cmNvam9jYXJ1QGJpdGRlZmVuZGVyLmNvbT4KQ0M6IEFkcmlhbiBQb3AgPGFwb3BAYml0ZGVmZW5k ZXIuY29tPgpDQzogTGFycyBLdXJ0aCA8bGFycy5rdXJ0aEBjaXRyaXguY29tPgotLS0KIHhlbi9h cmNoL3g4Ni9odm0vaHZtLmMgfCAzMSArKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrCiAx IGZpbGUgY2hhbmdlZCwgMzEgaW5zZXJ0aW9ucygrKQoKZGlmZiAtLWdpdCBhL3hlbi9hcmNoL3g4 Ni9odm0vaHZtLmMgYi94ZW4vYXJjaC94ODYvaHZtL2h2bS5jCmluZGV4IDE4MTZmYWE5YjMuLjg0 ZWVkMWY0YmMgMTAwNjQ0Ci0tLSBhL3hlbi9hcmNoL3g4Ni9odm0vaHZtLmMKKysrIGIveGVuL2Fy Y2gveDg2L2h2bS9odm0uYwpAQCAtNDQ2Nyw2ICs0NDY3LDM3IEBAIHN0YXRpYyBpbnQgaHZtb3Bf Z2V0X3BhcmFtKAogICAgIHJldHVybiByYzsKIH0KIAorLyoKKyAqIGFsdHAybSBvcGVyYXRpb25z IGFyZSBlbnZpc2lvbmVkIGFzIGJlaW5nIHVzZWQgaW4gc2V2ZXJhbCBkaWZmZXJlbnQgCisgKiBt b2RlczoKKyAqIAorICogLSBleHRlcm5hbDogQWxsIGNvbnRyb2wgYW5kIGRlY2lzaW9ucyBhcmUg bWFkZSBieSBhbiBleHRlcm5hbCBhZ2VudAorICogICBydW5uaW5nIGRvbWFpbiAwLgorICoKKyAq IC0gaW50ZXJuYWw6IGFsdHAybSBvcGVyYXRpb25zIGFyZSB1c2VkIGV4Y2x1c2l2ZWx5IGJ5IGFu IGluLWd1ZXN0CisgKiAgIGFnZW50IHRvIHByb3RlY3QgaXRzZWxmIGZyb20gdGhlIGd1ZXN0IGtl cm5lbCBhbmQgaW4tZ3Vlc3QKKyAqICAgYXR0YWNrZXJzLgorICogCisgKiAtIGNvb3JkaW5hdGVk OiBBbiBpbi1ndWVzdCBhZ2VudCBoYW5kbGVzICNWRSBhbmQgVk1GVU5DcyBsb2NhbGx5LAorICog ICBidXQgbWFrZXMgcmVxdWVzdHMgb2YgYW4gYWdlbnQgcnVubmluZyBvdXRzaWRlIHRoZSBkb21h aW4gZm9yCisgKiAgIGJpZ2dlciBjaGFuZ2VzIChzdWNoIGFzIG1vZGlmeWluZyBhbHRwMm0gZW50 aXJlcykuCisgKgorICogVGhpcyBjb3JyZXNwb25kcyB0byB0aGUgdGhyZWUgdmFsdWVzIGZvciBI Vk1fUEFSQU1fQUxUUDJNCisgKiAoZXh0ZXJuYWwsIG1peGVkLCBsaW1pdGVkKS4gQWxsIHRocmVl IG1vZGVscyBoYXZlIGFkdmFudGFnZXMgYW5kCisgKiBkaXNhZHZhbnRhZ2VzLgorICoKKyAqIE5v cm1hbGx5IGh5cGVyY2FsbHMgbWFkZSBieSBhIHByb2dyYW0gaW4gZG9tYWluIDAgaW4gb3JkZXIg dG8KKyAqIGNvbnRyb2wgYSBndWVzdCB3b3VsZCBiZSBET01DVExzIHJhdGhlciB0aGFuIEhWTU9Q cy4gIEJ1dCBpbiBvcmRlcgorICogdG8gcHJvcGVybHkgZW5hYmxlIHRoZSAnaW50ZXJuYWwnIHVz ZSBjYXNlLCBhcyB3ZWxsIGFzIHRvIGF2b2lkCisgKiBmcmFnbWVudGF0aW9uLCBhbGwgYWx0cDJt IHN1Ym9wcyBzaG91bGQgY29tZSB1bmRlciB0aGlzIHNpbmdsZQorICogSFZNT1AuCisgKiAKKyAq IE5vdGUgdGhhdCAnaW50ZXJuYWwnIG1vZGUgKEhWTV9QQVJBTV9BTFRQMk0gPT0gWEVOX0FMVFAy TV9taXhlZCkKKyAqIGhhcyBub3QgYmVlbiBldmFsdWF0ZWQgZm9yIHNhZmV0eSBmcm9tIGEgc2Vj dXJpdHkgcGVyc3BlY3RpdmUuCisgKiBCZWZvcmUgdXNpbmcgdGhpcyBtb2RlIGluIGEgc2VjdXJp dHktY3JpdGljYWwgZW52aXJvbm1lbnQsIGVhY2gKKyAqIHN1Ym9wIHNob3VsZCBiZSBldmFsdWF0 ZWQgZm9yIHNhZmV0eSwgd2l0aCB1bnNhZmUgc3Vib3BzCisgKiBibGFja2xpc3RlZCBpbiB4c21f aHZtX2FsdHAybWh2bV9vcCgpLgorICovCiBzdGF0aWMgaW50IGRvX2FsdHAybV9vcCgKICAgICBY RU5fR1VFU1RfSEFORExFX1BBUkFNKHZvaWQpIGFyZykKIHsKLS0gCjIuMTguMAoKCl9fX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fClhlbi1kZXZlbCBtYWlsaW5n IGxpc3QKWGVuLWRldmVsQGxpc3RzLnhlbnByb2plY3Qub3JnCmh0dHBzOi8vbGlzdHMueGVucHJv amVjdC5vcmcvbWFpbG1hbi9saXN0aW5mby94ZW4tZGV2ZWw=