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 0F181C4332F for ; Mon, 3 Oct 2022 15:37:07 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S230225AbiJCPhF (ORCPT ); Mon, 3 Oct 2022 11:37:05 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:36950 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230328AbiJCPgo (ORCPT ); Mon, 3 Oct 2022 11:36:44 -0400 Received: from mail-wr1-x430.google.com (mail-wr1-x430.google.com [IPv6:2a00:1450:4864:20::430]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id D96E713DE7 for ; Mon, 3 Oct 2022 08:36:38 -0700 (PDT) Received: by mail-wr1-x430.google.com with SMTP id j7so11960003wrr.3 for ; Mon, 03 Oct 2022 08:36:38 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=content-transfer-encoding:in-reply-to:from:references:cc:to :content-language:subject:user-agent:mime-version:date:message-id :from:to:cc:subject:date; bh=XNKN62ufy1+xZwjokTiFAK6DG0fkYs2uyoDmdXUsmfk=; b=joStem3d8drVJs049ako4kuE59txaO6NDwV0bfhPO1a6au6KSg1jl9JsQbZC3bw7u+ FD6FayZuGqdzNjFvhzr644aHDEG6eCiaS9OElKxDfveQgku8qAOD+P94IxzfUncnx8IO RK+0MVu0VdhcKkFmQsLSyILE5TNyJbkDMhEFSgk6kG9xiR+G48J4fbd7Ydqu9lfNyuxm tvzmrPwJsIDRpFq4+XQKhrZjD3+bkaJPRtm2Df97oP5CxhB+whhXaMyK76P9RB4KrQx9 WR8EWkAW9tn/Zis7k+FaXmzNAPD5b79QWJRpBzgishcYEQtk6m/FkQliHjtVn56Kmtc7 3OuA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:in-reply-to:from:references:cc:to :content-language:subject:user-agent:mime-version:date:message-id :x-gm-message-state:from:to:cc:subject:date; bh=XNKN62ufy1+xZwjokTiFAK6DG0fkYs2uyoDmdXUsmfk=; b=wX84sZj6t0xBjVH461kQlF7GCsy7q04gFqtDRpfnbjj6HPwENOWTMrULGIw624+/mq ftEpN2FPm3EEFDnFnoTwo89MverlUO5A4UZNrRRkjsW4gN5myCC4IRgzlasyRRXLnueQ uIHJBRvM1GvrKA0nXj+F5aaawOmqFGYUhZFZQULEUPrvgNuZIpi6bnn/PRmGCEcwGmOS o0Q+ZqSrtuHp6jOT/TbJAjwYTlz2Kd+9cAf2X4qRFihzAR07uaAB12bF0o3ZyMVtiBw5 AXc3CGGqkbm07tVgfxJgwJ32GMvAgWBFOvjmsCHMcpH8jI2VAqzLqtvP3OhjC1IgCx+C EPFQ== X-Gm-Message-State: ACrzQf05ISOtrgHwszajA/qQ6wCDyfFygHBkE3SDGeEGTFxPUjD6+8Wa jVC2LCRBxm5SjEy2nV489DW0Fw== X-Google-Smtp-Source: AMsMyM5sZ5raF+DNJ/cTSf5EVIWxvlZeClNcXX2TDk8N8PojssLE59qDPC1gOPTXuAj69kjJPYFesg== X-Received: by 2002:a05:6000:1c0e:b0:22e:2c39:1da6 with SMTP id ba14-20020a0560001c0e00b0022e2c391da6mr7285770wrb.588.1664811396754; Mon, 03 Oct 2022 08:36:36 -0700 (PDT) Received: from ?IPV6:2a05:6e02:1041:c10:f3a:9f5e:1605:a75a? ([2a05:6e02:1041:c10:f3a:9f5e:1605:a75a]) by smtp.googlemail.com with ESMTPSA id v17-20020a5d43d1000000b0022e049586c5sm8599784wrr.28.2022.10.03.08.36.34 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Mon, 03 Oct 2022 08:36:36 -0700 (PDT) Message-ID: Date: Mon, 3 Oct 2022 17:36:34 +0200 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101 Thunderbird/91.11.0 Subject: Re: [PATCH v8 00/29] Rework the trip points creation Content-Language: en-US To: Marek Szyprowski , rafael@kernel.org Cc: linux-kernel@vger.kernel.org, linux-pm@vger.kernel.org, rui.zhang@intel.com, Broadcom Kernel Team , Support Opensource , Pengutronix Kernel Team , NXP Linux Team , Andy Gross , Bartlomiej Zolnierkiewicz , Krzysztof Kozlowski , Alim Akhtar , netdev@vger.kernel.org, platform-driver-x86@vger.kernel.org, linux-rpi-kernel@lists.infradead.org, linux-arm-kernel@lists.infradead.org, linux-arm-msm@vger.kernel.org, linux-renesas-soc@vger.kernel.org, linux-samsung-soc@vger.kernel.org, linux-tegra@vger.kernel.org, linux-omap@vger.kernel.org References: <20221003092602.1323944-1-daniel.lezcano@linaro.org> <8cdd1927-da38-c23e-fa75-384694724b1c@samsung.com> From: Daniel Lezcano In-Reply-To: <8cdd1927-da38-c23e-fa75-384694724b1c@samsung.com> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit Precedence: bulk List-ID: X-Mailing-List: linux-tegra@vger.kernel.org On 03/10/2022 16:10, Marek Szyprowski wrote: > Hi Daniel, > > On 03.10.2022 11:25, Daniel Lezcano wrote: >> This work is the pre-requisite of handling correctly when the trip >> point are crossed. For that we need to rework how the trip points are >> declared and assigned to a thermal zone. >> >> Even if it appears to be a common sense to have the trip points being >> ordered, this no guarantee neither documentation telling that is the >> case. >> >> One solution could have been to create an ordered array of trips built >> when registering the thermal zone by calling the different get_trip* >> ops. However those ops receive a thermal zone pointer which is not >> known as it is in the process of creating it. >> >> This cyclic dependency shows we have to rework how we manage the trip >> points. >> >> Actually, all the trip points definition can be common to the backend >> sensor drivers and we can factor out the thermal trip structure in all >> of them. >> >> Then, as we register the thermal trips array, they will be available >> in the thermal zone structure and a core function can return the trip >> given its id. >> >> The get_trip_* ops won't be needed anymore and could be removed. The >> resulting code will be another step forward to a self encapsulated >> generic thermal framework. >> >> Most of the drivers can be converted more or less easily. This series >> does a first round with most of the drivers. Some remain and will be >> converted but with a smaller set of changes as the conversion is a bit >> more complex. >> >> Changelog: >> v8: >> - Pretty oneline change and parenthesis removal (Rafael) >> - Collected tags >> v7: >> - Added missing return 0 in the x86_pkg_temp driver >> v6: >> - Improved the code for the get_crit_temp() function as suggested by >> Rafael >> - Removed inner parenthesis in the set_trip_temp() function and invert the >> conditions. Check the type of the trip point is unchanged >> - Folded patch 4 with 1 >> - Add per thermal zone info message in the bang-bang governor >> - Folded the fix for an uninitialized variable in >> int340x_thermal_zone_add() >> v5: >> - Fixed a deadlock when calling thermal_zone_get_trip() while >> handling the thermal zone lock >> - Remove an extra line in the sysfs change >> - Collected tags >> v4: >> - Remove extra lines on exynos changes as reported by Krzysztof Kozlowski >> - Collected tags >> v3: >> - Reorg the series to be git-bisect safe >> - Added the set_trip generic function >> - Added the get_crit_temp generic function >> - Removed more dead code in the thermal-of >> - Fixed the exynos changelog >> - Fixed the error check for the exynos drivers >> - Collected tags >> v2: >> - Added missing EXPORT_SYMBOL_GPL() for thermal_zone_get_trip() >> - Removed tab whitespace in the acerhdf driver >> - Collected tags >> >> Cc: Raju Rangoju >> Cc: "David S. Miller" >> Cc: Eric Dumazet >> Cc: Jakub Kicinski >> Cc: Paolo Abeni >> Cc: Peter Kaestle >> Cc: Hans de Goede >> Cc: Mark Gross >> Cc: Miquel Raynal >> Cc: "Rafael J. Wysocki" >> Cc: Daniel Lezcano >> Cc: Amit Kucheria >> Cc: Zhang Rui >> Cc: Nicolas Saenz Julienne >> Cc: Broadcom Kernel Team >> Cc: Florian Fainelli >> Cc: Ray Jui >> Cc: Scott Branden >> Cc: Support Opensource >> Cc: Lukasz Luba >> Cc: Shawn Guo >> Cc: Sascha Hauer >> Cc: Pengutronix Kernel Team >> Cc: Fabio Estevam >> Cc: NXP Linux Team >> Cc: Thara Gopinath >> Cc: Andy Gross >> Cc: Bjorn Andersson >> Cc: "Niklas Söderlund" >> Cc: Bartlomiej Zolnierkiewicz >> Cc: Krzysztof Kozlowski >> Cc: Alim Akhtar >> Cc: Thierry Reding >> Cc: Jonathan Hunter >> Cc: Eduardo Valentin >> Cc: Keerthy >> Cc: Kunihiko Hayashi >> Cc: Masami Hiramatsu >> Cc: Antoine Tenart >> Cc: Srinivas Pandruvada >> Cc: Dmitry Osipenko >> Cc: netdev@vger.kernel.org >> Cc: linux-kernel@vger.kernel.org >> Cc: platform-driver-x86@vger.kernel.org >> Cc: linux-pm@vger.kernel.org >> Cc: linux-rpi-kernel@lists.infradead.org >> Cc: linux-arm-kernel@lists.infradead.org >> Cc: linux-arm-msm@vger.kernel.org >> Cc: linux-renesas-soc@vger.kernel.org >> Cc: linux-samsung-soc@vger.kernel.org >> Cc: linux-tegra@vger.kernel.org >> Cc: linux-omap@vger.kernel.org >> >> Daniel Lezcano (29): >> thermal/core: Add a generic thermal_zone_get_trip() function >> thermal/sysfs: Always expose hysteresis attributes >> thermal/core: Add a generic thermal_zone_set_trip() function >> thermal/core/governors: Use thermal_zone_get_trip() instead of ops >> functions >> thermal/of: Use generic thermal_zone_get_trip() function >> thermal/of: Remove unused functions >> thermal/drivers/exynos: Use generic thermal_zone_get_trip() function >> thermal/drivers/exynos: of_thermal_get_ntrips() >> thermal/drivers/exynos: Replace of_thermal_is_trip_valid() by >> thermal_zone_get_trip() >> thermal/drivers/tegra: Use generic thermal_zone_get_trip() function >> thermal/drivers/uniphier: Use generic thermal_zone_get_trip() function >> thermal/drivers/hisi: Use generic thermal_zone_get_trip() function >> thermal/drivers/qcom: Use generic thermal_zone_get_trip() function >> thermal/drivers/armada: Use generic thermal_zone_get_trip() function >> thermal/drivers/rcar_gen3: Use the generic function to get the number >> of trips >> thermal/of: Remove of_thermal_get_ntrips() >> thermal/of: Remove of_thermal_is_trip_valid() >> thermal/of: Remove of_thermal_set_trip_hyst() >> thermal/of: Remove of_thermal_get_crit_temp() >> thermal/drivers/st: Use generic trip points >> thermal/drivers/imx: Use generic thermal_zone_get_trip() function >> thermal/drivers/rcar: Use generic thermal_zone_get_trip() function >> thermal/drivers/broadcom: Use generic thermal_zone_get_trip() function >> thermal/drivers/da9062: Use generic thermal_zone_get_trip() function >> thermal/drivers/ti: Remove unused macros ti_thermal_get_trip_value() / >> ti_thermal_trip_is_valid() >> thermal/drivers/acerhdf: Use generic thermal_zone_get_trip() function >> thermal/drivers/cxgb4: Use generic thermal_zone_get_trip() function >> thermal/intel/int340x: Replace parameter to simplify >> thermal/drivers/intel: Use generic thermal_zone_get_trip() function > > I've tested this v8 patchset after fixing the issue with Exynos TMU with > https://lore.kernel.org/all/20221003132943.1383065-1-daniel.lezcano@linaro.org/ > patch and I got the following lockdep warning on all Exynos-based boards: > > ====================================================== > WARNING: possible circular locking dependency detected > 6.0.0-rc1-00083-ge5c9d117223e #12945 Not tainted > ------------------------------------------------------ > swapper/0/1 is trying to acquire lock: > c1ce66b0 (&data->lock#2){+.+.}-{3:3}, at: exynos_get_temp+0x3c/0xc8 > > but task is already holding lock: > c2979b94 (&tz->lock){+.+.}-{3:3}, at: > thermal_zone_device_update.part.0+0x3c/0x528 > > which lock already depends on the new lock. Investigating ... -- Linaro.org │ Open source software for ARM SoCs Follow Linaro: Facebook | Twitter | Blog 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 C1A85C433FE for ; Mon, 3 Oct 2022 15:37:47 +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-Type: Content-Transfer-Encoding:List-Subscribe:List-Help:List-Post:List-Archive: List-Unsubscribe:List-Id:In-Reply-To:From:References:Cc:To:Subject: MIME-Version:Date:Message-ID:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=ANc1G7rbFZIOEZ8Gv8uj2PceovgbrxX6uBiroOW3+ok=; b=Y/D95+nyhJxQyd jXJ6fP1FOaBZRWZwrPcbfG//eynMxJ7RR78PyhgPZN6YDrEVlZa9NBPtIpxUbD2chcGgaleWLzLpi KqPTOYRvzE8qIbuouC5pUsN7grNyuRCc+VqSzXsHmXZWvgW2AhOVYsU21+qOdo7r9LksxxjJ56j44 sesPjvrpLDeYaVEEF5MVRPiOdl/NfOVlaWGpl4Rz4wtRLXr5cGjVMZs3iaeQa69Jedesqxw+vsqub IcWgNvAWbozzqGCyVrTw0+8XGuBAYVQwzrbTUDn9ELCwwFhzKZYSHe/qOLp4Fp5RTsvqrYGHxAod5 LgFmedCGWwJaT9pGgowg==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1ofNUp-006UoL-6e; Mon, 03 Oct 2022 15:36:43 +0000 Received: from mail-wr1-x433.google.com ([2a00:1450:4864:20::433]) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1ofNUk-006Um3-Ti for linux-arm-kernel@lists.infradead.org; Mon, 03 Oct 2022 15:36:41 +0000 Received: by mail-wr1-x433.google.com with SMTP id j16so5383023wrh.5 for ; Mon, 03 Oct 2022 08:36:37 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=content-transfer-encoding:in-reply-to:from:references:cc:to :content-language:subject:user-agent:mime-version:date:message-id :from:to:cc:subject:date; bh=XNKN62ufy1+xZwjokTiFAK6DG0fkYs2uyoDmdXUsmfk=; b=joStem3d8drVJs049ako4kuE59txaO6NDwV0bfhPO1a6au6KSg1jl9JsQbZC3bw7u+ FD6FayZuGqdzNjFvhzr644aHDEG6eCiaS9OElKxDfveQgku8qAOD+P94IxzfUncnx8IO RK+0MVu0VdhcKkFmQsLSyILE5TNyJbkDMhEFSgk6kG9xiR+G48J4fbd7Ydqu9lfNyuxm tvzmrPwJsIDRpFq4+XQKhrZjD3+bkaJPRtm2Df97oP5CxhB+whhXaMyK76P9RB4KrQx9 WR8EWkAW9tn/Zis7k+FaXmzNAPD5b79QWJRpBzgishcYEQtk6m/FkQliHjtVn56Kmtc7 3OuA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:in-reply-to:from:references:cc:to :content-language:subject:user-agent:mime-version:date:message-id :x-gm-message-state:from:to:cc:subject:date; bh=XNKN62ufy1+xZwjokTiFAK6DG0fkYs2uyoDmdXUsmfk=; b=0mHczcfgmsIcHUe/+G50jZDEe30+ki0cxn7rkSIXjdg9HZFhZh6xw3n8KOkxtSxpgP lY/B6zSuVWpkTWdJ/CdZcwDOJCpomADsczVqN5pAKUU1yh+2Se5E++wbfCEyb69fVHCV Vz7IS5Wd/aeiCJWJBTSwlloq6sN4hpDlQw4+txUeJbdU3to+BrtIJNuhNiY56cTspggQ 7WJV6xrjlNRt2Q3x9NoF8CVaoNa3Sn32BJkJjDscUHIuWT14B/GdMAAr6FyTiwMAQ6WI gX/M3NrJ/O8dehq38vH+yOn7GnDlATrQjhfC30EL6g0nXfLJezKPWGTdHgrSw3VVw9mM tttQ== X-Gm-Message-State: ACrzQf2V4xs8ommb15GpfT6lxMbYzyGPL2RKXAchNTEbRKor9bmkFh3z XyRa2psgDGBKkaeJ4dqv2c0NRg== X-Google-Smtp-Source: AMsMyM5sZ5raF+DNJ/cTSf5EVIWxvlZeClNcXX2TDk8N8PojssLE59qDPC1gOPTXuAj69kjJPYFesg== X-Received: by 2002:a05:6000:1c0e:b0:22e:2c39:1da6 with SMTP id ba14-20020a0560001c0e00b0022e2c391da6mr7285770wrb.588.1664811396754; Mon, 03 Oct 2022 08:36:36 -0700 (PDT) Received: from ?IPV6:2a05:6e02:1041:c10:f3a:9f5e:1605:a75a? ([2a05:6e02:1041:c10:f3a:9f5e:1605:a75a]) by smtp.googlemail.com with ESMTPSA id v17-20020a5d43d1000000b0022e049586c5sm8599784wrr.28.2022.10.03.08.36.34 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Mon, 03 Oct 2022 08:36:36 -0700 (PDT) Message-ID: Date: Mon, 3 Oct 2022 17:36:34 +0200 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101 Thunderbird/91.11.0 Subject: Re: [PATCH v8 00/29] Rework the trip points creation Content-Language: en-US To: Marek Szyprowski , rafael@kernel.org Cc: linux-kernel@vger.kernel.org, linux-pm@vger.kernel.org, rui.zhang@intel.com, Broadcom Kernel Team , Support Opensource , Pengutronix Kernel Team , NXP Linux Team , Andy Gross , Bartlomiej Zolnierkiewicz , Krzysztof Kozlowski , Alim Akhtar , netdev@vger.kernel.org, platform-driver-x86@vger.kernel.org, linux-rpi-kernel@lists.infradead.org, linux-arm-kernel@lists.infradead.org, linux-arm-msm@vger.kernel.org, linux-renesas-soc@vger.kernel.org, linux-samsung-soc@vger.kernel.org, linux-tegra@vger.kernel.org, linux-omap@vger.kernel.org References: <20221003092602.1323944-1-daniel.lezcano@linaro.org> <8cdd1927-da38-c23e-fa75-384694724b1c@samsung.com> From: Daniel Lezcano In-Reply-To: <8cdd1927-da38-c23e-fa75-384694724b1c@samsung.com> X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20221003_083638_994414_D094A769 X-CRM114-Status: GOOD ( 32.17 ) 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-Transfer-Encoding: base64 Content-Type: text/plain; charset="utf-8"; Format="flowed" Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org T24gMDMvMTAvMjAyMiAxNjoxMCwgTWFyZWsgU3p5cHJvd3NraSB3cm90ZToKPiBIaSBEYW5pZWws Cj4gCj4gT24gMDMuMTAuMjAyMiAxMToyNSwgRGFuaWVsIExlemNhbm8gd3JvdGU6Cj4+IFRoaXMg d29yayBpcyB0aGUgcHJlLXJlcXVpc2l0ZSBvZiBoYW5kbGluZyBjb3JyZWN0bHkgd2hlbiB0aGUg dHJpcAo+PiBwb2ludCBhcmUgY3Jvc3NlZC4gRm9yIHRoYXQgd2UgbmVlZCB0byByZXdvcmsgaG93 IHRoZSB0cmlwIHBvaW50cyBhcmUKPj4gZGVjbGFyZWQgYW5kIGFzc2lnbmVkIHRvIGEgdGhlcm1h bCB6b25lLgo+Pgo+PiBFdmVuIGlmIGl0IGFwcGVhcnMgdG8gYmUgYSBjb21tb24gc2Vuc2UgdG8g aGF2ZSB0aGUgdHJpcCBwb2ludHMgYmVpbmcKPj4gb3JkZXJlZCwgdGhpcyBubyBndWFyYW50ZWUg bmVpdGhlciBkb2N1bWVudGF0aW9uIHRlbGxpbmcgdGhhdCBpcyB0aGUKPj4gY2FzZS4KPj4KPj4g T25lIHNvbHV0aW9uIGNvdWxkIGhhdmUgYmVlbiB0byBjcmVhdGUgYW4gb3JkZXJlZCBhcnJheSBv ZiB0cmlwcyBidWlsdAo+PiB3aGVuIHJlZ2lzdGVyaW5nIHRoZSB0aGVybWFsIHpvbmUgYnkgY2Fs bGluZyB0aGUgZGlmZmVyZW50IGdldF90cmlwKgo+PiBvcHMuIEhvd2V2ZXIgdGhvc2Ugb3BzIHJl Y2VpdmUgYSB0aGVybWFsIHpvbmUgcG9pbnRlciB3aGljaCBpcyBub3QKPj4ga25vd24gYXMgaXQg aXMgaW4gdGhlIHByb2Nlc3Mgb2YgY3JlYXRpbmcgaXQuCj4+Cj4+IFRoaXMgY3ljbGljIGRlcGVu ZGVuY3kgc2hvd3Mgd2UgaGF2ZSB0byByZXdvcmsgaG93IHdlIG1hbmFnZSB0aGUgdHJpcAo+PiBw b2ludHMuCj4+Cj4+IEFjdHVhbGx5LCBhbGwgdGhlIHRyaXAgcG9pbnRzIGRlZmluaXRpb24gY2Fu IGJlIGNvbW1vbiB0byB0aGUgYmFja2VuZAo+PiBzZW5zb3IgZHJpdmVycyBhbmQgd2UgY2FuIGZh Y3RvciBvdXQgdGhlIHRoZXJtYWwgdHJpcCBzdHJ1Y3R1cmUgaW4gYWxsCj4+IG9mIHRoZW0uCj4+ Cj4+IFRoZW4sIGFzIHdlIHJlZ2lzdGVyIHRoZSB0aGVybWFsIHRyaXBzIGFycmF5LCB0aGV5IHdp bGwgYmUgYXZhaWxhYmxlCj4+IGluIHRoZSB0aGVybWFsIHpvbmUgc3RydWN0dXJlIGFuZCBhIGNv cmUgZnVuY3Rpb24gY2FuIHJldHVybiB0aGUgdHJpcAo+PiBnaXZlbiBpdHMgaWQuCj4+Cj4+IFRo ZSBnZXRfdHJpcF8qIG9wcyB3b24ndCBiZSBuZWVkZWQgYW55bW9yZSBhbmQgY291bGQgYmUgcmVt b3ZlZC4gVGhlCj4+IHJlc3VsdGluZyBjb2RlIHdpbGwgYmUgYW5vdGhlciBzdGVwIGZvcndhcmQg dG8gYSBzZWxmIGVuY2Fwc3VsYXRlZAo+PiBnZW5lcmljIHRoZXJtYWwgZnJhbWV3b3JrLgo+Pgo+ PiBNb3N0IG9mIHRoZSBkcml2ZXJzIGNhbiBiZSBjb252ZXJ0ZWQgbW9yZSBvciBsZXNzIGVhc2ls eS4gVGhpcyBzZXJpZXMKPj4gZG9lcyBhIGZpcnN0IHJvdW5kIHdpdGggbW9zdCBvZiB0aGUgZHJp dmVycy4gU29tZSByZW1haW4gYW5kIHdpbGwgYmUKPj4gY29udmVydGVkIGJ1dCB3aXRoIGEgc21h bGxlciBzZXQgb2YgY2hhbmdlcyBhcyB0aGUgY29udmVyc2lvbiBpcyBhIGJpdAo+PiBtb3JlIGNv bXBsZXguCj4+Cj4+IENoYW5nZWxvZzoKPj4gdjg6Cj4+IC0gUHJldHR5IG9uZWxpbmUgY2hhbmdl IGFuZCBwYXJlbnRoZXNpcyByZW1vdmFsIChSYWZhZWwpCj4+IC0gQ29sbGVjdGVkIHRhZ3MKPj4g djc6Cj4+IC0gQWRkZWQgbWlzc2luZyByZXR1cm4gMCBpbiB0aGUgeDg2X3BrZ190ZW1wIGRyaXZl cgo+PiB2NjoKPj4gLSBJbXByb3ZlZCB0aGUgY29kZSBmb3IgdGhlIGdldF9jcml0X3RlbXAoKSBm dW5jdGlvbiBhcyBzdWdnZXN0ZWQgYnkKPj4gUmFmYWVsCj4+IC0gUmVtb3ZlZCBpbm5lciBwYXJl bnRoZXNpcyBpbiB0aGUgc2V0X3RyaXBfdGVtcCgpIGZ1bmN0aW9uIGFuZCBpbnZlcnQgdGhlCj4+ IGNvbmRpdGlvbnMuIENoZWNrIHRoZSB0eXBlIG9mIHRoZSB0cmlwIHBvaW50IGlzIHVuY2hhbmdl ZAo+PiAtIEZvbGRlZCBwYXRjaCA0IHdpdGggMQo+PiAtIEFkZCBwZXIgdGhlcm1hbCB6b25lIGlu Zm8gbWVzc2FnZSBpbiB0aGUgYmFuZy1iYW5nIGdvdmVybm9yCj4+IC0gRm9sZGVkIHRoZSBmaXgg Zm9yIGFuIHVuaW5pdGlhbGl6ZWQgdmFyaWFibGUgaW4KPj4gaW50MzQweF90aGVybWFsX3pvbmVf YWRkKCkKPj4gdjU6Cj4+IC0gRml4ZWQgYSBkZWFkbG9jayB3aGVuIGNhbGxpbmcgdGhlcm1hbF96 b25lX2dldF90cmlwKCkgd2hpbGUKPj4gaGFuZGxpbmcgdGhlIHRoZXJtYWwgem9uZSBsb2NrCj4+ IC0gUmVtb3ZlIGFuIGV4dHJhIGxpbmUgaW4gdGhlIHN5c2ZzIGNoYW5nZQo+PiAtIENvbGxlY3Rl ZCB0YWdzCj4+IHY0Ogo+PiAtIFJlbW92ZSBleHRyYSBsaW5lcyBvbiBleHlub3MgY2hhbmdlcyBh cyByZXBvcnRlZCBieSBLcnp5c3p0b2YgS296bG93c2tpCj4+IC0gQ29sbGVjdGVkIHRhZ3MKPj4g djM6Cj4+IC0gUmVvcmcgdGhlIHNlcmllcyB0byBiZSBnaXQtYmlzZWN0IHNhZmUKPj4gLSBBZGRl ZCB0aGUgc2V0X3RyaXAgZ2VuZXJpYyBmdW5jdGlvbgo+PiAtIEFkZGVkIHRoZSBnZXRfY3JpdF90 ZW1wIGdlbmVyaWMgZnVuY3Rpb24KPj4gLSBSZW1vdmVkIG1vcmUgZGVhZCBjb2RlIGluIHRoZSB0 aGVybWFsLW9mCj4+IC0gRml4ZWQgdGhlIGV4eW5vcyBjaGFuZ2Vsb2cKPj4gLSBGaXhlZCB0aGUg ZXJyb3IgY2hlY2sgZm9yIHRoZSBleHlub3MgZHJpdmVycwo+PiAtIENvbGxlY3RlZCB0YWdzCj4+ IHYyOgo+PiAtIEFkZGVkIG1pc3NpbmcgRVhQT1JUX1NZTUJPTF9HUEwoKSBmb3IgdGhlcm1hbF96 b25lX2dldF90cmlwKCkKPj4gLSBSZW1vdmVkIHRhYiB3aGl0ZXNwYWNlIGluIHRoZSBhY2VyaGRm IGRyaXZlcgo+PiAtIENvbGxlY3RlZCB0YWdzCj4+Cj4+IENjOiBSYWp1IFJhbmdvanUgPHJhanVy QGNoZWxzaW8uY29tPgo+PiBDYzogIkRhdmlkIFMuIE1pbGxlciIgPGRhdmVtQGRhdmVtbG9mdC5u ZXQ+Cj4+IENjOiBFcmljIER1bWF6ZXQgPGVkdW1hemV0QGdvb2dsZS5jb20+Cj4+IENjOiBKYWt1 YiBLaWNpbnNraSA8a3ViYUBrZXJuZWwub3JnPgo+PiBDYzogUGFvbG8gQWJlbmkgPHBhYmVuaUBy ZWRoYXQuY29tPgo+PiBDYzogUGV0ZXIgS2Flc3RsZSA8cGV0ZXJAcGlpZS5uZXQ+Cj4+IENjOiBI YW5zIGRlIEdvZWRlIDxoZGVnb2VkZUByZWRoYXQuY29tPgo+PiBDYzogTWFyayBHcm9zcyA8bWFy a2dyb3NzQGtlcm5lbC5vcmc+Cj4+IENjOiBNaXF1ZWwgUmF5bmFsIDxtaXF1ZWwucmF5bmFsQGJv b3RsaW4uY29tPgo+PiBDYzogIlJhZmFlbCBKLiBXeXNvY2tpIiA8cmFmYWVsQGtlcm5lbC5vcmc+ Cj4+IENjOiBEYW5pZWwgTGV6Y2FubyA8ZGFuaWVsLmxlemNhbm9AbGluYXJvLm9yZz4KPj4gQ2M6 IEFtaXQgS3VjaGVyaWEgPGFtaXRrQGtlcm5lbC5vcmc+Cj4+IENjOiBaaGFuZyBSdWkgPHJ1aS56 aGFuZ0BpbnRlbC5jb20+Cj4+IENjOiBOaWNvbGFzIFNhZW56IEp1bGllbm5lIDxuc2FlbnpAa2Vy bmVsLm9yZz4KPj4gQ2M6IEJyb2FkY29tIEtlcm5lbCBUZWFtIDxiY20ta2VybmVsLWZlZWRiYWNr LWxpc3RAYnJvYWRjb20uY29tPgo+PiBDYzogRmxvcmlhbiBGYWluZWxsaSA8Zi5mYWluZWxsaUBn bWFpbC5jb20+Cj4+IENjOiBSYXkgSnVpIDxyanVpQGJyb2FkY29tLmNvbT4KPj4gQ2M6IFNjb3R0 IEJyYW5kZW4gPHNicmFuZGVuQGJyb2FkY29tLmNvbT4KPj4gQ2M6IFN1cHBvcnQgT3BlbnNvdXJj ZSA8c3VwcG9ydC5vcGVuc291cmNlQGRpYXNlbWkuY29tPgo+PiBDYzogTHVrYXN6IEx1YmEgPGx1 a2Fzei5sdWJhQGFybS5jb20+Cj4+IENjOiBTaGF3biBHdW8gPHNoYXduZ3VvQGtlcm5lbC5vcmc+ Cj4+IENjOiBTYXNjaGEgSGF1ZXIgPHMuaGF1ZXJAcGVuZ3V0cm9uaXguZGU+Cj4+IENjOiBQZW5n dXRyb25peCBLZXJuZWwgVGVhbSA8a2VybmVsQHBlbmd1dHJvbml4LmRlPgo+PiBDYzogRmFiaW8g RXN0ZXZhbSA8ZmVzdGV2YW1AZ21haWwuY29tPgo+PiBDYzogTlhQIExpbnV4IFRlYW0gPGxpbnV4 LWlteEBueHAuY29tPgo+PiBDYzogVGhhcmEgR29waW5hdGggPHRoYXJhLmdvcGluYXRoQGxpbmFy by5vcmc+Cj4+IENjOiBBbmR5IEdyb3NzIDxhZ3Jvc3NAa2VybmVsLm9yZz4KPj4gQ2M6IEJqb3Ju IEFuZGVyc3NvbiA8Ympvcm4uYW5kZXJzc29uQGxpbmFyby5vcmc+Cj4+IENjOiAiTmlrbGFzIFPD tmRlcmx1bmQiIDxuaWtsYXMuc29kZXJsdW5kQHJhZ25hdGVjaC5zZT4KPj4gQ2M6IEJhcnRsb21p ZWogWm9sbmllcmtpZXdpY3ogPGJ6b2xuaWVyQGdtYWlsLmNvbT4KPj4gQ2M6IEtyenlzenRvZiBL b3psb3dza2kgPGtyenlzenRvZi5rb3psb3dza2lAbGluYXJvLm9yZz4KPj4gQ2M6IEFsaW0gQWto dGFyIDxhbGltLmFraHRhckBzYW1zdW5nLmNvbT4KPj4gQ2M6IFRoaWVycnkgUmVkaW5nIDx0aGll cnJ5LnJlZGluZ0BnbWFpbC5jb20+Cj4+IENjOiBKb25hdGhhbiBIdW50ZXIgPGpvbmF0aGFuaEBu dmlkaWEuY29tPgo+PiBDYzogRWR1YXJkbyBWYWxlbnRpbiA8ZWR1YmV6dmFsQGdtYWlsLmNvbT4K Pj4gQ2M6IEtlZXJ0aHkgPGota2VlcnRoeUB0aS5jb20+Cj4+IENjOiBLdW5paGlrbyBIYXlhc2hp IDxoYXlhc2hpLmt1bmloaWtvQHNvY2lvbmV4dC5jb20+Cj4+IENjOiBNYXNhbWkgSGlyYW1hdHN1 IDxtaGlyYW1hdEBrZXJuZWwub3JnPgo+PiBDYzogQW50b2luZSBUZW5hcnQgPGF0ZW5hcnRAa2Vy bmVsLm9yZz4KPj4gQ2M6IFNyaW5pdmFzIFBhbmRydXZhZGEgPHNyaW5pdmFzLnBhbmRydXZhZGFA bGludXguaW50ZWwuY29tPgo+PiBDYzogRG1pdHJ5IE9zaXBlbmtvIDxkaWdldHhAZ21haWwuY29t Pgo+PiBDYzogbmV0ZGV2QHZnZXIua2VybmVsLm9yZwo+PiBDYzogbGludXgta2VybmVsQHZnZXIu a2VybmVsLm9yZwo+PiBDYzogcGxhdGZvcm0tZHJpdmVyLXg4NkB2Z2VyLmtlcm5lbC5vcmcKPj4g Q2M6IGxpbnV4LXBtQHZnZXIua2VybmVsLm9yZwo+PiBDYzogbGludXgtcnBpLWtlcm5lbEBsaXN0 cy5pbmZyYWRlYWQub3JnCj4+IENjOiBsaW51eC1hcm0ta2VybmVsQGxpc3RzLmluZnJhZGVhZC5v cmcKPj4gQ2M6IGxpbnV4LWFybS1tc21Admdlci5rZXJuZWwub3JnCj4+IENjOiBsaW51eC1yZW5l c2FzLXNvY0B2Z2VyLmtlcm5lbC5vcmcKPj4gQ2M6IGxpbnV4LXNhbXN1bmctc29jQHZnZXIua2Vy bmVsLm9yZwo+PiBDYzogbGludXgtdGVncmFAdmdlci5rZXJuZWwub3JnCj4+IENjOiBsaW51eC1v bWFwQHZnZXIua2VybmVsLm9yZwo+Pgo+PiBEYW5pZWwgTGV6Y2FubyAoMjkpOgo+PiB0aGVybWFs L2NvcmU6IEFkZCBhIGdlbmVyaWMgdGhlcm1hbF96b25lX2dldF90cmlwKCkgZnVuY3Rpb24KPj4g dGhlcm1hbC9zeXNmczogQWx3YXlzIGV4cG9zZSBoeXN0ZXJlc2lzIGF0dHJpYnV0ZXMKPj4gdGhl cm1hbC9jb3JlOiBBZGQgYSBnZW5lcmljIHRoZXJtYWxfem9uZV9zZXRfdHJpcCgpIGZ1bmN0aW9u Cj4+IHRoZXJtYWwvY29yZS9nb3Zlcm5vcnM6IFVzZSB0aGVybWFsX3pvbmVfZ2V0X3RyaXAoKSBp bnN0ZWFkIG9mIG9wcwo+PiBmdW5jdGlvbnMKPj4gdGhlcm1hbC9vZjogVXNlIGdlbmVyaWMgdGhl cm1hbF96b25lX2dldF90cmlwKCkgZnVuY3Rpb24KPj4gdGhlcm1hbC9vZjogUmVtb3ZlIHVudXNl ZCBmdW5jdGlvbnMKPj4gdGhlcm1hbC9kcml2ZXJzL2V4eW5vczogVXNlIGdlbmVyaWMgdGhlcm1h bF96b25lX2dldF90cmlwKCkgZnVuY3Rpb24KPj4gdGhlcm1hbC9kcml2ZXJzL2V4eW5vczogb2Zf dGhlcm1hbF9nZXRfbnRyaXBzKCkKPj4gdGhlcm1hbC9kcml2ZXJzL2V4eW5vczogUmVwbGFjZSBv Zl90aGVybWFsX2lzX3RyaXBfdmFsaWQoKSBieQo+PiB0aGVybWFsX3pvbmVfZ2V0X3RyaXAoKQo+ PiB0aGVybWFsL2RyaXZlcnMvdGVncmE6IFVzZSBnZW5lcmljIHRoZXJtYWxfem9uZV9nZXRfdHJp cCgpIGZ1bmN0aW9uCj4+IHRoZXJtYWwvZHJpdmVycy91bmlwaGllcjogVXNlIGdlbmVyaWMgdGhl cm1hbF96b25lX2dldF90cmlwKCkgZnVuY3Rpb24KPj4gdGhlcm1hbC9kcml2ZXJzL2hpc2k6IFVz ZSBnZW5lcmljIHRoZXJtYWxfem9uZV9nZXRfdHJpcCgpIGZ1bmN0aW9uCj4+IHRoZXJtYWwvZHJp dmVycy9xY29tOiBVc2UgZ2VuZXJpYyB0aGVybWFsX3pvbmVfZ2V0X3RyaXAoKSBmdW5jdGlvbgo+ PiB0aGVybWFsL2RyaXZlcnMvYXJtYWRhOiBVc2UgZ2VuZXJpYyB0aGVybWFsX3pvbmVfZ2V0X3Ry aXAoKSBmdW5jdGlvbgo+PiB0aGVybWFsL2RyaXZlcnMvcmNhcl9nZW4zOiBVc2UgdGhlIGdlbmVy aWMgZnVuY3Rpb24gdG8gZ2V0IHRoZSBudW1iZXIKPj4gb2YgdHJpcHMKPj4gdGhlcm1hbC9vZjog UmVtb3ZlIG9mX3RoZXJtYWxfZ2V0X250cmlwcygpCj4+IHRoZXJtYWwvb2Y6IFJlbW92ZSBvZl90 aGVybWFsX2lzX3RyaXBfdmFsaWQoKQo+PiB0aGVybWFsL29mOiBSZW1vdmUgb2ZfdGhlcm1hbF9z ZXRfdHJpcF9oeXN0KCkKPj4gdGhlcm1hbC9vZjogUmVtb3ZlIG9mX3RoZXJtYWxfZ2V0X2NyaXRf dGVtcCgpCj4+IHRoZXJtYWwvZHJpdmVycy9zdDogVXNlIGdlbmVyaWMgdHJpcCBwb2ludHMKPj4g dGhlcm1hbC9kcml2ZXJzL2lteDogVXNlIGdlbmVyaWMgdGhlcm1hbF96b25lX2dldF90cmlwKCkg ZnVuY3Rpb24KPj4gdGhlcm1hbC9kcml2ZXJzL3JjYXI6IFVzZSBnZW5lcmljIHRoZXJtYWxfem9u ZV9nZXRfdHJpcCgpIGZ1bmN0aW9uCj4+IHRoZXJtYWwvZHJpdmVycy9icm9hZGNvbTogVXNlIGdl bmVyaWMgdGhlcm1hbF96b25lX2dldF90cmlwKCkgZnVuY3Rpb24KPj4gdGhlcm1hbC9kcml2ZXJz L2RhOTA2MjogVXNlIGdlbmVyaWMgdGhlcm1hbF96b25lX2dldF90cmlwKCkgZnVuY3Rpb24KPj4g dGhlcm1hbC9kcml2ZXJzL3RpOiBSZW1vdmUgdW51c2VkIG1hY3JvcyB0aV90aGVybWFsX2dldF90 cmlwX3ZhbHVlKCkgLwo+PiB0aV90aGVybWFsX3RyaXBfaXNfdmFsaWQoKQo+PiB0aGVybWFsL2Ry aXZlcnMvYWNlcmhkZjogVXNlIGdlbmVyaWMgdGhlcm1hbF96b25lX2dldF90cmlwKCkgZnVuY3Rp b24KPj4gdGhlcm1hbC9kcml2ZXJzL2N4Z2I0OiBVc2UgZ2VuZXJpYyB0aGVybWFsX3pvbmVfZ2V0 X3RyaXAoKSBmdW5jdGlvbgo+PiB0aGVybWFsL2ludGVsL2ludDM0MHg6IFJlcGxhY2UgcGFyYW1l dGVyIHRvIHNpbXBsaWZ5Cj4+IHRoZXJtYWwvZHJpdmVycy9pbnRlbDogVXNlIGdlbmVyaWMgdGhl cm1hbF96b25lX2dldF90cmlwKCkgZnVuY3Rpb24KPiAKPiBJJ3ZlIHRlc3RlZCB0aGlzIHY4IHBh dGNoc2V0IGFmdGVyIGZpeGluZyB0aGUgaXNzdWUgd2l0aCBFeHlub3MgVE1VIHdpdGgKPiBodHRw czovL2xvcmUua2VybmVsLm9yZy9hbGwvMjAyMjEwMDMxMzI5NDMuMTM4MzA2NS0xLWRhbmllbC5s ZXpjYW5vQGxpbmFyby5vcmcvCj4gcGF0Y2ggYW5kIEkgZ290IHRoZSBmb2xsb3dpbmcgbG9ja2Rl cCB3YXJuaW5nIG9uIGFsbCBFeHlub3MtYmFzZWQgYm9hcmRzOgo+Cj4gPT09PT09PT09PT09PT09 PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09Cj4gV0FSTklORzogcG9zc2li bGUgY2lyY3VsYXIgbG9ja2luZyBkZXBlbmRlbmN5IGRldGVjdGVkCj4gNi4wLjAtcmMxLTAwMDgz LWdlNWM5ZDExNzIyM2UgIzEyOTQ1IE5vdCB0YWludGVkCj4gLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tCj4gc3dhcHBlci8wLzEgaXMgdHJ5aW5n IHRvIGFjcXVpcmUgbG9jazoKPiBjMWNlNjZiMCAoJmRhdGEtPmxvY2sjMil7Ky4rLn0tezM6M30s IGF0OiBleHlub3NfZ2V0X3RlbXArMHgzYy8weGM4Cj4gCj4gYnV0IHRhc2sgaXMgYWxyZWFkeSBo b2xkaW5nIGxvY2s6Cj4gYzI5NzliOTQgKCZ0ei0+bG9jayl7Ky4rLn0tezM6M30sIGF0Ogo+IHRo ZXJtYWxfem9uZV9kZXZpY2VfdXBkYXRlLnBhcnQuMCsweDNjLzB4NTI4Cj4gCj4gd2hpY2ggbG9j ayBhbHJlYWR5IGRlcGVuZHMgb24gdGhlIG5ldyBsb2NrLgoKSW52ZXN0aWdhdGluZyAuLi4KCgoK LS0gCjxodHRwOi8vd3d3LmxpbmFyby5vcmcvPiBMaW5hcm8ub3JnIOKUgiBPcGVuIHNvdXJjZSBz b2Z0d2FyZSBmb3IgQVJNIFNvQ3MKCkZvbGxvdyBMaW5hcm86ICA8aHR0cDovL3d3dy5mYWNlYm9v ay5jb20vcGFnZXMvTGluYXJvPiBGYWNlYm9vayB8CjxodHRwOi8vdHdpdHRlci5jb20vIyEvbGlu YXJvb3JnPiBUd2l0dGVyIHwKPGh0dHA6Ly93d3cubGluYXJvLm9yZy9saW5hcm8tYmxvZy8+IEJs b2cKCl9fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fCmxpbnV4 LWFybS1rZXJuZWwgbWFpbGluZyBsaXN0CmxpbnV4LWFybS1rZXJuZWxAbGlzdHMuaW5mcmFkZWFk Lm9yZwpodHRwOi8vbGlzdHMuaW5mcmFkZWFkLm9yZy9tYWlsbWFuL2xpc3RpbmZvL2xpbnV4LWFy bS1rZXJuZWwK