From mboxrd@z Thu Jan 1 00:00:00 1970 From: Dave Martin Subject: [PATCH v4 25/25] KVM: arm64/sve: Document KVM API extensions for SVE Date: Thu, 17 Jan 2019 20:33:39 +0000 Message-ID: <1547757219-19439-26-git-send-email-Dave.Martin@arm.com> References: <1547757219-19439-1-git-send-email-Dave.Martin@arm.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from localhost (localhost [127.0.0.1]) by mm01.cs.columbia.edu (Postfix) with ESMTP id 8C20F4A2E4 for ; Thu, 17 Jan 2019 15:35:23 -0500 (EST) Received: from mm01.cs.columbia.edu ([127.0.0.1]) by localhost (mm01.cs.columbia.edu [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id Uz0abm3dcn84 for ; Thu, 17 Jan 2019 15:35:22 -0500 (EST) Received: from foss.arm.com (foss.arm.com [217.140.101.70]) by mm01.cs.columbia.edu (Postfix) with ESMTP id 19A4A4A39E for ; Thu, 17 Jan 2019 15:35:22 -0500 (EST) In-Reply-To: <1547757219-19439-1-git-send-email-Dave.Martin@arm.com> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: kvmarm-bounces@lists.cs.columbia.edu Sender: kvmarm-bounces@lists.cs.columbia.edu To: kvmarm@lists.cs.columbia.edu Cc: Okamoto Takayuki , Christoffer Dall , Ard Biesheuvel , Marc Zyngier , Catalin Marinas , Will Deacon , linux-arm-kernel@lists.infradead.org List-Id: kvmarm@lists.cs.columbia.edu VGhpcyBwYXRjaCBhZGRzIHNlY3Rpb25zIHRvIHRoZSBLVk0gQVBJIGRvY3VtZW50YXRpb24gZGVz Y3JpYmluZwp0aGUgZXh0ZW5zaW9ucyBmb3Igc3VwcG9ydGluZyB0aGUgU2NhbGFibGUgVmVjdG9y IEV4dGVuc2lvbiAoU1ZFKQppbiBndWVzdHMuCgpTaWduZWQtb2ZmLWJ5OiBEYXZlIE1hcnRpbiA8 RGF2ZS5NYXJ0aW5AYXJtLmNvbT4KCi0tLQoKQ2hhbmdlcyBzaW5jZSBSRkMgdjM6CgogKiBSZXdy b3RlIHRoZSBidWxrIG9mIHRoZSBkb2N1bWVudGF0aW9uIHRvIGRvY3VtZW50IHRoZSBuZXcgdmVj dG9yCiAgIGxlbmd0aCBzZXQgY29udHJvbCBpbnRlcmZhY2UgdmlhIEtWTV9SRUdfQVJNNjRfU1ZF X1ZMUywgYW5kIGRlc2NyaWJlCiAgIHRoZSBuZXcgdmNwdSBpbml0IC8gcmVnaXN0ZXIgYWNjZXNz IHNlbWFudGljcy4KCiAqIEZpeCBkb2N1bWVudGF0aW9uIHJlZ2FyZGluZyB3aGljaCBTVkUgWm4g cmVnaXN0ZXIgYml0cyBtdXN0IGJlCiAgIGFjY2Vzc2VkIGluIG9yZGVyIHRvIGdldCBhdCBWbiBv biBhbiBTVkUtZW5hYmxlZCB2Y3B1LgotLS0KIERvY3VtZW50YXRpb24vdmlydHVhbC9rdm0vYXBp LnR4dCB8IDYxICsrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKystLQogMSBmaWxl IGNoYW5nZWQsIDU4IGluc2VydGlvbnMoKyksIDMgZGVsZXRpb25zKC0pCgpkaWZmIC0tZ2l0IGEv RG9jdW1lbnRhdGlvbi92aXJ0dWFsL2t2bS9hcGkudHh0IGIvRG9jdW1lbnRhdGlvbi92aXJ0dWFs L2t2bS9hcGkudHh0CmluZGV4IGNiMTVmMmEuLmQ0NWU5M2MgMTAwNjQ0Ci0tLSBhL0RvY3VtZW50 YXRpb24vdmlydHVhbC9rdm0vYXBpLnR4dAorKysgYi9Eb2N1bWVudGF0aW9uL3ZpcnR1YWwva3Zt L2FwaS50eHQKQEAgLTE4NTYsNiArMTg1Niw3IEBAIFBhcmFtZXRlcnM6IHN0cnVjdCBrdm1fb25l X3JlZyAoaW4pCiBSZXR1cm5zOiAwIG9uIHN1Y2Nlc3MsIG5lZ2F0aXZlIHZhbHVlIG9uIGZhaWx1 cmUKIEVycm9yczoKICDCoEVOT0VOVDogwqDCoG5vIHN1Y2ggcmVnaXN0ZXIKKyDCoEVQRVJNOiDC oMKgwqByZWdpc3RlciBhY2Nlc3MgZm9yYmlkZGVuIGZvciBhcmNoaXRlY3R1cmUtZGVwZW5kZW50 IHJlYXNvbnMKICDCoEVJTlZBTDogwqDCoG90aGVyIGVycm9ycywgc3VjaCBhcyBiYWQgc2l6ZSBl bmNvZGluZyBmb3IgYSBrbm93biByZWdpc3RlcgogCiBzdHJ1Y3Qga3ZtX29uZV9yZWcgewpAQCAt MjExMCwxMyArMjExMSwyMCBAQCBTcGVjaWZpY2FsbHk6CiAgIDB4NjAzMCAwMDAwIDAwMTAgMDA0 YyBTUFNSX1VORCAgICA2NCAgc3BzcltLVk1fU1BTUl9VTkRdCiAgIDB4NjAzMCAwMDAwIDAwMTAg MDA0ZSBTUFNSX0lSUSAgICA2NCAgc3BzcltLVk1fU1BTUl9JUlFdCiAgIDB4NjA2MCAwMDAwIDAw MTAgMDA1MCBTUFNSX0ZJUSAgICA2NCAgc3BzcltLVk1fU1BTUl9GSVFdCi0gIDB4NjA0MCAwMDAw IDAwMTAgMDA1NCBWMCAgICAgICAgIDEyOCAgZnBfcmVncy52cmVnc1swXQotICAweDYwNDAgMDAw MCAwMDEwIDAwNTggVjEgICAgICAgICAxMjggIGZwX3JlZ3MudnJlZ3NbMV0KKyAgMHg2MDQwIDAw MDAgMDAxMCAwMDU0IFYwICAgICAgICAgMTI4ICBmcF9yZWdzLnZyZWdzWzBdICAgICgqKQorICAw eDYwNDAgMDAwMCAwMDEwIDAwNTggVjEgICAgICAgICAxMjggIGZwX3JlZ3MudnJlZ3NbMV0gICAg KCopCiAgICAgLi4uCi0gIDB4NjA0MCAwMDAwIDAwMTAgMDBkMCBWMzEgICAgICAgIDEyOCAgZnBf cmVncy52cmVnc1szMV0KKyAgMHg2MDQwIDAwMDAgMDAxMCAwMGQwIFYzMSAgICAgICAgMTI4ICBm cF9yZWdzLnZyZWdzWzMxXSAgICgqKQogICAweDYwMjAgMDAwMCAwMDEwIDAwZDQgRlBTUiAgICAg ICAgMzIgIGZwX3JlZ3MuZnBzcgogICAweDYwMjAgMDAwMCAwMDEwIDAwZDUgRlBDUiAgICAgICAg MzIgIGZwX3JlZ3MuZnBjcgogCisoKikgVGhlc2UgZW5jb2RpbmdzIGFyZSBub3QgYWNjZXB0ZWQg Zm9yIFNWRS1lbmFibGVkIHZjcHVzLiAgU2VlCisgICAgS1ZNX0FSTV9WQ1BVX0lOSVQuCisKKyAg ICBUaGUgZXF1aXZhbGVudCByZWdpc3RlciBjb250ZW50IGNhbiBiZSBhY2Nlc3NlZCB2aWEgYml0 cyBbMTI3OjBdIG9mCisgICAgdGhlIGNvcnJlc3BvbmRpbmcgU1ZFIFpuIHJlZ2lzdGVycyBpbnN0 ZWFkIGZvciB2Y3B1cyB0aGF0IGhhdmUgU1ZFCisgICAgZW5hYmxlZCAoc2VlIGJlbG93KS4KKwog YXJtNjQgQ0NTSURSIHJlZ2lzdGVycyBhcmUgZGVtdWx0aXBsZXhlZCBieSBDU1NFTFIgdmFsdWU6 CiAgIDB4NjAyMCAwMDAwIDAwMTEgMDAgPGNzc2Vscjo4PgogCkBAIC0yMTI2LDYgKzIxMzQsNTAg QEAgYXJtNjQgc3lzdGVtIHJlZ2lzdGVycyBoYXZlIHRoZSBmb2xsb3dpbmcgaWQgYml0IHBhdHRl cm5zOgogYXJtNjQgZmlybXdhcmUgcHNldWRvLXJlZ2lzdGVycyBoYXZlIHRoZSBmb2xsb3dpbmcg Yml0IHBhdHRlcm46CiAgIDB4NjAzMCAwMDAwIDAwMTQgPHJlZ25vOjE2PgogCithcm02NCBTVkUg cmVnaXN0ZXJzIGhhdmUgdGhlIGZvbGxvd2luZyBiaXQgcGF0dGVybnM6CisgIDB4NjA4MCAwMDAw IDAwMTUgMDAgPG46NT4gPHNsaWNlOjU+ICAgWm4gYml0c1syMDQ4KnNsaWNlICsgMjA0NyA6IDIw NDgqc2xpY2VdCisgIDB4NjA1MCAwMDAwIDAwMTUgMDQgPG46ND4gPHNsaWNlOjU+ICAgUG4gYml0 c1syNTYqc2xpY2UgKyAyNTUgOiAyNTYqc2xpY2VdCisgIDB4NjA1MCAwMDAwIDAwMTUgMDYwIDxz bGljZTo1PiAgICAgICAgRkZSIGJpdHNbMjU2KnNsaWNlICsgMjU1IDogMjU2KnNsaWNlXQorICAw eDYwNjAgMDAwMCAwMDE1IGZmZmYgICAgICAgICAgICAgICAgIEtWTV9SRUdfQVJNNjRfU1ZFX1ZM UyBwc2V1ZG8tcmVnaXN0ZXIKKworVGhlc2UgcmVnaXN0ZXJzIGFyZSBvbmx5IGFjY2Vzc2libGUg b24gdmNwdXMgZm9yIHdoaWNoIFNWRSBpcyBlbmFibGVkLgorU2VlIEtWTV9BUk1fVkNQVV9JTklU IGZvciBkZXRhaWxzLgorCitLVk1fUkVHX0FSTTY0X1NWRV9WTFMgaXMgYSBwc2V1ZG8tcmVnaXN0 ZXIgdGhhdCBhbGxvd3MgdGhlIHNldCBvZiB2ZWN0b3IKK2xlbmd0aHMgc3VwcG9ydGVkIGJ5IHRo ZSB2Y3B1IHRvIGJlIGRpc2NvdmVyZWQgYW5kIGNvbmZpZ3VyZWQgYnkKK3VzZXJzcGFjZS4gIFdo ZW4gdHJhbnNmZXJyZWQgdG8gb3IgZnJvbSB1c2VyIG1lbW9yeSB2aWEgS1ZNX0dFVF9PTkVfUkVH CitvciBLVk1fU0VUX09ORV9SRUcsIHRoZSB2YWx1ZSBvZiB0aGlzIHJlZ2lzdGVyIGlzIG9mIHR5 cGUgX191NjRbOF0sIGFuZAorZW5jb2RlcyB0aGUgc2V0IG9mIHZlY3RvciBsZW5ndGhzIGFzIGZv bGxvd3M6CisKK19fdTY0IHZlY3Rvcl9sZW5ndGhzWzhdOworCitpZiAodnEgPj0gU1ZFX1ZRX01J TiAmJiB2cSA8PSBTVkVfVlFfTUFYICYmCisgICAgKCh2ZWN0b3JfbGVuZ3Roc1sodnEgLSAxKSAv IDY0XSA+PiAoKHZxIC0gMSkgJSA2NCkpICYgMSkpCisJLyogVmVjdG9yIGxlbmd0aCB2cSAqIDE2 IGJ5dGVzIHN1cHBvcnRlZCAqLworZWxzZQorCS8qIFZlY3RvciBsZW5ndGggdnEgKiAxNiBieXRl cyBub3Qgc3VwcG9ydGVkICovCisKKyhTZWUgRG9jdW1lbnRhdGlvbi9hcm02NC9zdmUudHh0IGZv ciBhbiBleHBsYW5hdGlvbiBvZiB0aGUgInZxIgorbm9tZW5jbGF0dXJlLikKKworS1ZNX1JFR19B Uk02NF9TVkVfVkxTIGlzIG9ubHkgYWNjZXNzaWJsZSBhZnRlciBLVk1fQVJNX1ZDUFVfSU5JVC4K K0tWTV9BUk1fVkNQVV9JTklUIGluaXRpYWxpc2VzIGl0IHRvIHRoZSBiZXN0IHNldCBvZiB2ZWN0 b3IgbGVuZ3RocyB0aGF0Cit0aGUgaG9zdCBzdXBwb3J0cy4KKworVXNlcnNwYWNlIG1heSBzdWJz ZXF1ZW50bHkgbW9kaWZ5IGl0IGlmIGRlc2lyZWQgdW50aWwgdGhlIHZjcHUKK2NvbmZpZ3VyYXRp b24gaXMgZmluYWxpemVkIGJ5IGFjY2Vzc2luZyB0aGUgZ3Vlc3QncyBTVkUgcmVnaXN0ZXJzLCBv cgorZW51bWVyYXRpbmcgdGhlbSB2aWEgS1ZNX0dFVF9SRUdfTElTVCwgb3Igc2V0dGluZyB0aGUg Y3B1IHJ1bm5pbmcgdmlhCitLVk1fUlVOLgorCitBcGFydCBmcm9tIHNpbXBseSByZW1vdmluZyBh bGwgdmVjdG9yIGxlbmd0aHMgZnJvbSB0aGUgaG9zdCBzZXQgdGhhdAorZXhjZWVkIHNvbWUgdmFs dWUsIHN1cHBvcnQgZm9yIGFyYml0cmFyaWx5IGNob3NlbiBzZXRzIG9mIHZlY3RvciBsZW5ndGhz CitpcyBoYXJkd2FyZS1kZXBlbmRlbnQgYW5kIG1heSBub3QgYmUgYXZhaWxhYmxlLiAgQXR0ZW1w dGluZyB0byBjb25maWd1cmUKK2FuIGludmFsaWQgc2V0IG9mIHZlY3RvciBsZW5ndGhzIHZpYSBL Vk1fU0VUX09ORV9SRUcgd2lsbCBmYWlsIHdpdGgKK0VJTlZBTC4KKworQWZ0ZXIgdGhlIHZjcHUn cyBjb25maWd1cmF0aW9uIGlzIGZpbmFsaXplZCwgZnVydGhlciBhdHRlbXB0cyB0byB3cml0ZQor dGhpcyByZWdpc3RlciB3aWxsIGZhaWwgd2l0aCBFUEVSTS4KKwogCiBNSVBTIHJlZ2lzdGVycyBh cmUgbWFwcGVkIHVzaW5nIHRoZSBsb3dlciAzMiBiaXRzLiAgVGhlIHVwcGVyIDE2IG9mIHRoYXQg aXMKIHRoZSByZWdpc3RlciBncm91cCB0eXBlOgpAQCAtMjE4MCw2ICsyMjMyLDcgQEAgUGFyYW1l dGVyczogc3RydWN0IGt2bV9vbmVfcmVnIChpbiBhbmQgb3V0KQogUmV0dXJuczogMCBvbiBzdWNj ZXNzLCBuZWdhdGl2ZSB2YWx1ZSBvbiBmYWlsdXJlCiBFcnJvcnM6CiAgwqBFTk9FTlQ6IMKgwqBu byBzdWNoIHJlZ2lzdGVyCisgwqBFUEVSTTogwqDCoMKgcmVnaXN0ZXIgYWNjZXNzIGZvcmJpZGRl biBmb3IgYXJjaGl0ZWN0dXJlLWRlcGVuZGVudCByZWFzb25zCiAgwqBFSU5WQUw6IMKgwqBvdGhl ciBlcnJvcnMsIHN1Y2ggYXMgYmFkIHNpemUgZW5jb2RpbmcgZm9yIGEga25vd24gcmVnaXN0ZXIK IAogVGhpcyBpb2N0bCBhbGxvd3MgdG8gcmVjZWl2ZSB0aGUgdmFsdWUgb2YgYSBzaW5nbGUgcmVn aXN0ZXIgaW1wbGVtZW50ZWQKQEAgLTI2NzIsNiArMjcyNSw4IEBAIFBvc3NpYmxlIGZlYXR1cmVz OgogCSAgRGVwZW5kcyBvbiBLVk1fQ0FQX0FSTV9QU0NJXzBfMi4KIAktIEtWTV9BUk1fVkNQVV9Q TVVfVjM6IEVtdWxhdGUgUE1VdjMgZm9yIHRoZSBDUFUuCiAJICBEZXBlbmRzIG9uIEtWTV9DQVBf QVJNX1BNVV9WMy4KKwktIEtWTV9BUk1fVkNQVV9TVkU6IEVuYWJsZXMgU1ZFIGZvciB0aGUgQ1BV IChhcm02NCBvbmx5KS4KKwkgIERlcGVuZHMgb24gS1ZNX0NBUF9BUk1fU1ZFLgogCiAKIDQuODMg S1ZNX0FSTV9QUkVGRVJSRURfVEFSR0VUCi0tIAoyLjEuNAoKX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX18Ka3ZtYXJtIG1haWxpbmcgbGlzdAprdm1hcm1AbGlz dHMuY3MuY29sdW1iaWEuZWR1Cmh0dHBzOi8vbGlzdHMuY3MuY29sdW1iaWEuZWR1L21haWxtYW4v bGlzdGluZm8va3ZtYXJtCg==