From mboxrd@z Thu Jan 1 00:00:00 1970 From: Lan Tianyu Subject: [PATCH V2 4/25] Xen/doc: Add Xen virtual IOMMU doc Date: Wed, 9 Aug 2017 16:34:05 -0400 Message-ID: <1502310866-10450-5-git-send-email-tianyu.lan@intel.com> References: <1502310866-10450-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: <1502310866-10450-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, julien.grall@arm.com, jbeulich@suse.com, chao.gao@intel.com List-Id: xen-devel@lists.xenproject.org VGhpcyBwYXRjaCBpcyB0byBhZGQgWGVuIHZpcnR1YWwgSU9NTVUgZG9jIHRvIGludHJvZHVjZSBt b3RpdmF0aW9uLApmcmFtZXdvcmssIHZJT01NVSBoeXBlcmNhbGwgYW5kIHhsIGNvbmZpZ3VyYXRp b24uCgpTaWduZWQtb2ZmLWJ5OiBMYW4gVGlhbnl1IDx0aWFueXUubGFuQGludGVsLmNvbT4KLS0t CiBkb2NzL21pc2MvdmlvbW11LnR4dCB8IDEzOSArKysrKysrKysrKysrKysrKysrKysrKysrKysr KysrKysrKysrKysrKysrKysrKysrKysKIDEgZmlsZSBjaGFuZ2VkLCAxMzkgaW5zZXJ0aW9ucygr KQogY3JlYXRlIG1vZGUgMTAwNjQ0IGRvY3MvbWlzYy92aW9tbXUudHh0CgpkaWZmIC0tZ2l0IGEv ZG9jcy9taXNjL3Zpb21tdS50eHQgYi9kb2NzL21pc2MvdmlvbW11LnR4dApuZXcgZmlsZSBtb2Rl IDEwMDY0NAppbmRleCAwMDAwMDAwLi4zOTQ1NWJiCi0tLSAvZGV2L251bGwKKysrIGIvZG9jcy9t aXNjL3Zpb21tdS50eHQKQEAgLTAsMCArMSwxMzkgQEAKK1hlbiB2aXJ0dWFsIElPTU1VCisKK01v 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 LS0tLS0tLS0tLS0tLS0tLS0tLS0tLSsKK3xoeXBlcnZpc29yICAgICB8ICAgICAgICAgICAgICAg ICAgICAgIHwgVklSUSAgICAgICB8Cit8ICAgICAgICAgICAgICAgfCAgICAgICAgICAgICstLS0t LS0tLS0rLS0tLS0tLS0rICAgfAorfCAgICAgICAgICAgICAgIHwgICAgICAgICAgICB8ICAgICAg dkxBUElDICAgICAgfCAgIHwKK3wgICAgICAgICAgICAgICB8VklSUSAgICAgICAgKy0tLS0tLS0t LSstLS0tLS0tLSsgICB8Cit8ICAgICAgICAgICAgICAgfCAgICAgICAgICAgICAgICAgICAgICBe ICAgICAgICAgICAgfAorfCAgICAgICAgICAgICAgIHwgICAgICAgICAgICAgICAgICAgICAgfCAg ICAgICAgICAgIHwKK3wgICAgICAgICAgICAgICB8ICAgICAgICAgICAgKy0tLS0tLS0tLSstLS0t LS0tLSsgICB8Cit8ICAgICAgICAgICAgICAgfCAgICAgICAgICAgIHwgICAgICB2SU9NTVUgICAg ICB8ICAgfAorfCAgICAgICAgICAgICAgIHwgICAgICAgICAgICArLS0tLS0tLS0tKy0tLS0tLS0t KyAgIHwKK3wgICAgICAgICAgICAgICB8ICAgICAgICAgICAgICAgICAgICAgIF4gICAgICAgICAg ICB8Cit8ICAgICAgICAgICAgICAgfCAgICAgICAgICAgICAgICAgICAgICB8ICAgICAgICAgICAg fAorfCAgICAgICAgICAgICAgIHwgICAgICAgICAgICArLS0tLS0tLS0tKy0tLS0tLS0tKyAgIHwK K3wgICAgICAgICAgICAgICB8ICAgICAgICAgICAgfCAgIHZJT0FQSUMvdk1TSSAgIHwgICB8Cit8 ICAgICAgICAgICAgICAgfCAgICAgICAgICAgICstLS0tKy0tLS0rLS0tLS0tLS0rICAgfAorfCAg ICAgICAgICAgICAgIHwgICAgICAgICAgICAgICAgIF4gICAgXiAgICAgICAgICAgIHwKK3wgICAg ICAgICAgICAgICArLS0tLS0tLS0tLS0tLS0tLS0rICAgIHwgICAgICAgICAgICB8Cit8ICAgICAg ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICB8ICAgICAgICAgICAgfAorKy0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLSsKK0hXICAgICAgICAg ICAgICAgICAgICAgICAgICAgICAgICAgICAgIHxJUlEKKyAgICAgICAgICAgICAgICAgICAgICAg ICAgICAgICAgKy0tLS0tLS0tLS0tLS0tLS0tLS0rCisgICAgICAgICAgICAgICAgICAgICAgICAg ICAgICAgIHwgICBQQ0kgRGV2aWNlICAgICAgfAorICAgICAgICAgICAgICAgICAgICAgICAgICAg ICAgICArLS0tLS0tLS0tLS0tLS0tLS0tLSsKKworCit2SU9NTVUgaHlwZXJjYWxsCis9PT09PT09 PT09PT09PT09CitJbnRyb2R1Y2UgbmV3IGRvbWN0bCBoeXBlcmNhbGwgInhlbl9kb21jdGxfdmlv bW11X29wIiB0byBjcmVhdGUvZGVzdHJveQordklPTU1VIGFuZCBxdWVyeSB2SU9NTVUgY2FwYWJp bGl0aWVzIHRoYXQgZGV2aWNlIG1vZGVsIGNhbiBzdXBwb3J0LgorCisqIHZJT01NVSBoeXBlcmNh bGwgcGFyYW1ldGVyIHN0cnVjdHVyZQorCisvKiB2SU9NTVUgdHlwZSAtIHNwZWNpZnkgdmVuZG9y IHZJT01NVSBkZXZpY2UgbW9kZWwgKi8KKyNkZWZpbmUgVklPTU1VX1RZUEVfSU5URUxfVlREICAg ICAoMXUgPDwgMCkKKworLyogdklPTU1VIGNhcGFiaWxpdGllcyAqLworI2RlZmluZSBWSU9NTVVf Q0FQX0lSUV9SRU1BUFBJTkcgICgxdSA8PCAwKQorCitzdHJ1Y3QgeGVuX2RvbWN0bF92aW9tbXVf b3AgeworICAgIHVpbnQzMl90IGNtZDsKKyNkZWZpbmUgWEVOX0RPTUNUTF9jcmVhdGVfdmlvbW11 ICAgICAgICAgIDAKKyNkZWZpbmUgWEVOX0RPTUNUTF9kZXN0cm95X3Zpb21tdSAgICAgICAgIDEK KyNkZWZpbmUgWEVOX0RPTUNUTF9xdWVyeV92aW9tbXVfY2FwcyAgICAgIDIKKyAgICB1bmlvbiB7 CisgICAgICAgIHN0cnVjdCB7CisgICAgICAgICAgICAvKiBJTiAtIHZJT01NVSB0eXBlICAqLwor ICAgICAgICAgICAgdWludDY0X3QgdmlvbW11X3R5cGU7CisgICAgICAgICAgICAvKiBJTiAtIE1N SU8gYmFzZSBhZGRyZXNzIG9mIHZJT01NVS4gKi8KKyAgICAgICAgICAgIHVpbnQ2NF90IGJhc2Vf YWRkcmVzczsKKyAgICAgICAgICAgIC8qIElOIC0gTGVuZ3RoIG9mIE1NSU8gcmVnaW9uICovCisg ICAgICAgICAgICB1aW50NjRfdCBsZW5ndGg7CisgICAgICAgICAgICAvKiBJTiAtIENhcGFiaWxp dGllcyB3aXRoIHdoaWNoIHdlIHdhbnQgdG8gY3JlYXRlICovCisgICAgICAgICAgICB1aW50NjRf dCBjYXBhYmlsaXRpZXM7CisgICAgICAgICAgICAvKiBPVVQgLSB2SU9NTVUgaWRlbnRpdHkgKi8K KyAgICAgICAgICAgIHVpbnQzMl90IHZpb21tdV9pZDsKKyAgICAgICAgfSBjcmVhdGVfdmlvbW11 OworCisgICAgICAgIHN0cnVjdCB7CisgICAgICAgICAgICAvKiBJTiAtIHZJT01NVSBpZGVudGl0 eSAqLworICAgICAgICAgICAgdWludDMyX3QgdmlvbW11X2lkOworICAgICAgICB9IGRlc3Ryb3lf dmlvbW11OworCisgICAgICAgIHN0cnVjdCB7CisgICAgICAgICAgICAvKiBJTiAtIHZJT01NVSB0 eXBlICovCisgICAgICAgICAgICB1aW50NjRfdCB2aW9tbXVfdHlwZTsKKyAgICAgICAgICAgIC8q IE9VVCAtIHZJT01NVSBDYXBhYmlsaXRpZXMgKi8KKyAgICAgICAgICAgIHVpbnQ2NF90IGNhcGFi aWxpdGllczsKKyAgICAgICAgfSBxdWVyeV9jYXBzOworICAgIH0gdTsKK307CisKKy0gWEVOX0RP TUNUTF9xdWVyeV92aW9tbXVfY2FwcworICAgIFF1ZXJ5IGNhcGFiaWxpdGllcyBvZiB2SU9NTVUg ZGV2aWNlIG1vZGVsLiB2SU9NTVVfdHlwZSBzcGVjaWZpZXMKK3doaWNoIHZlbmRvciB2SU9NTVUg ZGV2aWNlIG1vZGVsKEUsRyBJbnRlbCBWVEQpIGlzIHRhcmdldGVkIGFuZCBoeXBlcnZpc29yCity ZXR1cm5zIGNhcGFiaWxpdHkgYml0cyhFLEcgaW50ZXJydXB0IHJlbWFwcGluZyBiaXQpLgorCist IFhFTl9ET01DVExfY3JlYXRlX3Zpb21tdQorICAgIENyZWF0ZSB2SU9NTVUgZGV2aWNlIHdpdGgg dklPTU1VX3R5cGUsIGNhcGFiaWxpdGllcywgTU1JTworYmFzZSBhZGRyZXNzIGFuZCBsZW5ndGgu IEh5cGVydmlzb3IgcmV0dXJucyB2aW9tbXVfaWQuIENhcGFiaWxpdGllcyBzaG91bGQKK2JlIGlu IHJhbmdlIG9mIHZhbHVlIHJldHVybmVkIGJ5IHF1ZXJ5X3Zpb21tdV9jYXBzIGh5cGVyY2FsbC4K KworLSBYRU5fRE9NQ1RMX2Rlc3Ryb3lfdmlvbW11CisgICAgRGVzdHJveSB2SU9NTVUgaW4gWGVu IGh5cGVydmlzb3Igd2l0aCB2aW9tbXVfaWQgYXMgcGFyYW1ldGVycy4KKworTm93IGp1c3Qgc3Vw cHBvcnQgc2luZ2xlIHZJT01NVSBmb3Igb25lIFZNIGFuZCBpbnRyb2R1Y2VkIGRvbXRjbHMgYXJl IGNvbXBhdGlibGUKK3dpdGggbXVsdGktdklPTU1VIHN1cHBvcnQuCisKK3hsIHZJT01NVSBjb25m aWd1cmF0aW9uCis9PT09PT09PT09PT09PT09PT09PT09PQordmlvbW11PSJ0eXBlPWludGVsX3Z0 ZCxpbnRyZW1hcD0xLHgyYXBpYz0xIgorCisidHlwZSIgLSBTcGVjaWZ5IHZJT01NVSBkZXZpY2Ug bW9kZWwgdHlwZS4gQ3VycmVudGx5IG9ubHkgc3VwcG9ydHMgSW50ZWwgdnRkCitkZXZpY2UgbW9k ZWwuCisiaW50cmVtYXAiIC0gRW5hYmxlIHZJT01NVSBpbnRlcnJ1cHQgcmVtYXBwaW5nIGZ1bmN0 aW9uLgorIngyYXBpYyIgLSBTdXBwb3J0IHgyYXBpYyBtb2RlIHdpdGggaW50ZXJydXB0IHJlbWFw cGluZyBmdW5jdGlvbi4KLS0gCjEuOC4zLjEKCgpfX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fXwpYZW4tZGV2ZWwgbWFpbGluZyBsaXN0Clhlbi1kZXZlbEBsaXN0 cy54ZW4ub3JnCmh0dHBzOi8vbGlzdHMueGVuLm9yZy94ZW4tZGV2ZWwK