Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: base64 Subject: [4/5] usb: typec: ucsi: Preliminary support for alternate modes From: Heikki Krogerus Message-Id: <20190205152421.GB27830@kuha.fi.intel.com> Date: Tue, 5 Feb 2019 17:24:21 +0200 To: Michael Hsu Cc: Greg Kroah-Hartman , Ajay Gupta , "linux-usb@vger.kernel.org" List-ID: SGkgTWljaGFlbCwKCk9uIFR1ZSwgRmViIDA1LCAyMDE5IGF0IDAyOjIwOjM0QU0gKzAwMDAsIE1p Y2hhZWwgSHN1IHdyb3RlOgo+ID4gWW91ciBQUE0gaXMgcmVwb3J0aW5nIGEgc2VwYXJhdGUgbW9k ZSBmb3IgZXZlcnkgcGluLWFzc2lnbm1lbnQgaXQgc3VwcG9ydHMuIEl0Cj4gPiByZWFsbHkgc2hv dWxkIF9ub3RfIGRvIHRoYXQhIFlvdSBuZWVkIHRvIGJlIGFibGUgdG8gZ2V0IHRoZSBjYXBhYmls aXRpZXMgZm9yIERQCj4gPiBhbHQgbW9kZSB3aXRoIEdFVF9BTFRFUk5BVEVfTU9ERSBjb21tYW5k IGluIHRoZSBmb3JtYXQgdGhhdCB0aGUgRFAgYWx0Cj4gPiBtb2RlIHNwZWMgZGVmaW5lcywgYWxz byB3aXRoIHRoZSBjb25uZWN0b3IuCj4gPiBZb3UgYXJlIG5vdCBnZXR0aW5nIHRoZW0gbGlrZSB0 aGF0LiBOb3cgZm9yIGV4YW1wbGUgaW4gYm90aCBtb2RlcyB5b3VyCj4gPiBjb25uZWN0b3IgY2Fu IG9ubHkgYWN0IGFzIERpc3BsYXlQb3J0IHNpbmsgKGkuZS4gYSBkaXNwbGF5KSB3aGljaCBJJ20g cHJldHR5IHN1cmUKPiA+IGlzIG5vdCB0aGUgY2FzZS4KPiA+IAo+ID4gV2l0aCB0aGUgY3VycmVu dCB2ZXJzaW9uIG9mIHRoZSBEUCBhbHQgbW9kZSBzcGVjIHdlIGRvIG5vdCBldmVyIG5lZWQgbW9y ZQo+ID4gdGhhbiBvbmUgbW9kZSBmb3IgRFAuIFRoYXQgbW9kZSBuZWVkcyB0byBzaG93IGFsbCB0 aGUgc3VwcG9ydGVkIHBpbgo+ID4gYXNzaWdubWVudHMgdGhlIGRldmljZSwgcGFydG5lciBvciBj b25uZWN0b3IsIHN1cHBvcnRzLiBUaGF0IGlzIGV4YWN0bHkgaG93IGFsbAo+ID4gdGhlIG90aGVy IFVDU0kgUFBNcyB3b3JrIGN1cnJlbnRseS4gRm9yIGV4YW1wbGUgdGhlIFBQTSBvbiBEZWxsIFhQ UyAxMyA5MzgwCj4gPiB0aGF0IEkgdXNlIGZvciB0ZXN0aW5nIGdpdmVzIG9ubHkgb25lIG1vZGUg Zm9yIHRoZSBjb25uZWN0b3Igd2l0aCBTVklEIGZmMDEuIFRoZQo+ID4gbW9kZSBWRE8gKG9yIE1J RCBpbiBVQ1NJIGxpbmdvKSBoYXMgdGhlIHZhbHVlIDB4MWM0NjoKPiA+IAo+ID4gICAgICAgICBT VklEPTB4ZmYwMSwgVkRPPTB4MWM0Ngo+ID4gCj4gPiBGcm9tIHRoYXQgeW91IGNhbiBjbGVhcmx5 IHNlZSB0aGF0IHRoZSBjb25uZWN0b3IgY2FuIG9ubHkgYWN0IGFzIHRoZSBEaXNwbGF5UG9ydAo+ ID4gc291cmNlLCBhbmQgdGhhdCBpdCBzdXBwb3J0IHBpbiBhc3NpZ25tZW50cyBDLCBEIGFuZCBF Lgo+ID4gCj4gPiBTbyBpbiBwcmFjdGljZSB5b3UgaGF2ZSBhIGZpcm13YXJlIGJ1Zy4gSSB1bmRl cnN0YW5kIHdoeSB0aGUgUFBNIHdhcyBtYWRlCj4gPiB0aGF0IHdheS4gVGhhdCAiaGFjayIgYWxs b3dzIHRoZSBQUE0gdG8gd29ya2Fyb3VuZCBhIGxpbWl0YXRpb24gaW4gVUNTSSB3aGVyZQo+ID4g d2UgaW4gcHJhY3RpY2UgY2FuJ3QgdGVsbCB3aGljaCBjb25maWd1cmF0aW9uIGlzIGluIHVzZSBh dCBhbnkgZ2l2ZW4gdGltZS4KPiA+IFVuZm9ydHVuYXRlbHkgaXQgY2FuIG5vdCBiZSBkb25lIGxp a2UgdGhhdC4gSXQgbGVhdmVzIHVzIHdpdGggY3VzdG9tIFZETyB2YWx1ZXMKPiA+IHRoYXQgd2Ug d291bGQgaGF2ZSB0byBiZSBpbnRlcnByZXRlZCBzZXBhcmF0ZWx5LCB0aGF0IG9ubHkgeW91ciBQ UE0gc3VwcG9ydHMuCj4gPiAKPiAKPiBJIHN0aWxsIHRoaW5rIGl0IGNvbXBsaWVzIHdpdGggdGhl IGxldHRlciBhbmQgc3Bpcml0IG9mIHRoZSBVQ1NJIHNwZWMuLi4KPiBUaGVyZSB3YXMgbm90aGlu ZyBpbiB0aGUgZG9jdW1lbnQgdG8gc3VnZ2VzdCB0aGF0IHRoaXMgbWV0aG9kIG9mIGltcGxlbWVu dGluZwo+IGFsdCBtb2RlcyAoaS5lLiwgYXNzaWduaW5nIG9uZSBjb25uZWN0b3IgYWx0IG1vZGUg aW5kZXggcGVyIERQIHBpbgo+IGNvbmZpZ3VyYXRpb24pIGlzIG5vdCBhbGxvd2VkLgoKVGhlIHNw ZWMgZG9lcyBub3Qgc2F5IGFueXRoaW5nIGFib3V0IGhvdyB0aGF0IE1JRCBmaWVsZCBzaG91bGQg YmUKaW50ZXJwcmV0ZWQsIGFuZCB0aGF0IGlzIHRoZSBwcm9ibGVtIGhlcmUuCgpUaGUgY29yZSBw cm9ibGVtIGhlcmUgaXMgdGhlIFVDU0kgc3BlYy4gSXQgcmVhbGx5IG5lZWRzIGEgbmV3IHZlcnNp b24KdGhhdCBjb25zaWRlcnMgYWx0ZXJuYXRlIG1vZGVzIGEgYml0IGJldHRlci4KCj4gQWN0dWFs bHksIHRoZXJlJ3MgYWxzbyBhIChncmVhdCkgYmVuZWZpdCB3aXRoIHRoaXMgbWV0aG9kLCB0aGUg VUNTSQo+IEdFVF9TVVBQT1JUX0NBTSBjYW4gbm93IGJlIHVzZWQgdG8gZGV0ZXJtaW5lIHdoaWNo IERQIHBpbiBhc3NpZ25tZW50cyBhcmUKPiBhbGxvd2VkIC0gZHluYW1pY2FsbHkuICBGb3IgZXhh bXBsZSwgc29tZXRpbWVzIGR1ZSB0byBhbm90aGVyCj4gKG5vbi1EaXNwbGF5UG9ydCkgYWx0IG1v ZGUgYmVpbmcgYWN0aXZlLCB0aGUgcGlucyB1c2VkIGZvciBEUCBwaW4gQyBtaWdodCBub3QKPiBi ZSBhdmFpbGFibGUsIGJ1dCBEUCBwaW4gRCBpcyBzdGlsbCBhbGxvd2VkLiAgU28sIGEgY2FsbCB0 byBVQ1NJCj4gR0VUX1NVUFBPUlRFRF9DQU0gd291bGQgaW5kaWNhdGUgdGhhdCB0aGUgcGluIEMg RFAgYWx0IG1vZGUgd2FzIG5vdCBzdXBwb3J0ZWQsCj4gYnV0IHRoZSBwaW4gRCBEUCBhbHQgbW9k ZSB3YXMgY3VycmVudGx5IGFsbG93ZWQuCj4gCj4gVGhlIGRyYXdiYWNrIHdoaWNoIHlvdSBtZW50 aW9uZWQgImN1c3RvbSBWRE8gdmFsdWVzIiBpcyBub3QgYWNjdXJhdGUuICBUaGUKPiBHRVRfQUxU RVJOQVRFX01PREVTIGNvbW1hbmRzIHN0aWxsIHJldHVybnMgRFAtY29tcGxpYW50IG1vZGUgVkRP cyAtIGkuZS4sIGJpdHMKPiAxNS04IHN0aWxsIGluZGljYXRlIHRoZSBEUCBwaW4gY29uZmlndXJh dGlvbnMgYWxsb3dlZCB3aGVuIGVudGVyaW5nIHRoYXQKPiBEUC1jb21wYXRpYmxlIGFsdGVybmF0 ZSBtb2RlLgo+IAo+IE15IG9yaWdpbmFsIHN1Z2dlc3Rpb24gd2FzIHRvIHVzZSBhIGJpdHdpc2Ug QU5EIG1hc2sgdG8gbWFrZSB0aGUgY29ycmVsYXRpb24KPiBiZXR3ZWVuIHRoZSBjb25uZWN0b3In cyBhbHQgbW9kZSBhbmQgdGhlIHBhcnRuZXIncyBhbHQgbW9kZS4gIFRoaXMgaGFzIHRoZQo+IGJl bmVmaXQgb2YKPiAoMSkgd29ya2luZyB3aXRoIFBQTXMgd2hpY2ggcmVwb3J0IGEgc2luZ2xlIGNv bm5lY3RvciBhbHRlcm5hdGUgbW9kZSBmb3IgYWxsCj4gdGhlIERQIHBpbiBhc3NpZ25tZW50cwo+ ICgyKSB3b3JraW5nIHdpdGggUFBNcyB3aGljaCByZXBvcnQgc2VwYXJhdGUgY29ubmVjdG9yIGFs dGVybmF0ZSBtb2RlcyBmb3IgZWFjaAo+IERQIHBpbiBhc3NpZ25tZW50Cj4gCj4gSWYgd2UgdXNl IHlvdXIgb3JpZ2luYWwgcGF0Y2ggd2hpY2ggZG9lcyBhIHNpbXBsZSBtb2RlIGluZGV4IGVxdWFs aXR5Cj4gY29tcGFyaXNvbiAoaW5zdGVhZCBvZiBhIGJpdHdpc2UgQU5EIG1hc2spLCBpdCBjYW5u b3QgaGFuZGxlIGNhc2UgKDIpIGFib3ZlLgoKSSBkb24ndCB0aGluayB5b3UgY2FuIHVzZSB0aGUg VkRPIHZhbHVlIGFzIGEgbWFzayBldmVuIHdpdGggRFAgYWx0Cm1vZGUgKGxldCBhbG9uZSB3aXRo IGNlcnRhaW4gb3RoZXIgYWx0IG1vZGVzKSBiZWNhdXNlIHlvdSBuZWVkIHRvIGJlCmFibGUgdG8g bWF0Y2ggYml0cyAxNTo4IHRvIGJpdHMgMjM6MTYgYW5kIHZpc2UgdmVyc2EgaW4gc29tZSBjYXNl cy4KVGhlIG1hdGNoaW5nIG5lZWRzIHRvIGJlIGFsdCBtb2RlIHNwZWNpZmljIGluIGFueSBjYXNl IGFuZCBJIHRoaW5rCnRoYXQgcGFydGlhbGx5IHJlbmRlcnMgdGhlICJtYXNrcyIgdXNlbGVzcy4K ClJlZ2FyZGxlc3Mgb2YgdGhhdCwgeW91IGFyZSBtaXNzaW5nIHRoZSBwb2ludCBoZXJlLiBUaGUg cHJvYmxlbSBpcwp0aGF0IHlvdXIgUFBNIGlzIGV4cG9zaW5nIGJpdCBtYXNrcyBpbiB0aG9zZSBN SUQgZmllbGRzLCB3aGlsZSBvdGhlcnMKYXJlIGV4cG9zaW5nIHRoZSBjb25uZWN0b3IgRFAgY2Fw YWJpbGl0aWVzLiBUaGVyZSBpcyBhIGRpZmZlcmVuY2UgaW4KdGhlIGJlaGF2aW91ciBkZXBlbmRp bmcgb24gUFBNIGltcGxlbWVudGF0aW9uLiBUaGF0J3Mgbm90IGEgc21hbGwKcHJvYmxlbS4KClBl cmhhcHMgZXF1YWxseSBpbXBvcnRhbnRseSwgeW91IGFyZSB1c2luZyB0d28gZGlmZmVyZW50IGtp bmRzIG9mCnZhbHVlcyBpbiB0aGF0IHNhbWUgZGF0YSBzdHJ1Y3R1cmUgZGVwZW5kaW5nIG9uIHRo ZSByZXF1ZXN0IC0gd2l0aApwYXJ0bmVycyB0aGUgZGF0YSBzdHJ1Y3R1cmUgZ2l2ZXMgeW91IHRo ZSBjYXBhYmlsaXRpZXMgVkRPLCBidXQgd2l0aApjb25uZWN0b3JzIHlvdSBnZXQgc29tZXRoaW5n IGVsc2UgLSBpLmUuIHRoZSByZXR1cm5lZCBkYXRhIHN0cnVjdHVyZQppcyBpbiBwcmFjdGljZSBu b3QgYWx3YXlzIHRoZSBzYW1lLiBZb3UgY2FuJ3QganVzdCBjaGFuZ2UgdGhlIGRhdGEKc3RydWN0 dXJlIGxpa2UgdGhhdCBqdXN0IHdoZW4gaXQncyBjb252ZW5pZW50IGZvciB5b3UuIFlvdSBvbmx5 IGRvCnNvbWV0aGluZyBsaWtlIHRoYXQgaWYgYWxsIHRoZSBhbHRlcm5hdGl2ZSBkYXRhIHN0cnVj dHVyZXMgYXJlCmRvY3VtZW50ZWQgaW4gc29tZSBzdGFuZGFyZC4gVGhhdCdzIG5vdCB0aGUgY2Fz ZSBoZXJlLgoKWW91IGhhdmUgYWxzbyBtYWRlIHRoYXQgaGFjayBqdXN0IGZvciB0aGUgc2FrZSBv ZiBvbmUgbGltaXRhdGlvbiBpbgpVQ1NJLiBCeSBjb3JydXB0aW5nIHRoZSBkYXRhIHN0cnVjdHVy ZSBpbiBjb25uZWN0b3IgY2FzZSB5b3Ugd2lsbCBvbmx5Cmtub3cgdGhlIHBpbiBhc3NpZ25tZW50 LCBidXQgdGhhdCB5b3UgY2FuIGluIHByYWN0aWNlIGd1ZXNzIGluIGNhc2Ugb2YKRFAsIGFuZCB3 ZSBjYW4gZXZlbiBmaWd1cmUgaXQgb3V0IGZvciBjZXJ0YWludHkgaWYgbmVlZGVkIGJ5CmNvbW11 bmljYXRpbmcgd2l0aCBHUFUgZHJpdmVycyBmcm9tIHRoZSBVQ1NJIERQIGRyaXZlci4gTXVjaCBi aWdnZXIKbGltaXRhdGlvbiBpbiBVQ1NJIGlzIHRoYXQgdGhlcmUgaXMgbm8gd2F5IHRvIHNlZSB0 aGUgQXR0ZW50aW9uIFZETQpwYXlsb2FkcywgbGV0IGFsb25lIGdldCBhbiBldmVudCB3aGVuIHRo ZSBwYXJ0bmVyIHNlbmQgdGhlIEF0dGVudGlvbgpWRE0uIEluIGNhc2Ugb2YgRFAsIHdlIGNhbid0 IHNlZSB0aGUgRFAgU3RhdHVzIFZETy4gT24gc29tZSBwbGF0Zm9ybXMKd2UgY291bGQgaGF2ZSBy ZWFsbHkgdXNlZCB0aGUgRFAgU3RhdHVzIGFuZCBnZXQgdGhlIEF0dGVudGlvbiBldmVudHMKYmVj YXVzZSBvZiBIUEQuCgo+ID4gUGxlYXNlIHNlZSBpZiB5b3UgY2FuIGdldCB0aGUgZmlybXdhcmUg KFVDU0kgUFBNKSBmaXhlZC4gSXQgcmVhbGx5IG5lZWRzIHRvCj4gPiBleHBvc2Ugb25seSBvbmUg bW9kZSBmb3IgRGlzcGxheVBvcnQgYWx0IG1vZGUgaW4gdGhlIGNvbm5lY3RvciwgYW5kIHRoZSBW RE8KPiA+IGluIGl0IHNob3VsZCBiZSBpbiB0aGUgc2FtZSBmb3JtIHRoYXQgaXQgY291bGQgYmUg c2VuZCB0byB0aGUgcGFydG5lciwgaS5lLiBnaXZpbmcKPiA+IHRoZSBhY3R1YWwgRGlzcGxheVBv cnQgY2FwYWJpbGl0aWVzIGZvciB0aGUgY29ubmVjdG9yLgo+ID4gCj4gCj4gVGhlcmUgaXMgaW5m cmFzdHJ1Y3R1cmUgYnVpbGQgb24gdG9wIG9mIHRoaXMgY2FwYWJpbGl0eSBvZiBiZWluZyBhYmxl IHRvCj4gZGV0ZXJtaW5lIHRoZSBEUCBwaW4gYXNzaWdubWVudCBzdXBwb3J0IHVzaW5nIGp1c3Qg dGhlIGNvbm5lY3RvciBhbHQgbW9kZQo+IChDQU0pIGluZGV4LiAgU28sIHJlbW92aW5nIHRoZSAi ZGlzdGluY3QgYWx0IG1vZGUgaW5kZXgiIGltcGxlbWVudGF0aW9uIGlzIG5vdAo+IGZlYXNpYmxl Lgo+IAo+IEJ1dCwgYXMgbWVudGlvbmVkIGFib3ZlLCB3ZSBiZWxpZXZlIGEgbWlub3IgY2hhbmdl IChyZXBsYWNpbmcgPT0gY29tcGFyaXNvbiBvZgo+IHRoZSBtb2RlIGluZGV4LCB3aXRoIGEgIiYi IG1hc2tpbmcgb2YgdGhlIG1vZGUgVkRPKSB3b3VsZCBzdXBwb3J0IGFsbCBjYXNlcy4KPiAKPiA+ IFdlIHNob3VsZCBub3QgZG8gYW55dGhpbmcgYmVmb3JlIHlvdSBhc2sgdGhlbSB0byBmaXggdGhl IFBQTS4KPiA+IEV4cGVyaWVuY2UgdGVsbHMgdGhhdCBpZiB3ZSB3b3JrYXJvdW5kIGFuIGlzc3Vl IGluIGZpcm13YXJlLCB0aGUgZmlybXdhcmUgd2lsbAo+ID4gbmV2ZXIgZXZlciBnZXQgZml4ZWQu IEFuZCBpbiB0aGlzIGNhc2UgdGhlIHdvcmthcm91bmQgbWF5IG5vdCBiZSBhcyBzaW1wbGUgYXMK PiA+IG9uZSB3b3VsZCB0aGluay4gRXZlbiBpZiB3ZSBoYXZlIHRvIHdvcmthcm91bmQgdGhpcywg aXQgbmVlZHMgYSBzZXBhcmF0ZSBwYXRjaAo+ID4gd2l0aCBhIGdvb2QgZXhwbGFuYXRpb24uIEFu ZCBpdCBwcm9iYWJsZSBkb2VzIG5vdCBiZWxvbmcgdG8gdGhpcyBzZXJpZXMuCj4gCj4gT2YgdGhl IGF2YWlsYWJsZSBjaG9pY2VzLCBpbiB0ZXJtcyBvZiBudW1iZXIgb2YgbGluZXMgb2YgQyBjb2Rl IHRvIGNoYW5nZSArCj4gZW5naW5lZXJpbmcgcmVzb3VyY2VzLCBjaG9pY2UgKGIpIGlzIG1vcmUg c3RyYWlnaHRmb3J3YXJkLi4uCj4gKGEpIENoYW5nZSB0aGUgUFBNIGZpcm13YXJlOiBkbyBub3Qg cmVwb3J0IG11bHRpcGxlIGNvbm5lY3RvciBhbHQgbW9kZXMgcGVyCj4gRGlzcGxheVBvcnQgcGlu IGFzc2lnbm1lbnQKPiAgICAgICAtIHNpZ25pZmljYW50IHJld3JpdGUgb2YgZmlybXdhcmUgYWx0 IG1vZGUgY29kZQoKSWYgdGhhdCBpcyB0aGUgY2FzZSwgdGhlbiB0aGUgVUNTSSBjb2RlIGhhcyBi ZWVuIG1peGVkIGluIHdpdGggdGhlCnN0YXRlIG1hY2hpbmUgY29kZSwgYW5kIHRoZXJlIGlzIG5v IHJlYWwgc3RydWN0dXJlIGluIHRoZSBmaXJtd2FyZQpjb2RlLiBJIGRvbid0IGJlbGlldmUgdGhh dCB0aGF0IGlzIHRoZSBjYXNlLiBJJ20gcHJldHR5IHN1cmUgdGhhdApjaGFuZ2luZyB0aGUgdmFs dWVzIHRoYXQgdGhlIFBQTSBleHBvc2VzIHRvIHRoZSBPUE0gaW4gdGhlIFVDU0kgZGF0YQpzdHJ1 Y3R1cmVzIHJlcXVpcmVzIHRoZSBtaW5pbXVtIGFtb3VudCBvZiBlZmZvcnQuCgo+ICAgICAgIC0g cmVxdWlyZXMgUUEgcmVxdWFsaWZpY2F0aW9uIG9mIFBQTSB3aXRoIG90aGVyIGRpc3BsYXkgbW9u aXRvcnMKCk5vdyB3aHkgd291bGQgdGhhdCBiZSByZXF1aXJlZD8gVGhlIGFjdHVhbCBTVklEIHNw ZWNpZmljIGNvbW11bmljYXRpb24Kd2l0aCB0aGUgcGFydG5lcnMgaGFzIG5vdCBjaGFuZ2VkLiBU aGVyZSBzaG91bGQgYmUgYWJzb2x1dGVseSBubwpjaGFuZ2VzIHRvIHRoZSBzdGF0ZSBtYWNoaW5l cywgZXZlbiB0aGUgcG9saWNpZXMgd2lsbCBzdGF5IHRoZSBzYW1lLgpUaGUgT1BNIGludGVyZmFj ZSBzaW1wbHkgY2FuJ3QgYmUgY3JpdGljYWwuIExldCdzIG5vdCBmb3JnZXQ6CgogICAgICAgICJU aGUgUFBNIGlzIGV4cGVjdGVkIHRvIGZ1bmN0aW9uIHdpdGhvdXQgYW55IE9TIGludGVyYWN0aW9u IgoKPiAgICAgICAtIGNoYW5naW5nIGludGVybmFsIHRvb2xzIHRvIGF2b2lkIHF1ZXJ5aW5nIGFs dCBtb2RlIHBpbiBjb25maWd1cmF0aW9ucwo+ICAgICAgIChvciBwb3NzaWJseSByZXF1aXJlIG5v bi1VQ1NJIGludGVyZmFjZSB0byBiZSBjcmVhdGVkIHRvIHJlcGxhY2UgcmVtb3ZlZAo+ICAgICAg IGZlYXR1cmUpCgpUaGF0IHNvdW5kcyB0byBtZSBsaWtlIHlvdXIgdG9vbHMgYXJlIG5vdCB1c2lu ZyB0aGUgQUJJIGRlZmluZWQgaW4KTGludXgga2VybmVsOgoKICAgICAgICBEb2N1bWVudGF0aW9u L0FCSS90ZXN0aW5nL3N5c2ZzLWRyaXZlci10eXBlYy1kaXNwbGF5cG9ydAoKSSB0aGluayB5b3Ug bmVlZCB0byB1cGRhdGUgeW91ciB0b29scyByZWdhcmRsZXNzIGhvdyB0aGlzIHByb2JsZW0gaXMK c29sdmVkLgoKPiAoYikgQ2hhbmdlIExpbnV4IGRyaXZlcidzIGFsdCBtb2RlIGNvbXBhcmlzb24g ZnVuY3Rpb24KPiAKPiBHaXZlbiB0aGF0IHRoZSBwcm9wb3NlZCBwYXRjaCBtb2RpZmljYXRpb24g aXMgYSBmZXcgbGluZXMgb2YgY29kZSBhbmQKPiBpbmNyZWFzZXMgbnVtYmVyIG9mIFBQTXMgc3Vw cG9ydGVkLCBjYW4gd2UgcmUtY29uc2lkZXIgaXQgZm9yIHRoaXMgc2VyaWVzIG9mCj4gcGF0Y2hl cz8KCldlIGhhdmUgdG8gbWFrZSBzdXJlIGFsbCB0aGUgb3B0aW9ucyBoYXZlIGJlZW4gY29uc2lk ZXJlZCBiZWZvcmUKYWNjZXB0aW5nIGEgd29ya2Fyb3VuZCBsaWtlIHRoYXQuIE9uY2UgaXQncyBw YXJ0IG9mIG1haW5saW5lLCB5b3UgbWF5CmJlIG9mZiB0aGUgaG9vaywgYnV0IG1lIGFuZCB0aGUg Y29tbXVuaXR5IGFyZSBub3QuCgpFdmVuIGlmIHRoZXJlJ3Mgbm8gd2F5IHRvIGdldCByaWQgb2Yg dGhhdCBtYXNrIGhhY2ssIGl0IGhhcyB0byBiZQpoYW5kbGVkIGRpZmZlcmVudGx5IChpbiB0aGUg VUNTSSBEUCBkcml2ZXIpIGluIGFueSBjYXNlLiBJZiB3ZSByZWFsbHkKaGF2ZSB0byBhY2NlcHQg aXQsIHRoZW4gSSBkbyB3YW50IGEgc2VwYXJhdGUgcGF0Y2ggZm9yIGl0IHdpdGggYSBnb29kCmV4 cGxhbmF0aW9uIHdoeSBpdCdzIG5lZWRlZCBpbiB0aGUgY29tbWl0IG1lc3NhZ2UuCgpCZWZvcmUg d2UgZG8gYW55dGhpbmcsIGxldCdzIGp1c3QgbG9vayBhdCBvdXIgb3B0aW9uczoKCklmIHlvdSBu ZWVkIGNlcnRhaW50eSByZWdhcmRpbmcgdGhlIHNlbGVjdGVkIHBpbi1hc3NpZ25tZW50LCB0aGVu IEkKd291bGQgcHJvcG9zZSBpbml0aWFsbHkgdGhhdCB3ZSBjb21tdW5pY2F0ZSB3aXRoIHRoZSBH UFUvRFAgZHJpdmVyCmZyb20gVUNTSSBEUCBkcml2ZXIuIFRob3NlIGRyaXZlcnMgY2FuIHRlbGwg dXMgaG93IG1hbnkgRFAgbGFuZXMgYXJlCmluIHVzZSwgYW5kIHRoYXQgc2hvdWxkIGJlIGVub3Vn aCB0byB0ZWxsIGFyZSB3ZSB1c2luZyBDIG9yIEQuCgpUaGUgSFBEIHByb2JsZW0gSSBtZW50aW9u ZWQgYWJvdmUgd2FzIHNvbHZlZCBieSBzdXBwbHlpbmcgdGhlCm9wZXJhdGluZyBzeXN0ZW0gYSBj dXN0b20gZXZlbnQgbWltaWNraW5nIEhQRCBJUlEuIFRoZSBnZW5lcmljIFVDU0kKY29kZSB3YXMg bm90IGFmZmVjdGVkIGJ5IHRoYXQgYXQgYWxsLiBIb3cgYWJvdXQgaWYgeW91IGRvIHNvbWV0aGlu ZwpzaW1pbGFyPwoKWW91IHdvdWxkIGp1c3QgbmVlZCB0byBiZSBhYmxlIHRvIHNlZSB0aGUgY29u dGVudCBvZiB0aGUgQ29uZmlndXJhdGlvbgpWRE8gdGhhdCB0aGUgUFBNIHVzZWQgd2l0aCB0aGUg cGFydG5lciBpbiB5b3VyIGRyaXZlciAodWNzaV9jY2csYykuCklzIHRoYXQgYW4gb3B0aW9uPwoK Tm90ZSwgd2Ugd2lsbCBpbiBhbGwgdGhlc2UgY2FzZXMgbmVlZCB0byB0d2VhayB0aGUgVUNTSSBk cml2ZXJzIGEKbGl0dGxlLCBidXQgdGhhdCdzIG5vdCB0aGUgaXNzdWUuCgoKdGhhbmtzLAo=