From mboxrd@z Thu Jan 1 00:00:00 1970 From: George Dunlap Subject: [PATCH] hvm/altp2m: Clarify the proper way to extend the altp2m interface Date: Tue, 10 Jul 2018 10:33:22 +0100 Message-ID: <20180710093322.10854-1-george.dunlap@citrix.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from us1-rack-dfw2.inumbo.com ([104.130.134.6]) by lists.xenproject.org with esmtp (Exim 4.89) (envelope-from ) id 1fcp1U-0002UY-Sq for xen-devel@lists.xenproject.org; Tue, 10 Jul 2018 09:33:28 +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 , Andrew Cooper , Tim Deegan , George Dunlap , Julien Grall , Jan Beulich , Tamas K Lengyel , Ian Jackson List-Id: xen-devel@lists.xenproject.org VGhlIGFsdHAybSBmdW5jdGlvbmFsaXR5IHdhcyBvcmlnaW5hbGx5IGVudmlzaW9uZWQgdG8gYmUg dXNlZCBpbgpzZXZlcmFsIGRpZmZlcmVudCBjb25maWd1cmF0aW9ucywgb25lIG9mIHdoaWNoIHdh cyBhIHNpbmdsZSBpbi1ndWVzdAphZ2VudCB0aGF0IGhhZCBmdWxsIG9wZXJhdGlvbmFsIGNvbnRy b2wgb2YgYWx0cDJtLiAgVGhpcyByZXF1aXJlZCB0aGUKc2luZ2xlIGh5cGVyY2FsbCB0byBiZSBh biBIVk1PUCwgd2hpY2ggaXMgdGhlIG9ubHkgdHlwZSBvZiBoeXBlcmNhbGwKYW4gSFZNIGd1ZXN0 IGlzIGFsbG93ZWQgdG8gbWFrZS4KCkV4cG9zaW5nIHRoZSBhbHRwMm0gZnVuY3Rpb25hbGl0eSB0 byB0aGUgZ3Vlc3Qgd2FzIGNvbnRyb3ZlcnNpYWwgYXQKdGhlIHRpbWUsIGJ1dCB3YXMgdWx0aW1h dGVseSBhY2NlcHRlZC4gIFRoZSBmYWN0IHRoYXQgYWx0cDJtIGlzIGFuCkhWTU9QIHJhdGhlciB0 aGFuIGEgRE9NQ1RMIGhhcyBjYXVzZWQgc29tZSBwcm9ibGVtcywgaG93ZXZlciwgZm9yCnRob3Nl IG1vdmluZyBmb3J3YXJkIHRyeWluZyB0byBleHRlbmQgdGhlIGludGVyZmFjZTogRXh0ZW5kaW5n IHRoZQppbnRlcmZhY2UgZXZlbiBmb3IgdGhlICdleHRlcm5hbCcgdXNlIGNhc2Ugbm93IG1lYW5z IGV4dGVuZGluZyBhbgpIVk1PUCwgd2hpY2ggaW1wbGljaXRseSBleHRlbmRzIHRoZSBzdXJmYWNl IG9mIGF0dGFjayBmb3IgdGhlCidpbnRlcm5hbCcgdXNlIGNhc2UgYXMgd2VsbC4gIFRoZSByZXN1 bHQgaGFzIGJlZW4gdGhhdCBldmVyeSBhZGRpdGlvbgp0byB0aGlzIGludGVyZmFjZSBoYXMgYWxz byBiZWVuIGNvbnRyb3ZlcnNpYWwuCgpTZXR0bGUgdGhlIGNvbnRyb3ZlcnN5IG9uY2UgYW5kIGZv ciBhbGwgYnkgZG9jdW1lbnRpbmcgMSkgdGhlIHB1cnBvc2UKb2YgdGhlIGFsdHAybSBpbnRlcmZh Y2UsIGFuZCAyKSBob3cgdG8gZXh0ZW5kIGl0LiAgSW4gcGFydGljdWxhcjoKCiogU3BlY2lmeSB0 aGF0IHRoZSBmdWxseSBpbi1ndWVzdCBhZ2VudCBpcyBhIHRhcmdldCB1c2UgY2FzZQoKKiBTcGVj aWZ5IHRoYXQgYWxsIGV4dGVuc2lvbnMgdG8gYWx0cDJtIGZ1bmN0aW9uYWxpdHkgc2hvdWxkIGJl IHN1Ym9wcwogIG9mIHRoZSBIVk1PUCBoeXBlcmNhbGwKCiogU3BlY2lmeSB0aGF0IG5ldyBzdWJv cHMgc2hvdWxkIGJlIGRpc2FibGVkIGluIEFMVFAyTV9taXhlZCBtb2RlIGJ5CiAgZGVmYXVsdCwg dW5sZXNzIHNwZWNpZmljYWxseSBldmFsdWF0ZWQgYXMgYmVpbmcgdXNlZnVsIGZvciB0aGUKICAn aW50ZXJuYWwnIHVzZSBjYXNlLgoKSG9wZWZ1bGx5IHRoaXMgd2lsbCBhbGxvdyB0aGUgYWx0cDJt IGludGVyZmFjZSB0byBiZSBkZXZlbG9wZWQgZnVydGhlcgp3aXRob3V0IHVubmVjZXNzYXJ5IGNv bnRyb3ZlcnN5LgoKU2lnbmVkLW9mZi1ieTogR2VvcmdlIER1bmxhcCA8Z2VvcmdlLmR1bmxhcEBj aXRyaXguY29tPgotLS0KQ0M6IElhbiBKYWNrc29uIDxpYW4uamFja3NvbkBjaXRyaXguY29tPgpD QzogV2VpIExpdSA8d2VpLmxpdTJAY2l0cml4LmNvbT4KQ0M6IEFuZHJldyBDb29wZXIgPGFuZHJl dy5jb29wZXIzQGNpdHJpeC5jb20+CkNDOiBKYW4gQmV1bGljaCA8amJldWxpY2hAc3VzZS5jb20+ CkNDOiBUaW0gRGVlZ2FuIDx0aW1AeGVuLm9yZz4KQ0M6IEtvbnJhZCBXaWxrIDxrb25yYWQud2ls a0BvcmFjbGUuY29tPgpDQzogU3RlZmFubyBTdGFiZWxsaW5pIDxzc3RhYmVsbGluaUBrZXJuZWwu b3JnPgpDQzogSnVsaWVuIEdyYWxsIDxqdWxpZW4uZ3JhbGxAYXJtLmNvbT4KQ0M6IFRhbWFzIEsg TGVuZ3llbCA8dGFtYXMubGVuZ3llbEB6ZW50aWZpYy5jb20+CkNDOiBMYXJzIEt1cnRoIDxsYXJz Lmt1cnRoQGNpdHJpeC5jb20+CgpBcyBmYXIgYXMgSSBjYW4gdGVsbCB0aGVyZSBhcmUgdGhyZWUg cG9zc2libGUgc29sdXRpb25zIHRvIHRoaXMKY29udHJvdmVyc3k6CgpBLiBSZW1vdmUgdGhlICdp bnRlcm5hbCcgZnVuY3Rpb25hbGl0eSBhcyBhIHRhcmdldCBieSBjb252ZXJ0aW5nIHRoZQpjdXJy ZW50IEhWTU9QIGludG8gYSBET01DVEwuCgpCLiBIYXZlIHR3byBoeXBlcmNhbGxzIC0tIGFuIEhW TU9QIHdoaWNoIGNvbnRhaW5zIGZ1bmN0aW9uYWxpdHkKZXhwZWN0ZWQgdG8gYmUgdXNlZCBieSB0 aGUgJ2ludGVybmFsJyBhZ2VudCwgYW5kIGEgRE9NQ1RMIGZvcgpmdW5jdGlvbmFsaXR5IHdoaWNo IGlzIGV4cGVjdGVkIHRvIGJlIHVzZWQgb25seSBiZSB0aGUgJ2ludGVybmFsJwphZ2VudC4KCkMu IEFncmVlIHRvIGFkZCBhbGwgbmV3IHN1Ym9wcyB0byB0aGUgY3VycmVudCBoeXBlcmNhbGwgKEhW TU9QKSwgZXZlbgppZiB3ZSdyZSBub3Qgc3VyZSBpZiB0aGV5IHNob3VsZCBiZSBleHBvc2VkIHRv IHRoZSBndWVzdC4KCkkgdGhpbmsgQSBpcyBhIHRlcnJpYmxlIGlkZWEuICBIYXZpbmcgYSBzaW5n bGUgaW4tZ3Vlc3QgYWdlbnQgaXMgYQpyZWFzb25hYmxlIGRlc2lnbiBjaG9pY2UsIGFuZCBhcHBh cmVudGx5IGl0IHdhcyBldmVuIGltcGxlbWVudGVkIGF0CnNvbWUgcG9pbnQ7IHdlIHNob3VsZCBt YWtlIGl0IHN0cmFpZ2h0Zm9yd2FyZCBmb3Igc29tZW9uZSBpbiB0aGUKZnV0dXJlIHRvIHBpY2sg dXAgdGhlIHdvcmsgaWYgdGhleSB3YW50IHRvLgoKSSB0aGluayBCIGlzIGFsc28gYSB0ZXJyaWJs ZSBpZGVhLiAgVGhlIHBlb3BsZSBleHRlbmRpbmcgaXQgYXQgdGhlCm1vbWVudCBhcmUgcHJpbWFy aWx5IGNvbmNlcm5lZCB3aXRoIHRoZSAnZXh0ZXJuYWwnIHVzZSBjYXNlLiAgVGhlcmUgaXMKbm9i b2R5IGFyb3VuZCB0byByZXByZXNlbnQgd2hldGhlciBuZXcgZnVuY3Rpb25hbGl0eSBzaG91bGQg ZW5kIHVwIGluCnRoZSBIVk1PUCBvciB0aGUgRE9NQ1RMLCB3aGljaCBtZWFucyB0aGF0IGJ5IGRl ZmF1bHQgaXQgd2lsbCBlbmQgdXAgaW4KdGhlIERPTUNUTC4gIElmIGl0IGlzIGRpc2NvdmVyZWQs IGFmdGVyd2FyZHMsIHRoYXQgdGhlIG5ldyBvcGVyYXRpb25zCip3b3VsZCogYmUgc2FmZSBhbmQg dXNlZnVsIGZvciB0aGUgJ2ludGVybmFsJyB1c2UgY2FzZSwgdGhlbiB3ZSB3aWxsCmhhdmUgdG8g ZHVwbGljYXRlIHRoZW0gaW5zaWRlIHRoZSBIVk1PUC4KCkl0IGp1c3QgbWFrZXMgbW9yZSBzZW5z ZSB0byBoYXZlIGFsbCB0aGUgYWx0cDJtIG9wZXJhdGlvbnMgaW4gYSBzaW5nbGUKcGxhY2UsIGFu ZCBhIHNpbXBsZSB3YXkgdG8gY29udHJvbCB3aGV0aGVyIHRoZXkncmUgYXZhaWxhYmxlIHRvIHRo ZQonaW50ZXJuYWwnIHVzZSBjYXNlIG9yIG5vdC4gIEFzIHN1Y2gsIEkgYW0gcHJvcG9zaW5nICdD Jy4gIEkga25vdyBKYW4KY29uc2lkZXJzIHRoaXMgImJhZG5lc3MiLCBhbmQgb2JqZWN0cyB0byB0 aGUgY29udGludWFsICJleHRlbnNpb24iIG9mCnRoZSAiYmFkbmVzcyIsIGJ1dCBJIGRpc2FncmVl LCBhbmQgSSBzdHJvbmdseSBvYmplY3QgdG8gdGhlIG90aGVyIHR3bwpvcHRpb25zLgoKRGlzYWJs aW5nIG5ldyBzdWJvcHMgZm9yIHRoZSAnaW50ZXJuYWwnIHVzZSBjYXNlIGJ5IGRlZmF1bHQgbWVh bnMgdGhhdAp3ZSBjYW4gYWRkIG5ldyBzdWJvcHMgd2l0aG91dCB3b3JyeWluZyBhYm91dCBtYWtp bmcgdGhlICdpbnRlcm5hbCcgdXNlCmNhc2UgbGVzcyBzZWN1cmU7IGJ1dCBpZiBpbiB0aGUgZnV0 dXJlIHNvbWVvbmUgbWFrZXMgdGhlIGNhc2UgdGhhdAp0aGV5IGFyZSBzYWZlIGFuZCBuZWNlc3Nh cnksIHdlIGNhbiBlbmFibGUgdGhlbSB3aXRob3V0IGhhdmluZyBjb2RlCmR1cGxpY2F0aW9uLgoK SW4gYW55IGNhc2UgbmVlZCB0byBjb21lIHRvIGFuIGFncmVlbWVudCBvbmNlIGFuZCBmb3IgYWxs IHNvIHRoYXQKVGFtYXMgYW5kIFJhenZhbiBjYW4gZG8gdGhlaXIgd29yayB3aXRob3V0IGNvbnRp bnVhbCBhcmd1bWVudHMgb3ZlciBhCm1vZGUgdGhleSdyZSBub3QgdXNpbmcuCi0tLQogeGVuL2Fy Y2gveDg2L2h2bS9odm0uYyB8IDI4ICsrKysrKysrKysrKysrKysrKysrKysrKysrKysKIDEgZmls ZSBjaGFuZ2VkLCAyOCBpbnNlcnRpb25zKCspCgpkaWZmIC0tZ2l0IGEveGVuL2FyY2gveDg2L2h2 bS9odm0uYyBiL3hlbi9hcmNoL3g4Ni9odm0vaHZtLmMKaW5kZXggZTAyMmY1YWIwZS4uOTBhNGJl NWU4NiAxMDA2NDQKLS0tIGEveGVuL2FyY2gveDg2L2h2bS9odm0uYworKysgYi94ZW4vYXJjaC94 ODYvaHZtL2h2bS5jCkBAIC00NDYwLDYgKzQ0NjAsMzQgQEAgc3RhdGljIGludCBodm1vcF9nZXRf cGFyYW0oCiAgICAgcmV0dXJuIHJjOwogfQogCisvKgorICogYWx0cDJtIG9wZXJhdGlvbnMgYXJl IGVudmlzaW9uZWQgYXMgYmVpbmcgdXNlZCBpbiBzZXZlcmFsIGRpZmZlcmVudCAKKyAqIG1vZGVz OgorICogCisgKiAtIGV4dGVybmFsOiBBbGwgY29udHJvbCBhbmQgZGVjaXNpb25zIGFyZSBtYWRl IGJ5IGFuIGV4dGVybmFsIGFnZW50CisgKiAgIHJ1bm5pbmcgZG9tYWluIDAuCisgKgorICogLSBp bnRlcm5hbDogYWx0cDJtIG9wZXJhdGlvbnMgYXJlIHVzZWQgZXhjbHVzaXZlbHkgYnkgYW4gaW4t Z3Vlc3QgYWdlbnQKKyAqICAgdG8gcHJvdGVjdCBpdHNlbGYgZnJvbSB0aGUgZ3Vlc3Qga2VybmVs IGFuZCBpbi1ndWVzdCBhdHRhY2tlcnMuICAKKyAqIAorICogLSBjb29yZGluYXRlZDogQW4gaW4t Z3Vlc3QgYWdlbnQgaGFuZGxlcyAjVkUgYW5kIFZNRlVOQ3MgbG9jYWxseSwKKyAqICAgYnV0IG1h a2VzIHJlcXVlc3RzIG9mIGFuIGV4dGVybmFsIGVudGl0eSBmb3IgYmlnZ2VyIGNoYW5nZXMgKHN1 Y2gKKyAqICAgYXMgbW9kaWZ5aW5nIGFsdHAybSBlbnRpcmVzKS4KKyAqCisgKiBUaGlzIGNvcnJl c3BvbmRzIHRvIHRoZSB0aHJlZSB2YWx1ZXMgZm9yIEhWTV9QQVJBTV9BTFRQMk0KKyAqIChleHRl cm5hbCwgbWl4ZWQsIGxpbWl0ZWQpLiBBbGwgdGhyZWUgbW9kZWxzIGhhdmUgYWR2YW50YWdlcyBh bmQKKyAqIGRpc2FkdmFudGFnZXMuCisgKgorICogTm9ybWFsbHkgaHlwZXJjYWxscyBtYWRlIGJ5 IGEgcHJvZ3JhbSBpbiBkb21haW4gMCBpbiBvcmRlciB0bworICogY29udHJvbCBhIGd1ZXN0IHdv dWxkIGJlIERPTUNUTHMgcmF0aGVyIHRoYW4gSFZNT1BzLiAgQnV0IGluIG9yZGVyCisgKiB0byBw cm9wZXJseSBlbmFibGUgdGhlICdpbnRlcm5hbCcgdXNlIGNhc2UsIGFzIHdlbGwgYXMgdG8gYXZv aWQKKyAqIGZyYWdtZW50YXRpb24sIGFsbCBhbHRwMm0gc3Vib3BzIHNob3VsZCBjb21lIHVuZGVy IHRoaXMgc2luZ2xlCisgKiBIVk1PUC4KKyAqCisgKiBOZXcgc3Vib3BzIHdoaWNoIG1heSBub3Qg YmUgc3VpdGFibGUgZm9yIHRoZSAnaW50ZXJuYWwnIHVzZSBjYXNlCisgKiBzaG91bGQgYmUgZGlz YWJsZWQgaW4gdGhlICJYRU5fQUxUUDJNX21peGVkIiBjYXNlIGluCisgKiB4c21faHZtX2FsdHAy bWh2bV9vcCgpLgorICovCiBzdGF0aWMgaW50IGRvX2FsdHAybV9vcCgKICAgICBYRU5fR1VFU1Rf SEFORExFX1BBUkFNKHZvaWQpIGFyZykKIHsKLS0gCjIuMTguMAoKCl9fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fClhlbi1kZXZlbCBtYWlsaW5nIGxpc3QKWGVu LWRldmVsQGxpc3RzLnhlbnByb2plY3Qub3JnCmh0dHBzOi8vbGlzdHMueGVucHJvamVjdC5vcmcv bWFpbG1hbi9saXN0aW5mby94ZW4tZGV2ZWw=