From mboxrd@z Thu Jan 1 00:00:00 1970 From: Andrew Cooper Subject: [PATCH v2 1/4] xen/dom0: Improve documentation for dom0= and dom0-iommu= Date: Mon, 31 Dec 2018 15:16:20 +0000 Message-ID: <1546269383-32166-2-git-send-email-andrew.cooper3@citrix.com> References: <1546269383-32166-1-git-send-email-andrew.cooper3@citrix.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: In-Reply-To: <1546269383-32166-1-git-send-email-andrew.cooper3@citrix.com> List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Errors-To: xen-devel-bounces@lists.xenproject.org Sender: "Xen-devel" To: Xen-devel Cc: Stefano Stabellini , Wei Liu , Andrew Cooper , Julien Grall , Jan Beulich , =?UTF-8?q?Roger=20Pau=20Monn=C3=A9?= List-Id: xen-devel@lists.xenproject.org VXBkYXRlIHRvIHRoZSBsYXRlc3QgbWV0YWRhdGEgc3R5bGUsIGFuZCBleHBhbmQgZWFjaCBvZiB0 aGUgY2xhdXNlcyB3aXRoIG1vcmUKaW5mb3JtYXRpb24sIGluY2x1ZGluZyBhcHBsaWNhYmxlIENP TkZJR18qIG9wdGlvbnMuCgpEcm9wIHRoZSByZWR1bmRhbnQgY29tbWVudCBiZXNpZGUgcGFyc2Vf ZG9tMF9wYXJhbSgpLCB0byBhdm9pZCBpdCBnZXR0aW5nIG91dApvZiBzeW5jIHdpdGggdGhlIG1h aW4gZG9jdW1lbnRhdGlvbi4gIEFsc28gZHJvcCB0aGUgaW5kaXZpZHVhbCBkb2N1bWVudGF0aW9u CmZvciBkZXByZWNhdGVkIG9wdGlvbnMgd2hpY2ggcmVmZXIgdG8gdGhlaXIgbmV3ZXIgdmVyc2lv bnMsIGZvciB0aGUgc2FtZQpyZWFzb24uCgpTaWduZWQtb2ZmLWJ5OiBBbmRyZXcgQ29vcGVyIDxh bmRyZXcuY29vcGVyM0BjaXRyaXguY29tPgotLS0KQ0M6IEphbiBCZXVsaWNoIDxKQmV1bGljaEBz dXNlLmNvbT4KQ0M6IFdlaSBMaXUgPHdlaS5saXUyQGNpdHJpeC5jb20+CkNDOiBSb2dlciBQYXUg TW9ubsOpIDxyb2dlci5wYXVAY2l0cml4LmNvbT4KQ0M6IFN0ZWZhbm8gU3RhYmVsbGluaSA8c3N0 YWJlbGxpbmlAa2VybmVsLm9yZz4KQ0M6IEp1bGllbiBHcmFsbCA8anVsaWVuLmdyYWxsQGFybS5j b20+CgpQbGVhc2UgZG91YmxlIGNoZWNrIGZvciBjb3JyZWN0bmVzcy4gIFRoZSB0ZXh0IG1hdGNo ZXMgbXkKdW5kZXJzdGFuZGluZy9yZWFkaW5nIG9mIHRoZSBjb2RlLCBidXQgc29tZSBvZiBpdCBp cyByYXRoZXIgc3VidGxlIGdvaW5nLgoKdjI6CiAqIEZpeCBzdGF0ZW1lbnQgb2YgZGVmYXVsdHMK ICogVHdlYWsgd29yZGluZy4gIEluIHBhcnRpY3VsYXIsIGV4cGFuZCB0aGUgZGVzY3JpcHRpb24g b2YgcGFzc3Rocm91Z2guCi0tLQogZG9jcy9taXNjL3hlbi1jb21tYW5kLWxpbmUubWFya2Rvd24g fCAxMjcgKysrKysrKysrKysrKysrKysrKy0tLS0tLS0tLS0tLS0tLS0tCiB4ZW4vYXJjaC94ODYv ZG9tMF9idWlsZC5jICAgICAgICAgICB8ICAgNiAtLQogMiBmaWxlcyBjaGFuZ2VkLCA2NyBpbnNl cnRpb25zKCspLCA2NiBkZWxldGlvbnMoLSkKCmRpZmYgLS1naXQgYS9kb2NzL21pc2MveGVuLWNv bW1hbmQtbGluZS5tYXJrZG93biBiL2RvY3MvbWlzYy94ZW4tY29tbWFuZC1saW5lLm1hcmtkb3du CmluZGV4IDc4YjIwN2MuLmExNzNmMTAgMTAwNjQ0Ci0tLSBhL2RvY3MvbWlzYy94ZW4tY29tbWFu ZC1saW5lLm1hcmtkb3duCisrKyBiL2RvY3MvbWlzYy94ZW4tY29tbWFuZC1saW5lLm1hcmtkb3du CkBAIC02MzYsNTUgKzYzNiw4MCBAQCB0cmFjZSBmZWF0dXJlIGlzIG9ubHkgZW5hYmxlZCBpbiBk ZWJ1Z2dpbmcgYnVpbGRzIG9mIFhlbi4KIAogU3BlY2lmeSB0aGUgYml0IHdpZHRoIG9mIHRoZSBE TUEgaGVhcC4KIAotIyMjIGRvbTAgKHg4NikKLT4gYD0gTGlzdCBvZiBbIHB2aCB8IHNoYWRvdyBd YAorIyMjIGRvbTAKKz4gYD0gTGlzdCBvZiBbIHB2aD08Ym9vbD4sIHNoYWRvdz08Ym9vbD4gXWAK IAotPiBTdWItb3B0aW9uczoKKz4gQXBwbGljYWJpbGl0eTogeDg2CiAKLT4gYHB2aGAKK0NvbnRy b2xzIGZvciBob3cgZG9tMCBpcyBjb25zdHJ1Y3RlZCBvbiB4ODYgc3lzdGVtcy4KIAotPiBEZWZh dWx0OiBgZmFsc2VgCisqICAgVGhlIGBwdmhgIGJvb2xlYW4gY29udHJvbHMgd2hldGhlciBkb20w IGlzIGNvbnN0cnVjdGVkIGFzIGEgUFYgb3IgYSBQVkgKKyAgICBndWVzdC4gIFRoZSBkZWZhdWx0 IGlzIFBWLiAgSW4gYWRkaXRpb24sIHRoZSBmb2xsb3dpbmcgcmVxdWlyZW1lbnRzIG11c3QKKyAg ICBiZSBtZXQ6CiAKLUZsYWcgdGhhdCBtYWtlcyBhIGRvbTAgYm9vdCBpbiBQVkh2MiBtb2RlLgor ICAgICogICAgVGhlIGRvbTAga2VybmVsIHNlbGVjdGVkIGJ5IHRoZSBib290IGxvYWRlciBtdXN0 IGJlIGNhcGFibGUgb2YgdGhlCisgICAgICAgICBzZWxlY3RlZCBtb2RlLgorICAgICogICAgRm9y IGEgUFYgZG9tMCwgWGVuIG11c3QgaGF2ZSBiZWVuIGNvbXBpbGVkIHdpdGggYENPTkZJR19QVmAg ZW5hYmxlZC4KKyAgICAqICAgIEZvciBhIFBWSCBkb20wLCBYZW4gbXVzdCBoYXZlIGJlZW4gY29t cGlsZWQgd2l0aCBgQ09ORklHX0hWTWAgZW5hYmxlZCwKKyAgICAgICAgIGFuZCB0aGUgaGFyZHdh cmUgbXVzdCBoYXZlIFZULXgvU1ZNIGV4dGVuc2lvbnMgYXZhaWxhYmxlLgogCi0+IGBzaGFkb3dg CisqICAgVGhlIGBzaGFkb3dgIGJvb2xlYW4gaXMgb25seSBhcHBsaWNhYmxlIHdoZW4gZG9tMCBp cyBjb25zdHJ1Y3RlZCBhcyBhIFBWSAorICAgIGd1ZXN0LCBhbmQgY29udHJvbHMgd2hldGhlciBk b20wIHVzZXMgaGFyZHdhcmUgYXNzaXN0ZWQgcGFnaW5nLCBvciBzaGFkb3cKKyAgICBwYWdpbmcu ICBUaGUgZGVmYXVsdCBpcyBIQVAgd2hlbiBhdmFpbGFibGUsIGFuZCBzaGFkb3cgb3RoZXJ3aXNl LgogCi0+IERlZmF1bHQ6IGBmYWxzZWAKLQotRmxhZyB0aGF0IG1ha2VzIGEgZG9tMCB1c2Ugc2hh ZG93IHBhZ2luZy4gT25seSB3b3JrcyB3aGVuICJwdmgiIGlzCi1lbmFibGVkLgorICAgIFRoaXMg b3B0aW9uIGlzIHVuYXZhaWxhYmxlIHdoZW4gYENPTkZJR19TSEFET1dfUEFHSU5HYCBpcyBjb21w aWxlZCBvdXQuICBBCisgICAgUFZIIGRvbTAgY2Fubm90IGJlIHVzZWQgaWYgYENPTkZJR19TSEFE T1dfUEFHSU5HYCBpcyBjb21waWxlZCBvdXQsIGFuZCB0aGUKKyAgICBoYXJkd2FyZSBpcyBub3Qg SEFQLWNhcGFibGUuCiAKICMjIyBkb20wLWlvbW11Ci0+IGA9IExpc3Qgb2YgWyBwYXNzdGhyb3Vn aCB8IHN0cmljdCB8IG1hcC1pbmNsdXNpdmUgXWAKLQotVGhpcyBsaXN0IG9mIGJvb2xlYW5zIGNv bnRyb2xzIHRoZSBpb21tdSB1c2FnZSBieSBEb20wOgotCi0qIGBwYXNzdGhyb3VnaGA6IGRpc2Fi bGVzIERNQSByZW1hcHBpbmcgZm9yIERvbTAuIERlZmF1bHQgaXMgYGZhbHNlYC4gTm90ZSB0aGF0 Ci0gIHRoaXMgb3B0aW9uIGlzIGhhcmQgY29kZWQgdG8gYGZhbHNlYCBmb3IgYSBQVkggRG9tMCBh bmQgYW55IGF0dGVtcHQgdG8KLSAgb3ZlcndyaXRlIGl0IGZyb20gdGhlIGNvbW1hbmQgbGluZSBp cyBpZ25vcmVkLgotCi0qIGBzdHJpY3RgOiBzZXRzIHVwIERNQSByZW1hcHBpbmcgb25seSBmb3Ig dGhlIFJBTSBEb20wIGFjdHVhbGx5IGdvdCBhc3NpZ25lZC4KLSAgRGVmYXVsdCBpcyBgZmFsc2Vg IHdoaWNoIG1lYW5zIERvbTAgd2lsbCBnZXQgbWFwcGluZ3MgZm9yIGFsbCB0aGUgaG9zdAotICBS QU0gZXhjZXB0IHJlZ2lvbnMgaW4gdXNlIGJ5IFhlbi4gTm90ZSB0aGF0IHRoaXMgb3B0aW9uIGlz IGhhcmQgY29kZWQgdG8KLSAgYHRydWVgIGZvciBhIFBWSCBEb20wIGFuZCBhbnkgYXR0ZW1wdCB0 byBvdmVyd3JpdGUgaXQgZnJvbSB0aGUgY29tbWFuZCBsaW5lCi0gIGlzIGlnbm9yZWQuCi0KLSog YG1hcC1pbmNsdXNpdmVgOiBzZXRzIHVwIERNQSByZW1hcHBpbmcgZm9yIGFsbCB0aGUgbm9uLVJB TSByZWdpb25zIGJlbG93IDRHQgotICBleGNlcHQgZm9yIHVudXNhYmxlIHJhbmdlcy4gVXNlIHRo aXMgdG8gd29yayBhcm91bmQgZmlybXdhcmUgaXNzdWVzIHByb3ZpZGluZwotICBpbmNvcnJlY3Qg Uk1SUi9JVk1EIGVudHJpZXMuIFJhdGhlciB0aGFuIG9ubHkgbWFwcGluZyBSQU0gcGFnZXMgZm9y IElPTU1VCi0gIGFjY2Vzc2VzIGZvciBEb20wLCB3aXRoIHRoaXMgb3B0aW9uIGFsbCBwYWdlcyB1 cCB0byA0R0IsIG5vdCBtYXJrZWQgYXMKLSAgdW51c2FibGUgaW4gdGhlIEU4MjAgdGFibGUsIHdp bGwgZ2V0IGEgbWFwcGluZyBlc3RhYmxpc2hlZC4gTm90ZSB0aGF0IHRoaXMKLSAgb3B0aW9uIGlz IG9ubHkgYXBwbGljYWJsZSB0byBhIFBWIERvbTAgYW5kIGlzIGVuYWJsZWQgYnkgZGVmYXVsdCBv biBJbnRlbAotICBoYXJkd2FyZS4KLQotKiBgbWFwLXJlc2VydmVkYDogc2V0cyB1cCBETUEgcmVt YXBwaW5nIGZvciBhbGwgdGhlIHJlc2VydmVkIHJlZ2lvbnMgaW4gdGhlCi0gIG1lbW9yeSBtYXAg Zm9yIERvbTAuIFVzZSB0aGlzIHRvIHdvcmsgYXJvdW5kIGZpcm13YXJlIGlzc3VlcyBwcm92aWRp bmcKLSAgaW5jb3JyZWN0IFJNUlIvSVZNRCBlbnRyaWVzLiBSYXRoZXIgdGhhbiBvbmx5IG1hcHBp bmcgUkFNIHBhZ2VzIGZvciBJT01NVQotICBhY2Nlc3NlcyBmb3IgRG9tMCwgYWxsIG1lbW9yeSBy ZWdpb25zIG1hcmtlZCBhcyByZXNlcnZlZCBpbiB0aGUgbWVtb3J5IG1hcAotICB0aGF0IGRvbid0 IG92ZXJsYXAgd2l0aCBhbnkgTU1JTyByZWdpb24gZnJvbSBlbXVsYXRlZCBkZXZpY2VzIHdpbGwg YmUKLSAgaWRlbnRpdHkgbWFwcGVkLiBUaGlzIG9wdGlvbiBtYXBzIGEgc3Vic2V0IG9mIHRoZSBt ZW1vcnkgdGhhdCB3b3VsZCBiZQotICBtYXBwZWQgd2hlbiB1c2luZyB0aGUgYG1hcC1pbmNsdXNp dmVgIG9wdGlvbi4gVGhpcyBvcHRpb24gaXMgYXZhaWxhYmxlIHRvIGFsbAotICBEb20wIG1vZGVz IGFuZCBpcyBlbmFibGVkIGJ5IGRlZmF1bHQgb24gSW50ZWwgaGFyZHdhcmUuCis+IGA9IExpc3Qg b2YgWyBwYXNzdGhyb3VnaD08Ym9vbD4sIHN0cmljdD08Ym9vbD4sIG1hcC1pbmNsdXNpdmU9PGJv b2w+LAorPiAgICAgICAgICAgICAgbWFwLXJlc2VydmVkPTxib29sPiBdYAorCitDb250cm9scyBm b3IgdGhlIGRvbTAgSU9NTVUgc2V0dXAuCisKKyogICBUaGUgYHBhc3N0aHJvdWdoYCBib29sZWFu IGNvbnRyb2xzIHdoZXRoZXIgSU9NTVUgdHJhbnNsYXRpb24gZnVuY3Rpb25hbGl0eQorICAgIGlz IGRpc2FibGVkIGZvciBkZXZpY2VzIGluIGRvbTAgKGBwYXNzdGhyb3VnaD0xYCkgb3Igd2hldGhl ciB0aGUgSU9NTVUgaXMKKyAgICB1c2VkIHRvIGVuc3VyZSB0aGF0IGRvbTAgY2FuIG9ubHkgRE1B IHRvIGl0cyBwZXJtaXR0ZWQgYXJlYXMgb2YgUkFNCisgICAgKGBwYXNzdGhyb3VnaD0wYCkuCisK KyAgICBUaGlzIG9wdGlvbiBpcyBvbmx5IGFwcGxpY2FibGUgdG8geDg2IFBWIGRvbTAncywgYW5k IGRlZmF1bHRzIHRvIGZhbHNlLgorCisgICAgU29tZSBvbGRlciBJbnRlbCBWVC1kIGhhcmR3YXJl IGlzbid0IGNhcGFibGUgb2YgZGlzYWJsaW5nIHRyYW5zbGF0aW9uCisgICAgZnVuY3Rpb25hbGl0 eSBvbiBhIHBlci1kZXZpY2UgYmFzaXMsIGFuZCB3aWxsIGNhdXNlIHRoaXMgb3B0aW9uIHRvIGJl CisgICAgaWdub3JlZCBhbmQgYXNzdW1lZCB0byBiZSAwLiAgU2ltaWxhciBiZWhhdmlvdXIgb24g c3VjaCBzeXN0ZW1zIGlzIG9ubHkKKyAgICBhdmFpbGFibGUgYnkgZnVsbHkgZGlzYWJsaW5nIGFs bCBJT01NVXMuCisKKyAgICBUaGlzIG9wdGlvbiBpcyBoYXJkd2lyZWQgdG8gZmFsc2UgZm9yIHg4 NiBQVkggZG9tMCdzICh3aGVyZSBhIG5vbi1pZGVudGl0eQorICAgIHRyYW5zZm9ybSBpcyByZXF1 aXJlZCBmb3IgZG9tMCB0byBmdW5jdGlvbiksIGFuZCBpcyBpZ25vcmVkIGZvciBBUk0uCisKKyog ICBUaGUgYHN0cmljdGAgYm9vbGVhbiBpcyBhcHBsaWNhYmxlIHRvIHg4NiBQViBkb20wJ3Mgb25s eSBhbmQgZGVmYXVsdHMgdG8KKyAgICBmYWxzZS4gIEl0IGNvbnRyb2xzIHdoZXRoZXIgZG9tMCBj YW4gaGF2ZSBJT01NVSBtYXBwaW5ncyBmb3IgYWxsIGRvbWFpbgorICAgIFJBTSBpbiB0aGUgc3lz dGVtLCBvciBvbmx5IGZvciBpdHMgYWxsb2NhdGVkIFJBTSAoYW5kIGdyYW50IG1hcHBpbmdzIGV0 Yy4pCisKKyAgICBUaGlzIG9wdGlvbiBpcyBoYXJkd2lyZWQgdG8gdHJ1ZSBmb3IgeDg2IFBWSCBk b20wJ3MgKGFzIFJBTSBiZWxvbmdpbmcgdG8KKyAgICBvdGhlciBkb21haW5zIGluIHRoZSBzeXN0 ZW0gZG9uJ3QgbGl2ZSBpbiBhIGNvbXBhdGlibGUgYWRkcmVzcyBzcGFjZSksIGFuZAorICAgIGlz IGlnbm9yZWQgZm9yIEFSTS4KKworKiAgIFRoZSBgbWFwLWluY2x1c2l2ZWAgYm9vbGVhbiBpcyBh cHBsaWNhYmxlIHRvIHg4NiBQViBkb20wJ3MsIGFuZCBzZXRzIHVwCisgICAgaWRlbnRpdHkgSU9N TVUgbWFwcGluZ3MgZm9yIGFsbCBub24tUkFNIHJlZ2lvbnMgYmVsb3cgNEdCIGV4Y2VwdCBmb3IK KyAgICB1bnVzYWJsZSByYW5nZXMsIGFuZCByYW5nZXMgYmVsb25naW5nIHRvIFhlbi4KKworICAg IFR5cGljYWxseSwgc29tZSBkZXZpY2VzIGluIGEgc3lzdGVtIHVzZSBiaXRzIG9mIFJBTSBmb3Ig Y29tbXVuaWNhdGlvbiwgYW5kCisgICAgdGhlc2UgYXJlYXMgc2hvdWxkIGJlIGxpc3RlZCBhcyBy ZXNlcnZlZCBpbiB0aGUgRTgyMCB0YWJsZSBhbmQgaWRlbnRpZmllZAorICAgIHZpYSBSTVJSIG9y IElWTUQgZW50cmllcyBpbiB0aGUgQVBDSSB0YWJsZXMsIHNvIFhlbiBjYW4gZW5zdXJlIHRoYXQg dGhleQorICAgIGFyZSBpZGVudGl0eS1tYXBwZWQgaW4gdGhlIElPTU1VLiAgSG93ZXZlciwgc29t ZSBmaXJtd2FyZSBtYWtlcyBtaXN0YWtlcywKKyAgICBhbmQgdGhpcyBvcHRpb24gaXMgYSBjb2Fy c2UtZ3JhaW4gd29ya2Fyb3VuZCBmb3IgdGhvc2UgZXJyb3JzLgorCisgICAgV2hlcmUgcG9zc2li bGUsIGZpbmVyIGdyYWluIGNvcnJlY3Rpb25zIHNob3VsZCBiZSBtYWRlIHdpdGggdGhlIGBybXJy PWAsCisgICAgYGl2cnNfaHBldD1gIG9yIGBpdnJzX2lvYXBpYz1gIGNvbW1hbmQgbGluZSBvcHRp b25zLgorCisgICAgVGhpcyBvcHRpb24gaXMgZW5hYmxlZCBieSBkZWZhdWx0IG9uIHg4NiBzeXN0 ZW1zLCBhbmQgaW52YWxpZCBvbiBBUk0KKyAgICBzeXN0ZW1zLgorCisqICAgVGhlIGBtYXAtcmVz ZXJ2ZWRgIGZ1bmN0aW9uYWxpdHkgaXMgdmVyeSBzaW1pbGFyIHRvIGBtYXAtaW5jbHVzaXZlYCwg YnV0IGlzCisgICAgYXBwbGljYWJsZSB0byBib3RoIHg4NiBQViBhbmQgUFZIIGRvbTAncywgYW5k IHJlcHJlc2VudHMgYSBzdWJzZXQgb2YgdGhlCisgICAgY29ycmVjdGlvbiBieSBvbmx5IG1hcHBp bmcgcmVzZXJ2ZWQgbWVtb3J5IHJlZ2lvbnMgcmF0aGVyIHRoYW4gYWxsIG5vbi1SQU0KKyAgICBy ZWdpb25zLgogCiAjIyMgZG9tMFxfaW9wb3J0c1xfZGlzYWJsZSAoeDg2KQogPiBgPSBMaXN0IG9m IDxoZXg+LTxoZXg+YApAQCAtMTE3NSwyMCArMTIwMCwxMSBAQCBkZXRlY3Rpb24gb2Ygc3lzdGVt cyBrbm93biB0byBtaXNiZWhhdmUgdXBvbiBhY2Nlc3NlcyB0byB0aGF0IHBvcnQuCiA+ICoqV0FS TklORzogVGhpcyBjb21tYW5kIGxpbmUgb3B0aW9uIGlzIGRlcHJlY2F0ZWQsIGFuZCBzdXBlcnNl ZGVkIGJ5CiA+IF9kb20wLWlvbW11PXBhc3N0aHJvdWdoXyAtIHVzaW5nIGJvdGggb3B0aW9ucyBp biBjb21iaW5hdGlvbiBpcyB1bmRlZmluZWQuKioKIAotPiBEZWZhdWx0OiBgZmFsc2VgCi0KLT4+ IENvbnRyb2wgd2hldGhlciB0byBkaXNhYmxlIERNQSByZW1hcHBpbmcgZm9yIERvbTAuCi0KID4g YGRvbTAtc3RyaWN0YAogCiA+ICoqV0FSTklORzogVGhpcyBjb21tYW5kIGxpbmUgb3B0aW9uIGlz IGRlcHJlY2F0ZWQsIGFuZCBzdXBlcnNlZGVkIGJ5CiA+IF9kb20wLWlvbW11PXN0cmljdF8gLSB1 c2luZyBib3RoIG9wdGlvbnMgaW4gY29tYmluYXRpb24gaXMgdW5kZWZpbmVkLioqCiAKLT4gRGVm YXVsdDogYGZhbHNlYAotCi0+PiBDb250cm9sIHdoZXRoZXIgdG8gc2V0IHVwIERNQSByZW1hcHBp bmcgb25seSBmb3IgdGhlIG1lbW9yeSBEb20wIGFjdHVhbGx5Ci0+PiBnb3QgYXNzaWduZWQuIElt cGxpZXMgYG5vLWRvbTAtcGFzc3Rocm91Z2hgLgotCiA+IGBhbWQtaW9tbXUtcGVyZGV2LWludHJl bWFwYAogCiA+IERlZmF1bHQ6IGB0cnVlYApAQCAtMTIzNSwyMSArMTI1MSwxMiBAQCBTcGVjaWZ5 IHRoZSB0aW1lb3V0IG9mIHRoZSBkZXZpY2UgSU9UTEIgaW52YWxpZGF0aW9uIGluIG1pbGxpc2Vj b25kcy4KIEJ5IGRlZmF1bHQsIHRoZSB0aW1lb3V0IGlzIDEwMDAgbXMuIFdoZW4geW91IHNlZSBl cnJvciAnUXVldWUgaW52YWxpZGF0ZQogd2FpdCBkZXNjcmlwdG9yIHRpbWVkIG91dCcsIHRyeSBp bmNyZWFzaW5nIHRoaXMgdmFsdWUuCiAKLSMjIyBpb21tdVxfaW5jbHVzaXZlXF9tYXBwaW5nIChW VC1kKQorIyMjIGlvbW11X2luY2x1c2l2ZV9tYXBwaW5nCiA+IGA9IDxib29sZWFuPmAKIAogKipX QVJOSU5HOiBUaGlzIGNvbW1hbmQgbGluZSBvcHRpb24gaXMgZGVwcmVjYXRlZCwgYW5kIHN1cGVy c2VkZWQgYnkKIF9kb20wLWlvbW11PW1hcC1pbmNsdXNpdmVfIC0gdXNpbmcgYm90aCBvcHRpb25z IGluIGNvbWJpbmF0aW9uIGlzIHVuZGVmaW5lZC4qKgogCi0+IERlZmF1bHQ6IGB0cnVlYAotCi1V c2UgdGhpcyB0byB3b3JrIGFyb3VuZCBmaXJtd2FyZSBpc3N1ZXMgcHJvdmlkaW5nIGluY29ycmVj dCBSTVJSIGVudHJpZXMuCi1SYXRoZXIgdGhhbiBvbmx5IG1hcHBpbmcgUkFNIHBhZ2VzIGZvciBJ T01NVSBhY2Nlc3NlcyBmb3IgRG9tMCwgd2l0aCB0aGlzCi1vcHRpb24gYWxsIHBhZ2VzIHVwIHRv IDRHQiwgbm90IG1hcmtlZCBhcyB1bnVzYWJsZSBpbiB0aGUgRTgyMCB0YWJsZSwgd2lsbAotZ2V0 IGEgbWFwcGluZyBlc3RhYmxpc2hlZC4gTm90ZSB0aGF0IHRoaXMgb3B0aW9uIGlzIG9ubHkgYXBw bGljYWJsZSB0byBhCi1QViBkb20wLiBBbHNvIG5vdGUgdGhhdCBpZiBgZG9tMC1zdHJpY3RgIG1v ZGUgaXMgZW5hYmxlZCB0aGVuIGNvbnZlbnRpb25hbAotUkFNIHBhZ2VzIG5vdCBhc3NpZ25lZCB0 byBkb20wIHdpbGwgbm90IGJlIG1hcHBlZC4KLQogIyMjIGlycVxfcmF0ZWxpbWl0ICh4ODYpCiA+ IGA9IDxpbnRlZ2VyPmAKIApkaWZmIC0tZ2l0IGEveGVuL2FyY2gveDg2L2RvbTBfYnVpbGQuYyBi L3hlbi9hcmNoL3g4Ni9kb20wX2J1aWxkLmMKaW5kZXggNTQ3MzdkYS4uODVkNGZmMiAxMDA2NDQK LS0tIGEveGVuL2FyY2gveDg2L2RvbTBfYnVpbGQuYworKysgYi94ZW4vYXJjaC94ODYvZG9tMF9i dWlsZC5jCkBAIC0yODIsMTIgKzI4Miw2IEBAIGJvb2wgX19pbml0ZGF0YSBvcHRfZG9tMF9zaGFk b3c7CiAjZW5kaWYKIGJvb2wgX19pbml0ZGF0YSBkb20wX3B2aDsKIAotLyoKLSAqIExpc3Qgb2Yg cGFyYW1ldGVycyB0aGF0IGFmZmVjdCBEb20wIGNyZWF0aW9uOgotICoKLSAqICAtIHB2aCAgICAg ICAgICAgICAgIENyZWF0ZSBhIFBWSHYyIERvbTAuCi0gKiAgLSBzaGFkb3cgICAgICAgICAgICBV c2Ugc2hhZG93IHBhZ2luZyBmb3IgRG9tMC4KLSAqLwogc3RhdGljIGludCBfX2luaXQgcGFyc2Vf ZG9tMF9wYXJhbShjb25zdCBjaGFyICpzKQogewogICAgIGNvbnN0IGNoYXIgKnNzOwotLSAKMi4x LjQKCgpfX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fXwpYZW4t ZGV2ZWwgbWFpbGluZyBsaXN0Clhlbi1kZXZlbEBsaXN0cy54ZW5wcm9qZWN0Lm9yZwpodHRwczov L2xpc3RzLnhlbnByb2plY3Qub3JnL21haWxtYW4vbGlzdGluZm8veGVuLWRldmVs