From mboxrd@z Thu Jan 1 00:00:00 1970 From: Lan Tianyu Subject: [RFC PATCH V2 5/26] Xen/doc: Add Xen virtual IOMMU doc Date: Thu, 18 May 2017 01:34:35 -0400 Message-ID: <1495085696-10819-6-git-send-email-tianyu.lan@intel.com> References: <1495085696-10819-1-git-send-email-tianyu.lan@intel.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: In-Reply-To: <1495085696-10819-1-git-send-email-tianyu.lan@intel.com> List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Errors-To: xen-devel-bounces@lists.xen.org Sender: "Xen-devel" To: xen-devel@lists.xen.org Cc: Lan Tianyu , kevin.tian@intel.com, wei.liu2@citrix.com, andrew.cooper3@citrix.com, ian.jackson@eu.citrix.com, jbeulich@suse.com, chao.gao@intel.com List-Id: xen-devel@lists.xenproject.org VGhpcyBwYXRjaCBpcyB0byBhZGQgWGVuIHZpcnR1YWwgSU9NTVUgZG9jIHRvIGludHJvZHVjZSBt b3RpdmF0aW9uLApmcmFtZXdvcmssIHZJT01NVSBoeXBlcmNhbGwgYW5kIHhsIGNvbmZpZ3VyYXRp b24uCgpTaWduZWQtb2ZmLWJ5OiBMYW4gVGlhbnl1IDx0aWFueXUubGFuQGludGVsLmNvbT4KLS0t CiBkb2NzL21pc2MvdmlvbW11LnR4dCB8IDEyOSArKysrKysrKysrKysrKysrKysrKysrKysrKysr KysrKysrKysrKysrKysrKysrKysrKysKIDEgZmlsZSBjaGFuZ2VkLCAxMjkgaW5zZXJ0aW9ucygr KQogY3JlYXRlIG1vZGUgMTAwNjQ0IGRvY3MvbWlzYy92aW9tbXUudHh0CgpkaWZmIC0tZ2l0IGEv ZG9jcy9taXNjL3Zpb21tdS50eHQgYi9kb2NzL21pc2MvdmlvbW11LnR4dApuZXcgZmlsZSBtb2Rl IDEwMDY0NAppbmRleCAwMDAwMDAwLi43NmQ0Y2VlCi0tLSAvZGV2L251bGwKKysrIGIvZG9jcy9t aXNjL3Zpb21tdS50eHQKQEAgLTAsMCArMSwxMjkgQEAKK1hlbiB2aXJ0dWFsIElPTU1VCisKK01v dGl2YXRpb24KKz09PT09PT09PT0KKyopIEVuYWJsZSBtb3JlIHRoYW4gMjU1IHZjcHUgc3VwcG9y dAorSFBDIGNsb3VkIHNlcnZpY2UgcmVxdWlyZXMgVk0gcHJvdmlkZXMgaGlnaCBwZXJmb3JtYW5j ZSBwYXJhbGxlbAorY29tcHV0aW5nIGFuZCB3ZSBob3BlIHRvIGNyZWF0ZSBhIGh1Z2UgVk0gd2l0 aCA+MjU1IHZjcHUgb24gb25lIG1hY2hpbmUKK3RvIG1lZXQgc3VjaCByZXF1aXJlbWVudC4gUGlu IGVhY2ggdmNwdSB0byBzZXBhcmF0ZSBwY3B1cy4KKworVG8gc3VwcG9ydCA+MjU1IHZjcHVzLCBY MkFQSUMgbW9kZSBpbiBndWVzdCBpcyBuZWNlc3NhcnkgYmVjYXVzZSBsZWdhY3kKK0FQSUMoWEFQ SUMpIGp1c3Qgc3VwcG9ydHMgOC1iaXQgQVBJQyBJRCBhbmQgaXQgb25seSBjYW4gc3VwcG9ydCAy NTUKK3ZjcHVzIGF0IG1vc3QuIFgyQVBJQyBtb2RlIHN1cHBvcnRzIDMyLWJpdCBBUElDIElEIGFu ZCBpdCByZXF1aXJlcworaW50ZXJydXB0IG1hcHBpbmcgZnVuY3Rpb24gb2YgdklPTU1VLgorCitU aGUgcmVhc29uIGZvciB0aGlzIGlzIHRoYXQgdGhlcmUgaXMgbm8gbW9kaWZpY2F0aW9uIHRvIGV4 aXN0aW5nIFBDSSBNU0kKK2FuZCBJT0FQSUMgd2l0aCB0aGUgaW50cm9kdWN0aW9uIG9mIFgyQVBJ Qy4gUENJIE1TSS9JT0FQSUMgY2FuIG9ubHkgc2VuZAoraW50ZXJydXB0IG1lc3NhZ2UgY29udGFp bmluZyA4LWJpdCBBUElDIElELCB3aGljaCBjYW5ub3QgYWRkcmVzcyA+MjU1CitjcHVzLiBJbnRl cnJ1cHQgcmVtYXBwaW5nIHN1cHBvcnRzIDMyLWJpdCBBUElDIElEIGFuZCBzbyBpdCdzIG5lY2Vz c2FyeQordG8gZW5hYmxlID4yNTUgY3B1cyB3aXRoIHgyYXBpYyBtb2RlLgorCisKK3ZJT01NVSBB cmNoaXRlY3R1cmUKKz09PT09PT09PT09PT09PT09PT0KK3ZJT01NVSBkZXZpY2UgbW9kZWwgaXMg aW5zaWRlIFhlbiBoeXBlcnZpc29yIGZvciBmb2xsb3dpbmcgZmFjdG9ycworICAgIDEpIEF2b2lk IHJvdW5kIHRyaXBzIGJldHdlZW4gUWVtdSBhbmQgWGVuIGh5cGVydmlzb3IKKyAgICAyKSBFYXNl IG9mIGludGVncmF0aW9uIHdpdGggdGhlIHJlc3Qgb2YgaHlwZXJ2aXNvcgorICAgIDMpIEhWTWxp dGUvUFZIIGRvZXNuJ3QgdXNlIFFlbXUKKworKiBJbnRlcnJ1cHQgcmVtYXBwaW5nIG92ZXJ2aWV3 LgorSW50ZXJydXB0cyBmcm9tIHZpcnR1YWwgZGV2aWNlcyBhbmQgcGh5c2ljYWwgZGV2aWNlcyBh cmUgZGVsaXZlcmVkCit0byB2TEFQSUMgZnJvbSB2SU9BUElDIGFuZCB2TVNJLiB2SU9NTVUgbmVl ZHMgdG8gcmVtYXAgaW50ZXJydXB0IGR1cmluZwordGhpcyBwcm9jZWR1cmUuCisKKystLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0rCit8UWVtdSAgICAg ICAgICAgICAgICAgICAgICAgfFZNICAgICAgICAgICAgICAgICAgICAgfAorfCAgICAgICAgICAg ICAgICAgICAgICAgICAgIHwgKy0tLS0tLS0tLS0tLS0tLS0rICAgIHwKK3wgICAgICAgICAgICAg ICAgICAgICAgICAgICB8IHwgIERldmljZSBkcml2ZXIgfCAgICB8Cit8ICAgICAgICAgICAgICAg ICAgICAgICAgICAgfCArLS0tLS0tLS0rLS0tLS0tLSsgICAgfAorfCAgICAgICAgICAgICAgICAg ICAgICAgICAgIHwgICAgICAgICAgXiAgICAgICAgICAgIHwKK3wgICAgICAgKy0tLS0tLS0tLS0t LS0tLS0rICB8ICstLS0tLS0tLSstLS0tLS0tKyAgICB8Cit8ICAgICAgIHwgVmlydHVhbCBkZXZp Y2UgfCAgfCB8ICBJUlEgc3Vic3lzdGVtIHwgICAgfAorfCAgICAgICArLS0tLS0tLSstLS0tLS0t LSsgIHwgKy0tLS0tLS0tKy0tLS0tLS0rICAgIHwKK3wgICAgICAgICAgICAgICB8ICAgICAgICAg ICB8ICAgICAgICAgIF4gICAgICAgICAgICB8Cit8ICAgICAgICAgICAgICAgfCAgICAgICAgICAg fCAgICAgICAgICB8ICAgICAgICAgICAgfAorKy0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLSst LS0tLS0tLS0tLS0tLS0tLS0tLS0tLSsKK3xoeXBlcnZpb3NyICAgICB8ICAgICAgICAgICAgICAg ICAgICAgIHwgVklSUSAgICAgICB8Cit8ICAgICAgICAgICAgICAgfCAgICAgICAgICAgICstLS0t LS0tLS0rLS0tLS0tLS0rICAgfAorfCAgICAgICAgICAgICAgIHwgICAgICAgICAgICB8ICAgICAg dkxBUElDICAgICAgfCAgIHwKK3wgICAgICAgICAgICAgICB8VklSUSAgICAgICAgKy0tLS0tLS0t LSstLS0tLS0tLSsgICB8Cit8ICAgICAgICAgICAgICAgfCAgICAgICAgICAgICAgICAgICAgICBe ICAgICAgICAgICAgfAorfCAgICAgICAgICAgICAgIHwgICAgICAgICAgICAgICAgICAgICAgfCAg ICAgICAgICAgIHwKK3wgICAgICAgICAgICAgICB8ICAgICAgICAgICAgKy0tLS0tLS0tLSstLS0t LS0tLSsgICB8Cit8ICAgICAgICAgICAgICAgfCAgICAgICAgICAgIHwgICAgICB2SU9NTVUgICAg ICB8ICAgfAorfCAgICAgICAgICAgICAgIHwgICAgICAgICAgICArLS0tLS0tLS0tKy0tLS0tLS0t KyAgIHwKK3wgICAgICAgICAgICAgICB8ICAgICAgICAgICAgICAgICAgICAgIF4gICAgICAgICAg ICB8Cit8ICAgICAgICAgICAgICAgfCAgICAgICAgICAgICAgICAgICAgICB8ICAgICAgICAgICAg fAorfCAgICAgICAgICAgICAgIHwgICAgICAgICAgICArLS0tLS0tLS0tKy0tLS0tLS0tKyAgIHwK K3wgICAgICAgICAgICAgICB8ICAgICAgICAgICAgfCAgIHZJT0FQSUMvdk1TSSAgIHwgICB8Cit8 ICAgICAgICAgICAgICAgfCAgICAgICAgICAgICstLS0tKy0tLS0rLS0tLS0tLS0rICAgfAorfCAg ICAgICAgICAgICAgIHwgICAgICAgICAgICAgICAgIF4gICAgXiAgICAgICAgICAgIHwKK3wgICAg ICAgICAgICAgICArLS0tLS0tLS0tLS0tLS0tLS0rICAgIHwgICAgICAgICAgICB8Cit8ICAgICAg ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICB8ICAgICAgICAgICAgfAorKy0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLSsKK0hXICAgICAgICAg ICAgICAgICAgICAgICAgICAgICAgICAgICAgIHxJUlEKKyAgICAgICAgICAgICAgICAgICAgICAg ICAgICAgICAgKy0tLS0tLS0tLS0tLS0tLS0tLS0rCisgICAgICAgICAgICAgICAgICAgICAgICAg ICAgICAgIHwgICBQQ0kgRGV2aWNlICAgICAgfAorICAgICAgICAgICAgICAgICAgICAgICAgICAg ICAgICArLS0tLS0tLS0tLS0tLS0tLS0tLSsKKworCit2SU9NTVUgaHlwZXJjYWxsCis9PT09PT09 PT09PT09PT09CitJbnRyb2R1Y2UgbmV3IGRvbWN0bCBoeXBlcmNhbGwgInhlbl9kb21jdGxfdmlv bW11X29wIiB0byBjcmVhdGUvZGVzdHJveQordklPTU1VIGFuZCBxdWVyeSB2SU9NTVUgY2FwYWJp bGl0aWVzIHRoYXQgZGV2aWNlIG1vZGVsIGNhbiBzdXBwb3J0LgorCisqIHZJT01NVSBoeXBlcmNh bGwgcGFyYW1ldGVyIHN0cnVjdHVyZQorc3RydWN0IHhlbl9kb21jdGxfdmlvbW11X29wIHsKKyAg ICB1aW50MzJfdCBjbWQ7CisjZGVmaW5lIFhFTl9ET01DVExfY3JlYXRlX3Zpb21tdSAgICAgICAg ICAwCisjZGVmaW5lIFhFTl9ET01DVExfZGVzdHJveV92aW9tbXUgICAgICAgICAxCisjZGVmaW5l IFhFTl9ET01DVExfcXVlcnlfdmlvbW11X2NhcHMgICAgICAyCisgICAgdW5pb24geworICAgICAg ICBzdHJ1Y3QgeworICAgICAgICAgICAgLyogSU4gLSB2SU9NTVUgdHlwZSAqLworICAgICAgICAg ICAgdWludDY0X3QgdmlvbW11X3R5cGU7CisgICAgICAgICAgICAvKiBJTiAtIE1NSU8gYmFzZSBh ZGRyZXNzIG9mIHZJT01NVS4gKi8KKyAgICAgICAgICAgIHVpbnQ2NF90IGJhc2VfYWRkcmVzczsK KyAgICAgICAgICAgIC8qIElOIC0gTGVuZ3RoIG9mIE1NSU8gcmVnaW9uICovCisgICAgICAgICAg ICB1aW50NjRfdCBsZW5ndGg7CisgICAgICAgICAgICAvKiBJTiAtIENhcGFiaWxpdGllcyB3aXRo IHdoaWNoIHdlIHdhbnQgdG8gY3JlYXRlICovCisgICAgICAgICAgICB1aW50NjRfdCBjYXBhYmls aXRpZXM7CisgICAgICAgICAgICAvKiBPVVQgLSB2SU9NTVUgaWRlbnRpdHkgKi8KKyAgICAgICAg ICAgIHVpbnQzMl90IHZpb21tdV9pZDsKKyAgICAgICAgfSBjcmVhdGVfdmlvbW11OworCisgICAg ICAgIHN0cnVjdCB7CisgICAgICAgICAgICAvKiBJTiAtIHZJT01NVSBpZGVudGl0eSAqLworICAg ICAgICAgICAgdWludDMyX3QgdmlvbW11X2lkOworICAgICAgICB9IGRlc3Ryb3lfdmlvbW11Owor CisgICAgICAgIHN0cnVjdCB7CisgICAgICAgICAgICAvKiBJTiAtIHZJT01NVSB0eXBlICovCisg ICAgICAgICAgICB1aW50NjRfdCB2aW9tbXVfdHlwZTsKKyAgICAgICAgICAgIC8qIE9VVCAtIHZJ T01NVSBDYXBhYmlsaXRpZXMgKi8KKyAgICAgICAgICAgIHVpbnQ2NF90IGNhcHM7CisgICAgICAg IH0gcXVlcnlfY2FwczsKKyAgICB9IHU7Cit9OworCistIFhFTl9ET01DVExfcXVlcnlfdmlvbW11 X2NhcHMKKyAgICBRdWVyeSBjYXBhYmlsaXRpZXMgb2YgdklPTU1VIGRldmljZSBtb2RlbC4gdklP TU1VX3R5cGUgc3BlY2lmaWVzCit3aGljaCB2ZW5kb3IgdklPTU1VIGRldmljZSBtb2RlbChFLEcg SW50ZWwgVlREKSBpcyB0YXJnZXRlZCBhbmQgaHlwZXJ2aXNvcgorcmV0dXJucyBjYXBhYmlsaXR5 IGJpdHMoRSxHIGludGVycnVwdCByZW1hcHBpbmcgYml0KS4KKworLSBYRU5fRE9NQ1RMX2NyZWF0 ZV92aW9tbXUKKyAgICBDcmVhdGUgdklPTU1VIGRldmljZSB3aXRoIHZJT01NVV90eXBlLCBjYXBh YmlsaXRpZXMsIE1NSU8KK2Jhc2UgYWRkcmVzcyBhbmQgbGVuZ3RoLiBIeXBlcnZpc29yIHJldHVy bnMgdmlvbW11X2lkLiBDYXBhYmlsaXRpZXMgc2hvdWxkCitiZSBpbiByYW5nZSBvZiB2YWx1ZSBy ZXR1cm5lZCBieSBxdWVyeV92aW9tbXVfY2FwcyBoeXBlcmNhbGwuCisKKy0gWEVOX0RPTUNUTF9k ZXN0cm95X3Zpb21tdQorICAgIERlc3Ryb3kgdklPTU1VIGluIFhlbiBoeXBlcnZpc29yIHdpdGgg dmlvbW11X2lkIGFzIHBhcmFtZXRlcnMuCisKK3hsIHZJT01NVSBjb25maWd1cmF0aW9uCis9PT09 PT09PT09PT09PT09PT09PT09PQordmlvbW11PSJ0eXBlPXZ0ZCxpbnRyZW1hcD0xLHgyYXBpYz0x IgorCisidHlwZSIgLSBTcGVjaWZ5IHZJT01NVSBkZXZpY2UgbW9kZWwgdHlwZS4gQ3VycmVudGx5 IG9ubHkgc3VwcG9ydHMgSW50ZWwgdnRkCitkZXZpY2UgbW9kZWwuCisiaW50cmVtYXAiIC0gRW5h YmxlIHZJT01NVSBpbnRlcnJ1cHQgcmVtYXBwaW5nIGZ1bmN0aW9uLgorIngyYXBpYyIgLSBTdXBw b3J0IHgyYXBpYyBtb2RlIHdpdGggaW50ZXJydXB0IHJlbWFwcGluZyBmdW5jdGlvbi4KLS0gCjEu OC4zLjEKCgpfX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fXwpY ZW4tZGV2ZWwgbWFpbGluZyBsaXN0Clhlbi1kZXZlbEBsaXN0cy54ZW4ub3JnCmh0dHBzOi8vbGlz dHMueGVuLm9yZy94ZW4tZGV2ZWwK