From: Christopher Clark Subject: [PATCH v8 for-4.12 17/17] docs, argo: add design document for Argo Date: Wed, 6 Feb 2019 00:55:08 -0800 Message-ID: <1549443308-24448-18-git-send-email-christopher.w.clark@gmail.com> References: <1549443308-24448-1-git-send-email-christopher.w.clark@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from us1-rack-dfw2.inumbo.com ([104.130.134.6]) by lists.xenproject.org with esmtp (Exim 4.89) (envelope-from ) id 1grJ06-0000Ka-I0 for xen-devel@lists.xenproject.org; Wed, 06 Feb 2019 08:56:10 +0000 Received: by mail-it1-x129.google.com with SMTP id a6so4502091itl.4 for ; Wed, 06 Feb 2019 00:56:08 -0800 (PST) In-Reply-To: <1549443308-24448-1-git-send-email-christopher.w.clark@gmail.com> List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Errors-To: xen-devel-bounces@lists.xenproject.org Sender: "Xen-devel" To: xen-devel@lists.xenproject.org Cc: Juergen Gross , Stefano Stabellini , Wei Liu , Ross Philipson , Konrad Rzeszutek Wilk , George Dunlap , Andrew Cooper , Jason Andryuk , Ian Jackson , Rich Persaud , Tim Deegan , Daniel Smith , Julien Grall , Paul Durrant , Jan Beulich , Daniel De Graaf , James McKenzie , Eric Chanudet , Roger Pau Monne List-Id: xen-devel@lists.xenproject.org RG9jdW1lbnQgcHJvdmlkZXMgYSBicmllZiBpbnRyb2R1Y3Rpb24gdG8gdGhlIEFyZ28gaW50ZXJk b21haW4KY29tbXVuaWNhdGlvbiBtZWNoYW5pc20gYW5kIGEgZGV0YWlsZWQgZGVzY3JpcHRpb24g b2YgdGhlIGdyYW51bGFyCmxvY2tpbmcgdXNlZCB3aXRoaW4gdGhlIEFyZ28gaW1wbGVtZW50YXRp b24uCgpTaWduZWQtb2ZmLWJ5OiBDaHJpc3RvcGhlciBDbGFyayA8Y2hyaXN0b3BoZXIuY2xhcms2 QGJhZXN5c3RlbXMuY29tPgotLS0KIGRvY3MvZGVzaWducy9hcmdvLnBhbmRvYyB8IDQ0OCArKysr KysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKwogMSBmaWxlIGNoYW5n ZWQsIDQ0OCBpbnNlcnRpb25zKCspCiBjcmVhdGUgbW9kZSAxMDA2NDQgZG9jcy9kZXNpZ25zL2Fy Z28ucGFuZG9jCgpkaWZmIC0tZ2l0IGEvZG9jcy9kZXNpZ25zL2FyZ28ucGFuZG9jIGIvZG9jcy9k ZXNpZ25zL2FyZ28ucGFuZG9jCm5ldyBmaWxlIG1vZGUgMTAwNjQ0CmluZGV4IDAwMDAwMDAuLjJj ZTI1M2IKLS0tIC9kZXYvbnVsbAorKysgYi9kb2NzL2Rlc2lnbnMvYXJnby5wYW5kb2MKQEAgLTAs MCArMSw0NDggQEAKKyMgQXJnbworCisjIyBJbnRyb2R1Y3Rpb24KKworQXJnbyBpcyBhbiBpbnRl cmRvbWFpbiBjb21tdW5pY2F0aW9uIG1lY2hhbmlzbS4gSXQgcHJvdmlkZXMgWGVuIGh5cGVydmlz b3IKK3ByaW1pdGl2ZXMgdG8gdHJhbnNtaXQgZGF0YSBiZXR3ZWVuIFZNcywgYnkgcGVyZm9ybWlu ZyBkYXRhIGNvcGllcyBpbnRvCityZWNlaXZlIG1lbW9yeSByaW5ncyByZWdpc3RlcmVkIGJ5IGRv bWFpbnMuIEl0IGRvZXMgbm90IHJlcXVpcmUgbWVtb3J5CitzaGFyaW5nIGJldHdlZW4gVk1zIGFu ZCBkb2VzIG5vdCB1c2UgdGhlIGdyYW50IHRhYmxlcyBvciBYZW5zdG9yZS4KKworQXJnbyBoYXMg cmVxdWlyZW1lbnRzIGZvciBwZXJmb3JtYW5jZSBpc29sYXRpb24gYmV0d2VlbiBkb21haW5zLCB0 byBwcmV2ZW50CituZWdhdGl2ZSBwZXJmb3JtYW5jZSBpbXBhY3QgZnJvbSBtYWxpY2lvdXMgb3Ig ZGlzcnVwdGl2ZSBhY3Rpdml0eSBvZiBvdGhlcgorZG9tYWlucywgb3IgZXZlbiBvdGhlciBWQ1BV cyBvZiB0aGUgc2FtZSBkb21haW4gb3BlcmF0aW5nIG90aGVyIHJpbmdzLgorCisjIyBIeXBlcnZp c29yLU1lZGlhdGVkIGRhdGEgZVhjaGFuZ2UgKEhNWCkKKworVGhpcyB0ZXJtIHJlZmVyZW5jZXMg aW50ZXItVk0gY29tbXVuaWNhdGlvbiBwcm90b2NvbHMgdGhhdCBoYXZlIHRoaXMKK2tleSBhcmNo aXRlY3R1cmFsIHBvaW50OiBUaGUgaHlwZXJ2aXNvciBpcyByZXNwb25zaWJsZSBmb3IgcGVyZm9y bWluZyB0aGUKK3dyaXRlIG9mIGRhdGEgaW50byB0aGUgZ3Vlc3QtYWNjZXNzaWJsZSBtZW1vcnkg YnVmZmVyLCBpbiB0aGUgbWFubmVyCithY2NvcmRpbmcgdG8gdGhlIGFncmVlZCB0cmFuc2ZlciBw cm90b2NvbC4gVGhpcyBzdHJ1Y3R1cmUgZW5zdXJlcyB0aGF0Cit0aGVyZSBpcyBzdHJlbmd0aCB0 byB0aGUgdHJhbnNwb3J0IG1lY2hhbmlzbSwgYmVjYXVzZSB0aGUgdHJhbnNtaXR0aW5nIHNpZGUK K29mIHRoZSBjb21tdW5pY2F0aW9uIGlzIHRoZSBoeXBlcnZpc29yLCB3aGljaCBjYW4gYmUgdHJ1 c3RlZCBieSB0aGUgcmVjZWl2ZXIsCithbmQgdGhlIGJ1ZmZlciBpcyBpc29sYXRlZCBmcm9tIGFj Y2VzcyBieSBhbnkgb3RoZXIgcG90ZW50aWFsIHNvdXJjZXMKK291dHNpZGUgdGhlIHJlY2VpdmVy LgorCitUaGUgcmVjZWl2ZXIgY2FuIHRydXN0IHRoYXQgdGhlIGh5cGVydmlzb3Igd2lsbDoKKwor LSBQcm92aWRlIGEgcHJvdG9jb2wgaW1wbGVtZW50YXRpb24gYWRoZXJpbmcgdG8gaGFyZHdhcmUg c3luY2hyb25pemF0aW9uCityZXF1aXJlbWVudHMgZm9yIGNvbmN1cnJlbnQgYWNjZXNzIHRvIHN5 c3RlbSBtZW1vcnkgYnkgY29tbXVuaWNhdGluZworY29tcG9uZW50cworLSBEZWxpdmVyIGRhdGEg b25seSBmcm9tIGFuIGFwcHJvdmVkIHNvdXJjZSwgZW5mb3JjaW5nIHBvbGljeSBmb3IgTWFuZGF0 b3J5CitBY2Nlc3MgQ29udHJvbC4KKy0gSW5kaWNhdGUgdGhlIGNvcnJlY3Qgc2VuZGVyIG9mIHRo ZSBkYXRhLgorLSBUcmFuc21pdCBvbmx5IHRoZSBpbnRlbmRlZCBkYXRhLCBhZGhlcmluZyB0byB0 aGUgYWNjZXNzIHByb3RvY29sIG9mIHRoZSBkYXRhCitzdHJ1Y3R1cmUgaW4gdGhlIGJ1ZmZlci4g SWYgdGhlIG1lbW9yeSByZWdpb24gaXMgYmVpbmcgdXNlZCBhcyBhIHJpbmcsIHRoZW46CisgICAg LSBEYXRhIHdyaXRlcyB3aWxsIG9ubHkgb2NjdXIgd2l0aGluIHRoZSByaW5nIHJlZ2lvbiB0aGF0 IGlzIGluZGljYXRlZCBhcworICAgIGF2YWlsYWJsZSBmb3IgaW5jb21pbmcgZGF0YSBieSB0aGUg cmluZyBpbmRleGVzLgorICAgIC0gVGhlIGluZGljYXRlZCBsZW5ndGggb2YgZGF0YSB3cml0dGVu IHdpbGwgZXhhY3RseSBtYXRjaCB0aGUgbGVuZ3RoIG9mCisgICAgZGF0YSBhY3R1YWxseSB3cml0 dGVuLgorICAgIC0gVGhlIHdyaXRlIGZvciBlYWNoIHBpZWNlIG9mIGRhdGEgd2lsbCBvY2N1ciBv bmx5IG9uY2UuCisgICAgLSBEYXRhIHdpbGwgYmUgd3JpdHRlbiBzZXF1ZW50aWFsbHkgaW4gdGhl IG9yZGVyIHRoYXQgaXQgaXMgc2VudC4KKy0gSXNzdWUgbm90aWZpY2F0aW9uIG9mIGRhdGEgZGVs aXZlcmVkIGNvcnJlY3RseS4KKworVGhpcyBzdHJ1Y3R1cmUgYWxsb3dzIGZvciBhdWdtZW50YXRp b24gYnkgdGhlIGh5cGVydmlzb3IgdG8gaWRlbnRpZnkgdGhlCitzZW5kaW5nIGVudGl0eSB3aXRo aW4gdGhlIHNvdXJjZSBWTSwgYW5kIHRoZW4gcHJvdmlkZSB0aGUgcmVjZWl2ZXIgd2l0aAorYXNz dXJlZCBjb250ZXh0IGluZm9ybWF0aW9uIGFib3V0IHRoZSBkYXRhIHNvdXJjZS4gVGhpcyBlbmFi bGVzIHRoZSByZWNlaXZlcgordG8gbWFrZSBkZWNpc2lvbnMgYmFzZWQgb24gZmluZS1ncmFpbmVk IGtub3dsZWRnZSBvZiB0aGUgc291cmNlIG9mIHRoZSBkYXRhLgorCitUaGlzIHN0cnVjdHVyZSBp cyBhbHNvIG9mIHN0cm9uZyBpbnRlcmVzdCBmb3IgbmVzdGVkIHZpcnR1YWxpemF0aW9uOgordHJh bnNwb3J0IHZpYSB0aGUgaHlwZXJ2aXNvciBjYW4gZW5hYmxlIGNvbnN0cnVjdGlvbiBvZiBlZmZp Y2llbnQKK2NvbW11bmljYXRpb25zIGJldHdlZW4gVk1zIGF0IGRpZmZlcmVudCBsZXZlbHMgb2Yg bmVzdGluZy4KKworIyBMb2NraW5nCisKK1NpbmNlIEFyZ28gb3BlcmF0ZXMgYSBkYXRhIHBhdGgg YmV0d2VlbiBkb21haW5zLCBzZWN0aW9ucyBvZiB0aGlzIGNvZGUgYXJlCisqaG90KiB3aGVuIHRo ZSBjb21tdW5pY2F0aW9uIHBhdGhzIGFyZSBpbiB1c2UuIFRvIGVuY291cmFnZSBoaWdoIHBlcmZv cm1hbmNlLCBhCitnb2FsIGlzIHRvIGxpbWl0IG11dHVhbCBleGNsdXNpb24gdG8gb25seSB3aGVy ZSByZXF1aXJlZCBhbmQgZW5hYmxlIHNpZ25pZmljYW50Citjb25jdXJyZW5jeS4KKworQXZvaWRh bmNlIG9mIGRlYWRsb2NrIGlzIGVzc2VudGlhbCBhbmQgc2luY2Ugc3RhdGUgbXVzdCBmcmVxdWVu dGx5IGJlIHVwZGF0ZWQKK3RoYXQgcGVydGFpbnMgdG8gbW9yZSB0aGFuIG9uZSBkb21haW4sIGEg bG9ja2luZyBwcm90b2NvbCBkZWZpbmVzIHdoaWNoIGxvY2tzCithcmUgbmVlZGVkIGFuZCB0aGUg b3JkZXIgb2YgdGhlaXIgYWNxdWlzdGlvbi4KKworIyMgU3RydWN0dXJlCisKK1RoZSBncmFudWxh ciBsb2NraW5nIHN0cnVjdHVyZSBvZiBBcmdvIGVuYWJsZXM6CisKKzEuIFBlcmZvcm1hbmNlIGlz b2xhdGlvbiBvZiBndWVzdHMKKzIuIEF2b2lkYW5jZSBvZiBEb1Mgb2YgcmluZ3MgYnkgZG9tYWlu cyB0aGF0IGFyZSBub3QgYXV0aG9yaXplZCB0byBzZW5kIHRvIHRoZW0KKzMuIERlYWRsb2NrLWZy ZWUgdGVhcmRvd24gb2Ygc3RhdGUgYWNyb3NzIG11bHRpcGxlIGRvbWFpbnMgb24gZG9tYWluIGRl c3Ryb3kKKzQuIFBlcmZvcm1hbmNlIG9mIGd1ZXN0cyB1c2luZyBBcmdvIHdpdGggY29uY3VycmVu dCBvcGVyYXRpb24gb2YgcmluZ3MuCisKK0FyZ28gdXNlcyB0aHJlZSBwZXItZG9tYWluIGxvY2tz IHRvIHByb3RlY3QgdGhyZWUgc2VwYXJhdGUgZGF0YSBzdHJ1Y3R1cmVzLgorQWNjZXNzIHRvIHRo ZSByaW5nX2hhc2ggZGF0YSBzdHJ1Y3R1cmUgaXMgY29uZmluZWQgdG8gZG9tYWlucyB0aGF0IGEK K3JpbmctcmVnaXN0ZXJpbmcgZG9tYWluIGhhcyBhdXRob3JpemVkIHRvIHNlbmQgZGF0YSB2aWEg dGhlIHJpbmcuICBUaGUgY29tcGxldGUKK3NldCBvZiBBcmdvIGxvY2tzIGlzOgorCisqIEdsb2Jh bCA6IGBMMV9nbG9iYWxfYXJnb19yd2xvY2tgCisqIFBlci1kb21haW46IGByaW5nc19MMl9yd2xv Y2tgCisqIFBlci1kb21haW46IGBzZW5kX0wyX2xvY2tgCisqIFBlci1kb21haW46IGB3aWxkY2Fy ZF9MMl9sb2NrYAorKiBQZXItcmluZzogYEwzX2xvY2tgCisKKyMjIFByb3RlY3RlZCBTdGF0ZQor CitUaGUgZGF0YSBzdHJ1Y3R1cmVzIGJlaW5nIHByb3RlY3RlZCBieSB0aGUgbG9ja3MgYXJlIGFs bCBwZXItZG9tYWluLiBUaGUgb25seQorZ2xvYmFsIEFyZ28gc3RhdGUgaXMgdGhlIGBMMV9nbG9i YWxfYXJnb19yd2xvY2tgIHVzZWQgdG8gY29vcmRpbmF0ZSBhY2Nlc3MgdG8KK2RhdGEgc3RydWN0 dXJlcyBvZiBvdGhlciBkb21haW5zLgorCisjIyMgU3RhdGU6IFJpbmdzIHJlZ2lzdGVyZWQgYW5k IG93bmVkIGJ5IGEgZG9tYWluCisKK1RoaXMgaW5jbHVkZXMgdGhlIHN0YXRlIHRvIHJ1biB0aGF0 IHJpbmcsIHN1Y2ggYXMgbWVtb3J5IGZyYW1lIG51bWJlcnMgYW5kCitlc3RhYmxpc2hlZCBtYXBw aW5ncy4gUGVyLXJpbmcgc3RhdGUgaXMgcHJvdGVjdGVkIGJ5IGl0cyBvd24gbG9jaywgc28gdGhh dAorbXVsdGlwbGUgVkNQVXMgb2YgdGhlIHNhbWUgZG9tYWluIG9wZXJhdGluZyBkaWZmZXJlbnQg cmluZ3MgZG8gbm90IGluaGliaXQgdGhlCitwZXJmb3JtYW5jZSBvZiBlYWNoIG90aGVyLgorCitU aGUgcGVyLWRvbWFpbiByaW5nIHN0YXRlIGFsc28gaW5jbHVkZXMgdGhlIGxpc3Qgb2YgcGVuZGlu ZyBub3RpZmljYXRpb25zIGZvcgorb3RoZXIgZG9tYWlucyB0aGF0IGFyZSB3YWl0aW5nIGZvciBy aW5nIHNwYWNlIGF2YWlsYWJpbGl0eS4KKworIyMjIFN0YXRlOiBQYXJ0bmVyIHJpbmdzIGZvciB3 aGljaCB0aGlzIGRvbWFpbiBpcyB0aGUgc2luZ2xlIGFsbG93ZWQgc2VuZGVyCisKK1RoaXMgc3Rh dGUgYmVsb25naW5nIHRvIHRoZSBwZXJtaXR0ZWQgc2VuZGVyIGlzIHdyaXR0ZW4gdG8gd2hlbiBh IHJpbmcgaXMKK3JlZ2lzdGVyZWQgYnkgYW5vdGhlciBkb21haW4uIFRoZSBsb2NrIHRoYXQgcHJv dGVjdHMgdGhpcyBzdGF0ZSBpcyBzdWJqZWN0IHRvCitsb2NraW5nIGF0IGFyYml0cmFyeSBmcmVx dWVuY3kgYnkgdGhvc2UgZm9yZWlnbiBkb21haW5zIHdoZW4gcmVnaXN0ZXJpbmcgcmluZ3MKKy0t IHdoaWNoIGRvIG5vdCBuZWVkIGFueSBwZXJtaXNzaW9uIGdyYW50ZWQgYnkgdGhpcyBkb21haW4g aW4gb3JkZXIgdG8gcmVnaXN0ZXIKK2EgcmluZyB0byBjb21tdW5pY2F0ZSB3aXRoIGl0IC0tICBz byBpdCBtdXN0IG5vdCBpbmhpYml0IHRoZSBkb21haW4ncyBvd24KK2FiaWxpdHkgdG8gdXNlIGl0 cyBvd24gcmluZ3MsIHRvIHByb3RlY3QgdGhlbSBmcm9tIERvUy4gRm9yIHRoaXMgcmVhc29uLCB0 aGlzCitzdGF0ZSBpcyBwcm90ZWN0ZWQgYnkgaXRzIG93biBsb2NrLgorCisjIyMgU3RhdGU6IFBl bmRpbmcgbm90aWZpY2F0aW9ucyBmb3Igd2lsZGNhcmQgcmluZ3MgcmVnaXN0ZXJlZCBieSBvdGhl ciBkb21haW5zCisKK1RoaXMgZGF0YSBzdHJ1Y3R1cmUgaXMgbmVlZGVkIHdoZW4gYSBkb21haW4g aXMgZGVzdHJveWVkLCB0byBjYW5jZWwgdGhlCitvdXRzdGFuZGluZyBzcGFjZSBhdmFpbGFiaWxp dHkgbm90aWZpY2F0aW9ucyBhYm91dCB0aGUgd2lsZGNhcmQgcmluZ3Mgb2Ygb3RoZXIKK2RvbWFp bnMgdGhhdCB0aGlzIGRvbWFpbiBoYXMgcXVlcmllZC4KKworRGF0YSBpcyBlbnRlcmVkIGludG8g dGhpcyBkYXRhIHN0cnVjdHVyZSBieSB0aGUgZG9tYWluIHRoYXQgb3ducyBpdCwgZWl0aGVyIGJ5 CithIHNwYWNlLWluaGliaXRlZCBzZW5kdiBvciBhIG5vdGlmeSBvcGVyYXRpb24uCisKK0RhdGEg aXMgcmVtb3ZlZCBmcm9tIHRoaXMgZGF0YSBzdHJ1Y3R1cmUgaW4gb25lIG9mIHRocmVlIGNhc2Vz OiB3aGVuIHNwYWNlCitiZWNvbWVzIGF2YWlsYWJsZSBpbiB0aGUgZGVzdGluYXRpb24gcmluZyBh bmQgdGhlIG5vdGlmaWNhdGlvbiBpcyBzZW50LCB3aGVuCit0aGUgcmluZyBpcyB0b3JuIGRvd24s IG9yIHdoZW4gdGhlIGF3YWl0aW5nIGRvbWFpbiBpcyBkZXN0cm95ZWQuCisKK0luIHRoZSBjYXNl IHdoZXJlIGEgbm90aWZpY2F0aW9uIGlzIHNlbnQsIGFjY2VzcyB0byB0aGUgZGF0YSBzdHJ1Y3R1 cmUgaXMKK3RyaWdnZXJlZCBieSB0aGUgcmluZyBvd25lciBkb21haW4sIHJhdGhlciB0aGFuIHRo ZSBkb21haW4gd2FpdGluZyBmb3IKK25vdGlmaWNhdGlvbi4gVGhpcyBkYXRhIHN0cnVjdHVyZSBp cyBwcm90ZWN0ZWQgYnkgaXRzIG93biBsb2NrIHNpbmNlIGRvaW5nIHNvCitlbnRhaWxzIGxlc3Mg Y29udGVudGlvbiB0aGFuIHRoZSBhbHRlcm5hdGl2ZSBvZiByZXVzaW5nIGFuIGV4aXN0aW5nIGxv Y2sgb3duZWQKK2J5IHRoZSBkb21haW4uCisKKyMjIEhpZXJhcmNoaWNhbCBMb2NraW5nIE1vZGVs IGFuZCBQcm90b2NvbAorCitUaGUgbG9ja2luZyBkaXNjaXBsaW5lIHdpdGhpbiB0aGUgQXJnbyBj b2RlIGlzIGhlaXJhcmNoaWNhbCBhbmQgdXRpbGl6ZXMKK3JlYWRlci93cml0ZXIgbG9ja3MgdG8g ZW5hYmxlIGluY3JlYXNlZCBjb25jdXJyZW5jeSB3aGVuIG9wZXJhdGlvbnMgZG8gbm90Citjb25m bGljdC4gTm9uZSBvZiB0aGUgQXJnbyBsb2NrcyBhcmUgcmVlbnRyYW50LgorCitUaGUgaGllcmFy Y2h5OgorCisqIFRoZXJlIGlzIGEgZ2xvYmFsIHJ3bG9jayAoYEwxYCkgdG8gcHJvdGVjdCBhY2Nl c3MgdG8gYWxsIG9mIHRoZSBwZXItZG9tYWluCithcmdvIGRhdGEgc3RydWN0dXJlcy4KKyogVGhl cmUgaXMgYSByd2xvY2sgcGVyLWRvbWFpbiAoYHJpbmdzX0wyYCkgdG8gcHJvdGVjdCB0aGUgaGFz aHRhYmxlIG9mIHRoZQorcGVyLXJpbmcgZGF0YSBzdHJ1Y3R1cmVzLgorKiBUaGVyZSBpcyBhIGxv Y2sgcGVyIHJpbmcgKGBMM2ApIHRvIHByb3RlY3QgdGhlIHBlci1yaW5nIGRhdGEgc3RydWN0dXJl LAorYHN0cnVjdCBhcmdvX3JpbmdfaW5mb2AuCisKK1RoZXJlIGFyZSBhIHR3byBvdGhlciBwZXIt ZG9tYWluIEwyIGxvY2tzOyB0aGVpciBvcGVyYXRpb24gaXMgc2ltaWxhciBhbmQgdGhleQorYXJl IGRlc2NyaWJlZCBsYXRlci4KKworVGhlIHByb3RvY29sIHRvIHNhZmVseSBhY3F1aXJlIHdyaXRl IGFjY2VzcyB0byB0aGUgcGVyLXJpbmcgZGF0YSBzdHJ1Y3R1cmUsCitgc3RydWN0IGFyZ29fcmlu Z19pbmZvYCwgaXM6CisKKzEpIEFjcXVpcmUgYSBSZWFkIGxvY2sgb24gTDEuCisyKSBBY3F1aXJl IGEgUmVhZCBsb2NrIG9uIEwyLgorMykgQWNxdWlyZSBMMy4KKworQW4gYWx0ZXJuYXRpdmUgdmFs aWQgc2VxdWVuY2UgaXM6CisKKzEpIEFjcXVpcmUgYSBSZWFkIGxvY2sgb24gTDEuCisyKSBBY3F1 aXJlIGEgV3JpdGUgbG9jayBvbiBMMi4KKworVGhpcyBzZWNvbmQgc2VxdWVuY2UgZ3JhbnRzIHdy aXRlIGFjY2VzcyB0byBfYWxsXyBvZiB0aGUgYGFyZ29fcmluZ19pbmZvYAorc3RydWN0cyBiZWxv bmdpbmcgdG8gdGhlIGRvbWFpbiwgYnV0IGF0IHRoZSBleHBlbnNlIG9mIGxlc3MgY29uY3VycmVu Y3k6IG5vCitvdGhlciBvcGVyYXRpb24gY2FuIGFjY2VzcyB0aG9zZSBzdHJ1Y3RzIHdoaWxlIHRo ZSBsb2NrcyBhcmUgaGVsZCwgd2hpY2ggd2lsbAoraW5oaWJpdCBvcGVyYXRpb25zIG9uIHRob3Nl IHJpbmdzIHVudGlsIHRoZSBsb2NrcyBhcmUgcmVsZWFzZWQuCisKK0Fub3RoZXIgYWx0ZXJuYXRp dmUgdmFsaWQgc2VxdWVuY2UgaXM6CisKKzEpIEFjcXVpcmUgYSBXcml0ZSBsb2NrIG9uIEwxLgor CitUaGlzIGdyYW50cyB3cml0ZSBhY2Nlc3MgdG8gX2FsbF8gb2YgdGhlIGBhcmdvX3JpbmdfaW5m b2Agc3RydWN0cyBiZWxvbmdpbmcgdG8KK19hbGwgZG9tYWluc18sIGJ1dCBhZ2FpbiBhdCB0aGUg ZXhwZW5zZSBvZiBmYXIgbGVzcyBjb25jdXJyZW5jeTogbm8gb3RoZXIKK29wZXJhdGlvbiBjYW4g b3BlcmF0ZSBvbiBBcmdvIHJpbmdzIHVudGlsIHRoZSBsb2NrcyBhcmUgcmVsZWFzZWQuCisKKyMj IExvY2sgRGVmaW5pdGlvbnMKKworVGhlIGZ1bGwgc2V0IG9mIGxvY2tzIHRoYXQgYXJlIGRpcmVj dGx5IG9wZXJhdGVkIHVwb24gYnkgdGhlIEFyZ28gY29kZSBhcmUKK2Rlc2NyaWJlZCBpbiB0aGUg Zm9sbG93aW5nIHNlY3Rpb24uCisKKyMjIyBUaGUgZ2xvYmFsIHNpbmdsZXRvbiBsb2NrOgorCisq IGBMMV9nbG9iYWxfYXJnb19yd2xvY2tgCisKK1RoZSByYXRpb25hbGUgZm9yIGhhdmluZyBhIGds b2JhbCBsb2NrIGlzIHRvIGJlIGFibGUgdG8gZW5mb3JjZSBzeXN0ZW0td2lkZQorZXhjbHVzaW9u IGZvciBhIGNyaXRpY2FsIHJlZ2lvbiBhbmQgc2ltcGxpZnkgdGhlIGxvZ2ljIHJlcXVpcmVkIHRv IGF2b2lkCitkZWFkbG9jaywgZm9yIHRlYXJkb3duIG9mIHN0YXRlIGFjcm9zcyBtdWx0aXBsZSBk b21haW5zIHdoZW4gYSBkb21haW4gaXMKK2Rlc3Ryb3llZC4KKworVGhlIG1ham9yaXR5IG9mIG9w ZXJhdGlvbnMgdGFrZSBhIHJlYWQtbG9jayBvbiB0aGlzIGxvY2ssIGFsbG93aW5nIGNvbmN1cnJl bnQKK0FyZ28gb3BlcmF0aW9ucyBieSBtYW55IGRvbWFpbnMuCisKK1RoZSBwb2ludGVyIGQtPmFy Z28gb24gZXZlcnkgZG9tYWluIGlzIHByb3RlY3RlZCBieSB0aGlzIGxvY2suIEEgc2V0IG9mIG1v cmUKK2dyYW51bGFyIHBlci1kb21haW4gbG9ja3MgY291bGQgYmUgdXNlZCB0byBkbyB0aGF0LCBi dXQgc2luY2UgZG9tYWluIHN0YXJ0IGFuZAorc3RvcCBpcyBleHBlY3RlZCB0byBiZSBhIGZhciBs ZXNzIGZyZXF1ZW50IG9wZXJhdGlvbiB0aGFuIHRoZSBvdGhlciBhcmdvCitvcGVyYXRpb25zLCBh Y3F1aXJpbmcgYSBzaW5nbGUgcmVhZCBsb2NrIHRvIGVuYWJsZSBhY2Nlc3MgdG8gYWxsIHRoZSBh cmdvCitzdHJ1Y3RzIG9mIGFsbCBkb21haW5zIHNpbXBsaWZpZXMgdGhlIHByb3RvY29sLgorCitQ b2ludHMgb2Ygd3JpdGUtbG9ja2luZyBvbiB0aGlzIGxvY2s6CisKKyogYGFyZ29fZGVzdHJveWAs IHdoZXJlOgorICAqIEFsbCBvZiB0aGUgZG9tYWluJ3Mgb3duIHJpbmdzIGFyZSBkZXN0cm95ZWQu CisgICAgICAqIEFsbCBvZiB0aGUgbm90aWZpY2F0aW9ucyBwZW5kaW5nIGZvciBvdGhlciBkb21h aW5zIGFyZSBjYW5jZWxsZWQuCisgICAqIEFsbCBvZiB0aGUgdW5pY2FzdCBwYXJ0bmVyIHJpbmdz IG93bmVkIGJ5IG90aGVyIGRvbWFpbnMgZm9yIHRoaXMgZG9tYWluIHRvCitzZW5kIHRvLCBhcmUg ZGVzdHJveWVkLgorICAgICAgKiBBbGwgb2YgdGhlIG5vdGlmaWNhdGlvbnMgcGVuZGluZyBvbiB0 aG9zZSByaW5ncyBhcmUgY2FuY2VsbGVkLgorICAgKiBBbGwgb2YgdGhlIG5vdGlmaWNhdGlvbnMg cGVuZGluZyBmb3IgdGhpcyBkb21haW4gb24gd2lsZGNhcmQgcmluZ3Mgb3duZWQKK2J5IG90aGVy IGRvbWFpbnMgYXJlIGNhbmNlbGxlZC4KKyogYGFyZ29fc29mdF9yZXNldGAsIGZvciBzaW1pbGFy IHRlYXJkb3duIG9wZXJhdGlvbnMgYXMgYXJnb19kZXN0cm95LgorKiBgYXJnb19pbml0YCwgd2hl cmUgdGhlIGBkLT5hcmdvYCBwb2ludGVyIGlzIGZpcnN0IHBvcHVsYXRlZC4KKyAgKiBTaW5jZSB0 aGUgd3JpdGUgbG9jayBpcyB0YWtlbiBoZXJlLCB0aGVyZSBpcyBzZXJpYWxpemF0aW9uIGFsbCBj b25jdXJyZW50CitBcmdvIG9wZXJhdGlvbnMgYXJvdW5kIHRoaXMgc2luZ2xlIHBvaW50ZXIgd3Jp dGU7IHRoaXMgaXMgdGhlIGNvc3Qgb2YgdXNpbmcgdGhlCitzaW1wbGVyIG9uZSBnbG9iYWwgbG9j ayBhcHByb2FjaC4KKworRW5mb3JjaW5nIHRoYXQgdGhlIHdyaXRlX2xvY2sgaXMgYWNxdWlyZWQg b24gYEwxX2dsb2JhbF9hcmdvX3J3bG9ja2AgYmVmb3JlCitleGVjdXRpbmcgdGVhcmRvd24sIGVu c3VyZXMgdGhhdCBubyB0ZWFyZG93biBvcGVyYXRpb25zIGFjdCBjb25jdXJyZW50bHkgYW5kIG5v CitvdGhlciBBcmdvIG9wZXJhdGlvbnMgaGFwcGVuIGNvbmN1cnJlbnRseSB3aXRoIGEgdGVhcmRv d24uIFRoZSB0ZWFyZG93biBsb2dpYworaXMgZnJlZSB0byBzYWZlbHkgbW9kaWZ5IHRoZSBBcmdv IHN0YXRlIGFjcm9zcyBhbGwgZG9tYWlucyB3aXRob3V0IGhhdmluZyB0bworYWNxdWlyZSBwZXIt ZG9tYWluIGxvY2tzIGFuZCBkZWFkbG9jayBjYW5ub3Qgb2NjdXIuCisKKyMjIyBQZXItRG9tYWlu OiBSaW5nIGhhc2ggbG9jaworCitgcmluZ3NfTDJfcndsb2NrYAorCitQcm90ZWN0czogdGhlIHBl ci1kb21haW4gcmluZyBoYXNoIHRhYmxlIG9mIGBhcmdvX3JpbmdfaW5mb2Agc3RydWN0cy4KKwor SG9sZGluZyBhIHJlYWQgbG9jayBvbiBgcmluZ3NfTDJgIHByb3RlY3RzIHRoZSByaW5nIGhhc2gg dGFibGUgYW5kIHRoZSBlbGVtZW50cworaW4gdGhlIGhhc2ggdGFibGUgYGQtPmFyZ28tPnJpbmdf aGFzaGAsIGFuZCB0aGUgYG5vZGVgIGFuZCBgaWRgIGZpZWxkcyBpbgorc3RydWN0IGBhcmdvX3Jp bmdfaW5mb2AgaW4gdGhlIGhhc2ggdGFibGUuCisKK0hvbGRpbmcgYSB3cml0ZSBsb2NrIG9uIGBy aW5nc19MMmAgcHJvdGVjdHMgYWxsIG9mIHRoZSBlbGVtZW50cyBvZiBhbGwgdGhlCitzdHJ1Y3Qg YGFyZ29fcmluZ19pbmZvYCBiZWxvbmdpbmcgdG8gdGhpcyBkb21haW4uCisKK1RvIHRha2UgYHJp bmdzX0wyYCB5b3UgbXVzdCBhbHJlYWR5IGhhdmUgYFIoTDEpYC4gYFcoTDEpYCBpbXBsaWVzIGBX KHJpbmdzX0wyKWAKK2FuZCBgTDNgLgorCitQcmVyZXF1aXNpdGVzOgorCisqIGBSKEwxX2dsb2Jh bF9hcmdvX3J3bG9jaylgIG11c3QgYmUgYWNxdWlyZWQgYmVmb3JlIHRha2luZyBlaXRoZXIgcmVh ZCBvcgord3JpdGUgb24gYHJpbmdzX0wyX3J3bG9ja2AuCisqIGBXKEwxX2dsb2JhbF9hcmdvX3J3 bG9jaylgIGltcGxpZXMgYFcocmluZ3NfTDJfcndsb2NrKWAsIHNvIGlmCitgVyhMMV9nbG9iYWxf YXJnb19yd2xvY2spYCBpcyBoZWxkLCB0aGVuIGByaW5nc19MMl9yd2xvY2tgIGRvZXMgbm90IG5l ZWQgdG8gYmUKK2FjcXVpcmVkLCBhbmQgYWxsIHRoZSBkYXRhIHN0cnVjdHVyZXMgdGhhdCBgcmlu Z3NfTDJfcndsb2NrYCBwcm90ZWN0cyBjYW4gYmUKK2FjY2Vzc2VkIGFzIGlmIGBXKHJpbmdfTDJf cndsb2NrKWAgd2FzIGhlbGQuCisKK0lzIGFjY2Vzc2VkIGJ5IHRoZSBoeXBlcnZpc29yIG9uIGJl aGFsZiBvZjoKKworKiBUaGUgZG9tYWluIHRoYXQgcmVnaXN0ZXJlZCB0aGUgcmluZy4KKyogQW55 IGRvbWFpbiB0aGF0IGlzIGFsbG93ZWQgdG8gc2VuZCB0byB0aGUgcmluZyAtLSBzbyB0aGF0J3Mg dGhlIHBhcnRuZXIKK2RvbWFpbiwgZm9yIHVuaWNhc3QgcmluZ3MsIG9yIGFueSBkb21haW4sIGZv ciB3aWxkY2FyZCByaW5ncy4KKworIyMjIFNlbmQgaGFzaCBsb2NrCisKK2BzZW5kX0wyX2xvY2tg CisKK1Byb3RlY3RzOiB0aGUgcGVyLWRvbWFpbiBzZW5kIGhhc2ggdGFibGUgb2YgYGFyZ29fc2Vu ZF9pbmZvYCBzdHJ1Y3RzLgorCitJcyBhY2Nlc3NlZCBieSB0aGUgaHlwZXJ2aXNvciBvbiBiZWhh bGYgb2Y6CisKKyogQW55IGRvbWFpbiB0aGF0IHJlZ2lzdGVycyBhIHJpbmcgdGhhdCBzcGVjaWZp ZXMgdGhlIGRvbWFpbiBhcyB0aGUgdW5pY2FzdAorc2VuZGVyLgorKiBUaGUgZG9tYWluIHRoYXQg aGFzIGJlZW4gYWxsb3dlZCB0byBzZW5kLCBhcyBwYXJ0IG9mIHRlYXJkb3duIHdoZW4gdGhlIGRv bWFpbgoraXMgYmVpbmcgZGVzdHJveWVkLgorCisKKyMjIyBXaWxkY2FyZCBwZW5kaW5nIGxpc3Qg bG9jaworCitgd2lsZGNhcmRfTDJfbG9ja2AKKworUHJvdGVjdHM6IHRoZSBwZXItZG9tYWluIGxp c3Qgb2YgcGVuZGluZyBub3RpZmljYXRpb25zIHRvIHRoZSBkb21haW4gZnJvbQord2lsZGNhcmQg cmluZ3Mgb3duZWQgYnkgb3RoZXIgZG9tYWlucy4KKworSXMgYWNjZXNzZWQgYnkgdGhlIGh5cGVy dmlzb3Igb24gYmVoYWxmIG9mOgorCisqIFRoZSBkb21haW4gdGhhdCBpc3N1ZWQgYSBxdWVyeSB0 byBhbm90aGVyIGFib3V0IHNwYWNlIGF2YWlsYWJpbGl0eSBpbiBvbmUgb2YKK2l0cyB3aWxkY2Fy ZCByaW5ncyAtIHRoaXMgY2FuIGJlIGRvbmUgYnkgYXR0ZW1wdGluZyBhIHNlbmQgb3BlcmF0aW9u IHdoZW4gdGhlcmUKK2lzIGluc3VmZmljaWVudCByaW5nIHNwYWNlIGF2YWlsYWJsZSBhdCB0aGUg dGltZS4KKyogQW55IGRvbWFpbiB0aGF0IHRoZSBkb21haW4gaGFzIGlzc3VlZCBhIHF1ZXJ5IHRv IGFib3V0IHNwYWNlIGF2YWlsYWJpbGl0eSBpbgorb25lIG9mIHRoZWlyIHdpbGRjYXJkIHJpbmdz LgorCisjIyMgUGVyLVJpbmcgbG9ja3M6CisKKyogYEwzX2xvY2tgCisKK1RoaXMgbG9jayBwcm90 ZWN0cyB0aGUgbWVtYmVycyBvZiBhIGBzdHJ1Y3QgcmluZ19pbmZvYCB3aGljaCBpcyB0aGUgcHJp bWFyeQorc3RhdGUgZm9yIGEgZG9tYWluJ3Mgb3duIHJlZ2lzdGVyZWQgcmluZy4KKworCisjIyBS ZWFzb25pbmcgTW9kZWwKKworQSBjb21tb24gbW9kZWwgZm9yIHJlYXNvbmluZyBhYm91dCBjb25j dXJyZW50IGNvZGUgZm9jdXNzZXMgb24gYWNjZXNzZXMgdG8KK2luZGl2aWR1YWwgdmFyaWFibGVz OiBpZiBjb2RlIHRvdWNoZXMgdGhpcyB2YXJpYWJsZSwgc2VlIHRoYXQgaXQgZmlyc3QgYWNxdWly ZXMKK3RoZSBjb3JyZXNwb25kaW5nIGxvY2sgYW5kIHRoZW4gZHJvcHMgaXQgYWZ0ZXJ3YXJkcy4g QSBjaGFsbGVuZ2Ugd2l0aCB0aGlzCittb2RlbCBpcyBpbiBlbnN1cmluZyB0aGF0IHRoZSBzZXF1 ZW5jZSBvZiBsb2NrcyBhY3F1aXJlZCB3aXRoaW4gbmVzdGVkCitmdW5jdGlvbnMsIHdoZW4gb3Bl cmF0aW5nIG9uIGRhdGEgZnJvbSBtdWx0aXBsZSBkb21haW5zIHdpdGggY29uY3VycmVudAorb3Bl cmF0aW9ucywgaXMgc2FmZSBmcm9tIGRlYWRsb2NrLgorCitBbiBhbHRlcm5hdGl2ZSBtZXRob2Qg dGhhdCBpcyBiZXR0ZXIgc3VpdGVkIHRvIHRoZSBBcmdvIHNvZnR3YXJlIGlzIHRvIGNvbnNpZGVy Cit0aGUgZXhlY3V0aW9uIHBhdGgsIHRoZSBmdWxsIHNlcXVlbmNlIG9mIGxvY2tzIGFjcXVpcmVk LCBhY2Nlc3NlcyBwZXJmb3JtZWQsCithbmQgbG9ja3MgcmVsZWFzZWQsIGZyb20gZW50ZXJpbmcg YW4gb3BlcmF0aW9uLCB0byB0aGUgY29tcGxldGlvbiBvZiB0aGUgd29yay4KKworQW4gZXhhbXBs ZSBjb2RlIHBhdGggZm9yIGFuIG9wZXJhdGlvbjoKKworYFtlbnRyeV0gPiAtLSBbIHRha2UgUihM MSkgXSAtLSBbIHRha2UgUihMMikgXSAtLSBsb29wIFsgdGFrZSBhIEwzIC8gZHJvcCBMMyBdCist LSAgWyBkcm9wIFIoTDIpIF0gLS0gWyBkcm9wIFIoTDEpXSAtLSA+IFtleGl0XWAKKworSWYgYSBm dW5jdGlvbiBpbXBsZW1lbnRzIGEgc2VjdGlvbiBvZiB0aGUgcGF0aCwgaXQgaXMgaW1wb3J0YW50 IHRvIGtub3cgbm90Citvbmx5IHdoYXQgdmFyaWFibGVzIHRoZSBmdW5jdGlvbiBpdHNlbGYgb3Bl cmF0ZXMgdXBvbiwgYnV0IGFsc28gdGhlIGxvY2tpbmcKK3N0YXRlIHRoYXQgd2lsbCBhbHJlYWR5 IGhhdmUgYmVlbiBlc3RhYmxpc2hlZCBhdCB0aGUgcG9pbnQgd2hlbiB0aGUgZnVuY3Rpb24gaXMK K2ludm9rZWQsIHNpbmNlIHRoaXMgd2lsbCBhZmZlY3Qgd2hhdCBkYXRhIHRoZSBmdW5jdGlvbiBj YW4gYWNjZXNzLiBGb3IgdGhpcworcmVhc29uLCBjb21tZW50cyBpbiB0aGUgY29kZSwgb3IgQVNT RVJUcyB0aGF0IGV4cGxpY2l0bHkgY2hlY2sgbG9jayBzdGF0ZSwKK2NvbW11bmljYXRlIHdoYXQg dGhlIGxvY2tpbmcgc3RhdGUgaXMgZXhwZWN0ZWQgYW5kIGludGVuZGVkIHRvIGJlIHdoZW4gdGhh dAorY29kZSBpcyBpbnZva2VkLiBTZWUgdGhlIG1hY3JvcyBkZWZpbmVkIHRvIHN1cHBvcnQgdGhp cyBmb3IgQXJnbyBsYXRlciBpbiB0aGlzCitkb2N1bWVudC4KKworCisjIyBNYWNyb3MgdG8gVmFs aWRhdGUgYW5kIERvY3VtZW50IExvY2sgU3RhdGUKKworVGhlc2UgbWFjcm9zIGVuY29kZSB0aGUg bG9naWMgdG8gdmVyaWZ5IHRoYXQgdGhlIGxvY2tpbmcgaGFzIGFkaGVyZWQgdG8gdGhlCitsb2Nr aW5nIGRpc2NpcGxpbmUuCisKK2VnLiBPbiBlbnRyeSB0byBsb2dpYyB0aGF0IHJlcXVpcmVzIGhv bGRpbmcgYXQgbGVhc3QgYFIocmluZ3NfTDIpYCwgdGhpczoKKworYEFTU0VSVChMT0NLSU5HX1Jl YWRfcmluZ3NfTDIoZCkpO2AKKworY2hlY2tzIHRoYXQgdGhlIGxvY2sgc3RhdGUgaXMgc3VmZmlj aWVudCwgdmFsaWRhdGluZyB0aGF0IG9uZSBvZiB0aGUgZm9sbG93aW5nCittdXN0IGJlIHRydWUg d2hlbiBleGVjdXRlZDoKKworYFIocmluZ3NfTDIpICYmIFIoTDEpYAorb3I6ICBgVyhyaW5nc19M MikgJiYgUihMMSlgCitvcjogIGBXKEwxKWAKKworVGhlIG1hY3JvcyBhcmUgZGVmaW5lZCB0aHVz OgorCitgYGAKKyNkZWZpbmUgTE9DS0lOR19Xcml0ZV9MMSAocndfaXNfd3JpdGVfbG9ja2VkKCZM MV9nbG9iYWxfYXJnb19yd2xvY2spKQorLyoKKyAqIFdoaWxlIExPQ0tJTkdfUmVhZF9MMSB3aWxs IHJldHVybiB0cnVlIGV2ZW4gaWYgdGhlIGxvY2sgaXMgd3JpdGUtbG9ja2VkLAorICogdGhhdCdz IE9LIGJlY2F1c2UgZXZlcnl3aGVyZSB0aGF0IGEgUmVhZCBsb2NrIGlzIG5lZWRlZCB3aXRoIHRo ZXNlIG1hY3JvcywKKyAqIGhvbGRpbmcgYSBXcml0ZSBsb2NrIHRoZXJlIGluc3RlYWQgaXMgT0sg dG9vOiB3ZSdyZSBjaGVja2luZyB0aGF0IF9hdCBsZWFzdF8KKyAqIHRoZSBzcGVjaWZpZWQgbGV2 ZWwgb2YgbG9ja3MgYXJlIGhlbGQuCisgKi8KKyNkZWZpbmUgTE9DS0lOR19SZWFkX0wxIChyd19p c19sb2NrZWQoJkwxX2dsb2JhbF9hcmdvX3J3bG9jaykpCisKKyNkZWZpbmUgTE9DS0lOR19Xcml0 ZV9yaW5nc19MMihkKSBcCisgICAgKChMT0NLSU5HX1JlYWRfTDEgJiYgcndfaXNfd3JpdGVfbG9j a2VkKCYoZCktPmFyZ28tPnJpbmdzX0wyX3J3bG9jaykpIHx8IFwKKyAgICAgTE9DS0lOR19Xcml0 ZV9MMSkKKy8qCisgKiBTa2lwIGNoZWNraW5nIExPQ0tJTkdfV3JpdGVfcmluZ3NfTDIoZCkgd2l0 aGluIHRoaXMgTE9DS0lOR19SZWFkX3JpbmdzX0wyCisgKiBkZWZpbml0aW9uIGJlY2F1c2UgdGhl IGZpcnN0IGNsYXVzZSB0aGF0IGlzIHRlc3RpbmcgUihMMSkgJiYgUihMMikgd2lsbCBhbHNvCisg KiByZXR1cm4gdHJ1ZSBpZiBSKEwxKSAmJiBXKEwyKSBpcyB0cnVlLCBiZWNhdXNlIG9mIHRoZSB3 YXkgdGhhdCByd19pc19sb2NrZWQKKyAqIGJlaGF2ZXMuIFRoaXMgcmVzdWx0cyBpbiBhIHNsaWdo dGx5IHNob3J0ZXIgYW5kIGZhc3RlciBpbXBsZW1lbnRhdGlvbi4KKyAqLworI2RlZmluZSBMT0NL SU5HX1JlYWRfcmluZ3NfTDIoZCkgXAorICAgICgoTE9DS0lOR19SZWFkX0wxICYmIHJ3X2lzX2xv Y2tlZCgmKGQpLT5hcmdvLT5yaW5nc19MMl9yd2xvY2spKSB8fCBcCisgICAgIExPQ0tJTkdfV3Jp dGVfTDEpCisvKgorICogU2tpcCBjaGVja2luZyBMT0NLSU5HX1dyaXRlX0wxIHdpdGhpbiB0aGlz IExPQ0tJTkdfTDMgZGVmaW5pdGlvbiBiZWNhdXNlCisgKiBMT0NLSU5HX1dyaXRlX3JpbmdzX0wy KGQpIHdpbGwgcmV0dXJuIHRydWUgZm9yIHRoYXQgY29uZGl0aW9uLgorICovCisjZGVmaW5lIExP Q0tJTkdfTDMoZCwgcikgXAorICAgICgoTE9DS0lOR19SZWFkX0wxICYmIHJ3X2lzX2xvY2tlZCgm KGQpLT5hcmdvLT5yaW5nc19MMl9yd2xvY2spIFwKKyAgICAgICYmIHNwaW5faXNfbG9ja2VkKCYo ciktPkwzX2xvY2spKSB8fCBMT0NLSU5HX1dyaXRlX3JpbmdzX0wyKGQpKQorCisjZGVmaW5lIExP Q0tJTkdfc2VuZF9MMihkKSBcCisgICAgKChMT0NLSU5HX1JlYWRfTDEgJiYgc3Bpbl9pc19sb2Nr ZWQoJihkKS0+YXJnby0+c2VuZF9MMl9sb2NrKSkgfHwgXAorICAgICBMT0NLSU5HX1dyaXRlX0wx KQorYGBgCisKK0hlcmUgaXMgYW4gZXhhbXBsZSBvZiBhIG1hY3JvIGluIHVzZToKKworYGBgCitz dGF0aWMgdm9pZAorbm90aWZ5X3JpbmcoY29uc3Qgc3RydWN0IGRvbWFpbiAqZCwgc3RydWN0IGFy Z29fcmluZ19pbmZvICpyaW5nX2luZm8sCisgICAgICAgICAgc3RydWN0IGhsaXN0X2hlYWQgKnRv X25vdGlmeSkKK3sKKyAgdWludDMyX3Qgc3BhY2U7CisKKyAgQVNTRVJUKExPQ0tJTkdfUmVhZF9y aW5nc19MMihkKSk7CisKKyAgc3Bpbl9sb2NrKCZyaW5nX2luZm8tPkwzX2xvY2spOworCisgIGlm ICggcmluZ19pbmZvLT5sZW4gKQorICAgICAgc3BhY2UgPSByaW5nYnVmX3BheWxvYWRfc3BhY2Uo ZCwgcmluZ19pbmZvKTsKKyAgZWxzZQorICAgICAgc3BhY2UgPSAwOworCisgIHNwaW5fdW5sb2Nr KCZyaW5nX2luZm8tPkwzX2xvY2spOworCisgIGlmICggc3BhY2UgKQorICAgICAgcGVuZGluZ19m aW5kKGQsIHJpbmdfaW5mbywgc3BhY2UsIHRvX25vdGlmeSk7Cit9CisKK2BgYAorCitJbiB0aGUg YWJvdmUgZXhhbXBsZSwgaXQgY2FuIGJlIHNlZW4gdGhhdCBpdCBpcyBzYWZlIHRvIGFjcXVpcmUg dGhlIGBMM2AgbG9jaworYmVjYXVzZSBfYXQgbGVhc3RfIGBSKHJpbmdzX0wyKWAgaXMgYWxyZWFk eSBoZWxkLCBhcyBkb2N1bWVudGVkIGFuZCB2ZXJpZmllZCBieQordGhlIG1hY3JvLgorCisjIyBG QVEgLyBPdGhlciBDb25zaWRlcmF0aW9ucworCisjIyMgV2h5IG5vdCBoYXZlIGEgc2luZ2xlIHBl ci1kb21haW4gbG9jaz8KKworRHVlIHRvIHBlcmZvcm1hbmNlIGlzb2xhdGlvbiAvIERvUyBhdm9p ZGFuY2U6IGlmIHRoZXJlIGlzIGEgc2luZ2xlIHBlci1kb21haW4KK2xvY2ssIGFjcXVpcmluZyB0 aGlzIGxvY2sgd2lsbCBzdGFsbCBvcGVyYXRpb25zIG9uIG90aGVyIGFjdGl2ZSByaW5ncyBvd25l ZCBieQordGhlIGRvbWFpbi4gQSBtYWxpY2lvdXMgZG9tYWluIGNhbiBsb29wIHJlZ2lzdGVyaW5n IGFuZCB1bnJlZ2lzdGVyaW5nIHJpbmdzLAord2l0aG91dCBhbnkgY29uc2VudCBieSB0aGUgdGFy Z2V0dGVkIGRvbWFpbiwgd2hpY2ggd291bGQgZXhwZXJpZW5jZSBkZWNyZWFzZWQKK3Rocm91Z2hw dXQgZHVlIHRvIHRoZSBjb250ZW50aW9uIG9uIHRoZSBzaW5nbGUgcGVyLWRvbWFpbiBsb2NrLiBU aGUgZ3JhbnVsYXIKK2xvY2tpbmcgc3RydWN0dXJlIG9mIEFyZ28gcHJldmVudHMgdGhpcy4gSXQg YWxzbyBhbGxvd3MgY29uY3VycmVudCBvcGVyYXRpb24gb2YKK2RpZmZlcmVudCByaW5ncyBieSBt dWx0aXBsZSBWQ1BVcyBvZiB0aGUgc2FtZSBkb21haW4gd2l0aG91dCBjb250ZW50aW9uLCB0bwor YXZvaWQgbmVnYXRpdmUgYXBwbGljYXRpb24gcGVyZm9ybWFuY2UgaW50ZXJhY3Rpb24uCisKKyMj IFJhdGlvbmFsZSBmb3IgVXNpbmcgYSBTaW5nbGV0b24gR2xvYmFsIExvY2s6IEwxCisKKyMjIyBU ZWFyZG93biBvbiBkb21haW4gZGVzdHJveQorCitUaGUgc2luZ2xlIGdsb2JhbCBsb2NrIGVuYWJs ZXMgZXhjbHVzaXZlIGFjY2VzcyB0byB0aGUgYXJnbyBkYXRhIHN0cnVjdHVyZXMKK2Fjcm9zcyBk b21haW5zIHdoZW4gYSBkb21haW4gaXMgZGVzdHJveWVkLiBFdmVyeSB1bmljYXN0IHJpbmcgdGhh dCB0aGUgZHlpbmcKK2RvbWFpbiBpcyB0aGUgYXV0aG9yaXplZCBzZW5kZXIgaXMgdG9ybiBkb3du IGFuZCBhbnkgcGVuZGluZyBzcGFjZS1hdmFpbGFibGUKK25vdGlmaWNhdGlvbnMgaW4gb3RoZXIg ZG9tYWluJ3Mgd2lsZGNhcmQgcmluZ3MgYXJlIGNhbmNlbGxlZC4gVGhpcyByZXF1aXJlcworZ2Fp bmluZyBzYWZlIGFjY2VzcyB0byB0aGUgZGF0YSBzdHJ1Y3R1cmVzIG9uIGVhY2ggb2YgdGhlIGRv bWFpbnMgaW52b2x2ZWQuCisKK1RoZSAnc2VuZCBoYXNodGFibGUnIGRhdGEgc3RydWN0dXJlIGlz IG5lZWRlZCBpbiBvcmRlciB0byBwZXJmb3JtIHRoZSB0ZWFyZG93bgorb2YgcmluZ3Mgd2hlbiBh IGRvbWFpbiBpcyBkZXN0cm95ZWQuIFRvIHBvcHVsYXRlIGl0LCB3aGVuZXZlciBhIHVuaWNhc3Qg cmluZyBpcworcmVnaXN0ZXJlZCwgdGhlIGxvY2sgdGhhdCBwcm90ZWN0cyB0aGF0IGRhdGEgc3Ry dWN0dXJlIG11c3QgYmUgdGFrZW4KK2V4Y2x1c2l2ZWx5LgorCitUaGVyZSBhcmUgZ3JhbnVsYXIg cGVyLWRvbWFpbiBsb2NrcyB3aGljaCBwcm90ZWN0IHRoZSBwZXItZG9tYWluIGRhdGEKK3N0cnVj dHVyZXMuIFRoZSBnbG9iYWwgc2luZ2xldG9uIEwxIGxvY2sgb3BlcmF0ZXMgd2l0aC1hbmQtYWJv dmUgdGhlIHBlci1kb21haW4KK2xvY2tzIGFuZCBpcyB1c2VkIHRvIG9idGFpbiBleGNsdXNpdmUg YWNjZXNzIHRvIG11bHRpcGxlIGRvbWFpbidzIGFyZ28gZGF0YQorc3RydWN0dXJlcyBpbiB0aGUg aW5mcmVxdWVudCBjYXNlIHdoZXJlIGl0IGlzIHVzZWQgLS0gZm9yIGRvbWFpbiBkZXN0cm95IC0t Cit3aGlsc3Qgb3RoZXJ3aXNlIGFsbG93aW5nIGNvbmN1cnJlbnQgYWNjZXNzLCB2aWEgYWNxdWly aW5nIGl0IHdpdGggJ3JlYWQnCithY2Nlc3MsIGZvciB0aGUgbWFqb3JpdHkgb2YgdGhlIHRpbWUu CisKK1RvIHBlcmZvcm0gdGhlIHJlcXVpcmVkIHN0YXRlIHRlYXJkb3duIG9uIGRvbWFpbiBkZXN0 cnVjdGlvbiwgd2hpY2ggY2FuIHJlcXVpcmUKK3JlbW92aW5nIHN0YXRlIGZyb20gdGhlIGRhdGEg c3RydWN0dXJlcyBvZiBtdWx0aXBsZSBkb21haW5zLCBhIGxvY2tpbmcgcHJvdG9jb2wKK3RvIG9i dGFpbiBtdXR1YWwgZXhjbHVzaW9uIGFuZCBzYWZlIGFjY2VzcyB0byB0aGUgc3RhdGUgaXMgcmVx dWlyZWQsIHdpdGhvdXQKK2RlYWRsb2NraW5nLgorCitVc2luZyB0aGUgc2luZ2xlIGdsb2JhbCBs b2NrIGF2b2lkcyB0aGUgbmVlZCBmb3Igc2VxdWVuY2luZyB0aGUgYWNxdWlzaXRpb24gb2YKK211 bHRpcGxlIGluZGl2aWR1YWwgcGVyLWRvbWFpbiBsb2NrcyAoYW5kIGxvd2VyIGxldmVsIGRhdGEg c3RydWN0dXJlIGxvY2tzKSB0bworcHJldmVudCBkZWFkbG9jazogdGFraW5nIFcoTDEpIGdyYW50 cyBhY2Nlc3MgdG8gYWxsIGFuZCB0YWtpbmcgUihMMSkgZW5zdXJlcwordGhhdCB0ZWFyZG93biBv ZiBhbnkgZG9tYWluIHdpbGwgbm90IGludGVyZmVyZSB3aXRoIGFueSBBcmdvIGh5cGVyY2FsbAor b3BlcmF0aW9uLiBJdCBlbmFibGVzIGludHJvZHVjaW5nIGdyYW51bGFyIGxvY2tpbmcgd2l0aG91 dCBjb21wbGV4IG9yCitlcnJvci1wcm9uZSBsb2NrIGFjcXVpc2l0aW9uIGxvZ2ljLgorCisjIEZ1 dHVyZSBXb3JrCisKKy0gUGVyZm9ybWFuY2UgbWVhc3VyZW1lbnQgYW5kIG9wdGltaXphdGlvbgor LSBQcm92aWRlIGFzc3VyYW5jZSBvZiBjb25uZWN0aW9uIHNvdXJjZSBjb250ZXh0IHRvIGRlc3Rp bmF0aW9uCistIFBvbGljeSBjb250cm9scyBmb3IgcmVkdWNpbmcgdGhlIGR1cmF0aW9uIG9mIGh5 cGVydmlzb3IgbWFwcGluZ3Mgb2YKK3RyYW5zbWlzc2lvbiByaW5ncywgdG8gaW1wcm92ZSByZXNp c3RhbmNlIHRvIGRhdGEgcmVhZCBhdHRhY2tzIG9uCitoeXBlcnZpc29yIG1lbW9yeQotLSAKMi43 LjQKCgpfX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fXwpYZW4t ZGV2ZWwgbWFpbGluZyBsaXN0Clhlbi1kZXZlbEBsaXN0cy54ZW5wcm9qZWN0Lm9yZwpodHRwczov L2xpc3RzLnhlbnByb2plY3Qub3JnL21haWxtYW4vbGlzdGluZm8veGVuLWRldmVs