From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 5C2C9C43334 for ; Tue, 19 Jul 2022 07:18:14 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S234894AbiGSHSN (ORCPT ); Tue, 19 Jul 2022 03:18:13 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:46870 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233598AbiGSHSM (ORCPT ); Tue, 19 Jul 2022 03:18:12 -0400 Received: from ams.source.kernel.org (ams.source.kernel.org [145.40.68.75]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 66C6B1EC7C; Tue, 19 Jul 2022 00:18:11 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ams.source.kernel.org (Postfix) with ESMTPS id 01304B81810; Tue, 19 Jul 2022 07:18:10 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 1CA5DC341C6; Tue, 19 Jul 2022 07:18:02 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1658215088; bh=Zpo3d0kFt2DSecXAUJMA9148wQ51zt50WI97410OekI=; h=Date:From:To:Cc:Subject:In-Reply-To:References:From; b=J+9GJiMRTnsTv2egsEBrsCHjrpOKMoy5LIiO3m3oCv1Pii/hGRb4hONCWnDW8ACDg BUsoP27RCtfmbYZ3Z/w9XIE+xWECUJ64ragPzWMEpE7Bh/znE4tN16NDnDCClqOyQM AIkxuy43y8cgFmoX7Vm+S0DhrD2KL4dJKyjB4WaRslSo1LReB7SWLKvbyOyb5v73w2 his4OlfQq5alvg7t5zuVQo1kDTW25e9ISL+j02b18zoaxMTg9vmrOV3dlcZrYC87lk i2E/2f2uj/LJPR3d1U/5Nn2IetYDH+p/6qgE3PX2zfIwzVljy0QLWvcNZBIdoK8yVc g4a/rlmai909g== Date: Tue, 19 Jul 2022 09:18:00 +0200 From: Marek =?UTF-8?B?QmVow7pu?= To: Andy Shevchenko Cc: "Russell King (Oracle)" , Vladimir Oltean , Andrew Lunn , Heiner Kallweit , Alexandre Belloni , Alvin __ipraga , Claudiu Manoil , Daniel Scally , "David S. Miller" , DENG Qingfang , Eric Dumazet , Florian Fainelli , George McCollister , Greg Kroah-Hartman , Hauke Mehrtens , Heikki Krogerus , Jakub Kicinski , Kurt Kanzenbach , Landen Chao , Linus Walleij , linux-acpi@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-mediatek@lists.infradead.org, Matthias Brugger , netdev@vger.kernel.org, Paolo Abeni , "Rafael J. Wysocki" , Sakari Ailus , Sean Wang , UNGLinuxDriver@microchip.com, Vivien Didelot , Woojung Huh Subject: Re: [PATCH net-next 2/6] software node: allow named software node to be created Message-ID: <20220719091800.3116daf1@dellmb> In-Reply-To: References: <20220715201715.foea4rifegmnti46@skbuf> <20220715204841.pwhvnue2atrkc2fx@skbuf> <20220718223942.245f29b6@thinkpad> X-Mailer: Claws Mail 3.19.0 (GTK+ 2.24.33; x86_64-pc-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-acpi@vger.kernel.org On Mon, 18 Jul 2022 23:48:21 +0300 Andy Shevchenko wrote: > On Mon, Jul 18, 2022 at 10:39:42PM +0200, Marek Beh=C3=BAn wrote: > > On Mon, 18 Jul 2022 22:24:09 +0300 > > Andy Shevchenko wrote: > > =20 > > > On Mon, Jul 18, 2022 at 08:14:58PM +0100, Russell King (Oracle) wrote= : =20 > > > > On Mon, Jul 18, 2022 at 09:53:39PM +0300, Andy Shevchenko wrote: = =20 > > > > > On Mon, Jul 18, 2022 at 09:43:42PM +0300, Andy Shevchenko wrote: = =20 > > > > > > On Mon, Jul 18, 2022 at 02:27:02PM +0100, Russell King (Oracle)= wrote: =20 > > > > > > > On Mon, Jul 18, 2022 at 03:29:52PM +0300, Andy Shevchenko wro= te: =20 > > > > > > > > On Fri, Jul 15, 2022 at 11:48:41PM +0300, Vladimir Oltean w= rote: =20 > > > > > > > > > So won't kobject_init_and_add() fail on namespace collisi= on? Is it the > > > > > > > > > problem that it's going to fail, or that it's not trivial= to statically > > > > > > > > > determine whether it'll fail? > > > > > > > > >=20 > > > > > > > > > Sorry, but I don't see something actionable about this. = =20 > > > > > > > >=20 > > > > > > > > I'm talking about validation before a runtime. But if you t= hink that is fine, > > > > > > > > let's fail it at runtime, okay, and consume more backtraces= in the future. =20 > > > > > > >=20 > > > > > > > Is there any sane way to do validation of this namespace befo= re > > > > > > > runtime? =20 > > > > > >=20 > > > > > > For statically compiled, I think we can do it (to some extent). > > > > > > Currently only three drivers, if I'm not mistaken, define softw= are nodes with > > > > > > names. It's easy to check that their node names are unique. > > > > > >=20 > > > > > > When you allow such an API then we might have tracebacks (from = sysfs) bout name > > > > > > collisions. Not that is something new to kernel (we have seen m= any of a kind), > > > > > > but I prefer, if possible, to validate this before sysfs issues= a traceback. > > > > > > =20 > > > > > > > The problem in this instance is we need a node named "fixed-l= ink" that > > > > > > > is attached to the parent node as that is defined in the bind= ing doc, > > > > > > > and we're creating swnodes to provide software generated node= s for > > > > > > > this binding. =20 > > > > > >=20 > > > > > > And how you guarantee that it will be only a single one with un= ique pathname? > > > > > >=20 > > > > > > For example, you have two DSA cards (or whatever it's called) i= n the SMP system, > > > > > > it mean that there is non-zero probability of coexisting swnode= s for them. > > > > > > =20 > > > > > > > There could be several such nodes scattered around, but in th= is > > > > > > > instance they are very short-lived before they are destroyed,= they > > > > > > > don't even need to be published to userspace (and its probabl= y a waste > > > > > > > of CPU cycles for them to be published there.) > > > > > > >=20 > > > > > > > So, for this specific case, is this the best approach, or is = there > > > > > > > some better way to achieve what we need here? =20 > > > > > >=20 > > > > > > Honestly, I don't know. > > > > > >=20 > > > > > > The "workaround" (but it looks to me rather a hack) is to creat= e unique swnode > > > > > > and make fixed-link as a child of it. > > > > > >=20 > > > > > > Or entire concept of the root swnodes (when name is provided) s= hould be > > > > > > reconsidered, so somehow we will have a uniqueness so that the = entire > > > > > > path(s) behind it will be caller-dependent. But this I also don= 't like. > > > > > >=20 > > > > > > Maybe Heikki, Sakari, Rafael can share their thoughts... > > > > > >=20 > > > > > > Just for my learning, why PHY uses "fixed-link" instead of rely= ing on a > > > > > > (firmware) graph? It might be the actual solution to your probl= em. > > > > > >=20 > > > > > > How graphs are used with swnodes, you may look into IPU3 (Intel= Camera) > > > > > > glue driver to support devices before MIPI standardisation of t= he > > > > > > respective properties. =20 > > > > >=20 > > > > > Forgot to say (yes, it maybe obvious) that this API will be expor= ted, > > > > > anyone can use it and trap into the similar issue, because, for e= xample, > > > > > of testing in environment with a single instance of the caller. = =20 > > > >=20 > > > > I think we're coming to the conclusion that using swnodes is not the > > > > correct approach for this problem, correct? =20 > > >=20 > > > If I understand the possibilities of the usage in _this_ case, then i= t's > > > would be problematic (it does not mean it's incorrect). It might be d= ue to > > > swnode design restrictions which shouldn't be made, I dunno. That' why > > > it's better to ask the others for their opinions. > > >=20 > > > By design swnode's name makes not much sense, because the payload the= re > > > is a property set, where _name_ is a must. > > >=20 > > > Now, telling you this, I'm questioning myself why the heck I added na= mes > > > to swnodes in the intel_quark_i2c_gpio driver... =20 > >=20 > > 1. the way we use this new named swnode (in patch 5/6 of this series) is > > that it gets destroyed immediately after being parsed, so I don't > > think there will be collisions in the namespace for forseeable future > >=20 > > also, we first create an unnamed swnode for port and only then > > fixed-link swnode as a child. > >=20 > > new_port_fwnode =3D fwnode_create_software_node(port_props, NULL); > > ... > > fixed_link_fwnode =3D > > fwnode_create_named_software_node(fixed_link_props, > > new_port_fwnode, "fixed-link"= ); > >=20 > > so there shouldn't be a name collision, since the port node gets a > > unique name, or am I misunderstanding this? =20 >=20 > This is not problem, but what I was talking about is how to guarantee this > hierarchy? See what I answered to RNK. >=20 > > 2. even if there was a problem with name collision, I think the place > > that needs to be fixed is swnode system. What use are swnodes if > > they cannot be used like this? =20 >=20 > Precisely, that's why I don't want to introduce an API that needs to be f= ixed. >=20 Aha, so you want to ensure that root swnodes are created with unique name? Can't we just make it so that named software node must have a parent? Marek From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id C90EFC43334 for ; Tue, 19 Jul 2022 07:19:20 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To: Message-ID:Subject:Cc:To:From:Date:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=BDNgp6gJU4UQ91XAYSP8OxCXQA6N1W0gdXx2kMKRB5Q=; b=VegkfaCwPS4iDE iqIf5SQUC5IPMS6xFNajka0r6s94ELGhM41Oxvb9uGa3Kq4Kai74axtmBDagZ/g3J8QLMK8qFzRWq Wmy3IfVF93TC1UXJgp6GxIAwdpk5n7rJkQx0ufuJqalNXMy4HRhMBp5sSXcO+H8D4BjQenXgYj8KC Ujx6vBRNVAB4hpau4ZCMdNBTWHW7b30ldzRN+liljMTl+QCYQzhSnHXWZCLClIpYXTcJ9qmM3sDG9 EqmK7/aqr/OtX0pYBD6pVNzPyzOpDRRTCMfU+V6/kafEC/gTqknmP/t+GRUYag3T179wsJ2rUwgtc HJU+MLLk4F/OQfztNO/w==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1oDhUj-005rg4-Hs; Tue, 19 Jul 2022 07:18:13 +0000 Received: from dfw.source.kernel.org ([2604:1380:4641:c500::1]) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1oDhUg-005rfA-91; Tue, 19 Jul 2022 07:18:12 +0000 Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by dfw.source.kernel.org (Postfix) with ESMTPS id 7D7716166A; Tue, 19 Jul 2022 07:18:09 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 1CA5DC341C6; Tue, 19 Jul 2022 07:18:02 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1658215088; bh=Zpo3d0kFt2DSecXAUJMA9148wQ51zt50WI97410OekI=; h=Date:From:To:Cc:Subject:In-Reply-To:References:From; b=J+9GJiMRTnsTv2egsEBrsCHjrpOKMoy5LIiO3m3oCv1Pii/hGRb4hONCWnDW8ACDg BUsoP27RCtfmbYZ3Z/w9XIE+xWECUJ64ragPzWMEpE7Bh/znE4tN16NDnDCClqOyQM AIkxuy43y8cgFmoX7Vm+S0DhrD2KL4dJKyjB4WaRslSo1LReB7SWLKvbyOyb5v73w2 his4OlfQq5alvg7t5zuVQo1kDTW25e9ISL+j02b18zoaxMTg9vmrOV3dlcZrYC87lk i2E/2f2uj/LJPR3d1U/5Nn2IetYDH+p/6qgE3PX2zfIwzVljy0QLWvcNZBIdoK8yVc g4a/rlmai909g== Date: Tue, 19 Jul 2022 09:18:00 +0200 From: Marek =?UTF-8?B?QmVow7pu?= To: Andy Shevchenko Cc: "Russell King (Oracle)" , Vladimir Oltean , Andrew Lunn , Heiner Kallweit , Alexandre Belloni , Alvin __ipraga , Claudiu Manoil , Daniel Scally , "David S. Miller" , DENG Qingfang , Eric Dumazet , Florian Fainelli , George McCollister , Greg Kroah-Hartman , Hauke Mehrtens , Heikki Krogerus , Jakub Kicinski , Kurt Kanzenbach , Landen Chao , Linus Walleij , linux-acpi@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-mediatek@lists.infradead.org, Matthias Brugger , netdev@vger.kernel.org, Paolo Abeni , "Rafael J. Wysocki" , Sakari Ailus , Sean Wang , UNGLinuxDriver@microchip.com, Vivien Didelot , Woojung Huh Subject: Re: [PATCH net-next 2/6] software node: allow named software node to be created Message-ID: <20220719091800.3116daf1@dellmb> In-Reply-To: References: <20220715201715.foea4rifegmnti46@skbuf> <20220715204841.pwhvnue2atrkc2fx@skbuf> <20220718223942.245f29b6@thinkpad> X-Mailer: Claws Mail 3.19.0 (GTK+ 2.24.33; x86_64-pc-linux-gnu) MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20220719_001810_411779_B64C4437 X-CRM114-Status: GOOD ( 57.83 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org T24gTW9uLCAxOCBKdWwgMjAyMiAyMzo0ODoyMSArMDMwMApBbmR5IFNoZXZjaGVua28gPGFuZHJp eS5zaGV2Y2hlbmtvQGxpbnV4LmludGVsLmNvbT4gd3JvdGU6Cgo+IE9uIE1vbiwgSnVsIDE4LCAy MDIyIGF0IDEwOjM5OjQyUE0gKzAyMDAsIE1hcmVrIEJlaMO6biB3cm90ZToKPiA+IE9uIE1vbiwg MTggSnVsIDIwMjIgMjI6MjQ6MDkgKzAzMDAKPiA+IEFuZHkgU2hldmNoZW5rbyA8YW5kcml5LnNo ZXZjaGVua29AbGludXguaW50ZWwuY29tPiB3cm90ZToKPiA+ICAgCj4gPiA+IE9uIE1vbiwgSnVs IDE4LCAyMDIyIGF0IDA4OjE0OjU4UE0gKzAxMDAsIFJ1c3NlbGwgS2luZyAoT3JhY2xlKSB3cm90 ZTogIAo+ID4gPiA+IE9uIE1vbiwgSnVsIDE4LCAyMDIyIGF0IDA5OjUzOjM5UE0gKzAzMDAsIEFu ZHkgU2hldmNoZW5rbyB3cm90ZTogICAgCj4gPiA+ID4gPiBPbiBNb24sIEp1bCAxOCwgMjAyMiBh dCAwOTo0Mzo0MlBNICswMzAwLCBBbmR5IFNoZXZjaGVua28gd3JvdGU6ICAgIAo+ID4gPiA+ID4g PiBPbiBNb24sIEp1bCAxOCwgMjAyMiBhdCAwMjoyNzowMlBNICswMTAwLCBSdXNzZWxsIEtpbmcg KE9yYWNsZSkgd3JvdGU6ICAgIAo+ID4gPiA+ID4gPiA+IE9uIE1vbiwgSnVsIDE4LCAyMDIyIGF0 IDAzOjI5OjUyUE0gKzAzMDAsIEFuZHkgU2hldmNoZW5rbyB3cm90ZTogICAgCj4gPiA+ID4gPiA+ ID4gPiBPbiBGcmksIEp1bCAxNSwgMjAyMiBhdCAxMTo0ODo0MVBNICswMzAwLCBWbGFkaW1pciBP bHRlYW4gd3JvdGU6ICAgIAo+ID4gPiA+ID4gPiA+ID4gPiBTbyB3b24ndCBrb2JqZWN0X2luaXRf YW5kX2FkZCgpIGZhaWwgb24gbmFtZXNwYWNlIGNvbGxpc2lvbj8gSXMgaXQgdGhlCj4gPiA+ID4g PiA+ID4gPiA+IHByb2JsZW0gdGhhdCBpdCdzIGdvaW5nIHRvIGZhaWwsIG9yIHRoYXQgaXQncyBu b3QgdHJpdmlhbCB0byBzdGF0aWNhbGx5Cj4gPiA+ID4gPiA+ID4gPiA+IGRldGVybWluZSB3aGV0 aGVyIGl0J2xsIGZhaWw/Cj4gPiA+ID4gPiA+ID4gPiA+IAo+ID4gPiA+ID4gPiA+ID4gPiBTb3Jy eSwgYnV0IEkgZG9uJ3Qgc2VlIHNvbWV0aGluZyBhY3Rpb25hYmxlIGFib3V0IHRoaXMuICAgIAo+ ID4gPiA+ID4gPiA+ID4gCj4gPiA+ID4gPiA+ID4gPiBJJ20gdGFsa2luZyBhYm91dCB2YWxpZGF0 aW9uIGJlZm9yZSBhIHJ1bnRpbWUuIEJ1dCBpZiB5b3UgdGhpbmsgdGhhdCBpcyBmaW5lLAo+ID4g PiA+ID4gPiA+ID4gbGV0J3MgZmFpbCBpdCBhdCBydW50aW1lLCBva2F5LCBhbmQgY29uc3VtZSBt b3JlIGJhY2t0cmFjZXMgaW4gdGhlIGZ1dHVyZS4gICAgCj4gPiA+ID4gPiA+ID4gCj4gPiA+ID4g PiA+ID4gSXMgdGhlcmUgYW55IHNhbmUgd2F5IHRvIGRvIHZhbGlkYXRpb24gb2YgdGhpcyBuYW1l c3BhY2UgYmVmb3JlCj4gPiA+ID4gPiA+ID4gcnVudGltZT8gICAgCj4gPiA+ID4gPiA+IAo+ID4g PiA+ID4gPiBGb3Igc3RhdGljYWxseSBjb21waWxlZCwgSSB0aGluayB3ZSBjYW4gZG8gaXQgKHRv IHNvbWUgZXh0ZW50KS4KPiA+ID4gPiA+ID4gQ3VycmVudGx5IG9ubHkgdGhyZWUgZHJpdmVycywg aWYgSSdtIG5vdCBtaXN0YWtlbiwgZGVmaW5lIHNvZnR3YXJlIG5vZGVzIHdpdGgKPiA+ID4gPiA+ ID4gbmFtZXMuIEl0J3MgZWFzeSB0byBjaGVjayB0aGF0IHRoZWlyIG5vZGUgbmFtZXMgYXJlIHVu aXF1ZS4KPiA+ID4gPiA+ID4gCj4gPiA+ID4gPiA+IFdoZW4geW91IGFsbG93IHN1Y2ggYW4gQVBJ IHRoZW4gd2UgbWlnaHQgaGF2ZSB0cmFjZWJhY2tzIChmcm9tIHN5c2ZzKSBib3V0IG5hbWUKPiA+ ID4gPiA+ID4gY29sbGlzaW9ucy4gTm90IHRoYXQgaXMgc29tZXRoaW5nIG5ldyB0byBrZXJuZWwg KHdlIGhhdmUgc2VlbiBtYW55IG9mIGEga2luZCksCj4gPiA+ID4gPiA+IGJ1dCBJIHByZWZlciwg aWYgcG9zc2libGUsIHRvIHZhbGlkYXRlIHRoaXMgYmVmb3JlIHN5c2ZzIGlzc3VlcyBhIHRyYWNl YmFjay4KPiA+ID4gPiA+ID4gICAgIAo+ID4gPiA+ID4gPiA+IFRoZSBwcm9ibGVtIGluIHRoaXMg aW5zdGFuY2UgaXMgd2UgbmVlZCBhIG5vZGUgbmFtZWQgImZpeGVkLWxpbmsiIHRoYXQKPiA+ID4g PiA+ID4gPiBpcyBhdHRhY2hlZCB0byB0aGUgcGFyZW50IG5vZGUgYXMgdGhhdCBpcyBkZWZpbmVk IGluIHRoZSBiaW5kaW5nIGRvYywKPiA+ID4gPiA+ID4gPiBhbmQgd2UncmUgY3JlYXRpbmcgc3du b2RlcyB0byBwcm92aWRlIHNvZnR3YXJlIGdlbmVyYXRlZCBub2RlcyBmb3IKPiA+ID4gPiA+ID4g PiB0aGlzIGJpbmRpbmcuICAgIAo+ID4gPiA+ID4gPiAKPiA+ID4gPiA+ID4gQW5kIGhvdyB5b3Ug Z3VhcmFudGVlIHRoYXQgaXQgd2lsbCBiZSBvbmx5IGEgc2luZ2xlIG9uZSB3aXRoIHVuaXF1ZSBw YXRobmFtZT8KPiA+ID4gPiA+ID4gCj4gPiA+ID4gPiA+IEZvciBleGFtcGxlLCB5b3UgaGF2ZSB0 d28gRFNBIGNhcmRzIChvciB3aGF0ZXZlciBpdCdzIGNhbGxlZCkgaW4gdGhlIFNNUCBzeXN0ZW0s Cj4gPiA+ID4gPiA+IGl0IG1lYW4gdGhhdCB0aGVyZSBpcyBub24temVybyBwcm9iYWJpbGl0eSBv ZiBjb2V4aXN0aW5nIHN3bm9kZXMgZm9yIHRoZW0uCj4gPiA+ID4gPiA+ICAgICAKPiA+ID4gPiA+ ID4gPiBUaGVyZSBjb3VsZCBiZSBzZXZlcmFsIHN1Y2ggbm9kZXMgc2NhdHRlcmVkIGFyb3VuZCwg YnV0IGluIHRoaXMKPiA+ID4gPiA+ID4gPiBpbnN0YW5jZSB0aGV5IGFyZSB2ZXJ5IHNob3J0LWxp dmVkIGJlZm9yZSB0aGV5IGFyZSBkZXN0cm95ZWQsIHRoZXkKPiA+ID4gPiA+ID4gPiBkb24ndCBl dmVuIG5lZWQgdG8gYmUgcHVibGlzaGVkIHRvIHVzZXJzcGFjZSAoYW5kIGl0cyBwcm9iYWJseSBh IHdhc3RlCj4gPiA+ID4gPiA+ID4gb2YgQ1BVIGN5Y2xlcyBmb3IgdGhlbSB0byBiZSBwdWJsaXNo ZWQgdGhlcmUuKQo+ID4gPiA+ID4gPiA+IAo+ID4gPiA+ID4gPiA+IFNvLCBmb3IgdGhpcyBzcGVj aWZpYyBjYXNlLCBpcyB0aGlzIHRoZSBiZXN0IGFwcHJvYWNoLCBvciBpcyB0aGVyZQo+ID4gPiA+ ID4gPiA+IHNvbWUgYmV0dGVyIHdheSB0byBhY2hpZXZlIHdoYXQgd2UgbmVlZCBoZXJlPyAgICAK PiA+ID4gPiA+ID4gCj4gPiA+ID4gPiA+IEhvbmVzdGx5LCBJIGRvbid0IGtub3cuCj4gPiA+ID4g PiA+IAo+ID4gPiA+ID4gPiBUaGUgIndvcmthcm91bmQiIChidXQgaXQgbG9va3MgdG8gbWUgcmF0 aGVyIGEgaGFjaykgaXMgdG8gY3JlYXRlIHVuaXF1ZSBzd25vZGUKPiA+ID4gPiA+ID4gYW5kIG1h a2UgZml4ZWQtbGluayBhcyBhIGNoaWxkIG9mIGl0Lgo+ID4gPiA+ID4gPiAKPiA+ID4gPiA+ID4g T3IgZW50aXJlIGNvbmNlcHQgb2YgdGhlIHJvb3Qgc3dub2RlcyAod2hlbiBuYW1lIGlzIHByb3Zp ZGVkKSBzaG91bGQgYmUKPiA+ID4gPiA+ID4gcmVjb25zaWRlcmVkLCBzbyBzb21laG93IHdlIHdp bGwgaGF2ZSBhIHVuaXF1ZW5lc3Mgc28gdGhhdCB0aGUgZW50aXJlCj4gPiA+ID4gPiA+IHBhdGgo cykgYmVoaW5kIGl0IHdpbGwgYmUgY2FsbGVyLWRlcGVuZGVudC4gQnV0IHRoaXMgSSBhbHNvIGRv bid0IGxpa2UuCj4gPiA+ID4gPiA+IAo+ID4gPiA+ID4gPiBNYXliZSBIZWlra2ksIFNha2FyaSwg UmFmYWVsIGNhbiBzaGFyZSB0aGVpciB0aG91Z2h0cy4uLgo+ID4gPiA+ID4gPiAKPiA+ID4gPiA+ ID4gSnVzdCBmb3IgbXkgbGVhcm5pbmcsIHdoeSBQSFkgdXNlcyAiZml4ZWQtbGluayIgaW5zdGVh ZCBvZiByZWx5aW5nIG9uIGEKPiA+ID4gPiA+ID4gKGZpcm13YXJlKSBncmFwaD8gSXQgbWlnaHQg YmUgdGhlIGFjdHVhbCBzb2x1dGlvbiB0byB5b3VyIHByb2JsZW0uCj4gPiA+ID4gPiA+IAo+ID4g PiA+ID4gPiBIb3cgZ3JhcGhzIGFyZSB1c2VkIHdpdGggc3dub2RlcywgeW91IG1heSBsb29rIGlu dG8gSVBVMyAoSW50ZWwgQ2FtZXJhKQo+ID4gPiA+ID4gPiBnbHVlIGRyaXZlciB0byBzdXBwb3J0 IGRldmljZXMgYmVmb3JlIE1JUEkgc3RhbmRhcmRpc2F0aW9uIG9mIHRoZQo+ID4gPiA+ID4gPiBy ZXNwZWN0aXZlIHByb3BlcnRpZXMuICAgIAo+ID4gPiA+ID4gCj4gPiA+ID4gPiBGb3Jnb3QgdG8g c2F5ICh5ZXMsIGl0IG1heWJlIG9idmlvdXMpIHRoYXQgdGhpcyBBUEkgd2lsbCBiZSBleHBvcnRl ZCwKPiA+ID4gPiA+IGFueW9uZSBjYW4gdXNlIGl0IGFuZCB0cmFwIGludG8gdGhlIHNpbWlsYXIg aXNzdWUsIGJlY2F1c2UsIGZvciBleGFtcGxlLAo+ID4gPiA+ID4gb2YgdGVzdGluZyBpbiBlbnZp cm9ubWVudCB3aXRoIGEgc2luZ2xlIGluc3RhbmNlIG9mIHRoZSBjYWxsZXIuICAgIAo+ID4gPiA+ IAo+ID4gPiA+IEkgdGhpbmsgd2UncmUgY29taW5nIHRvIHRoZSBjb25jbHVzaW9uIHRoYXQgdXNp bmcgc3dub2RlcyBpcyBub3QgdGhlCj4gPiA+ID4gY29ycmVjdCBhcHByb2FjaCBmb3IgdGhpcyBw cm9ibGVtLCBjb3JyZWN0PyAgICAKPiA+ID4gCj4gPiA+IElmIEkgdW5kZXJzdGFuZCB0aGUgcG9z c2liaWxpdGllcyBvZiB0aGUgdXNhZ2UgaW4gX3RoaXNfIGNhc2UsIHRoZW4gaXQncwo+ID4gPiB3 b3VsZCBiZSBwcm9ibGVtYXRpYyAoaXQgZG9lcyBub3QgbWVhbiBpdCdzIGluY29ycmVjdCkuIEl0 IG1pZ2h0IGJlIGR1ZSB0bwo+ID4gPiBzd25vZGUgZGVzaWduIHJlc3RyaWN0aW9ucyB3aGljaCBz aG91bGRuJ3QgYmUgbWFkZSwgSSBkdW5uby4gVGhhdCcgd2h5Cj4gPiA+IGl0J3MgYmV0dGVyIHRv IGFzayB0aGUgb3RoZXJzIGZvciB0aGVpciBvcGluaW9ucy4KPiA+ID4gCj4gPiA+IEJ5IGRlc2ln biBzd25vZGUncyBuYW1lIG1ha2VzIG5vdCBtdWNoIHNlbnNlLCBiZWNhdXNlIHRoZSBwYXlsb2Fk IHRoZXJlCj4gPiA+IGlzIGEgcHJvcGVydHkgc2V0LCB3aGVyZSBfbmFtZV8gaXMgYSBtdXN0Lgo+ ID4gPiAKPiA+ID4gTm93LCB0ZWxsaW5nIHlvdSB0aGlzLCBJJ20gcXVlc3Rpb25pbmcgbXlzZWxm IHdoeSB0aGUgaGVjayBJIGFkZGVkIG5hbWVzCj4gPiA+IHRvIHN3bm9kZXMgaW4gdGhlIGludGVs X3F1YXJrX2kyY19ncGlvIGRyaXZlci4uLiAgCj4gPiAKPiA+IDEuIHRoZSB3YXkgd2UgdXNlIHRo aXMgbmV3IG5hbWVkIHN3bm9kZSAoaW4gcGF0Y2ggNS82IG9mIHRoaXMgc2VyaWVzKSBpcwo+ID4g ICAgdGhhdCBpdCBnZXRzIGRlc3Ryb3llZCBpbW1lZGlhdGVseSBhZnRlciBiZWluZyBwYXJzZWQs IHNvIEkgZG9uJ3QKPiA+ICAgIHRoaW5rIHRoZXJlIHdpbGwgYmUgY29sbGlzaW9ucyBpbiB0aGUg bmFtZXNwYWNlIGZvciBmb3JzZWVhYmxlIGZ1dHVyZQo+ID4gCj4gPiAgICBhbHNvLCB3ZSBmaXJz dCBjcmVhdGUgYW4gdW5uYW1lZCBzd25vZGUgZm9yIHBvcnQgYW5kIG9ubHkgdGhlbgo+ID4gICAg Zml4ZWQtbGluayBzd25vZGUgYXMgYSBjaGlsZC4KPiA+IAo+ID4gICAgICAgbmV3X3BvcnRfZndu b2RlID0gZndub2RlX2NyZWF0ZV9zb2Z0d2FyZV9ub2RlKHBvcnRfcHJvcHMsIE5VTEwpOwo+ID4g ICAgICAgLi4uCj4gPiAgICAgICBmaXhlZF9saW5rX2Z3bm9kZSA9Cj4gPiAgICAgICAgIGZ3bm9k ZV9jcmVhdGVfbmFtZWRfc29mdHdhcmVfbm9kZShmaXhlZF9saW5rX3Byb3BzLAo+ID4gICAgICAg ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgbmV3X3BvcnRfZndub2RlLCAiZml4 ZWQtbGluayIpOwo+ID4gCj4gPiAgICBzbyB0aGVyZSBzaG91bGRuJ3QgYmUgYSBuYW1lIGNvbGxp c2lvbiwgc2luY2UgdGhlIHBvcnQgbm9kZSBnZXRzIGEKPiA+ICAgIHVuaXF1ZSBuYW1lLCBvciBh bSBJIG1pc3VuZGVyc3RhbmRpbmcgdGhpcz8gIAo+IAo+IFRoaXMgaXMgbm90IHByb2JsZW0sIGJ1 dCB3aGF0IEkgd2FzIHRhbGtpbmcgYWJvdXQgaXMgaG93IHRvIGd1YXJhbnRlZSB0aGlzCj4gaGll cmFyY2h5PyBTZWUgd2hhdCBJIGFuc3dlcmVkIHRvIFJOSy4KPiAKPiA+IDIuIGV2ZW4gaWYgdGhl cmUgd2FzIGEgcHJvYmxlbSB3aXRoIG5hbWUgY29sbGlzaW9uLCBJIHRoaW5rIHRoZSBwbGFjZQo+ ID4gICAgdGhhdCBuZWVkcyB0byBiZSBmaXhlZCBpcyBzd25vZGUgc3lzdGVtLiBXaGF0IHVzZSBh cmUgc3dub2RlcyBpZgo+ID4gICAgdGhleSBjYW5ub3QgYmUgdXNlZCBsaWtlIHRoaXM/ICAKPiAK PiBQcmVjaXNlbHksIHRoYXQncyB3aHkgSSBkb24ndCB3YW50IHRvIGludHJvZHVjZSBhbiBBUEkg dGhhdCBuZWVkcyB0byBiZSBmaXhlZC4KPiAKCkFoYSwgc28geW91IHdhbnQgdG8gZW5zdXJlIHRo YXQgcm9vdCBzd25vZGVzIGFyZSBjcmVhdGVkIHdpdGggdW5pcXVlCm5hbWU/CgpDYW4ndCB3ZSBq dXN0IG1ha2UgaXQgc28gdGhhdCBuYW1lZCBzb2Z0d2FyZSBub2RlIG11c3QgaGF2ZSBhIHBhcmVu dD8KCk1hcmVrCgpfX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f XwpsaW51eC1hcm0ta2VybmVsIG1haWxpbmcgbGlzdApsaW51eC1hcm0ta2VybmVsQGxpc3RzLmlu ZnJhZGVhZC5vcmcKaHR0cDovL2xpc3RzLmluZnJhZGVhZC5vcmcvbWFpbG1hbi9saXN0aW5mby9s aW51eC1hcm0ta2VybmVsCg==