From mboxrd@z Thu Jan 1 00:00:00 1970 From: Roger Pau Monne Subject: [PATCH] hvmlite: document the BSP/AP boot ABI Date: Tue, 15 Dec 2015 18:27:25 +0100 Message-ID: <1450200445-29402-1-git-send-email-roger.pau@citrix.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from mail6.bemta3.messagelabs.com ([195.245.230.39]) by lists.xen.org with esmtp (Exim 4.72) (envelope-from ) id 1a8tsH-0004JF-EP for xen-devel@lists.xenproject.org; Tue, 15 Dec 2015 17:58:57 +0000 List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Sender: xen-devel-bounces@lists.xen.org Errors-To: xen-devel-bounces@lists.xen.org To: xen-devel@lists.xenproject.org Cc: Ian Campbell , Andrew Cooper , Tim Deegan , Jan Beulich , Ian Jackson , Roger Pau Monne List-Id: xen-devel@lists.xenproject.org VGhlIGRpc2N1c3Npb24gaW4gWzFdIGxlYWQgdG8gYW4gYWdyZWVtZW50IG9mIHRoZSBtaXNzaW5n IHBpZWNlcyBpbiBQVkgKKG9yIEhWTSB3aXRob3V0IGEgZGV2aWNlLW1vZGVsKSBpbiBvcmRlciB0 byBwcm9ncmVzcyB3aXRoIGl0J3MKaW1wbGVtZW50YXRpb24uCgpPbmUgb2YgdGhlIG1pc3Npbmcg cGllY2VzIGlzIGEgbmV3IGJvb3QgQUJJLCB0aGF0IHJlcGxhY2VzIHRoZSBQViBib290CkFCSS4g VGhlIGFpbSBvZiB0aGlzIG5ldyBib290IEFCSSBpcyB0byByZW1vdmUgdGhlIGxpbWl0YXRpb25z IG9mIHRoZQpQViBib290IEFCSSwgdGhhdCBhcmUgbm8gbG9uZ2VyIHByZXNlbnQgd2hlbiB1c2lu ZyBhdXRvLXRyYW5zbGF0ZWQKZ3Vlc3RzLiBUaGUgbmV3IGJvb3QgcHJvdG9jb2wgc2hvdWxkIGFs bG93IHRvIHVzZSB0aGUgc2FtZSBlbnRyeSBwb2ludApmb3IgYm90aCAzMmJpdCBhbmQgNjRiaXQg Z3Vlc3RzLCBhbmQgbGV0IHRoZSBndWVzdCBjaG9vc2UgaXQncyBiaXRuZXNzCmF0IHJ1biB0aW1l IHdpdGhvdXQgdGhlIGRvbWFpbiBidWlsZGVyIGtub3dpbmcgaW4gYWR2YW5jZS4KClRoaXMgcGF0 Y2ggaW50cm9kdWNlcyBhIG5ldyBkb2N1bWVudCBjYWxsZWQgaHZtbGl0ZS5tYXJrZG93biwgd2l0 aCB0aGUKaW50ZW50aW9uIG9mIG1lcmdpbmcgaXQgaW50byBwdmgubWFya2Rvd24gb25jZSB0aGUg SFZNbGl0ZSBpbXBsZW1lbnRhdGlvbgpoYXMgZmVhdHVyZSBwYXJpdHkgd2l0aCBQVkggYW5kIHRo ZSBvbGQgUFZIIEFCSSBpcyByZXBsYWNlZCB3aXRoIHRoZQpIVk1saXRlIG9uZS4KClsxXSBodHRw Oi8vbGlzdHMueGVuLm9yZy9hcmNoaXZlcy9odG1sL3hlbi1kZXZlbC8yMDE1LTA2L21zZzAwMjU4 Lmh0bWwKClNpZ25lZC1vZmYtYnk6IFJvZ2VyIFBhdSBNb25uw6kgPHJvZ2VyLnBhdUBjaXRyaXgu Y29tPgotLS0KQ2M6IElhbiBDYW1wYmVsbCA8aWFuLmNhbXBiZWxsQGNpdHJpeC5jb20+CkNjOiBJ YW4gSmFja3NvbiA8aWFuLmphY2tzb25AZXUuY2l0cml4LmNvbT4KQ2M6IEphbiBCZXVsaWNoIDxq YmV1bGljaEBzdXNlLmNvbT4KQ2M6IFRpbSBEZWVnYW4gPHRpbUB4ZW4ub3JnPgpDYzogQW5kcmV3 IENvb3BlciA8YW5kcmV3LmNvb3BlcjNAY2l0cml4LmNvbT4KLS0tCiBkb2NzL21pc2MvaHZtbGl0 ZS5tYXJrZG93biB8IDgyICsrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysr KysrKysKIDEgZmlsZSBjaGFuZ2VkLCA4MiBpbnNlcnRpb25zKCspCiBjcmVhdGUgbW9kZSAxMDA2 NDQgZG9jcy9taXNjL2h2bWxpdGUubWFya2Rvd24KCmRpZmYgLS1naXQgYS9kb2NzL21pc2MvaHZt bGl0ZS5tYXJrZG93biBiL2RvY3MvbWlzYy9odm1saXRlLm1hcmtkb3duCm5ldyBmaWxlIG1vZGUg MTAwNjQ0CmluZGV4IDAwMDAwMDAuLjAwYWU0MjMKLS0tIC9kZXYvbnVsbAorKysgYi9kb2NzL21p c2MvaHZtbGl0ZS5tYXJrZG93bgpAQCAtMCwwICsxLDgyIEBACisqKk5PVEUqKjogdGhpcyBkb2N1 bWVudCB3aWxsIGJlIG1lcmdlZCBpbnRvIGBwdmgubWFya2Rvd25gIG9uY2UgUFZIIGlzIHJlcGxh Y2VkCit3aXRoIHRoZSBIVk1saXRlIGltcGxlbWVudGF0aW9uLgorCisjIEhWTSBkaXJlY3QgYm9v dCBBQkkgIworCitTaW5jZSB0aGUgWGVuIGVudHJ5IHBvaW50IGludG8gdGhlIGtlcm5lbCBjYW4g YmUgZGlmZmVyZW50IGZyb20gdGhlCituYXRpdmUgZW50cnkgcG9pbnQsIGEgYEVMRk5PVEVgIGlz IHVzZWQgaW4gb3JkZXIgdG8gdGVsbCB0aGUgZG9tYWluCitidWlsZGVyIGhvdyB0byBsb2FkIGFu ZCBqdW1wIGludG8gdGhlIGtlcm5lbCBlbnRyeSBwb2ludDoKKworICAgIEVMRk5PVEUoWGVuLCBY RU5fRUxGTk9URV9QSFlTMzJfRU5UUlksICAgICAgICAgIC5sb25nLCAgeGVuX3N0YXJ0MzIpCisK K1RoZSBwcmVzZW5jZSBvZiB0aGUgYFhFTl9FTEZOT1RFX1BIWVMzMl9FTlRSWWAgbm90ZSBpbmRp Y2F0ZXMgdGhhdCB0aGUKK2tlcm5lbCBzdXBwb3J0cyB0aGUgYm9vdCBBQkkgZGVzY3JpYmVkIGlu IHRoaXMgZG9jdW1lbnQuCisKK1RoZSBkb21haW4gYnVpbGRlciB3aWxsIGxvYWQgdGhlIGtlcm5l bCBpbnRvIHRoZSBndWVzdCBtZW1vcnkgc3BhY2UgYW5kCitqdW1wIGludG8gdGhlIGVudHJ5IHBv aW50IGRlZmluZWQgYXQgYFhFTl9FTEZOT1RFX1BIWVMzMl9FTlRSWWAgd2l0aCB0aGUKK2ZvbGxv d2luZyBtYWNoaW5lIHN0YXRlOgorCisgKiBgZWJ4YDogY29udGFpbnMgdGhlIHBoeXNpY2FsIG1l bW9yeSBhZGRyZXNzIHdoZXJlIHRoZSBsb2FkZXIgaGFzIHBsYWNlZAorICAgdGhlIGJvb3Qgc3Rh cnQgaW5mbyBzdHJ1Y3R1cmUuCisKKyAqIGBjcjBgOiBiaXQgMCAoUEUpIHdpbGwgYmUgc2V0LiBB bGwgdGhlIG90aGVyIHdyaXRlYWJsZSBiaXRzIGFyZSBjbGVhcmVkLgorCisgKiBgY3I0YDogYWxs IGJpdHMgYXJlIGNsZWFyZWQuCisKKyAqIGBjc2A6IG11c3QgYmUgYSAzMi1iaXQgcmVhZC9leGVj dXRlIGNvZGUgc2VnbWVudCB3aXRoIGEgYmFzZSBvZiDigJgw4oCZCisgICBhbmQgYSBsaW1pdCBv ZiDigJgweEZGRkZGRkZG4oCZLiBUaGUgc2VsZWN0b3IgdmFsdWUgaXMgdW5zcGVjaWZpZWQuCisK KyAqIGBkc2AsIGBlc2A6IG11c3QgYmUgYSAzMi1iaXQgcmVhZC93cml0ZSBkYXRhIHNlZ21lbnQg d2l0aCBhIGJhc2Ugb2YKKyAgIOKAmDDigJkgYW5kIGEgbGltaXQgb2Yg4oCYMHhGRkZGRkZGRuKA mS4gVGhlIHNlbGVjdG9yIHZhbHVlcyBhcmUgYWxsIHVuc3BlY2lmaWVkLgorCisgKiBgdHJgOiBt dXN0IGJlIGEgMzItYml0IFRTUyAoYWN0aXZlKSB3aXRoIGEgYmFzZSBvZiAnMCcgYW5kIGEgbGlt aXQgb2YgJzB4NjcnLgorCisgKiBgZWZsYWdzYDogYml0IDE3IChWTSkgbXVzdCBiZSBjbGVhcmVk LiBCaXQgOSAoSUYpIG11c3QgYmUgY2xlYXJlZC4KKyAgIEJpdCA4IChURikgbXVzdCBiZSBjbGVh cmVkLiBPdGhlciBiaXRzIGFyZSBhbGwgdW5zcGVjaWZpZWQuCisKK0FsbCBvdGhlciBwcm9jZXNz b3IgcmVnaXN0ZXJzIGFuZCBmbGFnIGJpdHMgYXJlIHVuc3BlY2lmaWVkLiBUaGUgT1MgaXMgaW4K K2NoYXJnZSBvZiBzZXR0aW5nIHVwIGl0J3Mgb3duIHN0YWNrLCBHRFQgYW5kIElEVC4KKworVGhl IGZvcm1hdCBvZiB0aGUgYm9vdCBzdGFydCBpbmZvIHN0cnVjdHVyZSBpcyB0aGUgZm9sbG93aW5n IChwb2ludGVkIHRvCitiZSAlZWJ4KToKKworICAgIHN0cnVjdCBodm1fc3RhcnRfaW5mbyB7Cisg ICAgI2RlZmluZSBIVk1fU1RBUlRfTUFHSUNfVkFMVUUgMHgzMzZlYzU3OAorICAgICAgICB1aW50 MzJfdCBtYWdpYzsgICAgICAgICAgICAgLyogQ29udGFpbnMgdGhlIG1hZ2ljIHZhbHVlIDB4MzM2 ZWM1NzggICAgICAgKi8KKyAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIC8qICgi eEVuMyIgd2l0aCB0aGUgMHg4MCBiaXQgb2YgdGhlICJFIiBzZXQpLiovCisgICAgICAgIHVpbnQz Ml90IGZsYWdzOyAgICAgICAgICAgICAvKiBTSUZfeHh4IGZsYWdzLiAgICAgICAgICAgICAgICAg ICAgICAgICAgICAqLworICAgICAgICB1aW50MzJfdCBjbWRsaW5lX3BhZGRyOyAgICAgLyogUGh5 c2ljYWwgYWRkcmVzcyBvZiB0aGUgY29tbWFuZCBsaW5lLiAgICAgKi8KKyAgICAgICAgdWludDMy X3QgbnJfbW9kdWxlczsgICAgICAgIC8qIE51bWJlciBvZiBtb2R1bGVzIHBhc3NlZCB0byB0aGUg a2VybmVsLiAgICovCisgICAgICAgIHVpbnQzMl90IG1vZGxpc3RfcGFkZHI7ICAgICAvKiBQaHlz aWNhbCBhZGRyZXNzIG9mIGFuIGFycmF5IG9mICAgICAgICAgICAqLworICAgICAgICAgICAgICAg ICAgICAgICAgICAgICAgICAgICAgLyogaHZtX21vZGxpc3RfZW50cnkuICAgICAgICAgICAgICAg ICAgICAgICAgKi8KKyAgICB9OworCisgICAgc3RydWN0IGh2bV9tb2RsaXN0X2VudHJ5IHsKKyAg ICAgICAgdWludDMyX3QgcGFkZHI7ICAgICAgICAgICAgIC8qIFBoeXNpY2FsIGFkZHJlc3Mgb2Yg dGhlIG1vZHVsZS4gICAgICAgICAgICovCisgICAgICAgIHVpbnQzMl90IHNpemU7ICAgICAgICAg ICAgICAvKiBTaXplIG9mIHRoZSBtb2R1bGUgaW4gYnl0ZXMuICAgICAgICAgICAgICAqLworICAg IH07CisKK090aGVyIHJlbGV2YW50IGluZm9ybWF0aW9uIG5lZWRlZCBpbiBvcmRlciB0byBib290 IGEgZ3Vlc3Qga2VybmVsCisoY29uc29sZSBwYWdlIGFkZHJlc3MsIHhlbnN0b3JlIGV2ZW50IGNo YW5uZWwuLi4pIGNhbiBiZSBvYnRhaW5lZAordXNpbmcgSFZNUEFSQU1TLCBqdXN0IGxpa2UgaXQn cyBkb25lIG9uIEhWTSBndWVzdHMuCisKK1RoZSBzZXR1cCBvZiB0aGUgaHlwZXJjYWxsIHBhZ2Ug aXMgYWxzbyBwZXJmb3JtZWQgaW4gdGhlIHNhbWUgd2F5CithcyBIVk0gZ3Vlc3RzLCB1c2luZyB0 aGUgaHlwZXJ2aXNvciBjcHVpZCBsZWF2ZXMgYW5kIG1zciByYW5nZXMuCisKKyMjIEFQIHN0YXJ0 dXAgIyMKKworQVAgc3RhcnR1cCBpcyBwZXJmb3JtZWQgdXNpbmcgaHlwZXJjYWxscy4gVGhlIGZv bGxvd2luZyBWQ1BVIG9wZXJhdGlvbnMKK2FyZSB1c2VkIGluIG9yZGVyIHRvIGJyaW5nIHVwIHNl Y29uZGFyeSB2Q1BVczoKKworICogYFZDUFVPUF9pbml0aWFsaXNlYCBpcyB1c2VkIHRvIHNldCB0 aGUgaW5pdGlhbCBzdGF0ZSBvZiB0aGUgdkNQVS4gVGhlCisgICBhcmd1bWVudCBwYXNzZWQgdG8g dGhlIGh5cGVyY2FsbCBtdXN0IGJlIG9mIHRoZSB0eXBlIHZjcHVfaHZtX2NvbnRleHQuCisgICBT ZWUgYHB1YmxpYy9odm0vaHZtX3ZjcHUuaGAgZm9yIHRoZSBsYXlvdXQgb2YgdGhlIHN0cnVjdHVy ZS4gTm90ZSB0aGF0CisgICB0aGlzIGh5cGVyY2FsbCBhbGxvd3Mgc3RhcnRpbmcgdGhlIHZDUFUg aW4gc2V2ZXJhbCBtb2RlcyAoMTYvMzIvNjRiaXRzKSwKKyAgIHJlZ2FyZGxlc3Mgb2YgdGhlIG1v ZGUgdGhlIEJTUCBpcyBjdXJyZW50bHkgcnVubmluZyBvbi4KKworICogYFZDUFVPUF91cGAgaXMg dXNlZCB0byBsYXVuY2ggdGhlIHZDUFUgb25jZSB0aGUgaW5pdGlhbCBzdGF0ZSBoYXMgYmVlbgor ICAgc2V0IHVzaW5nIGBWQ1BVT1BfaW5pdGlhbGlzZWAuCisKKyAqIGBWQ1BVT1BfZG93bmAgaXMg dXNlZCB0byBicmluZyBkb3duIGEgdkNQVS4KKworICogYFZDUFVPUF9pc191cGAgaXMgdXNlZCB0 byBzY2FuIHRoZSBudW1iZXIgb2YgYXZhaWxhYmxlIHZDUFVzLgotLSAKMS45LjUgKEFwcGxlIEdp dC01MC4zKQoKCl9fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f Clhlbi1kZXZlbCBtYWlsaW5nIGxpc3QKWGVuLWRldmVsQGxpc3RzLnhlbi5vcmcKaHR0cDovL2xp c3RzLnhlbi5vcmcveGVuLWRldmVsCg==