From mboxrd@z Thu Jan 1 00:00:00 1970 From: Roger Pau Monne Subject: [PATCH v2] x86/HVMlite: document the BSP/AP boot ABI Date: Mon, 25 Jan 2016 11:16:49 +0100 Message-ID: <1453717009-91577-1-git-send-email-royger@FreeBSD.org> 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.xen.org with esmtp (Exim 4.72) (envelope-from ) id 1aNeCk-0007LG-Bg for xen-devel@lists.xenproject.org; Mon, 25 Jan 2016 10:17:02 +0000 Received: by mail-wm0-f68.google.com with SMTP id u188so10349222wmu.0 for ; Mon, 25 Jan 2016 02:17:00 -0800 (PST) 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 RnJvbTogUm9nZXIgUGF1IE1vbm5lIDxyb2dlci5wYXVAY2l0cml4LmNvbT4KClRoZSBkaXNjdXNz aW9uIGluIFsxXSBsZWFkIHRvIGFuIGFncmVlbWVudCBvZiB0aGUgbWlzc2luZyBwaWVjZXMgaW4g UFZICihvciBIVk0gd2l0aG91dCBhIGRldmljZS1tb2RlbCkgaW4gb3JkZXIgdG8gcHJvZ3Jlc3Mg d2l0aCBpdCdzCmltcGxlbWVudGF0aW9uLgoKT25lIG9mIHRoZSBtaXNzaW5nIHBpZWNlcyBpcyBh IG5ldyBib290IEFCSSwgdGhhdCByZXBsYWNlcyB0aGUgUFYgYm9vdApBQkkuIFRoZSBhaW0gb2Yg dGhpcyBuZXcgYm9vdCBBQkkgaXMgdG8gcmVtb3ZlIHRoZSBsaW1pdGF0aW9ucyBvZiB0aGUKUFYg Ym9vdCBBQkksIHRoYXQgYXJlIG5vIGxvbmdlciBwcmVzZW50IHdoZW4gdXNpbmcgYXV0by10cmFu c2xhdGVkCmd1ZXN0cy4gVGhlIG5ldyBib290IHByb3RvY29sIHNob3VsZCBhbGxvdyB0byB1c2Ug dGhlIHNhbWUgZW50cnkgcG9pbnQKZm9yIGJvdGggMzJiaXQgYW5kIDY0Yml0IGd1ZXN0cywgYW5k IGxldCB0aGUgZ3Vlc3QgY2hvb3NlIGl0J3MgYml0bmVzcwphdCBydW4gdGltZSB3aXRob3V0IHRo ZSBkb21haW4gYnVpbGRlciBrbm93aW5nIGluIGFkdmFuY2UuCgpUaGlzIHBhdGNoIGludHJvZHVj ZXMgYSBuZXcgZG9jdW1lbnQgY2FsbGVkIGh2bWxpdGUubWFya2Rvd24sIHdpdGggdGhlCmludGVu dGlvbiBvZiBtZXJnaW5nIGl0IGludG8gcHZoLm1hcmtkb3duIG9uY2UgdGhlIEhWTWxpdGUgaW1w bGVtZW50YXRpb24KaGFzIGZlYXR1cmUgcGFyaXR5IHdpdGggUFZIIGFuZCB0aGUgb2xkIFBWSCBB QkkgaXMgcmVwbGFjZWQgd2l0aCB0aGUKSFZNbGl0ZSBvbmUuCgpbMV0gaHR0cDovL2xpc3RzLnhl bi5vcmcvYXJjaGl2ZXMvaHRtbC94ZW4tZGV2ZWwvMjAxNS0wNi9tc2cwMDI1OC5odG1sCgpTaWdu ZWQtb2ZmLWJ5OiBSb2dlciBQYXUgTW9ubsOpIDxyb2dlci5wYXVAY2l0cml4LmNvbT4KLS0tCkNj OiBJYW4gQ2FtcGJlbGwgPGlhbi5jYW1wYmVsbEBjaXRyaXguY29tPgpDYzogSWFuIEphY2tzb24g PGlhbi5qYWNrc29uQGV1LmNpdHJpeC5jb20+CkNjOiBKYW4gQmV1bGljaCA8amJldWxpY2hAc3Vz ZS5jb20+CkNjOiBUaW0gRGVlZ2FuIDx0aW1AeGVuLm9yZz4KQ2M6IEFuZHJldyBDb29wZXIgPGFu ZHJldy5jb29wZXIzQGNpdHJpeC5jb20+Ci0tLQpDaGFuZ2VzIHNpbmNlIHYxOgogLSBQcmVwZW5k IHg4NiB0byB0aGUgdGl0bGUuCiAtIENvbnNpc3RlbnRseSB1c2UgIm11c3QiLgotLS0KIGRvY3Mv bWlzYy9odm1saXRlLm1hcmtkb3duIHwgODIgKysrKysrKysrKysrKysrKysrKysrKysrKysrKysr KysrKysrKysrKysrKysrKwogMSBmaWxlIGNoYW5nZWQsIDgyIGluc2VydGlvbnMoKykKIGNyZWF0 ZSBtb2RlIDEwMDY0NCBkb2NzL21pc2MvaHZtbGl0ZS5tYXJrZG93bgoKZGlmZiAtLWdpdCBhL2Rv Y3MvbWlzYy9odm1saXRlLm1hcmtkb3duIGIvZG9jcy9taXNjL2h2bWxpdGUubWFya2Rvd24KbmV3 IGZpbGUgbW9kZSAxMDA2NDQKaW5kZXggMDAwMDAwMC4uYzFiNzVjNgotLS0gL2Rldi9udWxsCisr KyBiL2RvY3MvbWlzYy9odm1saXRlLm1hcmtkb3duCkBAIC0wLDAgKzEsODIgQEAKKyoqTk9URSoq OiB0aGlzIGRvY3VtZW50IHdpbGwgYmUgbWVyZ2VkIGludG8gYHB2aC5tYXJrZG93bmAgb25jZSBQ VkggaXMgcmVwbGFjZWQKK3dpdGggdGhlIEhWTWxpdGUgaW1wbGVtZW50YXRpb24uCisKKyMgeDg2 L0hWTSBkaXJlY3QgYm9vdCBBQkkgIworCitTaW5jZSB0aGUgWGVuIGVudHJ5IHBvaW50IGludG8g dGhlIGtlcm5lbCBjYW4gYmUgZGlmZmVyZW50IGZyb20gdGhlCituYXRpdmUgZW50cnkgcG9pbnQs IGEgYEVMRk5PVEVgIGlzIHVzZWQgaW4gb3JkZXIgdG8gdGVsbCB0aGUgZG9tYWluCitidWlsZGVy IGhvdyB0byBsb2FkIGFuZCBqdW1wIGludG8gdGhlIGtlcm5lbCBlbnRyeSBwb2ludDoKKworICAg IEVMRk5PVEUoWGVuLCBYRU5fRUxGTk9URV9QSFlTMzJfRU5UUlksICAgICAgICAgIC5sb25nLCAg eGVuX3N0YXJ0MzIpCisKK1RoZSBwcmVzZW5jZSBvZiB0aGUgYFhFTl9FTEZOT1RFX1BIWVMzMl9F TlRSWWAgbm90ZSBpbmRpY2F0ZXMgdGhhdCB0aGUKK2tlcm5lbCBzdXBwb3J0cyB0aGUgYm9vdCBB QkkgZGVzY3JpYmVkIGluIHRoaXMgZG9jdW1lbnQuCisKK1RoZSBkb21haW4gYnVpbGRlciBtdXN0 IGxvYWQgdGhlIGtlcm5lbCBpbnRvIHRoZSBndWVzdCBtZW1vcnkgc3BhY2UgYW5kCitqdW1wIGlu dG8gdGhlIGVudHJ5IHBvaW50IGRlZmluZWQgYXQgYFhFTl9FTEZOT1RFX1BIWVMzMl9FTlRSWWAg d2l0aCB0aGUKK2ZvbGxvd2luZyBtYWNoaW5lIHN0YXRlOgorCisgKiBgZWJ4YDogY29udGFpbnMg dGhlIHBoeXNpY2FsIG1lbW9yeSBhZGRyZXNzIHdoZXJlIHRoZSBsb2FkZXIgaGFzIHBsYWNlZAor ICAgdGhlIGJvb3Qgc3RhcnQgaW5mbyBzdHJ1Y3R1cmUuCisKKyAqIGBjcjBgOiBiaXQgMCAoUEUp IG11c3QgYmUgc2V0LiBBbGwgdGhlIG90aGVyIHdyaXRlYWJsZSBiaXRzIGFyZSBjbGVhcmVkLgor CisgKiBgY3I0YDogYWxsIGJpdHMgYXJlIGNsZWFyZWQuCisKKyAqIGBjc2A6IG11c3QgYmUgYSAz Mi1iaXQgcmVhZC9leGVjdXRlIGNvZGUgc2VnbWVudCB3aXRoIGEgYmFzZSBvZiDigJgw4oCZCisg ICBhbmQgYSBsaW1pdCBvZiDigJgweEZGRkZGRkZG4oCZLiBUaGUgc2VsZWN0b3IgdmFsdWUgaXMg dW5zcGVjaWZpZWQuCisKKyAqIGBkc2AsIGBlc2A6IG11c3QgYmUgYSAzMi1iaXQgcmVhZC93cml0 ZSBkYXRhIHNlZ21lbnQgd2l0aCBhIGJhc2Ugb2YKKyAgIOKAmDDigJkgYW5kIGEgbGltaXQgb2Yg 4oCYMHhGRkZGRkZGRuKAmS4gVGhlIHNlbGVjdG9yIHZhbHVlcyBhcmUgYWxsIHVuc3BlY2lmaWVk LgorCisgKiBgdHJgOiBtdXN0IGJlIGEgMzItYml0IFRTUyAoYWN0aXZlKSB3aXRoIGEgYmFzZSBv ZiAnMCcgYW5kIGEgbGltaXQgb2YgJzB4NjcnLgorCisgKiBgZWZsYWdzYDogYml0IDE3IChWTSkg bXVzdCBiZSBjbGVhcmVkLiBCaXQgOSAoSUYpIG11c3QgYmUgY2xlYXJlZC4KKyAgIEJpdCA4IChU RikgbXVzdCBiZSBjbGVhcmVkLiBPdGhlciBiaXRzIGFyZSBhbGwgdW5zcGVjaWZpZWQuCisKK0Fs bCBvdGhlciBwcm9jZXNzb3IgcmVnaXN0ZXJzIGFuZCBmbGFnIGJpdHMgYXJlIHVuc3BlY2lmaWVk LiBUaGUgT1MgaXMgaW4KK2NoYXJnZSBvZiBzZXR0aW5nIHVwIGl0J3Mgb3duIHN0YWNrLCBHRFQg YW5kIElEVC4KKworVGhlIGZvcm1hdCBvZiB0aGUgYm9vdCBzdGFydCBpbmZvIHN0cnVjdHVyZSBp cyB0aGUgZm9sbG93aW5nIChwb2ludGVkIHRvCitiZSAlZWJ4KToKKworICAgIHN0cnVjdCBodm1f c3RhcnRfaW5mbyB7CisgICAgI2RlZmluZSBIVk1fU1RBUlRfTUFHSUNfVkFMVUUgMHgzMzZlYzU3 OAorICAgICAgICB1aW50MzJfdCBtYWdpYzsgICAgICAgICAgICAgLyogQ29udGFpbnMgdGhlIG1h Z2ljIHZhbHVlIDB4MzM2ZWM1NzggICAgICAgKi8KKyAgICAgICAgICAgICAgICAgICAgICAgICAg ICAgICAgICAgIC8qICgieEVuMyIgd2l0aCB0aGUgMHg4MCBiaXQgb2YgdGhlICJFIiBzZXQpLiov CisgICAgICAgIHVpbnQzMl90IGZsYWdzOyAgICAgICAgICAgICAvKiBTSUZfeHh4IGZsYWdzLiAg ICAgICAgICAgICAgICAgICAgICAgICAgICAqLworICAgICAgICB1aW50MzJfdCBjbWRsaW5lX3Bh ZGRyOyAgICAgLyogUGh5c2ljYWwgYWRkcmVzcyBvZiB0aGUgY29tbWFuZCBsaW5lLiAgICAgKi8K KyAgICAgICAgdWludDMyX3QgbnJfbW9kdWxlczsgICAgICAgIC8qIE51bWJlciBvZiBtb2R1bGVz IHBhc3NlZCB0byB0aGUga2VybmVsLiAgICovCisgICAgICAgIHVpbnQzMl90IG1vZGxpc3RfcGFk ZHI7ICAgICAvKiBQaHlzaWNhbCBhZGRyZXNzIG9mIGFuIGFycmF5IG9mICAgICAgICAgICAqLwor ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgLyogaHZtX21vZGxpc3RfZW50cnku ICAgICAgICAgICAgICAgICAgICAgICAgKi8KKyAgICB9OworCisgICAgc3RydWN0IGh2bV9tb2Rs aXN0X2VudHJ5IHsKKyAgICAgICAgdWludDMyX3QgcGFkZHI7ICAgICAgICAgICAgIC8qIFBoeXNp Y2FsIGFkZHJlc3Mgb2YgdGhlIG1vZHVsZS4gICAgICAgICAgICovCisgICAgICAgIHVpbnQzMl90 IHNpemU7ICAgICAgICAgICAgICAvKiBTaXplIG9mIHRoZSBtb2R1bGUgaW4gYnl0ZXMuICAgICAg ICAgICAgICAqLworICAgIH07CisKK090aGVyIHJlbGV2YW50IGluZm9ybWF0aW9uIG5lZWRlZCBp biBvcmRlciB0byBib290IGEgZ3Vlc3Qga2VybmVsCisoY29uc29sZSBwYWdlIGFkZHJlc3MsIHhl bnN0b3JlIGV2ZW50IGNoYW5uZWwuLi4pIGNhbiBiZSBvYnRhaW5lZAordXNpbmcgSFZNUEFSQU1T LCBqdXN0IGxpa2UgaXQncyBkb25lIG9uIEhWTSBndWVzdHMuCisKK1RoZSBzZXR1cCBvZiB0aGUg aHlwZXJjYWxsIHBhZ2UgaXMgYWxzbyBwZXJmb3JtZWQgaW4gdGhlIHNhbWUgd2F5CithcyBIVk0g Z3Vlc3RzLCB1c2luZyB0aGUgaHlwZXJ2aXNvciBjcHVpZCBsZWF2ZXMgYW5kIG1zciByYW5nZXMu CisKKyMjIEFQIHN0YXJ0dXAgIyMKKworQVAgc3RhcnR1cCBpcyBwZXJmb3JtZWQgdXNpbmcgaHlw ZXJjYWxscy4gVGhlIGZvbGxvd2luZyBWQ1BVIG9wZXJhdGlvbnMKK2FyZSB1c2VkIGluIG9yZGVy IHRvIGJyaW5nIHVwIHNlY29uZGFyeSB2Q1BVczoKKworICogYFZDUFVPUF9pbml0aWFsaXNlYCBp cyB1c2VkIHRvIHNldCB0aGUgaW5pdGlhbCBzdGF0ZSBvZiB0aGUgdkNQVS4gVGhlCisgICBhcmd1 bWVudCBwYXNzZWQgdG8gdGhlIGh5cGVyY2FsbCBtdXN0IGJlIG9mIHRoZSB0eXBlIHZjcHVfaHZt X2NvbnRleHQuCisgICBTZWUgYHB1YmxpYy9odm0vaHZtX3ZjcHUuaGAgZm9yIHRoZSBsYXlvdXQg b2YgdGhlIHN0cnVjdHVyZS4gTm90ZSB0aGF0CisgICB0aGlzIGh5cGVyY2FsbCBhbGxvd3Mgc3Rh cnRpbmcgdGhlIHZDUFUgaW4gc2V2ZXJhbCBtb2RlcyAoMTYvMzIvNjRiaXRzKSwKKyAgIHJlZ2Fy ZGxlc3Mgb2YgdGhlIG1vZGUgdGhlIEJTUCBpcyBjdXJyZW50bHkgcnVubmluZyBvbi4KKworICog YFZDUFVPUF91cGAgaXMgdXNlZCB0byBsYXVuY2ggdGhlIHZDUFUgb25jZSB0aGUgaW5pdGlhbCBz dGF0ZSBoYXMgYmVlbgorICAgc2V0IHVzaW5nIGBWQ1BVT1BfaW5pdGlhbGlzZWAuCisKKyAqIGBW Q1BVT1BfZG93bmAgaXMgdXNlZCB0byBicmluZyBkb3duIGEgdkNQVS4KKworICogYFZDUFVPUF9p c191cGAgaXMgdXNlZCB0byBzY2FuIHRoZSBudW1iZXIgb2YgYXZhaWxhYmxlIHZDUFVzLgotLSAK MS45LjUgKEFwcGxlIEdpdC01MC4zKQoKCl9fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fClhlbi1kZXZlbCBtYWlsaW5nIGxpc3QKWGVuLWRldmVsQGxpc3RzLnhl bi5vcmcKaHR0cDovL2xpc3RzLnhlbi5vcmcveGVuLWRldmVsCg==