From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-ed1-f50.google.com (mail-ed1-f50.google.com [209.85.208.50]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id B8C47651AE for ; Thu, 11 Apr 2024 01:38:46 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.208.50 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1712799528; cv=none; b=T9PDGoHMWwtyxoilQ4NUueL3+IYc/wjEGp1l7m4zF8IcRYnmroSqiFGBbF5JEhRSgF4GxHSpuvzKDodNHLK6uB8OttA/MjDtUBEGOinCIle29hKoYUy/muYj7h8TwPqTnQGgCkVkdFL84uNqBS3t3j1Fx4bCYzweNnifGwBi6SE= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1712799528; c=relaxed/simple; bh=MCCB7pBGruwYdMlJw665wOkukt6AwC+vb1JVK5cpg54=; h=MIME-Version:References:In-Reply-To:From:Date:Message-ID:Subject: To:Cc:Content-Type; b=Qu1SL882ZT84GnENdvFPEw+Gaz/BWDVf1TWGDWHBFprhEt6W/W5dY+Q+4XzoHwuIpth9ClVDmpoSR5QqLyl/1ov/ya0zHU+PBgNPVwKFTsmQdH70o3+leoVU1iIDCF8gqYadPUCCSNitWjqyBCmOQdtrqFVFm/CEW/ZlGNiJn7Y= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=gompa.dev; spf=pass smtp.mailfrom=gmail.com; arc=none smtp.client-ip=209.85.208.50 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=gompa.dev Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Received: by mail-ed1-f50.google.com with SMTP id 4fb4d7f45d1cf-56e6acb39d4so4530002a12.1 for ; Wed, 10 Apr 2024 18:38:46 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1712799525; x=1713404325; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=Z5DCUyb/Xc4qjbfnJ52wsfA9f/5eaB6rvPGsloDB4HU=; b=ZCN5BMQQTbCgkQhW7iSFlvidN6AknkEXi64MwDFUTQs3hLVYsio9MmxiZb48G4j3WV GuwVAZ7B4kgXunbWhfzRppJgbHJyKwUP5HIb53I/esbui1BpoIfq+pQYGk3Ky0as9FB5 cBvqeXidlhg4cmXkcPw6UYdifZRIk1Dg0pp5KYbGvBIp6xKsb9daUaHdVk/8/6dvL+Gx Sfl0+dNWbBXXUYGFQ4roThd30v1K7q3afsGiAnm5Oe8IFxzjhi1LA5Fn3wmPb1ANlYTU JWtVseUHp6N2YPuhXmdvY6XMQG+Uk0DBWJKJ7B6tA9IwUfhk+6N8Gd5FZGFwuux45tEs x7ZA== X-Forwarded-Encrypted: i=1; AJvYcCU2Rt7utiPcLDopRIe/dawtL6/2d4B58lLwNZNteyYpnbDpNoPxBdHt6enm/UzPTHqOjZ/02myOgnaUaMtnjMMM1cQob6OOyV1glHxE X-Gm-Message-State: AOJu0YzPd/7OvaHQZtKu+HThGxvYblXhSbKSBO7LXHF0z3fnQq/CU8Wy 1lPaNSUcrcYu6JLTje7GXZ8+lJqL/dVHKhmQ/FV5F/9lkFftZb3ub6qV+VxBsP4= X-Google-Smtp-Source: AGHT+IHlaMb30HuScqnrEz767lWtRNTajx92t6GUFBO//6OL93ng5PArwmzrPJc7q6qWQgovsEKeGw== X-Received: by 2002:a50:d7c6:0:b0:56e:2b31:b111 with SMTP id m6-20020a50d7c6000000b0056e2b31b111mr2978473edj.7.1712799524804; Wed, 10 Apr 2024 18:38:44 -0700 (PDT) Received: from mail-ej1-f44.google.com (mail-ej1-f44.google.com. [209.85.218.44]) by smtp.gmail.com with ESMTPSA id dd15-20020a056402312f00b005689bfe2688sm208271edb.39.2024.04.10.18.38.44 for (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Wed, 10 Apr 2024 18:38:44 -0700 (PDT) Received: by mail-ej1-f44.google.com with SMTP id a640c23a62f3a-a44ad785a44so849182366b.3 for ; Wed, 10 Apr 2024 18:38:44 -0700 (PDT) X-Forwarded-Encrypted: i=1; AJvYcCUDaalCiw2UemOpZyCojOBkv7qzNd+VF0EqbUAgdXkJc7Zz6s8+xSF59KTV8oZcax5yl3n1xNjm/JCu6x7BV8ooqea1wL7OD6/96INw X-Received: by 2002:a17:906:cb8a:b0:a51:d7c8:300c with SMTP id mf10-20020a170906cb8a00b00a51d7c8300cmr2914356ejb.17.1712799503901; Wed, 10 Apr 2024 18:38:23 -0700 (PDT) Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 References: <20240411-tso-v1-0-754f11abfbff@marcan.st> In-Reply-To: <20240411-tso-v1-0-754f11abfbff@marcan.st> From: Neal Gompa Date: Wed, 10 Apr 2024 21:37:47 -0400 X-Gmail-Original-Message-ID: Message-ID: Subject: Re: [PATCH 0/4] arm64: Support the TSO memory model To: Hector Martin Cc: Catalin Marinas , Will Deacon , Marc Zyngier , Mark Rutland , Zayd Qumsieh , Justin Lu , Ryan Houdek , Mark Brown , Ard Biesheuvel , Mateusz Guzik , Anshuman Khandual , Oliver Upton , Miguel Luis , Joey Gouly , Christoph Paasch , Kees Cook , Sami Tolvanen , Baoquan He , Joel Granados , Dawei Li , Andrew Morton , Florent Revest , David Hildenbrand , Stefan Roesch , Andy Chiu , Josh Triplett , Oleg Nesterov , Helge Deller , Zev Weiss , Ondrej Mosnacek , Miguel Ojeda , linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org, Asahi Linux Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable On Wed, Apr 10, 2024 at 8:51=E2=80=AFPM Hector Martin wr= ote: > > x86 CPUs implement a stricter memory modern than ARM64 (TSO). For this > reason, x86 emulation on baseline ARM64 systems requires very expensive > memory model emulation. Having hardware that supports this natively is > therefore very attractive. Such hardware, in fact, exists. This series > adds support for userspace to identify when TSO is available and > toggle it on, if supported. > > Some ARM64 CPUs intrinsically implement the TSO memory model, while > others expose is as an IMPDEF control. Apple Silicon SoCs are in the > latter category. Using TSO for x86 emulation on chips that support it > has been shown to provide a massive performance boost [1]. > > Patch 1 introduces the PR_{SET,GET}_MEM_MODEL userspace control, which > is initially not implemented for any architectures. > > Patch 2 implements it for CPUs which are known, to the best of my > knowledge, to always implement the TSO memory model unconditionally. > This uses the cpufeature mechanism to only enable this if *all* cores in > the system meet the requirements. > > Patch 3 adds the scaffolding necesasry to save/restore the ACTLR_EL1 > register across context switches. This register contains IMPDEF flags > related to CPU execution, and on Apple CPUs this is where the runtime > TSO toggle bit is implemented. Other CPUs could conceivably benefit from > this scaffolding if they also use ACTLR_EL1 for things that could > ostensibly be runtime controlled and context-switched. For this to work, > ACTLR_EL1 must have a uniform layout across all cores in the system. > > Finally, patch 4 implements PR_{SET,GET}_MEM_MODEL for Apple CPUs by > hooking it up to flip the appropriate ACTLR_EL1 bit when the Apple TSO > feature is detected (on all CPUs, which also implies the uniform > ACTLR_EL1 layout). > > This series has been brewing in the downstream Asahi Linux tree for a > while now, and ships to thousands of users. A subset have been using it > with FEX-Emu, which already supports this feature. This rebase on > v6.9-rc1 is only build-tested (all intermediate commits with and without > the config enabled, on ARM64) but I'll update the downstream branch soon > with this version and get it pushed out to users/testers. > > The Apple support works on bare metal and *should* work exactly the same > way on macOS VMs (as alluded to by Zayd in his independent submission [3]= ), > though I haven't personally verified this. KVM support for this is left > for a future patchset. > > (Apologies for the large Cc: list; I want to make sure nobody who got > Cced on Zayd's alternate take is left out of this one.) > > [1] https://fex-emu.com/FEX-2306/ > [2] https://github.com/AsahiLinux/linux/tree/bits/220-tso > [3] https://lore.kernel.org/lkml/20240410211652.16640-1-zayd_qumsieh@appl= e.com/ > > To: Catalin Marinas > To: Will Deacon > To: Marc Zyngier > To: Mark Rutland > Cc: Zayd Qumsieh > Cc: Justin Lu > Cc: Ryan Houdek > Cc: Mark Brown > Cc: Ard Biesheuvel > Cc: Mateusz Guzik > Cc: Anshuman Khandual > Cc: Oliver Upton > Cc: Miguel Luis > Cc: Joey Gouly > Cc: Christoph Paasch > Cc: Kees Cook > Cc: Sami Tolvanen > Cc: Baoquan He > Cc: Joel Granados > Cc: Dawei Li > Cc: Andrew Morton > Cc: Florent Revest > Cc: David Hildenbrand > Cc: Stefan Roesch > Cc: Andy Chiu > Cc: Josh Triplett > Cc: Oleg Nesterov > Cc: Helge Deller > Cc: Zev Weiss > Cc: Ondrej Mosnacek > Cc: Miguel Ojeda > Cc: linux-arm-kernel@lists.infradead.org > Cc: linux-kernel@vger.kernel.org > Cc: Asahi Linux > > Signed-off-by: Hector Martin > --- > Hector Martin (4): > prctl: Introduce PR_{SET,GET}_MEM_MODEL > arm64: Implement PR_{GET,SET}_MEM_MODEL for always-TSO CPUs > arm64: Introduce scaffolding to add ACTLR_EL1 to thread state > arm64: Implement Apple IMPDEF TSO memory model control > > arch/arm64/Kconfig | 14 ++++++ > arch/arm64/include/asm/apple_cpufeature.h | 15 +++++++ > arch/arm64/include/asm/cpufeature.h | 10 +++++ > arch/arm64/include/asm/processor.h | 3 ++ > arch/arm64/kernel/Makefile | 3 +- > arch/arm64/kernel/cpufeature.c | 11 ++--- > arch/arm64/kernel/cpufeature_impdef.c | 61 +++++++++++++++++++++++++= + > arch/arm64/kernel/process.c | 71 +++++++++++++++++++++++++= ++++++ > arch/arm64/kernel/setup.c | 8 ++++ > arch/arm64/tools/cpucaps | 2 + > include/linux/memory_ordering_model.h | 11 +++++ > include/uapi/linux/prctl.h | 5 +++ > kernel/sys.c | 21 +++++++++ > 13 files changed, 229 insertions(+), 6 deletions(-) > --- > base-commit: 4cece764965020c22cff7665b18a012006359095 > change-id: 20240411-tso-e86fdceb94b8 > The series looks good to me. Reviewed-by: Neal Gompa --=20 =E7=9C=9F=E5=AE=9F=E3=81=AF=E3=81=84=E3=81=A4=E3=82=82=E4=B8=80=E3=81=A4=EF= =BC=81/ Always, there's only one truth! 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 CD2FBCD1297 for ; Thu, 11 Apr 2024 01:38:45 +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:Cc:To:Subject:Message-ID:Date:From: In-Reply-To:References:MIME-Version:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=g3QARDtPnncga/ZGaHOruymBOm2T6HmHqOM2kXj5x4A=; b=2CToAnFq/Dqxss 7Cy3QAB/SsWMRBelAd5UhJOXmk7MHNga0uml4BAt7hQYcdu/dIi3b8zXV430B1yEx5o5XpR2Qfgzk ialXo3k4J42MsndkEj50EsAqnlm2QYPTjCT6jPGWBEKKFx2T3P15uEXuTKyZvxEW1Z7U6AVVw3Q3P vpYoIwPMKOSiImtawFXKD7AAtL8JTZliQ7uSNIzzstp+4EGpVSWduxQG3cP27eBPpcTX9tRy4TVYW BRIlLsQVHNKsBpturmpj+cLQNXeUHlFbTqAzQAApbhn6MIUjWr7DVLuQPM1BTapNO+EnlcPN+u/F4 ZmF/WpgevJpIuFHJJhWQ==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.97.1 #2 (Red Hat Linux)) id 1rujOY-00000009rqX-3jly; Thu, 11 Apr 2024 01:38:30 +0000 Received: from mail-ed1-f52.google.com ([209.85.208.52]) by bombadil.infradead.org with esmtps (Exim 4.97.1 #2 (Red Hat Linux)) id 1rujOV-00000009rps-1C6z for linux-arm-kernel@lists.infradead.org; Thu, 11 Apr 2024 01:38:28 +0000 Received: by mail-ed1-f52.google.com with SMTP id 4fb4d7f45d1cf-56e2b3e114fso7708328a12.2 for ; Wed, 10 Apr 2024 18:38:26 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1712799505; x=1713404305; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=Z5DCUyb/Xc4qjbfnJ52wsfA9f/5eaB6rvPGsloDB4HU=; b=cyfhsQi0d1C1bmj9uMV5FOW4yb5YJ0dWzImGeJl+0KZMim9EoGbxn2WqIn1e2nY0J6 5Nh+j/la82UUOPJajwHL+vmVXXAJsrhf95gTYiZZYp+0jZeXSgHIP9OEpjx2T5e9GsYp FoVEskAZS9kVHvmwjpTzS+4KCGdwjGVACjSzE+7GywId3iGFgULgP13tpVusHBeL/Bfz 1nO4iAIBRhtdH4QkGjJ5/yLABXybGrbZiJkYsF3E8bZChjAT9B5jwJu7waHIEuNTUaBg as8kL4LmSRcz7CMIhYYGB72PNVRGxbdetH3dIfFR+VfVhARxcPb92bb0ssWuiE9MEVe8 NTzA== X-Forwarded-Encrypted: i=1; AJvYcCU7cownUsQK62jjuKPCYnZlSXpydjj/BolVQezROYA2eqNXV1c7aeNHHmawL6t+ddGCVZ88IIRJ72kq2QbUuTENB1s17xnBFM1mHdcZEOTqIB7IHkg= X-Gm-Message-State: AOJu0YwZxNSh5wYokgF+08xEpruGEecd3qbct+jyZDsgc0LHmD8YHyYO GfokjSjde976ghFkc/NlbfZVwtY/Fkr4J9+Drdqk3k7m4j/92lFB3smLNyfggZ0= X-Google-Smtp-Source: AGHT+IGkDwhHMe8aUA6qDZyWNs1s/lqOqAB14qAwAnaQhw61xruRDYuEKVaGoJ7abYI56VUpoBeE8A== X-Received: by 2002:a17:906:af8d:b0:a51:95ce:5a04 with SMTP id mj13-20020a170906af8d00b00a5195ce5a04mr2214378ejb.19.1712799504602; Wed, 10 Apr 2024 18:38:24 -0700 (PDT) Received: from mail-ej1-f53.google.com (mail-ej1-f53.google.com. [209.85.218.53]) by smtp.gmail.com with ESMTPSA id c19-20020a170906529300b00a4da28f42f1sm248542ejm.177.2024.04.10.18.38.24 for (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Wed, 10 Apr 2024 18:38:24 -0700 (PDT) Received: by mail-ej1-f53.google.com with SMTP id a640c23a62f3a-a4715991c32so976057266b.1 for ; Wed, 10 Apr 2024 18:38:24 -0700 (PDT) X-Forwarded-Encrypted: i=1; AJvYcCXuqGoo2S+6cZNUfc41knxOXtC058Iu4gI1OZPBJFRbn6oHxOYlIFwgy7CXyK6RHjEty5+pfof8vwSrkFqc7rG+cOw5Pv2LVs2zOMAs5MfTuBwlVD0= X-Received: by 2002:a17:906:cb8a:b0:a51:d7c8:300c with SMTP id mf10-20020a170906cb8a00b00a51d7c8300cmr2914356ejb.17.1712799503901; Wed, 10 Apr 2024 18:38:23 -0700 (PDT) MIME-Version: 1.0 References: <20240411-tso-v1-0-754f11abfbff@marcan.st> In-Reply-To: <20240411-tso-v1-0-754f11abfbff@marcan.st> From: Neal Gompa Date: Wed, 10 Apr 2024 21:37:47 -0400 X-Gmail-Original-Message-ID: Message-ID: Subject: Re: [PATCH 0/4] arm64: Support the TSO memory model To: Hector Martin Cc: Catalin Marinas , Will Deacon , Marc Zyngier , Mark Rutland , Zayd Qumsieh , Justin Lu , Ryan Houdek , Mark Brown , Ard Biesheuvel , Mateusz Guzik , Anshuman Khandual , Oliver Upton , Miguel Luis , Joey Gouly , Christoph Paasch , Kees Cook , Sami Tolvanen , Baoquan He , Joel Granados , Dawei Li , Andrew Morton , Florent Revest , David Hildenbrand , Stefan Roesch , Andy Chiu , Josh Triplett , Oleg Nesterov , Helge Deller , Zev Weiss , Ondrej Mosnacek , Miguel Ojeda , linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org, Asahi Linux X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20240410_183827_355261_DAC55A5C X-CRM114-Status: GOOD ( 35.45 ) 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 T24gV2VkLCBBcHIgMTAsIDIwMjQgYXQgODo1MeKAr1BNIEhlY3RvciBNYXJ0aW4gPG1hcmNhbkBt YXJjYW4uc3Q+IHdyb3RlOgo+Cj4geDg2IENQVXMgaW1wbGVtZW50IGEgc3RyaWN0ZXIgbWVtb3J5 IG1vZGVybiB0aGFuIEFSTTY0IChUU08pLiBGb3IgdGhpcwo+IHJlYXNvbiwgeDg2IGVtdWxhdGlv biBvbiBiYXNlbGluZSBBUk02NCBzeXN0ZW1zIHJlcXVpcmVzIHZlcnkgZXhwZW5zaXZlCj4gbWVt b3J5IG1vZGVsIGVtdWxhdGlvbi4gSGF2aW5nIGhhcmR3YXJlIHRoYXQgc3VwcG9ydHMgdGhpcyBu YXRpdmVseSBpcwo+IHRoZXJlZm9yZSB2ZXJ5IGF0dHJhY3RpdmUuIFN1Y2ggaGFyZHdhcmUsIGlu IGZhY3QsIGV4aXN0cy4gVGhpcyBzZXJpZXMKPiBhZGRzIHN1cHBvcnQgZm9yIHVzZXJzcGFjZSB0 byBpZGVudGlmeSB3aGVuIFRTTyBpcyBhdmFpbGFibGUgYW5kCj4gdG9nZ2xlIGl0IG9uLCBpZiBz dXBwb3J0ZWQuCj4KPiBTb21lIEFSTTY0IENQVXMgaW50cmluc2ljYWxseSBpbXBsZW1lbnQgdGhl IFRTTyBtZW1vcnkgbW9kZWwsIHdoaWxlCj4gb3RoZXJzIGV4cG9zZSBpcyBhcyBhbiBJTVBERUYg Y29udHJvbC4gQXBwbGUgU2lsaWNvbiBTb0NzIGFyZSBpbiB0aGUKPiBsYXR0ZXIgY2F0ZWdvcnku IFVzaW5nIFRTTyBmb3IgeDg2IGVtdWxhdGlvbiBvbiBjaGlwcyB0aGF0IHN1cHBvcnQgaXQKPiBo YXMgYmVlbiBzaG93biB0byBwcm92aWRlIGEgbWFzc2l2ZSBwZXJmb3JtYW5jZSBib29zdCBbMV0u Cj4KPiBQYXRjaCAxIGludHJvZHVjZXMgdGhlIFBSX3tTRVQsR0VUfV9NRU1fTU9ERUwgdXNlcnNw YWNlIGNvbnRyb2wsIHdoaWNoCj4gaXMgaW5pdGlhbGx5IG5vdCBpbXBsZW1lbnRlZCBmb3IgYW55 IGFyY2hpdGVjdHVyZXMuCj4KPiBQYXRjaCAyIGltcGxlbWVudHMgaXQgZm9yIENQVXMgd2hpY2gg YXJlIGtub3duLCB0byB0aGUgYmVzdCBvZiBteQo+IGtub3dsZWRnZSwgdG8gYWx3YXlzIGltcGxl bWVudCB0aGUgVFNPIG1lbW9yeSBtb2RlbCB1bmNvbmRpdGlvbmFsbHkuCj4gVGhpcyB1c2VzIHRo ZSBjcHVmZWF0dXJlIG1lY2hhbmlzbSB0byBvbmx5IGVuYWJsZSB0aGlzIGlmICphbGwqIGNvcmVz IGluCj4gdGhlIHN5c3RlbSBtZWV0IHRoZSByZXF1aXJlbWVudHMuCj4KPiBQYXRjaCAzIGFkZHMg dGhlIHNjYWZmb2xkaW5nIG5lY2VzYXNyeSB0byBzYXZlL3Jlc3RvcmUgdGhlIEFDVExSX0VMMQo+ IHJlZ2lzdGVyIGFjcm9zcyBjb250ZXh0IHN3aXRjaGVzLiBUaGlzIHJlZ2lzdGVyIGNvbnRhaW5z IElNUERFRiBmbGFncwo+IHJlbGF0ZWQgdG8gQ1BVIGV4ZWN1dGlvbiwgYW5kIG9uIEFwcGxlIENQ VXMgdGhpcyBpcyB3aGVyZSB0aGUgcnVudGltZQo+IFRTTyB0b2dnbGUgYml0IGlzIGltcGxlbWVu dGVkLiBPdGhlciBDUFVzIGNvdWxkIGNvbmNlaXZhYmx5IGJlbmVmaXQgZnJvbQo+IHRoaXMgc2Nh ZmZvbGRpbmcgaWYgdGhleSBhbHNvIHVzZSBBQ1RMUl9FTDEgZm9yIHRoaW5ncyB0aGF0IGNvdWxk Cj4gb3N0ZW5zaWJseSBiZSBydW50aW1lIGNvbnRyb2xsZWQgYW5kIGNvbnRleHQtc3dpdGNoZWQu IEZvciB0aGlzIHRvIHdvcmssCj4gQUNUTFJfRUwxIG11c3QgaGF2ZSBhIHVuaWZvcm0gbGF5b3V0 IGFjcm9zcyBhbGwgY29yZXMgaW4gdGhlIHN5c3RlbS4KPgo+IEZpbmFsbHksIHBhdGNoIDQgaW1w bGVtZW50cyBQUl97U0VULEdFVH1fTUVNX01PREVMIGZvciBBcHBsZSBDUFVzIGJ5Cj4gaG9va2lu ZyBpdCB1cCB0byBmbGlwIHRoZSBhcHByb3ByaWF0ZSBBQ1RMUl9FTDEgYml0IHdoZW4gdGhlIEFw cGxlIFRTTwo+IGZlYXR1cmUgaXMgZGV0ZWN0ZWQgKG9uIGFsbCBDUFVzLCB3aGljaCBhbHNvIGlt cGxpZXMgdGhlIHVuaWZvcm0KPiBBQ1RMUl9FTDEgbGF5b3V0KS4KPgo+IFRoaXMgc2VyaWVzIGhh cyBiZWVuIGJyZXdpbmcgaW4gdGhlIGRvd25zdHJlYW0gQXNhaGkgTGludXggdHJlZSBmb3IgYQo+ IHdoaWxlIG5vdywgYW5kIHNoaXBzIHRvIHRob3VzYW5kcyBvZiB1c2Vycy4gQSBzdWJzZXQgaGF2 ZSBiZWVuIHVzaW5nIGl0Cj4gd2l0aCBGRVgtRW11LCB3aGljaCBhbHJlYWR5IHN1cHBvcnRzIHRo aXMgZmVhdHVyZS4gVGhpcyByZWJhc2Ugb24KPiB2Ni45LXJjMSBpcyBvbmx5IGJ1aWxkLXRlc3Rl ZCAoYWxsIGludGVybWVkaWF0ZSBjb21taXRzIHdpdGggYW5kIHdpdGhvdXQKPiB0aGUgY29uZmln IGVuYWJsZWQsIG9uIEFSTTY0KSBidXQgSSdsbCB1cGRhdGUgdGhlIGRvd25zdHJlYW0gYnJhbmNo IHNvb24KPiB3aXRoIHRoaXMgdmVyc2lvbiBhbmQgZ2V0IGl0IHB1c2hlZCBvdXQgdG8gdXNlcnMv dGVzdGVycy4KPgo+IFRoZSBBcHBsZSBzdXBwb3J0IHdvcmtzIG9uIGJhcmUgbWV0YWwgYW5kICpz aG91bGQqIHdvcmsgZXhhY3RseSB0aGUgc2FtZQo+IHdheSBvbiBtYWNPUyBWTXMgKGFzIGFsbHVk ZWQgdG8gYnkgWmF5ZCBpbiBoaXMgaW5kZXBlbmRlbnQgc3VibWlzc2lvbiBbM10pLAo+IHRob3Vn aCBJIGhhdmVuJ3QgcGVyc29uYWxseSB2ZXJpZmllZCB0aGlzLiBLVk0gc3VwcG9ydCBmb3IgdGhp cyBpcyBsZWZ0Cj4gZm9yIGEgZnV0dXJlIHBhdGNoc2V0Lgo+Cj4gKEFwb2xvZ2llcyBmb3IgdGhl IGxhcmdlIENjOiBsaXN0OyBJIHdhbnQgdG8gbWFrZSBzdXJlIG5vYm9keSB3aG8gZ290Cj4gQ2Nl ZCBvbiBaYXlkJ3MgYWx0ZXJuYXRlIHRha2UgaXMgbGVmdCBvdXQgb2YgdGhpcyBvbmUuKQo+Cj4g WzFdIGh0dHBzOi8vZmV4LWVtdS5jb20vRkVYLTIzMDYvCj4gWzJdIGh0dHBzOi8vZ2l0aHViLmNv bS9Bc2FoaUxpbnV4L2xpbnV4L3RyZWUvYml0cy8yMjAtdHNvCj4gWzNdIGh0dHBzOi8vbG9yZS5r ZXJuZWwub3JnL2xrbWwvMjAyNDA0MTAyMTE2NTIuMTY2NDAtMS16YXlkX3F1bXNpZWhAYXBwbGUu Y29tLwo+Cj4gVG86IENhdGFsaW4gTWFyaW5hcyA8Y2F0YWxpbi5tYXJpbmFzQGFybS5jb20+Cj4g VG86IFdpbGwgRGVhY29uIDx3aWxsQGtlcm5lbC5vcmc+Cj4gVG86IE1hcmMgWnluZ2llciA8bWF6 QGtlcm5lbC5vcmc+Cj4gVG86IE1hcmsgUnV0bGFuZCA8bWFyay5ydXRsYW5kQGFybS5jb20+Cj4g Q2M6IFpheWQgUXVtc2llaCA8emF5ZF9xdW1zaWVoQGFwcGxlLmNvbT4KPiBDYzogSnVzdGluIEx1 IDxpaF9qdXN0aW5AYXBwbGUuY29tPgo+IENjOiBSeWFuIEhvdWRlayA8SG91ZGVrLlJ5YW5AZmV4 LWVtdS5vcmc+Cj4gQ2M6IE1hcmsgQnJvd24gPGJyb29uaWVAa2VybmVsLm9yZz4KPiBDYzogQXJk IEJpZXNoZXV2ZWwgPGFyZGJAa2VybmVsLm9yZz4KPiBDYzogTWF0ZXVzeiBHdXppayA8bWpndXpp a0BnbWFpbC5jb20+Cj4gQ2M6IEFuc2h1bWFuIEtoYW5kdWFsIDxhbnNodW1hbi5raGFuZHVhbEBh cm0uY29tPgo+IENjOiBPbGl2ZXIgVXB0b24gPG9saXZlci51cHRvbkBsaW51eC5kZXY+Cj4gQ2M6 IE1pZ3VlbCBMdWlzIDxtaWd1ZWwubHVpc0BvcmFjbGUuY29tPgo+IENjOiBKb2V5IEdvdWx5IDxq b2V5LmdvdWx5QGFybS5jb20+Cj4gQ2M6IENocmlzdG9waCBQYWFzY2ggPGNwYWFzY2hAYXBwbGUu Y29tPgo+IENjOiBLZWVzIENvb2sgPGtlZXNjb29rQGNocm9taXVtLm9yZz4KPiBDYzogU2FtaSBU b2x2YW5lbiA8c2FtaXRvbHZhbmVuQGdvb2dsZS5jb20+Cj4gQ2M6IEJhb3F1YW4gSGUgPGJoZUBy ZWRoYXQuY29tPgo+IENjOiBKb2VsIEdyYW5hZG9zIDxqLmdyYW5hZG9zQHNhbXN1bmcuY29tPgo+ IENjOiBEYXdlaSBMaSA8ZGF3ZWkubGlAc2hpbmdyb3VwLmNuPgo+IENjOiBBbmRyZXcgTW9ydG9u IDxha3BtQGxpbnV4LWZvdW5kYXRpb24ub3JnPgo+IENjOiBGbG9yZW50IFJldmVzdCA8cmV2ZXN0 QGNocm9taXVtLm9yZz4KPiBDYzogRGF2aWQgSGlsZGVuYnJhbmQgPGRhdmlkQHJlZGhhdC5jb20+ Cj4gQ2M6IFN0ZWZhbiBSb2VzY2ggPHNockBkZXZrZXJuZWwuaW8+Cj4gQ2M6IEFuZHkgQ2hpdSA8 YW5keS5jaGl1QHNpZml2ZS5jb20+Cj4gQ2M6IEpvc2ggVHJpcGxldHQgPGpvc2hAam9zaHRyaXBs ZXR0Lm9yZz4KPiBDYzogT2xlZyBOZXN0ZXJvdiA8b2xlZ0ByZWRoYXQuY29tPgo+IENjOiBIZWxn ZSBEZWxsZXIgPGRlbGxlckBnbXguZGU+Cj4gQ2M6IFpldiBXZWlzcyA8emV2QGJld2lsZGVyYmVl c3QubmV0Pgo+IENjOiBPbmRyZWogTW9zbmFjZWsgPG9tb3NuYWNlQHJlZGhhdC5jb20+Cj4gQ2M6 IE1pZ3VlbCBPamVkYSA8b2plZGFAa2VybmVsLm9yZz4KPiBDYzogbGludXgtYXJtLWtlcm5lbEBs aXN0cy5pbmZyYWRlYWQub3JnCj4gQ2M6IGxpbnV4LWtlcm5lbEB2Z2VyLmtlcm5lbC5vcmcKPiBD YzogQXNhaGkgTGludXggPGFzYWhpQGxpc3RzLmxpbnV4LmRldj4KPgo+IFNpZ25lZC1vZmYtYnk6 IEhlY3RvciBNYXJ0aW4gPG1hcmNhbkBtYXJjYW4uc3Q+Cj4gLS0tCj4gSGVjdG9yIE1hcnRpbiAo NCk6Cj4gICAgICAgcHJjdGw6IEludHJvZHVjZSBQUl97U0VULEdFVH1fTUVNX01PREVMCj4gICAg ICAgYXJtNjQ6IEltcGxlbWVudCBQUl97R0VULFNFVH1fTUVNX01PREVMIGZvciBhbHdheXMtVFNP IENQVXMKPiAgICAgICBhcm02NDogSW50cm9kdWNlIHNjYWZmb2xkaW5nIHRvIGFkZCBBQ1RMUl9F TDEgdG8gdGhyZWFkIHN0YXRlCj4gICAgICAgYXJtNjQ6IEltcGxlbWVudCBBcHBsZSBJTVBERUYg VFNPIG1lbW9yeSBtb2RlbCBjb250cm9sCj4KPiAgYXJjaC9hcm02NC9LY29uZmlnICAgICAgICAg ICAgICAgICAgICAgICAgfCAxNCArKysrKysKPiAgYXJjaC9hcm02NC9pbmNsdWRlL2FzbS9hcHBs ZV9jcHVmZWF0dXJlLmggfCAxNSArKysrKysrCj4gIGFyY2gvYXJtNjQvaW5jbHVkZS9hc20vY3B1 ZmVhdHVyZS5oICAgICAgIHwgMTAgKysrKysKPiAgYXJjaC9hcm02NC9pbmNsdWRlL2FzbS9wcm9j ZXNzb3IuaCAgICAgICAgfCAgMyArKwo+ICBhcmNoL2FybTY0L2tlcm5lbC9NYWtlZmlsZSAgICAg ICAgICAgICAgICB8ICAzICstCj4gIGFyY2gvYXJtNjQva2VybmVsL2NwdWZlYXR1cmUuYyAgICAg ICAgICAgIHwgMTEgKystLS0KPiAgYXJjaC9hcm02NC9rZXJuZWwvY3B1ZmVhdHVyZV9pbXBkZWYu YyAgICAgfCA2MSArKysrKysrKysrKysrKysrKysrKysrKysrKwo+ICBhcmNoL2FybTY0L2tlcm5l bC9wcm9jZXNzLmMgICAgICAgICAgICAgICB8IDcxICsrKysrKysrKysrKysrKysrKysrKysrKysr KysrKysKPiAgYXJjaC9hcm02NC9rZXJuZWwvc2V0dXAuYyAgICAgICAgICAgICAgICAgfCAgOCAr KysrCj4gIGFyY2gvYXJtNjQvdG9vbHMvY3B1Y2FwcyAgICAgICAgICAgICAgICAgIHwgIDIgKwo+ ICBpbmNsdWRlL2xpbnV4L21lbW9yeV9vcmRlcmluZ19tb2RlbC5oICAgICB8IDExICsrKysrCj4g IGluY2x1ZGUvdWFwaS9saW51eC9wcmN0bC5oICAgICAgICAgICAgICAgIHwgIDUgKysrCj4gIGtl cm5lbC9zeXMuYyAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIHwgMjEgKysrKysrKysrCj4g IDEzIGZpbGVzIGNoYW5nZWQsIDIyOSBpbnNlcnRpb25zKCspLCA2IGRlbGV0aW9ucygtKQo+IC0t LQo+IGJhc2UtY29tbWl0OiA0Y2VjZTc2NDk2NTAyMGMyMmNmZjc2NjViMThhMDEyMDA2MzU5MDk1 Cj4gY2hhbmdlLWlkOiAyMDI0MDQxMS10c28tZTg2ZmRjZWI5NGI4Cj4KClRoZSBzZXJpZXMgbG9v a3MgZ29vZCB0byBtZS4KClJldmlld2VkLWJ5OiBOZWFsIEdvbXBhIDxuZWFsQGdvbXBhLmRldj4K CgoKLS0gCuecn+Wun+OBr+OBhOOBpOOCguS4gOOBpO+8gS8gQWx3YXlzLCB0aGVyZSdzIG9ubHkg b25lIHRydXRoIQoKX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X18KbGludXgtYXJtLWtlcm5lbCBtYWlsaW5nIGxpc3QKbGludXgtYXJtLWtlcm5lbEBsaXN0cy5p bmZyYWRlYWQub3JnCmh0dHA6Ly9saXN0cy5pbmZyYWRlYWQub3JnL21haWxtYW4vbGlzdGluZm8v bGludXgtYXJtLWtlcm5lbAo=