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 DE537C433F5 for ; Mon, 14 Feb 2022 18:13:06 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1357361AbiBNSNN (ORCPT ); Mon, 14 Feb 2022 13:13:13 -0500 Received: from mxb-00190b01.gslb.pphosted.com ([23.128.96.19]:58018 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S236424AbiBNSNL (ORCPT ); Mon, 14 Feb 2022 13:13:11 -0500 Received: from mail-pj1-x1029.google.com (mail-pj1-x1029.google.com [IPv6:2607:f8b0:4864:20::1029]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 1CD5149255 for ; Mon, 14 Feb 2022 10:13:03 -0800 (PST) Received: by mail-pj1-x1029.google.com with SMTP id c5-20020a17090a1d0500b001b904a7046dso18105764pjd.1 for ; Mon, 14 Feb 2022 10:13:03 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=subject:to:cc:references:from:message-id:date:user-agent :mime-version:in-reply-to:content-language:content-transfer-encoding; bh=Yv0kyPBlUI7x2x4ZmpYRM2oynqiN1YdvwOx2uT47xE0=; b=muN6r8s/yaxLLW13Sr20enoDXZBpQWbYV239HJCiY3LkZUuywGM4GD3+WKHX0NKsRt dWMv18BDiygaIgdMcAgVNX9Atcnn22pe/lG6I6DdkVKkBEQZVUuNYdgADCcg9kaBZXu0 gDHGt5x9sdV9yz+Kjqms1xTMDPJiuzoXhhokYW4tWbX7WmbJY+HCIBMcS9YFHN+anfMX K/E/HpPQBEHxXEgGmubS1piO10LgrtnZNxrmikuraprfCpwVnwYcj5TqwWFj9oToVHhx UXPL6PpmeoFTcDCUeto7+R6ZPXUPJB5mCVh+dciICtRdx0YZNWsRethd56GEy6fRpXcr DVlA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:subject:to:cc:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=Yv0kyPBlUI7x2x4ZmpYRM2oynqiN1YdvwOx2uT47xE0=; b=oM9eW336JzxxVK1dSKu7yrweBrSqD6GEKU87dXZKL40w/mfhP0zHzpsqI9L68WxGGy sHB6KubXBlZDiMTjLKEKkqM1VQzhusQbGg0l+aeUJJsIWziXO0p4yQ2mSSt0wb//mTwo +z6yM22xvWLp81xyveGGOKxQn0ETXDQKR0cCs9fY0deiDNPz96Zie0ywJGXxnhv4fKP/ LTx2h246e+YQit5i7lSeUPQs/j/ayVaegiD+g2sdTvfmB1kDViVEqx27aEzFzOL4x3sP r6j7I6BHhcYYySY46fvdg6XuPGudXW6KuyvWDGg1lLbxiOH11tIuxP7y/nq5JnSb8Htd 8QXw== X-Gm-Message-State: AOAM532lrOpX5mzmGiL5FZQQ6bHR+8lHKGjU3O0NLzPm0J28+4qROdZP jXONh1Ybn90ZwnDIeKZwvIYLybs0XXg= X-Google-Smtp-Source: ABdhPJyhV/k4uo4YaF+TqLOB5MYLItb/uyobaZg/U0XNwkySdqb5HFLgZuHE7SYtHh7L/c+mlUcgeQ== X-Received: by 2002:a17:902:e747:: with SMTP id p7mr959240plf.61.1644862381897; Mon, 14 Feb 2022 10:13:01 -0800 (PST) Received: from [10.67.48.245] ([192.19.223.252]) by smtp.googlemail.com with ESMTPSA id iy13sm14489322pjb.51.2022.02.14.10.12.57 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Mon, 14 Feb 2022 10:13:01 -0800 (PST) Subject: Re: [PATCH 0/4] Broadcom STB PM PSCI extensions To: Sudeep Holla , Florian Fainelli Cc: linux-arm-kernel@lists.infradead.org, "maintainer:BROADCOM BCM7XXX ARM ARCHITECTURE" , Mark Rutland , Lorenzo Pieralisi , open list References: <20220122035421.4086618-1-f.fainelli@gmail.com> <20220203111435.e3eblv47ljkwkvwf@bogus> <34938793-cecc-2ad8-a4eb-81bb278ce9b5@gmail.com> <20220203185221.aw7kayj6qklmh5is@bogus> <06f84f27-973d-1dae-e2c3-3fda4e368331@gmail.com> <20220207162734.nt55nflwqstkej3p@bogus> From: Florian Fainelli Message-ID: <7c58b2c8-5ed8-4d2b-14cf-15dba8d672d9@gmail.com> Date: Mon, 14 Feb 2022 10:12:56 -0800 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Thunderbird/78.14.0 MIME-Version: 1.0 In-Reply-To: <20220207162734.nt55nflwqstkej3p@bogus> Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: 8bit Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On 2/7/22 8:27 AM, Sudeep Holla wrote: > On Thu, Feb 03, 2022 at 11:33:26AM -0800, Florian Fainelli wrote: >> >> >> On 2/3/2022 10:52 AM, Sudeep Holla wrote: >>> Correction: it is known as "freeze" rather than "idle" in terms of values >>> as per /sys/power/state. Sorry for referring it as "idle" and creating any >>> confusion. >>> >>> On Thu, Feb 03, 2022 at 09:36:28AM -0800, Florian Fainelli wrote: >>>> >>>> >>>> On 2/3/2022 3:14 AM, Sudeep Holla wrote: >>>>> On Fri, Jan 21, 2022 at 07:54:17PM -0800, Florian Fainelli wrote: >>>>>> Hi all, >>>>>> >>>>>> This patch series contains the Broadcom STB PSCI extensions which adds >>>>>> some additional functions on top of the existing standard PSCI interface >>>>>> which is the reason for having the driver implement a custom >>>>>> suspend_ops. >>>>>> >>>>>> These platforms have traditionally supported a mode that is akin to >>>>>> ACPI's S2 with the CPU in WFI and all of the chip being clock gated >>>>>> which is entered with "echo standby > /sys/power/state". Additional a >>>>>> true suspend to DRAM as defined in ACPI by S3 is implemented with "echo >>>>>> mem > /sys/power/state". >>>>> >>>>> How different is the above "standby" state compare to the standard "idle" >>>>> (a.k.a suspend-to-idle which is different from system-to-ram/S3) ? >>>> >>>> There are a few differences: >>>> >>>> - s2idle does not power gate the secondary CPUs >>>> >>> >>> Not sure what you mean by that ? S2I takes CPUs to deepest idle state. >>> If you want shallower states, one possible option is the disable deeper >>> states from the userspace. >> >> What I mean is that we do not get to call PSCI CPU_OFF here so the CPUs are >> idle, but not power gated. Those CPUs do not have any other idle state other >> than WFI because the HW designers sort of forgot or rather did not know that >> wiring up the ARM GIC power controller back to the power gating logic of the >> CPU was a good idea. >> > > Nice 😄 > >>> >>>> - s2idle requires the use of in-band interrupts for wake-up >>>> >>> >>> I am not sure if that is true. S2I behaves very similar to S2R except it >>> has low wake latency as all secondaries CPUs are not hotplugged out. >> >> OK, the fact that secondary CPUs are not hot-plugged could be remedied by >> doing this ahead of entering s2idle by user-space so this is not a valid >> argument from me anymore. >> > > Fair enough. > >>> >>>> The reasons for implementing "standby" are largely two fold: >>>> >>>> - we need to achieve decent power savings (typically below 0.5W for the >>>> whole system while allowing Wake-on-WLAN, GPIO, RTC, infrared, etc.) >>>> >>> >>> I fail to understand how that is a problem from S2I. It is probably worth >>> checking if there are any unnecessary IRQF_NO_SUSPEND users. Check section >>> IRQF_NO_SUSPEND and enable_irq_wake() in [1]. I don't see any issues other >>> wise in terms of unnecessary/spurious wakeup by in-band(to be precise >>> no-wake up) interrupts. >> >> I don't think your hyperlink referenced by [1] was provided, but my quick >> testing with: >> > > Yikes, I meant to refer Documentation/power/suspend-and-interrupts.rst > >> echo s2idle > /sys/power/mem_sleep >> echo mem > /sys/power/state >> >> appears to work to some extent when I use peripherals that can generate >> in-band interrupts. >> >> It looks like we have s2idle_ops that allows a platform to override some of >> the operations before/after entering s2idle, however the actual s2idle idle >> loop is still within the kernel, so we will not call into the ARM Trusted >> Firmware and engage the power management state machine. >> > > Correct. > >> This means that there will not be any of the clock gating that only the >> hardware state machine is capable of performing, the DRAM controller as a >> result will not enter self refresh power down, and in addition the side band >> wake-up interrupts will not be activate because the interrupt controller >> that aggregates them only outputs to the ARM GIC when the state machine has >> been engaged. >> > > One possible solution IIUC the issue is to add this as additional CPU Idle > state disabled most of the time. Enable them from user-space just prior to > calling freeze/s2idle, so that PSCI CPU_SUSPEND is called with right param > to indicate this is deepest idle state(in your case just WFI) + DRAM self > refresh/retention mode. Also TF-A can take care to enable the side band > interrupts before entering the state. Not knowing how to enable a disabled idle state from user-space, and ensure that it does not race with cpuidle somehow choosing to enter that state, I have all sorts of concerns about such interactions but can see how this could be made to work. In fact, I am wondering if we had not better off work around our broken HW and always advertise that state, and just let cpuidle pick that "deep" idle state resulting in powering down secondary core(s). In TF-A we would have to ensure that we save all of the SPIs affine to that particular core, and probably re-configure the PPIs and SGIs to be made secure such that TF-A can "trap" them and wake-up the core that was just powered off. It sounds like for your suggested approach plus requesting to enter s2idle, we need to start trapping WFI at ELx into EL3 such that TF-A has a chance of observing that all CPU cores are powered down and/or idle and then can engage our power management state machine hardware to clock gate the system and mux in the out of band interrupts. Unless the boot CPU's default idle state has to either be modified, or we have to advertise an additional "deeper" idle state that involves calling into TF-A with PSCI CPU_SUSPEND, too? What I really like about our approach other than it has been proven to work over the past 10 years, is that it fits well with Linux system suspend path via suspend_ops, with each layer taking care of defining its points of no return etc. We know how to debug it, and it is not opportunistic unlike cpuidle, which makes it easier to control. From a non technical point of view, it is also the devil people are used to, and no matter how we shape it, there will be resistance to change. > > Do you see any issue with this approach ? I am trying to find ways to avoid > deviating from standard PSCI. Re-reading the PSCI specification and the SYSTEM_SUSPEND specifically it does sound like ACPI S2 was taken into account but that lead to SYSTEM_SUSPEND not allowing to differentiate between these two states on the premise that "In practice, operating systems use only one suspend to RAM state, so this is not seen as a limitation". It would have been nice to leave provision for defining both instead of not. I am sympathetic to avoid divergence of both interpretation and implementation of the PSCI specification and its reference implementation in Linux. So I can see a few paths forward: - have me try what you suggested, which will take me weeks because I have a TODO list long like my arm (and my arms are really long), assuming that this even works for our use cases - work with you to amend the PSCI specification such that we can differentiate between an entry into S2 or S3 by defining which state we want to enter, but I assume we will get lots of resistance here? -- Florian 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 5424CC433EF for ; Mon, 14 Feb 2022 18:14:22 +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:In-Reply-To:MIME-Version:Date: Message-ID:From:References:Cc:To:Subject:Reply-To:Content-ID: Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc :Resent-Message-ID:List-Owner; bh=Q10C3ndQk/g0/aOI+TuGSE7RDsnhSXqEs4HzOXup5j8=; b=B1Qy8Q0Wm+cCNP6NPlFGwBeQVl Js7WTv8mwh/BbtEN7YI/E1Zme1FGS1Wr+c+k8rh//Ol/KN2GVWaSfOS6aKAuCLXHN8ibXKeGcFSA6 BUoL9CZFcQ2UbFvaPQp/BouSfYC6sf5opW8hvyZlWGIXEVyBCSEHOb1949RXRLxNG7wXgDSOUI8O4 WvunhO9CBABmBoA2kb7XAL+RiwlMfMVGuJvKak6An5B/DWEqHQH7/8iM8kTcRC+CKNb70EHoRS7bI xBNFi34cm0ymyYYGw9A6cDX1fesi8GVisEbT8m9DRGa18NG/E+6W3kJe3BwPyTA6+q7xyTrxbMLWR Mz2LNyqw==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1nJfqT-00GTwe-OB; Mon, 14 Feb 2022 18:13:05 +0000 Received: from mail-pl1-x62a.google.com ([2607:f8b0:4864:20::62a]) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1nJfqQ-00GTw0-Og for linux-arm-kernel@lists.infradead.org; Mon, 14 Feb 2022 18:13:04 +0000 Received: by mail-pl1-x62a.google.com with SMTP id 10so11190973plj.1 for ; Mon, 14 Feb 2022 10:13:02 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=subject:to:cc:references:from:message-id:date:user-agent :mime-version:in-reply-to:content-language:content-transfer-encoding; bh=Yv0kyPBlUI7x2x4ZmpYRM2oynqiN1YdvwOx2uT47xE0=; b=muN6r8s/yaxLLW13Sr20enoDXZBpQWbYV239HJCiY3LkZUuywGM4GD3+WKHX0NKsRt dWMv18BDiygaIgdMcAgVNX9Atcnn22pe/lG6I6DdkVKkBEQZVUuNYdgADCcg9kaBZXu0 gDHGt5x9sdV9yz+Kjqms1xTMDPJiuzoXhhokYW4tWbX7WmbJY+HCIBMcS9YFHN+anfMX K/E/HpPQBEHxXEgGmubS1piO10LgrtnZNxrmikuraprfCpwVnwYcj5TqwWFj9oToVHhx UXPL6PpmeoFTcDCUeto7+R6ZPXUPJB5mCVh+dciICtRdx0YZNWsRethd56GEy6fRpXcr DVlA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:subject:to:cc:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=Yv0kyPBlUI7x2x4ZmpYRM2oynqiN1YdvwOx2uT47xE0=; b=KjqQEHiRqwbzV9nkulKxuhEMu8kn2nHc3hoNwLTXA3Nii43ShCQ7zCfCVx+ukRfAjV oxFPe72zGudD8X2+d8ZAE/7qUdoJuj6kpGBwIpMMCLwNy3airaD6tcIn3EOIfr4JhubO f79kEHZE2OL0neWhPkO3kBFAcx9iA61w4OqJsLDazzXmdDqhCd+8heBOty/snGXvAiQY PS3qCbJ9uYUQDDDmyPTpfOXWnbcETnxZ8rEsgo+KtLhDPXWsInwRcchzNqsVxZV1h04K pxfxA9wScgyQ6IydGp37nBiKp2OtNJ8677fvJhzJEtc+CumPcSutHhCnEUFdrtIbZXaD VBWg== X-Gm-Message-State: AOAM532fKSb/DricYt8ERJr5OV1cBQNz150Q+o2VQvSmLilmIbrQvI39 9ySTfNEFR3IgJct/0UwhqLE= X-Google-Smtp-Source: ABdhPJyhV/k4uo4YaF+TqLOB5MYLItb/uyobaZg/U0XNwkySdqb5HFLgZuHE7SYtHh7L/c+mlUcgeQ== X-Received: by 2002:a17:902:e747:: with SMTP id p7mr959240plf.61.1644862381897; Mon, 14 Feb 2022 10:13:01 -0800 (PST) Received: from [10.67.48.245] ([192.19.223.252]) by smtp.googlemail.com with ESMTPSA id iy13sm14489322pjb.51.2022.02.14.10.12.57 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Mon, 14 Feb 2022 10:13:01 -0800 (PST) Subject: Re: [PATCH 0/4] Broadcom STB PM PSCI extensions To: Sudeep Holla , Florian Fainelli Cc: linux-arm-kernel@lists.infradead.org, "maintainer:BROADCOM BCM7XXX ARM ARCHITECTURE" , Mark Rutland , Lorenzo Pieralisi , open list References: <20220122035421.4086618-1-f.fainelli@gmail.com> <20220203111435.e3eblv47ljkwkvwf@bogus> <34938793-cecc-2ad8-a4eb-81bb278ce9b5@gmail.com> <20220203185221.aw7kayj6qklmh5is@bogus> <06f84f27-973d-1dae-e2c3-3fda4e368331@gmail.com> <20220207162734.nt55nflwqstkej3p@bogus> From: Florian Fainelli Message-ID: <7c58b2c8-5ed8-4d2b-14cf-15dba8d672d9@gmail.com> Date: Mon, 14 Feb 2022 10:12:56 -0800 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Thunderbird/78.14.0 MIME-Version: 1.0 In-Reply-To: <20220207162734.nt55nflwqstkej3p@bogus> Content-Language: en-US X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20220214_101302_855062_EEB0855F X-CRM114-Status: GOOD ( 46.79 ) 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 T24gMi83LzIyIDg6MjcgQU0sIFN1ZGVlcCBIb2xsYSB3cm90ZToKPiBPbiBUaHUsIEZlYiAwMywg MjAyMiBhdCAxMTozMzoyNkFNIC0wODAwLCBGbG9yaWFuIEZhaW5lbGxpIHdyb3RlOgo+Pgo+Pgo+ PiBPbiAyLzMvMjAyMiAxMDo1MiBBTSwgU3VkZWVwIEhvbGxhIHdyb3RlOgo+Pj4gQ29ycmVjdGlv bjogaXQgaXMga25vd24gYXMgImZyZWV6ZSIgcmF0aGVyIHRoYW4gImlkbGUiIGluIHRlcm1zIG9m IHZhbHVlcwo+Pj4gYXMgcGVyIC9zeXMvcG93ZXIvc3RhdGUuIFNvcnJ5IGZvciByZWZlcnJpbmcg aXQgYXMgImlkbGUiIGFuZCBjcmVhdGluZyBhbnkKPj4+IGNvbmZ1c2lvbi4KPj4+Cj4+PiBPbiBU aHUsIEZlYiAwMywgMjAyMiBhdCAwOTozNjoyOEFNIC0wODAwLCBGbG9yaWFuIEZhaW5lbGxpIHdy b3RlOgo+Pj4+Cj4+Pj4KPj4+PiBPbiAyLzMvMjAyMiAzOjE0IEFNLCBTdWRlZXAgSG9sbGEgd3Jv dGU6Cj4+Pj4+IE9uIEZyaSwgSmFuIDIxLCAyMDIyIGF0IDA3OjU0OjE3UE0gLTA4MDAsIEZsb3Jp YW4gRmFpbmVsbGkgd3JvdGU6Cj4+Pj4+PiBIaSBhbGwsCj4+Pj4+Pgo+Pj4+Pj4gVGhpcyBwYXRj aCBzZXJpZXMgY29udGFpbnMgdGhlIEJyb2FkY29tIFNUQiBQU0NJIGV4dGVuc2lvbnMgd2hpY2gg YWRkcwo+Pj4+Pj4gc29tZSBhZGRpdGlvbmFsIGZ1bmN0aW9ucyBvbiB0b3Agb2YgdGhlIGV4aXN0 aW5nIHN0YW5kYXJkIFBTQ0kgaW50ZXJmYWNlCj4+Pj4+PiB3aGljaCBpcyB0aGUgcmVhc29uIGZv ciBoYXZpbmcgdGhlIGRyaXZlciBpbXBsZW1lbnQgYSBjdXN0b20KPj4+Pj4+IHN1c3BlbmRfb3Bz Lgo+Pj4+Pj4KPj4+Pj4+IFRoZXNlIHBsYXRmb3JtcyBoYXZlIHRyYWRpdGlvbmFsbHkgc3VwcG9y dGVkIGEgbW9kZSB0aGF0IGlzIGFraW4gdG8KPj4+Pj4+IEFDUEkncyBTMiB3aXRoIHRoZSBDUFUg aW4gV0ZJIGFuZCBhbGwgb2YgdGhlIGNoaXAgYmVpbmcgY2xvY2sgZ2F0ZWQKPj4+Pj4+IHdoaWNo IGlzIGVudGVyZWQgd2l0aCAiZWNobyBzdGFuZGJ5ID4gL3N5cy9wb3dlci9zdGF0ZSIuIEFkZGl0 aW9uYWwgYQo+Pj4+Pj4gdHJ1ZSBzdXNwZW5kIHRvIERSQU0gYXMgZGVmaW5lZCBpbiBBQ1BJIGJ5 IFMzIGlzIGltcGxlbWVudGVkIHdpdGggImVjaG8KPj4+Pj4+IG1lbSA+IC9zeXMvcG93ZXIvc3Rh dGUiLgo+Pj4+Pgo+Pj4+PiBIb3cgZGlmZmVyZW50IGlzIHRoZSBhYm92ZSAic3RhbmRieSIgc3Rh dGUgY29tcGFyZSB0byB0aGUgc3RhbmRhcmQgImlkbGUiCj4+Pj4+IChhLmsuYSBzdXNwZW5kLXRv LWlkbGUgd2hpY2ggaXMgZGlmZmVyZW50IGZyb20gc3lzdGVtLXRvLXJhbS9TMykgPwo+Pj4+Cj4+ Pj4gVGhlcmUgYXJlIGEgZmV3IGRpZmZlcmVuY2VzOgo+Pj4+Cj4+Pj4gLSBzMmlkbGUgZG9lcyBu b3QgcG93ZXIgZ2F0ZSB0aGUgc2Vjb25kYXJ5IENQVXMKPj4+Pgo+Pj4KPj4+IE5vdCBzdXJlIHdo YXQgeW91IG1lYW4gYnkgdGhhdCA/IFMySSB0YWtlcyBDUFVzIHRvIGRlZXBlc3QgaWRsZSBzdGF0 ZS4KPj4+IElmIHlvdSB3YW50IHNoYWxsb3dlciBzdGF0ZXMsIG9uZSBwb3NzaWJsZSBvcHRpb24g aXMgdGhlIGRpc2FibGUgZGVlcGVyCj4+PiBzdGF0ZXMgZnJvbSB0aGUgdXNlcnNwYWNlLgo+Pgo+ PiBXaGF0IEkgbWVhbiBpcyB0aGF0IHdlIGRvIG5vdCBnZXQgdG8gY2FsbCBQU0NJIENQVV9PRkYg aGVyZSBzbyB0aGUgQ1BVcyBhcmUKPj4gaWRsZSwgYnV0IG5vdCBwb3dlciBnYXRlZC4gVGhvc2Ug Q1BVcyBkbyBub3QgaGF2ZSBhbnkgb3RoZXIgaWRsZSBzdGF0ZSBvdGhlcgo+PiB0aGFuIFdGSSBi ZWNhdXNlIHRoZSBIVyBkZXNpZ25lcnMgc29ydCBvZiBmb3Jnb3Qgb3IgcmF0aGVyIGRpZCBub3Qg a25vdyB0aGF0Cj4+IHdpcmluZyB1cCB0aGUgQVJNIEdJQyBwb3dlciBjb250cm9sbGVyIGJhY2sg dG8gdGhlIHBvd2VyIGdhdGluZyBsb2dpYyBvZiB0aGUKPj4gQ1BVIHdhcyBhIGdvb2QgaWRlYS4K Pj4KPiAKPiBOaWNlIPCfmIQKPiAKPj4+Cj4+Pj4gLSBzMmlkbGUgcmVxdWlyZXMgdGhlIHVzZSBv ZiBpbi1iYW5kIGludGVycnVwdHMgZm9yIHdha2UtdXAKPj4+Pgo+Pj4KPj4+IEkgYW0gbm90IHN1 cmUgaWYgdGhhdCBpcyB0cnVlLiBTMkkgYmVoYXZlcyB2ZXJ5IHNpbWlsYXIgdG8gUzJSIGV4Y2Vw dCBpdAo+Pj4gaGFzIGxvdyB3YWtlIGxhdGVuY3kgYXMgYWxsIHNlY29uZGFyaWVzIENQVXMgYXJl IG5vdCBob3RwbHVnZ2VkIG91dC4KPj4KPj4gT0ssIHRoZSBmYWN0IHRoYXQgc2Vjb25kYXJ5IENQ VXMgYXJlIG5vdCBob3QtcGx1Z2dlZCBjb3VsZCBiZSByZW1lZGllZCBieQo+PiBkb2luZyB0aGlz IGFoZWFkIG9mIGVudGVyaW5nIHMyaWRsZSBieSB1c2VyLXNwYWNlIHNvIHRoaXMgaXMgbm90IGEg dmFsaWQKPj4gYXJndW1lbnQgZnJvbSBtZSBhbnltb3JlLgo+Pgo+IAo+IEZhaXIgZW5vdWdoLgo+ IAo+Pj4KPj4+PiBUaGUgcmVhc29ucyBmb3IgaW1wbGVtZW50aW5nICJzdGFuZGJ5IiBhcmUgbGFy Z2VseSB0d28gZm9sZDoKPj4+Pgo+Pj4+IC0gd2UgbmVlZCB0byBhY2hpZXZlIGRlY2VudCBwb3dl ciBzYXZpbmdzICh0eXBpY2FsbHkgYmVsb3cgMC41VyBmb3IgdGhlCj4+Pj4gd2hvbGUgc3lzdGVt IHdoaWxlIGFsbG93aW5nIFdha2Utb24tV0xBTiwgR1BJTywgUlRDLCBpbmZyYXJlZCwgZXRjLikK Pj4+Pgo+Pj4KPj4+IEkgZmFpbCB0byB1bmRlcnN0YW5kIGhvdyB0aGF0IGlzIGEgcHJvYmxlbSBm cm9tIFMySS4gSXQgaXMgcHJvYmFibHkgd29ydGgKPj4+IGNoZWNraW5nIGlmIHRoZXJlIGFyZSBh bnkgdW5uZWNlc3NhcnkgSVJRRl9OT19TVVNQRU5EIHVzZXJzLiBDaGVjayBzZWN0aW9uCj4+PiBJ UlFGX05PX1NVU1BFTkQgYW5kIGVuYWJsZV9pcnFfd2FrZSgpIGluIFsxXS4gSSBkb24ndCBzZWUg YW55IGlzc3VlcyBvdGhlcgo+Pj4gd2lzZSBpbiB0ZXJtcyBvZiB1bm5lY2Vzc2FyeS9zcHVyaW91 cyB3YWtldXAgYnkgaW4tYmFuZCh0byBiZSBwcmVjaXNlCj4+PiBuby13YWtlIHVwKSBpbnRlcnJ1 cHRzLgo+Pgo+PiBJIGRvbid0IHRoaW5rIHlvdXIgaHlwZXJsaW5rIHJlZmVyZW5jZWQgYnkgWzFd IHdhcyBwcm92aWRlZCwgYnV0IG15IHF1aWNrCj4+IHRlc3Rpbmcgd2l0aDoKPj4KPiAKPiBZaWtl cywgSSBtZWFudCB0byByZWZlciBEb2N1bWVudGF0aW9uL3Bvd2VyL3N1c3BlbmQtYW5kLWludGVy cnVwdHMucnN0Cj4gCj4+IGVjaG8gczJpZGxlID4gL3N5cy9wb3dlci9tZW1fc2xlZXAKPj4gZWNo byBtZW0gPiAvc3lzL3Bvd2VyL3N0YXRlCj4+Cj4+IGFwcGVhcnMgdG8gd29yayB0byBzb21lIGV4 dGVudCB3aGVuIEkgdXNlIHBlcmlwaGVyYWxzIHRoYXQgY2FuIGdlbmVyYXRlCj4+IGluLWJhbmQg aW50ZXJydXB0cy4KPj4KPj4gSXQgbG9va3MgbGlrZSB3ZSBoYXZlIHMyaWRsZV9vcHMgdGhhdCBh bGxvd3MgYSBwbGF0Zm9ybSB0byBvdmVycmlkZSBzb21lIG9mCj4+IHRoZSBvcGVyYXRpb25zIGJl Zm9yZS9hZnRlciBlbnRlcmluZyBzMmlkbGUsIGhvd2V2ZXIgdGhlIGFjdHVhbCBzMmlkbGUgaWRs ZQo+PiBsb29wIGlzIHN0aWxsIHdpdGhpbiB0aGUga2VybmVsLCBzbyB3ZSB3aWxsIG5vdCBjYWxs IGludG8gdGhlIEFSTSBUcnVzdGVkCj4+IEZpcm13YXJlIGFuZCBlbmdhZ2UgdGhlIHBvd2VyIG1h bmFnZW1lbnQgc3RhdGUgbWFjaGluZS4KPj4KPiAKPiBDb3JyZWN0Lgo+IAo+PiBUaGlzIG1lYW5z IHRoYXQgdGhlcmUgd2lsbCBub3QgYmUgYW55IG9mIHRoZSBjbG9jayBnYXRpbmcgdGhhdCBvbmx5 IHRoZQo+PiBoYXJkd2FyZSBzdGF0ZSBtYWNoaW5lIGlzIGNhcGFibGUgb2YgcGVyZm9ybWluZywg dGhlIERSQU0gY29udHJvbGxlciBhcyBhCj4+IHJlc3VsdCB3aWxsIG5vdCBlbnRlciBzZWxmIHJl ZnJlc2ggcG93ZXIgZG93biwgYW5kIGluIGFkZGl0aW9uIHRoZSBzaWRlIGJhbmQKPj4gd2FrZS11 cCBpbnRlcnJ1cHRzIHdpbGwgbm90IGJlIGFjdGl2YXRlIGJlY2F1c2UgdGhlIGludGVycnVwdCBj b250cm9sbGVyCj4+IHRoYXQgYWdncmVnYXRlcyB0aGVtIG9ubHkgb3V0cHV0cyB0byB0aGUgQVJN IEdJQyB3aGVuIHRoZSBzdGF0ZSBtYWNoaW5lIGhhcwo+PiBiZWVuIGVuZ2FnZWQuCj4+Cj4gCj4g T25lIHBvc3NpYmxlIHNvbHV0aW9uIElJVUMgdGhlIGlzc3VlIGlzIHRvIGFkZCB0aGlzIGFzIGFk ZGl0aW9uYWwgQ1BVIElkbGUKPiBzdGF0ZSBkaXNhYmxlZCBtb3N0IG9mIHRoZSB0aW1lLiBFbmFi bGUgdGhlbSBmcm9tIHVzZXItc3BhY2UganVzdCBwcmlvciB0bwo+IGNhbGxpbmcgZnJlZXplL3My aWRsZSwgc28gdGhhdCBQU0NJIENQVV9TVVNQRU5EIGlzIGNhbGxlZCB3aXRoIHJpZ2h0IHBhcmFt Cj4gdG8gaW5kaWNhdGUgdGhpcyBpcyBkZWVwZXN0IGlkbGUgc3RhdGUoaW4geW91ciBjYXNlIGp1 c3QgV0ZJKSArIERSQU0gc2VsZgo+IHJlZnJlc2gvcmV0ZW50aW9uIG1vZGUuIEFsc28gVEYtQSBj YW4gdGFrZSBjYXJlIHRvIGVuYWJsZSB0aGUgc2lkZSBiYW5kCj4gaW50ZXJydXB0cyBiZWZvcmUg ZW50ZXJpbmcgdGhlIHN0YXRlLgoKTm90IGtub3dpbmcgaG93IHRvIGVuYWJsZSBhIGRpc2FibGVk IGlkbGUgc3RhdGUgZnJvbSB1c2VyLXNwYWNlLCBhbmQKZW5zdXJlIHRoYXQgaXQgZG9lcyBub3Qg cmFjZSB3aXRoIGNwdWlkbGUgc29tZWhvdyBjaG9vc2luZyB0byBlbnRlciB0aGF0CnN0YXRlLCBJ IGhhdmUgYWxsIHNvcnRzIG9mIGNvbmNlcm5zIGFib3V0IHN1Y2ggaW50ZXJhY3Rpb25zIGJ1dCBj YW4gc2VlCmhvdyB0aGlzIGNvdWxkIGJlIG1hZGUgdG8gd29yay4gSW4gZmFjdCwgSSBhbSB3b25k ZXJpbmcgaWYgd2UgaGFkIG5vdApiZXR0ZXIgb2ZmIHdvcmsgYXJvdW5kIG91ciBicm9rZW4gSFcg YW5kIGFsd2F5cyBhZHZlcnRpc2UgdGhhdCBzdGF0ZSwKYW5kIGp1c3QgbGV0IGNwdWlkbGUgcGlj ayB0aGF0ICJkZWVwIiBpZGxlIHN0YXRlIHJlc3VsdGluZyBpbiBwb3dlcmluZwpkb3duIHNlY29u ZGFyeSBjb3JlKHMpLiBJbiBURi1BIHdlIHdvdWxkIGhhdmUgdG8gZW5zdXJlIHRoYXQgd2Ugc2F2 ZSBhbGwKb2YgdGhlIFNQSXMgYWZmaW5lIHRvIHRoYXQgcGFydGljdWxhciBjb3JlLCBhbmQgcHJv YmFibHkgcmUtY29uZmlndXJlCnRoZSBQUElzIGFuZCBTR0lzIHRvIGJlIG1hZGUgc2VjdXJlIHN1 Y2ggdGhhdCBURi1BIGNhbiAidHJhcCIgdGhlbSBhbmQKd2FrZS11cCB0aGUgY29yZSB0aGF0IHdh cyBqdXN0IHBvd2VyZWQgb2ZmLgoKSXQgc291bmRzIGxpa2UgZm9yIHlvdXIgc3VnZ2VzdGVkIGFw cHJvYWNoIHBsdXMgcmVxdWVzdGluZyB0byBlbnRlcgpzMmlkbGUsIHdlIG5lZWQgdG8gc3RhcnQg dHJhcHBpbmcgV0ZJIGF0IEVMeCBpbnRvIEVMMyBzdWNoIHRoYXQgVEYtQSBoYXMKYSBjaGFuY2Ug b2Ygb2JzZXJ2aW5nIHRoYXQgYWxsIENQVSBjb3JlcyBhcmUgcG93ZXJlZCBkb3duIGFuZC9vciBp ZGxlCmFuZCB0aGVuIGNhbiBlbmdhZ2Ugb3VyIHBvd2VyIG1hbmFnZW1lbnQgc3RhdGUgbWFjaGlu ZSBoYXJkd2FyZSB0byBjbG9jawpnYXRlIHRoZSBzeXN0ZW0gYW5kIG11eCBpbiB0aGUgb3V0IG9m IGJhbmQgaW50ZXJydXB0cy4gVW5sZXNzIHRoZSBib290CkNQVSdzIGRlZmF1bHQgaWRsZSBzdGF0 ZSBoYXMgdG8gZWl0aGVyIGJlIG1vZGlmaWVkLCBvciB3ZSBoYXZlIHRvCmFkdmVydGlzZSBhbiBh ZGRpdGlvbmFsICJkZWVwZXIiIGlkbGUgc3RhdGUgdGhhdCBpbnZvbHZlcyBjYWxsaW5nIGludG8K VEYtQSB3aXRoIFBTQ0kgQ1BVX1NVU1BFTkQsIHRvbz8KCldoYXQgSSByZWFsbHkgbGlrZSBhYm91 dCBvdXIgYXBwcm9hY2ggb3RoZXIgdGhhbiBpdCBoYXMgYmVlbiBwcm92ZW4gdG8Kd29yayBvdmVy IHRoZSBwYXN0IDEwIHllYXJzLCBpcyB0aGF0IGl0IGZpdHMgd2VsbCB3aXRoIExpbnV4IHN5c3Rl bQpzdXNwZW5kIHBhdGggdmlhIHN1c3BlbmRfb3BzLCB3aXRoIGVhY2ggbGF5ZXIgdGFraW5nIGNh cmUgb2YgZGVmaW5pbmcKaXRzIHBvaW50cyBvZiBubyByZXR1cm4gZXRjLiBXZSBrbm93IGhvdyB0 byBkZWJ1ZyBpdCwgYW5kIGl0IGlzIG5vdApvcHBvcnR1bmlzdGljIHVubGlrZSBjcHVpZGxlLCB3 aGljaCBtYWtlcyBpdCBlYXNpZXIgdG8gY29udHJvbC4gRnJvbSBhCm5vbiB0ZWNobmljYWwgcG9p bnQgb2YgdmlldywgaXQgaXMgYWxzbyB0aGUgZGV2aWwgcGVvcGxlIGFyZSB1c2VkIHRvLAphbmQg bm8gbWF0dGVyIGhvdyB3ZSBzaGFwZSBpdCwgdGhlcmUgd2lsbCBiZSByZXNpc3RhbmNlIHRvIGNo YW5nZS4KCj4gCj4gRG8geW91IHNlZSBhbnkgaXNzdWUgd2l0aCB0aGlzIGFwcHJvYWNoID8gSSBh bSB0cnlpbmcgdG8gZmluZCB3YXlzIHRvIGF2b2lkCj4gZGV2aWF0aW5nIGZyb20gc3RhbmRhcmQg UFNDSS4KClJlLXJlYWRpbmcgdGhlIFBTQ0kgc3BlY2lmaWNhdGlvbiBhbmQgdGhlIFNZU1RFTV9T VVNQRU5EIHNwZWNpZmljYWxseSBpdApkb2VzIHNvdW5kIGxpa2UgQUNQSSBTMiB3YXMgdGFrZW4g aW50byBhY2NvdW50IGJ1dCB0aGF0IGxlYWQgdG8KU1lTVEVNX1NVU1BFTkQgbm90IGFsbG93aW5n IHRvIGRpZmZlcmVudGlhdGUgYmV0d2VlbiB0aGVzZSB0d28gc3RhdGVzIG9uCnRoZSBwcmVtaXNl IHRoYXQgIkluIHByYWN0aWNlLCBvcGVyYXRpbmcgc3lzdGVtcyB1c2Ugb25seSBvbmUgc3VzcGVu ZCB0bwpSQU0gc3RhdGUsIHNvIHRoaXMgaXMgbm90IHNlZW4gYXMgYSBsaW1pdGF0aW9uIi4gSXQg d291bGQgaGF2ZSBiZWVuIG5pY2UKdG8gbGVhdmUgcHJvdmlzaW9uIGZvciBkZWZpbmluZyBib3Ro IGluc3RlYWQgb2Ygbm90LgoKSSBhbSBzeW1wYXRoZXRpYyB0byBhdm9pZCBkaXZlcmdlbmNlIG9m IGJvdGggaW50ZXJwcmV0YXRpb24gYW5kCmltcGxlbWVudGF0aW9uIG9mIHRoZSBQU0NJIHNwZWNp ZmljYXRpb24gYW5kIGl0cyByZWZlcmVuY2UKaW1wbGVtZW50YXRpb24gaW4gTGludXguIFNvIEkg Y2FuIHNlZSBhIGZldyBwYXRocyBmb3J3YXJkOgoKLSBoYXZlIG1lIHRyeSB3aGF0IHlvdSBzdWdn ZXN0ZWQsIHdoaWNoIHdpbGwgdGFrZSBtZSB3ZWVrcyBiZWNhdXNlIEkKaGF2ZSBhIFRPRE8gbGlz dCBsb25nIGxpa2UgbXkgYXJtIChhbmQgbXkgYXJtcyBhcmUgcmVhbGx5IGxvbmcpLAphc3N1bWlu ZyB0aGF0IHRoaXMgZXZlbiB3b3JrcyBmb3Igb3VyIHVzZSBjYXNlcwoKLSB3b3JrIHdpdGggeW91 IHRvIGFtZW5kIHRoZSBQU0NJIHNwZWNpZmljYXRpb24gc3VjaCB0aGF0IHdlIGNhbgpkaWZmZXJl bnRpYXRlIGJldHdlZW4gYW4gZW50cnkgaW50byBTMiBvciBTMyBieSBkZWZpbmluZyB3aGljaCBz dGF0ZSB3ZQp3YW50IHRvIGVudGVyLCBidXQgSSBhc3N1bWUgd2Ugd2lsbCBnZXQgbG90cyBvZiBy ZXNpc3RhbmNlIGhlcmU/Ci0tIApGbG9yaWFuCgpfX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fXwpsaW51eC1hcm0ta2VybmVsIG1haWxpbmcgbGlzdApsaW51eC1h cm0ta2VybmVsQGxpc3RzLmluZnJhZGVhZC5vcmcKaHR0cDovL2xpc3RzLmluZnJhZGVhZC5vcmcv bWFpbG1hbi9saXN0aW5mby9saW51eC1hcm0ta2VybmVsCg==