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 D8C25C4321E for ; Sun, 4 Dec 2022 07:10:56 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229883AbiLDHKy (ORCPT ); Sun, 4 Dec 2022 02:10:54 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:57476 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229703AbiLDHKu (ORCPT ); Sun, 4 Dec 2022 02:10:50 -0500 Received: from out30-8.freemail.mail.aliyun.com (out30-8.freemail.mail.aliyun.com [115.124.30.8]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 85B4013CE9; Sat, 3 Dec 2022 23:10:45 -0800 (PST) X-Alimail-AntiSpam: AC=PASS;BC=-1|-1;BR=01201311R531e4;CH=green;DM=||false|;DS=||;FP=0|-1|-1|-1|0|-1|-1|-1;HT=ay29a033018045176;MF=renyu.zj@linux.alibaba.com;NM=1;PH=DS;RN=20;SR=0;TI=SMTPD_---0VWJBzxR_1670137838; Received: from 192.168.0.101(mailfrom:renyu.zj@linux.alibaba.com fp:SMTPD_---0VWJBzxR_1670137838) by smtp.aliyun-inc.com; Sun, 04 Dec 2022 15:10:40 +0800 Message-ID: Date: Sun, 4 Dec 2022 15:10:37 +0800 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:102.0) Gecko/20100101 Thunderbird/102.4.1 Subject: Re: [PATCH v3 5/6] perf vendor events arm64: Add PE utilization metrics for neoverse-n2 To: Ian Rogers Cc: John Garry , Xing Zhengjun , Will Deacon , James Clark , Mike Leach , Leo Yan , linux-arm-kernel@lists.infradead.org, linux-perf-users@vger.kernel.org, linux-kernel@vger.kernel.org, Peter Zijlstra , Ingo Molnar , Arnaldo Carvalho de Melo , Mark Rutland , Alexander Shishkin , Jiri Olsa , Namhyung Kim , Andrew Kilroy , Shuai Xue , Zhuo Song References: <1668411720-3581-1-git-send-email-renyu.zj@linux.alibaba.com> <1669310088-13482-1-git-send-email-renyu.zj@linux.alibaba.com> <1669310088-13482-6-git-send-email-renyu.zj@linux.alibaba.com> <1a7fc9da-2589-1835-716f-d52027f0ecda@linux.alibaba.com> From: Jing Zhang In-Reply-To: Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org 在 2022/12/3 上午4:05, Ian Rogers 写道: > On Thu, Dec 1, 2022 at 3:08 AM Jing Zhang wrote: >> >> >> >> 在 2022/12/1 上午2:58, Ian Rogers 写道: >>> On Thu, Nov 24, 2022 at 9:15 AM Jing Zhang wrote: >>>> >>>> Add PE utilization related metrics. >>>> >>>> Signed-off-by: Jing Zhang >>>> --- >>>> .../arch/arm64/arm/neoverse-n2/metrics.json | 45 ++++++++++++++++++++++ >>>> 1 file changed, 45 insertions(+) >>>> >>>> diff --git a/tools/perf/pmu-events/arch/arm64/arm/neoverse-n2/metrics.json b/tools/perf/pmu-events/arch/arm64/arm/neoverse-n2/metrics.json >>>> index 23c7d62..7b54819 100644 >>>> --- a/tools/perf/pmu-events/arch/arm64/arm/neoverse-n2/metrics.json >>>> +++ b/tools/perf/pmu-events/arch/arm64/arm/neoverse-n2/metrics.json >>>> @@ -189,5 +189,50 @@ >>>> "MetricGroup": "Branch", >>>> "MetricName": "branch_miss_pred_rate", >>>> "ScaleUnit": "100%" >>>> + }, >>>> + { >>>> + "MetricExpr": "instructions / CPU_CYCLES", >>>> + "PublicDescription": "The average number of instructions executed for each cycle.", >>>> + "BriefDescription": "Instructions per cycle", >>>> + "MetricGroup": "PEutilization", >>>> + "MetricName": "ipc" >>>> + }, >>> >>> A related useful metric is percentage of peak, so if the peak IPC is 8 >>> (usually a constant related to the number of functional units) then >>> you can just compute the ratio of IPC with this. >>> >> >> Glad to discuss these with you. >> The peak ipc value of neoverse-n2 is 5. Maybe I should add an ipc_rate metric? >> >>>> + { >>>> + "MetricExpr": "INST_RETIRED / CPU_CYCLES", >>>> + "PublicDescription": "Architecturally executed Instructions Per Cycle (IPC)", >>>> + "BriefDescription": "Architecturally executed Instructions Per Cycle (IPC)", >>> >>> >>> The duplicated descriptions are unnecessary. Drop the public one for >>> consistency with what we do for Intel: >>> https://github.com/intel/perfmon/blob/main/scripts/create_perf_json.py#L299 >>> >> >> Sounds good, will do. >> >>>> + "MetricGroup": "PEutilization", >>>> + "MetricName": "retired_ipc" >>>> + }, >>>> + { >>>> + "MetricExpr": "INST_SPEC / CPU_CYCLES", >>>> + "PublicDescription": "Speculatively executed Instructions Per Cycle (IPC)", >>>> + "BriefDescription": "Speculatively executed Instructions Per Cycle (IPC)", >>>> + "MetricGroup": "PEutilization", >>>> + "MetricName": "spec_ipc" >>>> + }, >>>> + { >>>> + "MetricExpr": "OP_RETIRED / OP_SPEC", >>>> + "PublicDescription": "Fraction of operations retired", >>>> + "BriefDescription": "Fraction of operations retired", >>> >>> Would instructions be clearer than operations here? >>> >> >> operation and instruction are different. OP_RETIRED counts any operation (not instruction) >> that has been architecturally executed, For example, speculatively executed operations that >> have been abandoned for a branch mispredict will not be counted. So I think operation might >> be more accurate. > > Thanks, I see this note in the N2 PMU guide: > > """ > For PMU event definitions, some events specifically count > instructions, while other events count micro-operations (which are > referred to as operations). Please be aware of the use of the word > "operations" or "instructions" in the event description. > """ > > From your explanation I wasn't sure if operation was a superset of > instruction that included both retired and speculated ones, or whether > operation had another meaning. I don't see operation being used in the > micro-operation sense elsewhere in the ARM perf json, I think > micro-operation is more consistent and also clearer: > https://git.kernel.org/pub/scm/linux/kernel/git/acme/linux.git/tree/tools/perf/pmu-events/arch/arm64/arm/cortex-a75/pipeline.json?h=perf/core#n27 > > Perhaps the description can be something like: > Of all the micro-operations issued, what percentage were retired. A > lower number indicates bad speculation. > > An alternate way to add documentation is the perf wiki's glossary: > https://perf.wiki.kernel.org/index.php/Glossary > > I added the Neoverse N2 PMU Guide to: > https://perf.wiki.kernel.org/index.php/Useful_Links#Manuals > Thanks. The operation here is micro-operation, perhaps it is more accurate to change it to micro-operation. Description of op_retired and op_spec: https://git.kernel.org/pub/scm/linux/kernel/git/acme/linux.git/tree/tools/perf/pmu-events/arch/arm64/common-and-microarch.json?h=perf/core#n315 The event of op_retired counts Micro-operation architecturally executed. The counter counts each operation counted by OP_SPEC that would be executed in a simple sequential execution of the program. The event of op_spec counts Micro-operation speculatively executed. The counter counts the number of operations executed by the processing element, including those that are executed speculatively and would not be executed in a simple sequential execution of the program. So "op_retired/op_spec" is indeed "of all the micro-operations issued, what percentage were retired". But not "a lower number indicates bad speculation". I think "retired" here means "committed". In the N2 PMU guide: """ If the branch is mispredicted, and the instructions are speculatively executed, they will not be considered architecturally executed. The Arm® Architecture Reference Manual also refers to architecturally executed instructions as “retired” or “committed”. Speculatively executed instructions that are not architecturally executed will be abandoned; that is, their results will be discarded and not counted as part of the program flow. """ > >>>> + "MetricGroup": "PEutilization", >>>> + "MetricName": "retired_rate", >>>> + "ScaleUnit": "100%" >>>> + }, >>>> + { >>>> + "MetricExpr": "1 - OP_RETIRED / OP_SPEC", >>> >>> Should OP_RETIRED be greater than OP_SPEC? In which case won't this >>> metric be negative? >>> >> >> OP_RETIRED will not be greater than OP_SPEC. OP_SPEC counts any operation that has been >> speculatively executed. OP_SPEC is a superset of the OP_RETIRED event. There is a >> description about OP_SPEC and OP_RETIRED in this neoverse-n2 document. >> Link: https://documentation-service.arm.com/static/62cfe21e31ea212bb6627393?token= >> >>>> + "PublicDescription": "Fraction of operations wasted", >>>> + "BriefDescription": "Fraction of operations wasted", >>>> + "MetricGroup": "PEutilization", >>>> + "MetricName": "wasted_rate", >>>> + "ScaleUnit": "100%" >>>> + }, >>>> + { >>>> + "MetricExpr": "OP_RETIRED / OP_SPEC * (1 - (STALL_SLOT - CPU_CYCLES) / (CPU_CYCLES * 5))", >>>> + "PublicDescription": "Utilization of CPU", >>>> + "BriefDescription": "Utilization of CPU", >>> >>> Some more detail in the description would be useful. >>> >> >> Ok, I'll describe it in more detail. CPU_utilization reflects the truly effective ratio of operation >> executed by the CPU, which means that misprediction and stall are not included. Note that stall_slot >> minus cpu_cycles is a correction to the stall_slot error count. >> >>>> + "MetricGroup": "PEutilization", >>>> + "MetricName": "cpu_utilization", >>>> + "ScaleUnit": "100%" >>>> } >>>> ] >>>> -- >>>> 1.8.3.1 >>>> 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 6CDABC4321E for ; Sun, 4 Dec 2022 07:12:27 +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: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=V+wRRc8jjEU8jfQUXhlkc4YSq0FcHCw9Iy1BW6hpwEQ=; b=k5fSjc5KZZUiM8 /gFwQQ+En2D9NOAtmRuX7TngjOVRGmt2bJ1OaVTN9sLhbeRCUcZ02/oE0BENIfhrej7iHDR+dfLl6 tf7Se0JL8fZxcJSkJcFKLi8izHlz/X2LVPBa0N4t6dI0O0kLB85RSnC4cSXOQswGUloyjBhPRdH95 nT3xgJKCrixX/AYGTxqC94lt17Q5BQ/Xf/aEG/TSl2/dM51ugkJDIbAmXQF/tVpA/qOhkrQaAhI8m mk3B/AWWyHDMOfRN7dlWML3qbb+qNPp8fOE8vVP+AcNHT5Y0jZTAPMTJDLoGvgM5CVHThxXy4Ny4n iEe+opRiJoRf1MV87NiA==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1p1j9K-006rFi-9o; Sun, 04 Dec 2022 07:10:54 +0000 Received: from out30-44.freemail.mail.aliyun.com ([115.124.30.44]) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1p1j9D-006rEu-QU for linux-arm-kernel@lists.infradead.org; Sun, 04 Dec 2022 07:10:51 +0000 X-Alimail-AntiSpam: AC=PASS;BC=-1|-1;BR=01201311R531e4;CH=green;DM=||false|;DS=||;FP=0|-1|-1|-1|0|-1|-1|-1;HT=ay29a033018045176;MF=renyu.zj@linux.alibaba.com;NM=1;PH=DS;RN=20;SR=0;TI=SMTPD_---0VWJBzxR_1670137838; Received: from 192.168.0.101(mailfrom:renyu.zj@linux.alibaba.com fp:SMTPD_---0VWJBzxR_1670137838) by smtp.aliyun-inc.com; Sun, 04 Dec 2022 15:10:40 +0800 Message-ID: Date: Sun, 4 Dec 2022 15:10:37 +0800 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:102.0) Gecko/20100101 Thunderbird/102.4.1 Subject: Re: [PATCH v3 5/6] perf vendor events arm64: Add PE utilization metrics for neoverse-n2 To: Ian Rogers Cc: John Garry , Xing Zhengjun , Will Deacon , James Clark , Mike Leach , Leo Yan , linux-arm-kernel@lists.infradead.org, linux-perf-users@vger.kernel.org, linux-kernel@vger.kernel.org, Peter Zijlstra , Ingo Molnar , Arnaldo Carvalho de Melo , Mark Rutland , Alexander Shishkin , Jiri Olsa , Namhyung Kim , Andrew Kilroy , Shuai Xue , Zhuo Song References: <1668411720-3581-1-git-send-email-renyu.zj@linux.alibaba.com> <1669310088-13482-1-git-send-email-renyu.zj@linux.alibaba.com> <1669310088-13482-6-git-send-email-renyu.zj@linux.alibaba.com> <1a7fc9da-2589-1835-716f-d52027f0ecda@linux.alibaba.com> From: Jing Zhang In-Reply-To: X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20221203_231048_785673_EC103A5C X-CRM114-Status: GOOD ( 23.68 ) 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 CgrlnKggMjAyMi8xMi8zIOS4iuWNiDQ6MDUsIElhbiBSb2dlcnMg5YaZ6YGTOgo+IE9uIFRodSwg RGVjIDEsIDIwMjIgYXQgMzowOCBBTSBKaW5nIFpoYW5nIDxyZW55dS56akBsaW51eC5hbGliYWJh LmNvbT4gd3JvdGU6Cj4+Cj4+Cj4+Cj4+IOWcqCAyMDIyLzEyLzEg5LiK5Y2IMjo1OCwgSWFuIFJv Z2VycyDlhpnpgZM6Cj4+PiBPbiBUaHUsIE5vdiAyNCwgMjAyMiBhdCA5OjE1IEFNIEppbmcgWmhh bmcgPHJlbnl1LnpqQGxpbnV4LmFsaWJhYmEuY29tPiB3cm90ZToKPj4+Pgo+Pj4+IEFkZCBQRSB1 dGlsaXphdGlvbiByZWxhdGVkIG1ldHJpY3MuCj4+Pj4KPj4+PiBTaWduZWQtb2ZmLWJ5OiBKaW5n IFpoYW5nIDxyZW55dS56akBsaW51eC5hbGliYWJhLmNvbT4KPj4+PiAtLS0KPj4+PiAgLi4uL2Fy Y2gvYXJtNjQvYXJtL25lb3ZlcnNlLW4yL21ldHJpY3MuanNvbiAgICAgICAgfCA0NSArKysrKysr KysrKysrKysrKysrKysrCj4+Pj4gIDEgZmlsZSBjaGFuZ2VkLCA0NSBpbnNlcnRpb25zKCspCj4+ Pj4KPj4+PiBkaWZmIC0tZ2l0IGEvdG9vbHMvcGVyZi9wbXUtZXZlbnRzL2FyY2gvYXJtNjQvYXJt L25lb3ZlcnNlLW4yL21ldHJpY3MuanNvbiBiL3Rvb2xzL3BlcmYvcG11LWV2ZW50cy9hcmNoL2Fy bTY0L2FybS9uZW92ZXJzZS1uMi9tZXRyaWNzLmpzb24KPj4+PiBpbmRleCAyM2M3ZDYyLi43YjU0 ODE5IDEwMDY0NAo+Pj4+IC0tLSBhL3Rvb2xzL3BlcmYvcG11LWV2ZW50cy9hcmNoL2FybTY0L2Fy bS9uZW92ZXJzZS1uMi9tZXRyaWNzLmpzb24KPj4+PiArKysgYi90b29scy9wZXJmL3BtdS1ldmVu dHMvYXJjaC9hcm02NC9hcm0vbmVvdmVyc2UtbjIvbWV0cmljcy5qc29uCj4+Pj4gQEAgLTE4OSw1 ICsxODksNTAgQEAKPj4+PiAgICAgICAgICAiTWV0cmljR3JvdXAiOiAiQnJhbmNoIiwKPj4+PiAg ICAgICAgICAiTWV0cmljTmFtZSI6ICJicmFuY2hfbWlzc19wcmVkX3JhdGUiLAo+Pj4+ICAgICAg ICAgICJTY2FsZVVuaXQiOiAiMTAwJSIKPj4+PiArICAgIH0sCj4+Pj4gKyAgICB7Cj4+Pj4gKyAg ICAgICAgIk1ldHJpY0V4cHIiOiAiaW5zdHJ1Y3Rpb25zIC8gQ1BVX0NZQ0xFUyIsCj4+Pj4gKyAg ICAgICAgIlB1YmxpY0Rlc2NyaXB0aW9uIjogIlRoZSBhdmVyYWdlIG51bWJlciBvZiBpbnN0cnVj dGlvbnMgZXhlY3V0ZWQgZm9yIGVhY2ggY3ljbGUuIiwKPj4+PiArICAgICAgICAiQnJpZWZEZXNj cmlwdGlvbiI6ICJJbnN0cnVjdGlvbnMgcGVyIGN5Y2xlIiwKPj4+PiArICAgICAgICAiTWV0cmlj R3JvdXAiOiAiUEV1dGlsaXphdGlvbiIsCj4+Pj4gKyAgICAgICAgIk1ldHJpY05hbWUiOiAiaXBj Igo+Pj4+ICsgICAgfSwKPj4+Cj4+PiBBIHJlbGF0ZWQgdXNlZnVsIG1ldHJpYyBpcyBwZXJjZW50 YWdlIG9mIHBlYWssIHNvIGlmIHRoZSBwZWFrIElQQyBpcyA4Cj4+PiAodXN1YWxseSBhIGNvbnN0 YW50IHJlbGF0ZWQgdG8gdGhlIG51bWJlciBvZiBmdW5jdGlvbmFsIHVuaXRzKSB0aGVuCj4+PiB5 b3UgY2FuIGp1c3QgY29tcHV0ZSB0aGUgcmF0aW8gb2YgSVBDIHdpdGggdGhpcy4KPj4+Cj4+Cj4+ IEdsYWQgdG8gZGlzY3VzcyB0aGVzZSB3aXRoIHlvdS4KPj4gVGhlIHBlYWsgaXBjIHZhbHVlIG9m IG5lb3ZlcnNlLW4yIGlzIDUuIE1heWJlIEkgc2hvdWxkIGFkZCBhbiBpcGNfcmF0ZSBtZXRyaWM/ Cj4+Cj4+Pj4gKyAgICB7Cj4+Pj4gKyAgICAgICAgIk1ldHJpY0V4cHIiOiAiSU5TVF9SRVRJUkVE IC8gQ1BVX0NZQ0xFUyIsCj4+Pj4gKyAgICAgICAgIlB1YmxpY0Rlc2NyaXB0aW9uIjogIkFyY2hp dGVjdHVyYWxseSBleGVjdXRlZCBJbnN0cnVjdGlvbnMgUGVyIEN5Y2xlIChJUEMpIiwKPj4+PiAr ICAgICAgICAiQnJpZWZEZXNjcmlwdGlvbiI6ICJBcmNoaXRlY3R1cmFsbHkgZXhlY3V0ZWQgSW5z dHJ1Y3Rpb25zIFBlciBDeWNsZSAoSVBDKSIsCj4+Pgo+Pj4KPj4+IFRoZSBkdXBsaWNhdGVkIGRl c2NyaXB0aW9ucyBhcmUgdW5uZWNlc3NhcnkuIERyb3AgdGhlIHB1YmxpYyBvbmUgZm9yCj4+PiBj b25zaXN0ZW5jeSB3aXRoIHdoYXQgd2UgZG8gZm9yIEludGVsOgo+Pj4gaHR0cHM6Ly9naXRodWIu Y29tL2ludGVsL3BlcmZtb24vYmxvYi9tYWluL3NjcmlwdHMvY3JlYXRlX3BlcmZfanNvbi5weSNM Mjk5Cj4+Pgo+Pgo+PiBTb3VuZHMgZ29vZCwgd2lsbCBkby4KPj4KPj4+PiArICAgICAgICAiTWV0 cmljR3JvdXAiOiAiUEV1dGlsaXphdGlvbiIsCj4+Pj4gKyAgICAgICAgIk1ldHJpY05hbWUiOiAi cmV0aXJlZF9pcGMiCj4+Pj4gKyAgICB9LAo+Pj4+ICsgICAgewo+Pj4+ICsgICAgICAgICJNZXRy aWNFeHByIjogIklOU1RfU1BFQyAvIENQVV9DWUNMRVMiLAo+Pj4+ICsgICAgICAgICJQdWJsaWNE ZXNjcmlwdGlvbiI6ICJTcGVjdWxhdGl2ZWx5IGV4ZWN1dGVkIEluc3RydWN0aW9ucyBQZXIgQ3lj bGUgKElQQykiLAo+Pj4+ICsgICAgICAgICJCcmllZkRlc2NyaXB0aW9uIjogIlNwZWN1bGF0aXZl bHkgZXhlY3V0ZWQgSW5zdHJ1Y3Rpb25zIFBlciBDeWNsZSAoSVBDKSIsCj4+Pj4gKyAgICAgICAg Ik1ldHJpY0dyb3VwIjogIlBFdXRpbGl6YXRpb24iLAo+Pj4+ICsgICAgICAgICJNZXRyaWNOYW1l IjogInNwZWNfaXBjIgo+Pj4+ICsgICAgfSwKPj4+PiArICAgIHsKPj4+PiArICAgICAgICAiTWV0 cmljRXhwciI6ICJPUF9SRVRJUkVEIC8gT1BfU1BFQyIsCj4+Pj4gKyAgICAgICAgIlB1YmxpY0Rl c2NyaXB0aW9uIjogIkZyYWN0aW9uIG9mIG9wZXJhdGlvbnMgcmV0aXJlZCIsCj4+Pj4gKyAgICAg ICAgIkJyaWVmRGVzY3JpcHRpb24iOiAiRnJhY3Rpb24gb2Ygb3BlcmF0aW9ucyByZXRpcmVkIiwK Pj4+Cj4+PiBXb3VsZCBpbnN0cnVjdGlvbnMgYmUgY2xlYXJlciB0aGFuIG9wZXJhdGlvbnMgaGVy ZT8KPj4+Cj4+Cj4+IG9wZXJhdGlvbiBhbmQgaW5zdHJ1Y3Rpb24gYXJlIGRpZmZlcmVudC4gT1Bf UkVUSVJFRCBjb3VudHMgYW55IG9wZXJhdGlvbiAobm90IGluc3RydWN0aW9uKQo+PiB0aGF0IGhh cyBiZWVuIGFyY2hpdGVjdHVyYWxseSBleGVjdXRlZCwgRm9yIGV4YW1wbGUsIHNwZWN1bGF0aXZl bHkgZXhlY3V0ZWQgb3BlcmF0aW9ucyB0aGF0Cj4+IGhhdmUgYmVlbiBhYmFuZG9uZWQgZm9yIGEg YnJhbmNoIG1pc3ByZWRpY3Qgd2lsbCBub3QgYmUgY291bnRlZC4gU28gSSB0aGluayBvcGVyYXRp b24gbWlnaHQKPj4gYmUgbW9yZSBhY2N1cmF0ZS4KPiAKPiBUaGFua3MsIEkgc2VlIHRoaXMgbm90 ZSBpbiB0aGUgTjIgUE1VIGd1aWRlOgo+IAo+ICIiIgo+IEZvciBQTVUgZXZlbnQgZGVmaW5pdGlv bnMsIHNvbWUgZXZlbnRzIHNwZWNpZmljYWxseSBjb3VudAo+IGluc3RydWN0aW9ucywgd2hpbGUg b3RoZXIgZXZlbnRzIGNvdW50IG1pY3JvLW9wZXJhdGlvbnMgKHdoaWNoIGFyZQo+IHJlZmVycmVk IHRvIGFzIG9wZXJhdGlvbnMpLiBQbGVhc2UgYmUgYXdhcmUgb2YgdGhlIHVzZSBvZiB0aGUgd29y ZAo+ICJvcGVyYXRpb25zIiBvciAiaW5zdHJ1Y3Rpb25zIiBpbiB0aGUgZXZlbnQgZGVzY3JpcHRp b24uCj4gIiIiCj4gCj4gRnJvbSB5b3VyIGV4cGxhbmF0aW9uIEkgd2Fzbid0IHN1cmUgaWYgb3Bl cmF0aW9uIHdhcyBhIHN1cGVyc2V0IG9mCj4gaW5zdHJ1Y3Rpb24gdGhhdCBpbmNsdWRlZCBib3Ro IHJldGlyZWQgYW5kIHNwZWN1bGF0ZWQgb25lcywgb3Igd2hldGhlcgo+IG9wZXJhdGlvbiBoYWQg YW5vdGhlciBtZWFuaW5nLiBJIGRvbid0IHNlZSBvcGVyYXRpb24gYmVpbmcgdXNlZCBpbiB0aGUK PiBtaWNyby1vcGVyYXRpb24gc2Vuc2UgZWxzZXdoZXJlIGluIHRoZSBBUk0gcGVyZiBqc29uLCBJ IHRoaW5rCj4gbWljcm8tb3BlcmF0aW9uIGlzIG1vcmUgY29uc2lzdGVudCBhbmQgYWxzbyBjbGVh cmVyOgo+IGh0dHBzOi8vZ2l0Lmtlcm5lbC5vcmcvcHViL3NjbS9saW51eC9rZXJuZWwvZ2l0L2Fj bWUvbGludXguZ2l0L3RyZWUvdG9vbHMvcGVyZi9wbXUtZXZlbnRzL2FyY2gvYXJtNjQvYXJtL2Nv cnRleC1hNzUvcGlwZWxpbmUuanNvbj9oPXBlcmYvY29yZSNuMjcKPiAKPiBQZXJoYXBzIHRoZSBk ZXNjcmlwdGlvbiBjYW4gYmUgc29tZXRoaW5nIGxpa2U6Cj4gT2YgYWxsIHRoZSBtaWNyby1vcGVy YXRpb25zIGlzc3VlZCwgd2hhdCBwZXJjZW50YWdlIHdlcmUgcmV0aXJlZC4gQQo+IGxvd2VyIG51 bWJlciBpbmRpY2F0ZXMgYmFkIHNwZWN1bGF0aW9uLgo+IAo+IEFuIGFsdGVybmF0ZSB3YXkgdG8g YWRkIGRvY3VtZW50YXRpb24gaXMgdGhlIHBlcmYgd2lraSdzIGdsb3NzYXJ5Ogo+IGh0dHBzOi8v cGVyZi53aWtpLmtlcm5lbC5vcmcvaW5kZXgucGhwL0dsb3NzYXJ5Cj4gCj4gSSBhZGRlZCB0aGUg TmVvdmVyc2UgTjIgUE1VIEd1aWRlIHRvOgo+IGh0dHBzOi8vcGVyZi53aWtpLmtlcm5lbC5vcmcv aW5kZXgucGhwL1VzZWZ1bF9MaW5rcyNNYW51YWxzCj4gCgpUaGFua3MuCgpUaGUgb3BlcmF0aW9u IGhlcmUgaXMgbWljcm8tb3BlcmF0aW9uLCBwZXJoYXBzIGl0IGlzIG1vcmUgYWNjdXJhdGUgdG8g Y2hhbmdlIGl0IHRvIG1pY3JvLW9wZXJhdGlvbi4KCkRlc2NyaXB0aW9uIG9mIG9wX3JldGlyZWQg YW5kIG9wX3NwZWM6Cmh0dHBzOi8vZ2l0Lmtlcm5lbC5vcmcvcHViL3NjbS9saW51eC9rZXJuZWwv Z2l0L2FjbWUvbGludXguZ2l0L3RyZWUvdG9vbHMvcGVyZi9wbXUtZXZlbnRzL2FyY2gvYXJtNjQv Y29tbW9uLWFuZC1taWNyb2FyY2guanNvbj9oPXBlcmYvY29yZSNuMzE1CgpUaGUgZXZlbnQgb2Yg b3BfcmV0aXJlZCBjb3VudHMgTWljcm8tb3BlcmF0aW9uIGFyY2hpdGVjdHVyYWxseSBleGVjdXRl ZC4gVGhlIGNvdW50ZXIgY291bnRzIGVhY2gKb3BlcmF0aW9uIGNvdW50ZWQgYnkgT1BfU1BFQyB0 aGF0IHdvdWxkIGJlIGV4ZWN1dGVkIGluIGEgc2ltcGxlIHNlcXVlbnRpYWwgZXhlY3V0aW9uIG9m IHRoZSBwcm9ncmFtLgoKVGhlIGV2ZW50IG9mIG9wX3NwZWMgY291bnRzIE1pY3JvLW9wZXJhdGlv biBzcGVjdWxhdGl2ZWx5IGV4ZWN1dGVkLiBUaGUgY291bnRlciBjb3VudHMgdGhlIG51bWJlcgpv ZiBvcGVyYXRpb25zIGV4ZWN1dGVkIGJ5IHRoZSBwcm9jZXNzaW5nIGVsZW1lbnQsIGluY2x1ZGlu ZyB0aG9zZSB0aGF0IGFyZSBleGVjdXRlZCBzcGVjdWxhdGl2ZWx5CmFuZCB3b3VsZCBub3QgYmUg ZXhlY3V0ZWQgaW4gYSBzaW1wbGUgc2VxdWVudGlhbCBleGVjdXRpb24gb2YgdGhlIHByb2dyYW0u CgpTbyAib3BfcmV0aXJlZC9vcF9zcGVjIiBpcyBpbmRlZWQgIm9mIGFsbCB0aGUgbWljcm8tb3Bl cmF0aW9ucyBpc3N1ZWQsIHdoYXQgcGVyY2VudGFnZSB3ZXJlIHJldGlyZWQiLgpCdXQgbm90ICJh IGxvd2VyIG51bWJlciBpbmRpY2F0ZXMgYmFkIHNwZWN1bGF0aW9uIi4gSSB0aGluayAicmV0aXJl ZCIgaGVyZSBtZWFucyAiY29tbWl0dGVkIi4KCkluIHRoZSBOMiBQTVUgZ3VpZGU6CiIiIgpJZiB0 aGUgYnJhbmNoIGlzIG1pc3ByZWRpY3RlZCwgYW5kIHRoZSBpbnN0cnVjdGlvbnMgYXJlIHNwZWN1 bGF0aXZlbHkgZXhlY3V0ZWQsIHRoZXkgd2lsbCBub3QgYmUKY29uc2lkZXJlZCBhcmNoaXRlY3R1 cmFsbHkgZXhlY3V0ZWQuIFRoZSBBcm3CriBBcmNoaXRlY3R1cmUgUmVmZXJlbmNlIE1hbnVhbCBh bHNvIHJlZmVycyB0bwphcmNoaXRlY3R1cmFsbHkgZXhlY3V0ZWQgaW5zdHJ1Y3Rpb25zIGFzIOKA nHJldGlyZWTigJ0gb3Ig4oCcY29tbWl0dGVk4oCdLiBTcGVjdWxhdGl2ZWx5IGV4ZWN1dGVkIGlu c3RydWN0aW9ucwp0aGF0IGFyZSBub3QgYXJjaGl0ZWN0dXJhbGx5IGV4ZWN1dGVkIHdpbGwgYmUg YWJhbmRvbmVkOyB0aGF0IGlzLCB0aGVpciByZXN1bHRzIHdpbGwgYmUgZGlzY2FyZGVkIGFuZApu b3QgY291bnRlZCBhcyBwYXJ0IG9mIHRoZSBwcm9ncmFtIGZsb3cuCiIiIgoKPiAKPj4+PiArICAg ICAgICAiTWV0cmljR3JvdXAiOiAiUEV1dGlsaXphdGlvbiIsCj4+Pj4gKyAgICAgICAgIk1ldHJp Y05hbWUiOiAicmV0aXJlZF9yYXRlIiwKPj4+PiArICAgICAgICAiU2NhbGVVbml0IjogIjEwMCUi Cj4+Pj4gKyAgICB9LAo+Pj4+ICsgICAgewo+Pj4+ICsgICAgICAgICJNZXRyaWNFeHByIjogIjEg LSBPUF9SRVRJUkVEIC8gT1BfU1BFQyIsCj4+Pgo+Pj4gU2hvdWxkIE9QX1JFVElSRUQgYmUgZ3Jl YXRlciB0aGFuIE9QX1NQRUM/IEluIHdoaWNoIGNhc2Ugd29uJ3QgdGhpcwo+Pj4gbWV0cmljIGJl IG5lZ2F0aXZlPwo+Pj4KPj4KPj4gT1BfUkVUSVJFRCB3aWxsIG5vdCBiZSBncmVhdGVyIHRoYW4g T1BfU1BFQy4gT1BfU1BFQyBjb3VudHMgYW55IG9wZXJhdGlvbiB0aGF0IGhhcyBiZWVuCj4+IHNw ZWN1bGF0aXZlbHkgZXhlY3V0ZWQuIE9QX1NQRUMgaXMgYSBzdXBlcnNldCBvZiB0aGUgT1BfUkVU SVJFRCBldmVudC4gVGhlcmUgaXMgYQo+PiBkZXNjcmlwdGlvbiBhYm91dCBPUF9TUEVDIGFuZCBP UF9SRVRJUkVEIGluIHRoaXMgbmVvdmVyc2UtbjIgZG9jdW1lbnQuCj4+IExpbms6IGh0dHBzOi8v ZG9jdW1lbnRhdGlvbi1zZXJ2aWNlLmFybS5jb20vc3RhdGljLzYyY2ZlMjFlMzFlYTIxMmJiNjYy NzM5Mz90b2tlbj0KPj4KPj4+PiArICAgICAgICAiUHVibGljRGVzY3JpcHRpb24iOiAiRnJhY3Rp b24gb2Ygb3BlcmF0aW9ucyB3YXN0ZWQiLAo+Pj4+ICsgICAgICAgICJCcmllZkRlc2NyaXB0aW9u IjogIkZyYWN0aW9uIG9mIG9wZXJhdGlvbnMgd2FzdGVkIiwKPj4+PiArICAgICAgICAiTWV0cmlj R3JvdXAiOiAiUEV1dGlsaXphdGlvbiIsCj4+Pj4gKyAgICAgICAgIk1ldHJpY05hbWUiOiAid2Fz dGVkX3JhdGUiLAo+Pj4+ICsgICAgICAgICJTY2FsZVVuaXQiOiAiMTAwJSIKPj4+PiArICAgIH0s Cj4+Pj4gKyAgICB7Cj4+Pj4gKyAgICAgICAgIk1ldHJpY0V4cHIiOiAiT1BfUkVUSVJFRCAvIE9Q X1NQRUMgKiAoMSAtIChTVEFMTF9TTE9UIC0gQ1BVX0NZQ0xFUykgLyAoQ1BVX0NZQ0xFUyAqIDUp KSIsCj4+Pj4gKyAgICAgICAgIlB1YmxpY0Rlc2NyaXB0aW9uIjogIlV0aWxpemF0aW9uIG9mIENQ VSIsCj4+Pj4gKyAgICAgICAgIkJyaWVmRGVzY3JpcHRpb24iOiAiVXRpbGl6YXRpb24gb2YgQ1BV IiwKPj4+Cj4+PiBTb21lIG1vcmUgZGV0YWlsIGluIHRoZSBkZXNjcmlwdGlvbiB3b3VsZCBiZSB1 c2VmdWwuCj4+Pgo+Pgo+PiBPaywgSSdsbCBkZXNjcmliZSBpdCBpbiBtb3JlIGRldGFpbC4gQ1BV X3V0aWxpemF0aW9uIHJlZmxlY3RzIHRoZSB0cnVseSBlZmZlY3RpdmUgcmF0aW8gb2Ygb3BlcmF0 aW9uCj4+IGV4ZWN1dGVkIGJ5IHRoZSBDUFUsIHdoaWNoIG1lYW5zIHRoYXQgbWlzcHJlZGljdGlv biBhbmQgc3RhbGwgYXJlIG5vdCBpbmNsdWRlZC4gTm90ZSB0aGF0IHN0YWxsX3Nsb3QKPj4gbWlu dXMgY3B1X2N5Y2xlcyBpcyBhIGNvcnJlY3Rpb24gdG8gdGhlIHN0YWxsX3Nsb3QgZXJyb3IgY291 bnQuCj4+Cj4+Pj4gKyAgICAgICAgIk1ldHJpY0dyb3VwIjogIlBFdXRpbGl6YXRpb24iLAo+Pj4+ ICsgICAgICAgICJNZXRyaWNOYW1lIjogImNwdV91dGlsaXphdGlvbiIsCj4+Pj4gKyAgICAgICAg IlNjYWxlVW5pdCI6ICIxMDAlIgo+Pj4+ICAgICAgfQo+Pj4+ICBdCj4+Pj4gLS0KPj4+PiAxLjgu My4xCj4+Pj4KCl9fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f CmxpbnV4LWFybS1rZXJuZWwgbWFpbGluZyBsaXN0CmxpbnV4LWFybS1rZXJuZWxAbGlzdHMuaW5m cmFkZWFkLm9yZwpodHRwOi8vbGlzdHMuaW5mcmFkZWFkLm9yZy9tYWlsbWFuL2xpc3RpbmZvL2xp bnV4LWFybS1rZXJuZWwK