From mboxrd@z Thu Jan 1 00:00:00 1970 From: Lan Tianyu Subject: [PATCH V3 1/29] Xen/doc: Add Xen virtual IOMMU doc Date: Thu, 21 Sep 2017 23:01:42 -0400 Message-ID: <1506049330-11196-2-git-send-email-tianyu.lan@intel.com> References: <1506049330-11196-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: <1506049330-11196-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, sstabellini@kernel.org, wei.liu2@citrix.com, George.Dunlap@eu.citrix.com, andrew.cooper3@citrix.com, ian.jackson@eu.citrix.com, tim@xen.org, jbeulich@suse.com, roger.pau@citrix.com, chao.gao@intel.com List-Id: xen-devel@lists.xenproject.org VGhpcyBwYXRjaCBpcyB0byBhZGQgWGVuIHZpcnR1YWwgSU9NTVUgZG9jIHRvIGludHJvZHVjZSBt b3RpdmF0aW9uLApmcmFtZXdvcmssIHZJT01NVSBoeXBlcmNhbGwgYW5kIHhsIGNvbmZpZ3VyYXRp b24uCgpTaWduZWQtb2ZmLWJ5OiBMYW4gVGlhbnl1IDx0aWFueXUubGFuQGludGVsLmNvbT4KLS0t CiBkb2NzL21pc2MvdmlvbW11LnR4dCB8IDEzNiArKysrKysrKysrKysrKysrKysrKysrKysrKysr KysrKysrKysrKysrKysrKysrKysrKysKIDEgZmlsZSBjaGFuZ2VkLCAxMzYgaW5zZXJ0aW9ucygr KQogY3JlYXRlIG1vZGUgMTAwNjQ0IGRvY3MvbWlzYy92aW9tbXUudHh0CgpkaWZmIC0tZ2l0IGEv ZG9jcy9taXNjL3Zpb21tdS50eHQgYi9kb2NzL21pc2MvdmlvbW11LnR4dApuZXcgZmlsZSBtb2Rl IDEwMDY0NAppbmRleCAwMDAwMDAwLi4zNDhlOGM0Ci0tLSAvZGV2L251bGwKKysrIGIvZG9jcy9t aXNjL3Zpb21tdS50eHQKQEAgLTAsMCArMSwxMzYgQEAKK1hlbiB2aXJ0dWFsIElPTU1VCisKK01v dGl2YXRpb24KKz09PT09PT09PT0KK0VuYWJsZSBtb3JlIHRoYW4gMTI4IHZjcHUgc3VwcG9ydAor CitUaGUgY3VycmVudCByZXF1aXJlbWVudHMgb2YgSFBDIGNsb3VkIHNlcnZpY2UgcmVxdWlyZXMg Vk0gd2l0aCBhIGhpZ2gKK251bWJlciBvZiBDUFVzIGluIG9yZGVyIHRvIGFjaGlldmUgaGlnaCBw ZXJmb3JtYW5jZSBpbiBwYXJhbGxlbAorY29tcHV0aW5nLgorCitUbyBzdXBwb3J0ID4xMjggdmNw dXMsIFgyQVBJQyBtb2RlIGluIGd1ZXN0IGlzIG5lY2Vzc2FyeSBiZWNhdXNlIGxlZ2FjeQorQVBJ QyhYQVBJQykganVzdCBzdXBwb3J0cyA4LWJpdCBBUElDIElELiBUaGUgQVBJQyBJRCB1c2VkIGJ5 IFhlbiBpcworQ1BVIElEICogMiAoaWU6IENQVSAxMjcgaGFzIEFQSUMgSUQgMjU0LCB3aGljaCBp cyB0aGUgbGFzdCBvbmUgYXZhaWxhYmxlCitpbiB4QVBJQyBtb2RlKSBhbmQgc28gaXQgb25seSBj YW4gc3VwcG9ydCAxMjggdmNwdXMgYXQgbW9zdC4geDJBUElDIG1vZGUKK3N1cHBvcnRzIDMyLWJp dCBBUElDIElEIGFuZCBpdCByZXF1aXJlcyB0aGUgaW50ZXJydXB0IHJlbWFwcGluZyBmdW5jdGlv bmFsaXR5CitvZiBhIHZJT01NVSBpZiB0aGUgZ3Vlc3Qgd2lzaGVzIHRvIHJvdXRlIGludGVycnVw dHMgdG8gYWxsIGF2YWlsYWJsZSB2Q1BVcworCitUaGUgcmVhc29uIGZvciB0aGlzIGlzIHRoYXQg dGhlcmUgaXMgbm8gbW9kaWZpY2F0aW9uIGZvciBleGlzdGluZyBQQ0kgTVNJCithbmQgSU9BUElD IHdoZW4gaW50cm9kdWNlIFgyQVBJQy4gUENJIE1TSS9JT0FQSUMgY2FuIG9ubHkgc2VuZCBpbnRl cnJ1cHQKK21lc3NhZ2UgY29udGFpbmluZyA4LWJpdCBBUElDIElELCB3aGljaCBjYW5ub3QgYWRk cmVzcyBjcHVzIHdpdGggPjI1NAorQVBJQyBJRC4gSW50ZXJydXB0IHJlbWFwcGluZyBzdXBwb3J0 cyAzMi1iaXQgQVBJQyBJRCBhbmQgc28gaXQncyBuZWNlc3NhcnkKK2ZvciA+MTI4IHZjcHVzIHN1 cHBvcnQuCisKKwordklPTU1VIEFyY2hpdGVjdHVyZQorPT09PT09PT09PT09PT09PT09PQordklP TU1VIGRldmljZSBtb2RlbCBpcyBpbnNpZGUgWGVuIGh5cGVydmlzb3IgZm9yIGZvbGxvd2luZyBm YWN0b3JzCisgICAgMSkgQXZvaWQgcm91bmQgdHJpcHMgYmV0d2VlbiBRZW11IGFuZCBYZW4gaHlw ZXJ2aXNvcgorICAgIDIpIEVhc2Ugb2YgaW50ZWdyYXRpb24gd2l0aCB0aGUgcmVzdCBvZiBoeXBl cnZpc29yCisgICAgMykgSFZNbGl0ZS9QVkggZG9lc24ndCB1c2UgUWVtdQorCisqIEludGVycnVw dCByZW1hcHBpbmcgb3ZlcnZpZXcuCitJbnRlcnJ1cHRzIGZyb20gdmlydHVhbCBkZXZpY2VzIGFu ZCBwaHlzaWNhbCBkZXZpY2VzIGFyZSBkZWxpdmVyZWQKK3RvIHZMQVBJQyBmcm9tIHZJT0FQSUMg YW5kIHZNU0kuIHZJT01NVSBuZWVkcyB0byByZW1hcCBpbnRlcnJ1cHQgZHVyaW5nCit0aGlzIHBy b2NlZHVyZS4KKworKy0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLSsKK3xRZW11ICAgICAgICAgICAgICAgICAgICAgICB8Vk0gICAgICAgICAgICAgICAg ICAgICB8Cit8ICAgICAgICAgICAgICAgICAgICAgICAgICAgfCArLS0tLS0tLS0tLS0tLS0tLSsg ICAgfAorfCAgICAgICAgICAgICAgICAgICAgICAgICAgIHwgfCAgRGV2aWNlIGRyaXZlciB8ICAg IHwKK3wgICAgICAgICAgICAgICAgICAgICAgICAgICB8ICstLS0tLS0tLSstLS0tLS0tKyAgICB8 Cit8ICAgICAgICAgICAgICAgICAgICAgICAgICAgfCAgICAgICAgICBeICAgICAgICAgICAgfAor fCAgICAgICArLS0tLS0tLS0tLS0tLS0tLSsgIHwgKy0tLS0tLS0tKy0tLS0tLS0rICAgIHwKK3wg ICAgICAgfCBWaXJ0dWFsIGRldmljZSB8ICB8IHwgIElSUSBzdWJzeXN0ZW0gfCAgICB8Cit8ICAg ICAgICstLS0tLS0tKy0tLS0tLS0tKyAgfCArLS0tLS0tLS0rLS0tLS0tLSsgICAgfAorfCAgICAg ICAgICAgICAgIHwgICAgICAgICAgIHwgICAgICAgICAgXiAgICAgICAgICAgIHwKK3wgICAgICAg ICAgICAgICB8ICAgICAgICAgICB8ICAgICAgICAgIHwgICAgICAgICAgICB8CisrLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tKy0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tKworfGh5cGVydmlzb3Ig ICAgIHwgICAgICAgICAgICAgICAgICAgICAgfCBWSVJRICAgICAgIHwKK3wgICAgICAgICAgICAg ICB8ICAgICAgICAgICAgKy0tLS0tLS0tLSstLS0tLS0tLSsgICB8Cit8ICAgICAgICAgICAgICAg fCAgICAgICAgICAgIHwgICAgICB2TEFQSUMgICAgICB8ICAgfAorfCAgICAgICAgICAgICAgIHxW SVJRICAgICAgICArLS0tLS0tLS0tKy0tLS0tLS0tKyAgIHwKK3wgICAgICAgICAgICAgICB8ICAg ICAgICAgICAgICAgICAgICAgIF4gICAgICAgICAgICB8Cit8ICAgICAgICAgICAgICAgfCAgICAg ICAgICAgICAgICAgICAgICB8ICAgICAgICAgICAgfAorfCAgICAgICAgICAgICAgIHwgICAgICAg ICAgICArLS0tLS0tLS0tKy0tLS0tLS0tKyAgIHwKK3wgICAgICAgICAgICAgICB8ICAgICAgICAg ICAgfCAgICAgIHZJT01NVSAgICAgIHwgICB8Cit8ICAgICAgICAgICAgICAgfCAgICAgICAgICAg ICstLS0tLS0tLS0rLS0tLS0tLS0rICAgfAorfCAgICAgICAgICAgICAgIHwgICAgICAgICAgICAg ICAgICAgICAgXiAgICAgICAgICAgIHwKK3wgICAgICAgICAgICAgICB8ICAgICAgICAgICAgICAg ICAgICAgIHwgICAgICAgICAgICB8Cit8ICAgICAgICAgICAgICAgfCAgICAgICAgICAgICstLS0t LS0tLS0rLS0tLS0tLS0rICAgfAorfCAgICAgICAgICAgICAgIHwgICAgICAgICAgICB8ICAgdklP QVBJQy92TVNJICAgfCAgIHwKK3wgICAgICAgICAgICAgICB8ICAgICAgICAgICAgKy0tLS0rLS0t LSstLS0tLS0tLSsgICB8Cit8ICAgICAgICAgICAgICAgfCAgICAgICAgICAgICAgICAgXiAgICBe ICAgICAgICAgICAgfAorfCAgICAgICAgICAgICAgICstLS0tLS0tLS0tLS0tLS0tLSsgICAgfCAg ICAgICAgICAgIHwKK3wgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIHwgICAg ICAgICAgICB8CisrLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tKworSFcgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgfElSUQorICAg ICAgICAgICAgICAgICAgICAgICAgICAgICAgICArLS0tLS0tLS0tLS0tLS0tLS0tLSsKKyAgICAg ICAgICAgICAgICAgICAgICAgICAgICAgICAgfCAgIFBDSSBEZXZpY2UgICAgICB8CisgICAgICAg ICAgICAgICAgICAgICAgICAgICAgICAgICstLS0tLS0tLS0tLS0tLS0tLS0tKworCisKK3ZJT01N VSBoeXBlcmNhbGwKKz09PT09PT09PT09PT09PT0KK0ludHJvZHVjZSBhIG5ldyBkb21jdGwgaHlw ZXJjYWxsICJ4ZW5fZG9tY3RsX3Zpb21tdV9vcCIgdG8gY3JlYXRlL2Rlc3Ryb3kKK3ZJT01NVXMu CisKKyogdklPTU1VIGh5cGVyY2FsbCBwYXJhbWV0ZXIgc3RydWN0dXJlCisKKy8qIHZJT01NVSB0 eXBlIC0gc3BlY2lmeSB2ZW5kb3IgdklPTU1VIGRldmljZSBtb2RlbCAqLworI2RlZmluZSBWSU9N TVVfVFlQRV9JTlRFTF9WVEQJICAgICAgIDAKKworLyogdklPTU1VIGNhcGFiaWxpdGllcyAqLwor I2RlZmluZSBWSU9NTVVfQ0FQX0lSUV9SRU1BUFBJTkcgICgxdSA8PCAwKQorCitzdHJ1Y3QgeGVu X2RvbWN0bF92aW9tbXVfb3AgeworICAgIHVpbnQzMl90IGNtZDsKKyNkZWZpbmUgWEVOX0RPTUNU TF9jcmVhdGVfdmlvbW11ICAgICAgICAgIDAKKyNkZWZpbmUgWEVOX0RPTUNUTF9kZXN0cm95X3Zp b21tdSAgICAgICAgIDEKKyAgICB1bmlvbiB7CisgICAgICAgIHN0cnVjdCB7CisgICAgICAgICAg ICAvKiBJTiAtIHZJT01NVSB0eXBlICAqLworICAgICAgICAgICAgdWludDY0X3QgdmlvbW11X3R5 cGU7CisgICAgICAgICAgICAvKiBJTiAtIE1NSU8gYmFzZSBhZGRyZXNzIG9mIHZJT01NVS4gKi8K KyAgICAgICAgICAgIHVpbnQ2NF90IGJhc2VfYWRkcmVzczsKKyAgICAgICAgICAgIC8qIElOIC0g Q2FwYWJpbGl0aWVzIHdpdGggd2hpY2ggd2Ugd2FudCB0byBjcmVhdGUgKi8KKyAgICAgICAgICAg IHVpbnQ2NF90IGNhcGFiaWxpdGllczsKKyAgICAgICAgICAgIC8qIE9VVCAtIHZJT01NVSBpZGVu dGl0eSAqLworICAgICAgICAgICAgdWludDMyX3QgdmlvbW11X2lkOworICAgICAgICB9IGNyZWF0 ZV92aW9tbXU7CisKKyAgICAgICAgc3RydWN0IHsKKyAgICAgICAgICAgIC8qIElOIC0gdklPTU1V IGlkZW50aXR5ICovCisgICAgICAgICAgICB1aW50MzJfdCB2aW9tbXVfaWQ7CisgICAgICAgIH0g ZGVzdHJveV92aW9tbXU7CisgICAgfSB1OworfTsKKworLSBYRU5fRE9NQ1RMX2NyZWF0ZV92aW9t bXUKKyAgICBDcmVhdGUgdklPTU1VIGRldmljZSB3aXRoIHZJT01NVV90eXBlLCBjYXBhYmlsaXRp ZXMgYW5kIE1NSU8gYmFzZQorYWRkcmVzcy4gSHlwZXJ2aXNvciBhbGxvY2F0ZXMgdmlvbW11X2lk IGZvciBuZXcgdklPTU1VIGluc3RhbmNlIGFuZCByZXR1cm4KK2JhY2suIFRoZSB2SU9NTVUgZGV2 aWNlIG1vZGVsIGluIGh5cGVydmlzb3Igc2hvdWxkIGNoZWNrIHdoZXRoZXIgaXQgY2FuCitzdXBw b3J0IHRoZSBpbnB1dCBjYXBhYmlsaXRpZXMgYW5kIHJldHVybiBlcnJvciBpZiBub3QuCisKKy0g WEVOX0RPTUNUTF9kZXN0cm95X3Zpb21tdQorICAgIERlc3Ryb3kgdklPTU1VIGluIFhlbiBoeXBl cnZpc29yIHdpdGggdmlvbW11X2lkIGFzIHBhcmFtZXRlci4KKworVGhlc2UgdklPTU1VIGRvbWN0 bCBhbmQgdklPTU1VIG9wdGlvbiBpbiBjb25maWd1cmUgZmlsZSBjb25zaWRlciBtdWx0aS12SU9N TVUKK3N1cHBvcnQgZm9yIHNpbmdsZSBWTS4oZS5nLCBwYXJhbWV0ZXJzIG9mIGNyZWF0ZS9kZXN0 cm95IHZJT01NVSBpbmNsdWRlcwordklPTU1VIGlkKS4gQnV0IGZ1bmN0aW9uIGltcGxlbWVudGF0 aW9uIG9ubHkgc3VwcG9ydHMgb25lIHZJT01NVSBwZXIgVk0gc28gZmFyLgorCitYZW4gaHlwZXJ2 aXNvciB2SU9NTVUgY29tbWFuZAorPT09PT09PT09PT09PT09PT09PT09PT09PT09PT0KK0ludHJv ZHVjZSB2SU9NTVUgY29tbWFuZCAidmlvbW11PTEiIHRvIGVuYWJsZSB2SU9NTVUgZnVuY3Rpb24g aW4gaHlwZXJ2aXNvci4KK0l0J3MgZGVmYXVsdCBkaXNhYmxlZC4KKworeGwgeDg2IHZJT01NVSBj b25maWd1cmF0aW9uIgorPT09PT09PT09PT09PT09PT09PT09PT09PT09PQordmlvbW11ID0gWwor ICAgICd0eXBlPWludGVsX3Z0ZCxpbnRyZW1hcD0xJywKKyAgICAuLi4KK10KKworInR5cGUiIC0g U3BlY2lmeSB2SU9NTVUgZGV2aWNlIG1vZGVsIHR5cGUuIEN1cnJlbnRseSBvbmx5IHN1cHBvcnRz IEludGVsIHZ0ZAorZGV2aWNlIG1vZGVsLgorImludHJlbWFwIiAtIEVuYWJsZSB2SU9NTVUgaW50 ZXJydXB0IHJlbWFwcGluZyBmdW5jdGlvbi4KLS0gCjEuOC4zLjEKCgpfX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fXwpYZW4tZGV2ZWwgbWFpbGluZyBsaXN0Clhl bi1kZXZlbEBsaXN0cy54ZW4ub3JnCmh0dHBzOi8vbGlzdHMueGVuLm9yZy94ZW4tZGV2ZWwK