From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-wm1-f50.google.com (mail-wm1-f50.google.com [209.85.128.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 8E9AE335B5 for ; Mon, 29 Jan 2024 19:13:19 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.50 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1706555601; cv=none; b=VnjqV6U+EdIVNlt1pbj30phj2S+wkDLTItfUfNwWZ5+i/ArHMKm9JQmFEFQgNe03Zw3bHCctokwkq8/hPdAJ05VhvebcdCAbiMQ/sZKpTlVlhd+9QXwvnFgkihAp3C+6s7QRVea+en4ka1/rMuUTanMCpSSAZHzxM7eaYdxUnQc= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1706555601; c=relaxed/simple; bh=k+rFaP2hx6Dhtbm5NmnswHdaELq6UccwTB1MNQilwlo=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Disposition:In-Reply-To; b=LncKq538kN/J4QWSgjRxxY2cJxk9Ql2V1TcK+H1pmsG1aN8YVsJ137xDTy+iS4+1iMBY0tSnYmXskZt6mGOVSPEvKovw+MGUG6njxLf9QdzIHDRgYAV8Qc5FJlVfg0kOfhKmr/qlGQ9t/0NAvqn1ZdyMtuxMik4C7cKmzhhcBGs= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com; spf=pass smtp.mailfrom=google.com; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b=R2cjUdKe; arc=none smtp.client-ip=209.85.128.50 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=google.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b="R2cjUdKe" Received: by mail-wm1-f50.google.com with SMTP id 5b1f17b1804b1-40ef9382752so9125e9.0 for ; Mon, 29 Jan 2024 11:13:19 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20230601; t=1706555598; x=1707160398; darn=lists.linux.dev; h=in-reply-to:content-transfer-encoding:content-disposition :mime-version:references:message-id:subject:cc:to:from:date:from:to :cc:subject:date:message-id:reply-to; bh=8BI/hrl4gqaMRwJZbaZdSazD5aJZfh2xP9rdDosVdXM=; b=R2cjUdKeM0d6p6TSm+UrdzlUMlzpTpIE7k/rWzh4xshERR+jaWADnm1xSbPeTXyAvQ mbRVSgqUmrO/gayPmTujFhygm+pSpKMJFtZx0j7uz2Rtd9Ezj++iAd7PXX34gzRD+OfH 7LKEPy1Zr4nMPKX5diC0eER87/AX/r0zN4Rs9sFM0gy1hylPRaLd0+0UEWuDMf/chV9/ 63s9yBwjyp1nSFk7RzGOR6PM461YxQZg0H4DdE+gvlJR6ZNI6hcHLpAt0VdRDaXI00f4 OeaJkaRjX3gYYIhbG+proXs8vMnsMEw9+U7pfsB2um51L+Y2Hliv17KURLOlFdoLX8c5 BrRg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1706555598; x=1707160398; h=in-reply-to:content-transfer-encoding:content-disposition :mime-version:references:message-id:subject:cc:to:from:date :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=8BI/hrl4gqaMRwJZbaZdSazD5aJZfh2xP9rdDosVdXM=; b=kuteY6ZM/U9zEzVmRsOgk8Zqmp6wAETFZA9w5q9nxCm3WLnwsypdEW7Uju3Arwh6Uk wMRLQQhkh8IzAD5wLRMEFAl46iwJvqSvr9j4tR0Z8SupsRdKrzfOPD7HlEz4Ux+9xCrQ fLJWk65uLrQI/L6VcnGzlGN2epKjnak5c9VeznFKVifurn89nDwnJZ8+SQOrFZ4G2Cs4 3Ub42wh+sEVpzMRR17+azwoojduKZuYEialHP4HWVwCsUqLv9GXbbU4gD0MLRgDR5Y1d UnjVtqglNVdsOHf3V7ju7mObbzKIis6rlKlvFHo1n/UTqo6MMlmyoavGe/+hpBeeWjRz zDPg== X-Gm-Message-State: AOJu0YyXf+aLBLQwDZdIKxCICWYXH/ku8cp4dJroPSf1DWCH2gnKPRd5 hgE+N+NS0c2hNGMWvdC+FabW7KcwwhL6FpWtN7RQlqNhgUoagXyL1ztuPboYEA== X-Google-Smtp-Source: AGHT+IH+hlBD7FN2bCsw/rzLuOPSHSMxINUDaY8nxAT10J4O4msNXPrRQpqMAB1wNW9m55yczjCuDA== X-Received: by 2002:a05:600c:6020:b0:40e:5274:e2ba with SMTP id az32-20020a05600c602000b0040e5274e2bamr17162wmb.4.1706555597705; Mon, 29 Jan 2024 11:13:17 -0800 (PST) Received: from google.com (185.83.140.34.bc.googleusercontent.com. [34.140.83.185]) by smtp.gmail.com with ESMTPSA id i3-20020a05600c354300b0040efcec0a6asm477834wmq.42.2024.01.29.11.13.17 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 29 Jan 2024 11:13:17 -0800 (PST) Date: Mon, 29 Jan 2024 19:13:13 +0000 From: Mostafa Saleh To: Jason Gunthorpe Cc: iommu@lists.linux.dev, Joerg Roedel , linux-arm-kernel@lists.infradead.org, Robin Murphy , Will Deacon , Eric Auger , Moritz Fischer , Michael Shavit , Nicolin Chen , patches@lists.linux.dev, Shameer Kolothum Subject: Re: [PATCH v3 00/19] Update SMMUv3 to the modern iommu API (part 1/3) Message-ID: References: <0-v3-d794f8d934da+411a-smmuv3_newapi_p1_jgg@nvidia.com> Precedence: bulk X-Mailing-List: iommu@lists.linux.dev List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <0-v3-d794f8d934da+411a-smmuv3_newapi_p1_jgg@nvidia.com> Hi Jason, On Tue, Dec 05, 2023 at 03:14:32PM -0400, Jason Gunthorpe wrote: > The SMMUv3 driver was originally written in 2015 when the iommu driver > facing API looked quite different. The API has evolved, especially lately, > and the driver has fallen behind. > > This work aims to bring make the SMMUv3 driver the best IOMMU driver with > the most comprehensive implementation of the API. After all parts it > addresses: > > - Global static BLOCKED and IDENTITY domains with 'never fail' attach > semantics. BLOCKED is desired for efficient VFIO. > > - Support map before attach for PAGING iommu_domains. > > - attach_dev failure does not change the HW configuration. > > - Fully hitless transitions between IDENTITY -> DMA -> IDENTITY. > The API has IOMMU_RESV_DIRECT which is expected to be > continuously translating. > > - Safe transitions between PAGING -> BLOCKED, do not ever temporarily > do IDENTITY. This is required for iommufd security. > > - Full PASID API support including: > - S1/SVA domains attached to PASIDs > - IDENTITY/BLOCKED/S1 attached to RID > - Change of the RID domain while PASIDs are attached > > - Streamlined SVA support using the core infrastructure > > - Hitless, whenever possible, change between two domains > > - iommufd IOMMU_GET_HW_INFO, IOMMU_HWPT_ALLOC_NEST_PARENT, and > IOMMU_DOMAIN_NESTED support > > Over all these things are going to become more accessible to iommufd, and > exposed to VMs, so it is important for the driver to have a robust > implementation of the API. > > The work is split into three parts, with this part largely focusing on the > STE and building up to the BLOCKED & IDENTITY global static domains. > > The second part largely focuses on the CD and builds up to having a common > PASID infrastructure that SVA and S1 domains equally use. > > The third part has some random cleanups and the iommufd related parts. > > Overall this takes the approach of turning the STE/CD programming upside > down where the CD/STE value is computed right at a driver callback > function and then pushed down into programming logic. The programming > logic hides the details of the required CD/STE tear-less update. This > makes the CD/STE functions independent of the arm_smmu_domain which makes > it fairly straightforward to untangle all the different call chains, and > add news ones. > > Further, this frees the arm_smmu_domain related logic from keeping track > of what state the STE/CD is currently in so it can carefully sequence the > correct update. There are many new update pairs that are subtly introduced > as the work progresses. > > The locking to support BTM via arm_smmu_asid_lock is a bit subtle right > now and patches throughout this work adjust and tighten this so that it is > clearer and doesn't get broken. > > Once the lower STE layers no longer need to touch arm_smmu_domain we can > isolate struct arm_smmu_domain to be only used for PAGING domains, audit > all the to_smmu_domain() calls to be only in PAGING domain ops, and > introduce the normal global static BLOCKED/IDENTITY domains using the new > STE infrastructure. Part 2 will ultimately migrate SVA over to use > arm_smmu_domain as well. > > All parts are on github: > > https://github.com/jgunthorpe/linux/commits/smmuv3_newapi I added some comments/questions for this series, but didn’t review it thoroughly as I see the code on github is quite different from these patches, and it seems to be targeted for v4. Do you have any plans to send it soon? > > v3: > - Use some local variables in arm_smmu_get_step_for_sid() for clarity > - White space and spelling changes > - Commit message updates > - Keep master->domain_head initialized to avoid a list_del corruption > v2: https://lore.kernel.org/r/0-v2-de8b10590bf5+400-smmuv3_newapi_p1_jgg@nvidia.com > - Rebased on v6.7-rc1 > - Improve the comment for arm_smmu_write_entry_step() > - Fix the botched memcmp > - Document the spec justification for the SHCFG exclusion in used > - Include STRTAB_STE_1_SHCFG for STRTAB_STE_0_CFG_S2_TRANS in used > - WARN_ON for unknown STEs in used > - Fix error unwind in arm_smmu_attach_dev() > - Whitespace, spelling, and checkpatch related items > v1: https://lore.kernel.org/r/0-v1-e289ca9121be+2be-smmuv3_newapi_p1_jgg@nvidia.com > > Jason Gunthorpe (19): > iommu/arm-smmu-v3: Add a type for the STE > iommu/arm-smmu-v3: Master cannot be NULL in > arm_smmu_write_strtab_ent() > iommu/arm-smmu-v3: Remove ARM_SMMU_DOMAIN_NESTED > iommu/arm-smmu-v3: Make STE programming independent of the callers > iommu/arm-smmu-v3: Consolidate the STE generation for abort/bypass > iommu/arm-smmu-v3: Move arm_smmu_rmr_install_bypass_ste() > iommu/arm-smmu-v3: Move the STE generation for S1 and S2 domains into > functions > iommu/arm-smmu-v3: Build the whole STE in > arm_smmu_make_s2_domain_ste() > iommu/arm-smmu-v3: Hold arm_smmu_asid_lock during all of attach_dev > iommu/arm-smmu-v3: Compute the STE only once for each master > iommu/arm-smmu-v3: Do not change the STE twice during > arm_smmu_attach_dev() > iommu/arm-smmu-v3: Put writing the context descriptor in the right > order > iommu/arm-smmu-v3: Pass smmu_domain to arm_enable/disable_ats() > iommu/arm-smmu-v3: Remove arm_smmu_master->domain > iommu/arm-smmu-v3: Add a global static IDENTITY domain > iommu/arm-smmu-v3: Add a global static BLOCKED domain > iommu/arm-smmu-v3: Use the identity/blocked domain during release > iommu/arm-smmu-v3: Pass arm_smmu_domain and arm_smmu_device to > finalize > iommu/arm-smmu-v3: Convert to domain_alloc_paging() > > drivers/iommu/arm/arm-smmu-v3/arm-smmu-v3.c | 729 +++++++++++++------- > drivers/iommu/arm/arm-smmu-v3/arm-smmu-v3.h | 12 +- > 2 files changed, 477 insertions(+), 264 deletions(-) > > > base-commit: ca7fcaff577c92d85f0e05cc7be79759155fe328 > -- > 2.43.0 > Thanks, Mostafa 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 9BEB7C47DB3 for ; Mon, 29 Jan 2024 19:13:31 +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:References: Message-ID:Subject:Cc:To:From:Date:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=dAVTO0r7N2qd9cZikAvuWeETuShuUa0uJ+U+887zpJ4=; b=4dp1Vppxh0Mrcd IHqRTuHqoullDjLPPf3NzDivsVhbBvzIqwNtvv5e4eVynQ20eAhYPPbwDmm1VHsOGR0tZyA8LsF9t aAdXeX0+iVqRCsHzvmfbhli0tw0TaCBHqc2syLxS+AcRwA5syya9raWhhZM+RilqD0YhHTGXrq3JT +I3QxoykkIdFJjNY9lwtTmWkDLJFgxylw4RumGzyTgXu7TciRfmNbWUKWC9Gv0yiX63H5fftMYh9s QBLUeeZgI3pCyWsff3/oLKntYWUzfQUle8jwW9PJNUYqTtHCJC0Tk17gBwYsFsZbrwXx9bDw21VcA 9yp9AO5q9VuZniezDUyQ==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.97.1 #2 (Red Hat Linux)) id 1rUX4M-0000000E4Rg-1mxw; Mon, 29 Jan 2024 19:13:22 +0000 Received: from mail-wm1-x332.google.com ([2a00:1450:4864:20::332]) by bombadil.infradead.org with esmtps (Exim 4.97.1 #2 (Red Hat Linux)) id 1rUX4K-0000000E4RB-1IAo for linux-arm-kernel@lists.infradead.org; Mon, 29 Jan 2024 19:13:21 +0000 Received: by mail-wm1-x332.google.com with SMTP id 5b1f17b1804b1-40ef9382752so9135e9.0 for ; Mon, 29 Jan 2024 11:13:19 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20230601; t=1706555598; x=1707160398; darn=lists.infradead.org; h=in-reply-to:content-transfer-encoding:content-disposition :mime-version:references:message-id:subject:cc:to:from:date:from:to :cc:subject:date:message-id:reply-to; bh=8BI/hrl4gqaMRwJZbaZdSazD5aJZfh2xP9rdDosVdXM=; b=Q3zUENWsZd1r5hsDHpenp6wphGyL32+vybX1jjjRr/+j61ChoFwW2U+UwEuWI/mVNw y/9mVfp0Ll9HcK5DUKJSAtDUNNmyqcs8fhfzLhAaECi24IFwyYHwgDRtv+wV6ZEoXTOI 07Ejpzu/QtuZOtOccaPrsSWfrNtajWUtDiBwx4nuIcBsXdtcjMC3jbWjpy4ApH2MOD/Z TT+WdxxojyaOSU3XDijP+pMyOR2HlC1nlqmZ9KfiWvE4y0LNJSR6P8pYgvDGdj2U2G9r K09cm74ERsRJQdJ73eB7Qdqban8GhkLXsT+R3XO4WQdyzHVQiII3r5aH1jVzD/r/8JvC gFxg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1706555598; x=1707160398; h=in-reply-to:content-transfer-encoding:content-disposition :mime-version:references:message-id:subject:cc:to:from:date :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=8BI/hrl4gqaMRwJZbaZdSazD5aJZfh2xP9rdDosVdXM=; b=Sboq1gZLLxGCvlgbUYfXccRrgTqrcHhwn0t6uvSfMdb7K9ZNg0DGKFOirxTOGRSHUu LAh+5bh2JoOq/7xEnfjQ2atAODYHBiztOuAXGdxWAMiI55d0RVv2iRZV+BBpYlDK9AJ0 9NQh/nzFhtQzdTfgdhj7FrP775ZLZE44LysXjMZ4bcKwsNRbM8ZBlFOPXJyworLvEtjr zU+a8OD72dM+PMDv7/slej3AY47UkccKUZXVJ501rT3qluXSe2fxv87OFZKNL9EKCwwp o0wO7dbN2UO/pzUSut+VvQvDRljA5J+kv8C/qDlUflc72oMuj38JzBOg1F/lOiGOIWTx pAtA== X-Gm-Message-State: AOJu0YwslDy3R13E+Q0u6dQt/fkGSpDE8TuP2V/l+3cnyxd91VDSH9bJ +nNPwJFFNXJKS0ZIqpKOte55AvNteHvlAy+PjwXXNGxYCIyUGxJI8VvGJCwNAw== X-Google-Smtp-Source: AGHT+IH+hlBD7FN2bCsw/rzLuOPSHSMxINUDaY8nxAT10J4O4msNXPrRQpqMAB1wNW9m55yczjCuDA== X-Received: by 2002:a05:600c:6020:b0:40e:5274:e2ba with SMTP id az32-20020a05600c602000b0040e5274e2bamr17162wmb.4.1706555597705; Mon, 29 Jan 2024 11:13:17 -0800 (PST) Received: from google.com (185.83.140.34.bc.googleusercontent.com. [34.140.83.185]) by smtp.gmail.com with ESMTPSA id i3-20020a05600c354300b0040efcec0a6asm477834wmq.42.2024.01.29.11.13.17 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 29 Jan 2024 11:13:17 -0800 (PST) Date: Mon, 29 Jan 2024 19:13:13 +0000 From: Mostafa Saleh To: Jason Gunthorpe Cc: iommu@lists.linux.dev, Joerg Roedel , linux-arm-kernel@lists.infradead.org, Robin Murphy , Will Deacon , Eric Auger , Moritz Fischer , Michael Shavit , Nicolin Chen , patches@lists.linux.dev, Shameer Kolothum Subject: Re: [PATCH v3 00/19] Update SMMUv3 to the modern iommu API (part 1/3) Message-ID: References: <0-v3-d794f8d934da+411a-smmuv3_newapi_p1_jgg@nvidia.com> MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: <0-v3-d794f8d934da+411a-smmuv3_newapi_p1_jgg@nvidia.com> X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20240129_111320_375692_0F5AD4AD X-CRM114-Status: GOOD ( 38.72 ) 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 SGkgSmFzb24sCgpPbiBUdWUsIERlYyAwNSwgMjAyMyBhdCAwMzoxNDozMlBNIC0wNDAwLCBKYXNv biBHdW50aG9ycGUgd3JvdGU6Cj4gVGhlIFNNTVV2MyBkcml2ZXIgd2FzIG9yaWdpbmFsbHkgd3Jp dHRlbiBpbiAyMDE1IHdoZW4gdGhlIGlvbW11IGRyaXZlcgo+IGZhY2luZyBBUEkgbG9va2VkIHF1 aXRlIGRpZmZlcmVudC4gVGhlIEFQSSBoYXMgZXZvbHZlZCwgZXNwZWNpYWxseSBsYXRlbHksCj4g YW5kIHRoZSBkcml2ZXIgaGFzIGZhbGxlbiBiZWhpbmQuCj4gCj4gVGhpcyB3b3JrIGFpbXMgdG8g YnJpbmcgbWFrZSB0aGUgU01NVXYzIGRyaXZlciB0aGUgYmVzdCBJT01NVSBkcml2ZXIgd2l0aAo+ IHRoZSBtb3N0IGNvbXByZWhlbnNpdmUgaW1wbGVtZW50YXRpb24gb2YgdGhlIEFQSS4gQWZ0ZXIg YWxsIHBhcnRzIGl0Cj4gYWRkcmVzc2VzOgo+IAo+ICAtIEdsb2JhbCBzdGF0aWMgQkxPQ0tFRCBh bmQgSURFTlRJVFkgZG9tYWlucyB3aXRoICduZXZlciBmYWlsJyBhdHRhY2gKPiAgICBzZW1hbnRp Y3MuIEJMT0NLRUQgaXMgZGVzaXJlZCBmb3IgZWZmaWNpZW50IFZGSU8uCj4gCj4gIC0gU3VwcG9y dCBtYXAgYmVmb3JlIGF0dGFjaCBmb3IgUEFHSU5HIGlvbW11X2RvbWFpbnMuCj4gCj4gIC0gYXR0 YWNoX2RldiBmYWlsdXJlIGRvZXMgbm90IGNoYW5nZSB0aGUgSFcgY29uZmlndXJhdGlvbi4KPiAK PiAgLSBGdWxseSBoaXRsZXNzIHRyYW5zaXRpb25zIGJldHdlZW4gSURFTlRJVFkgLT4gRE1BIC0+ IElERU5USVRZLgo+ICAgIFRoZSBBUEkgaGFzIElPTU1VX1JFU1ZfRElSRUNUIHdoaWNoIGlzIGV4 cGVjdGVkIHRvIGJlCj4gICAgY29udGludW91c2x5IHRyYW5zbGF0aW5nLgo+IAo+ICAtIFNhZmUg dHJhbnNpdGlvbnMgYmV0d2VlbiBQQUdJTkcgLT4gQkxPQ0tFRCwgZG8gbm90IGV2ZXIgdGVtcG9y YXJpbHkKPiAgICBkbyBJREVOVElUWS4gVGhpcyBpcyByZXF1aXJlZCBmb3IgaW9tbXVmZCBzZWN1 cml0eS4KPiAKPiAgLSBGdWxsIFBBU0lEIEFQSSBzdXBwb3J0IGluY2x1ZGluZzoKPiAgICAgLSBT MS9TVkEgZG9tYWlucyBhdHRhY2hlZCB0byBQQVNJRHMKPiAgICAgLSBJREVOVElUWS9CTE9DS0VE L1MxIGF0dGFjaGVkIHRvIFJJRAo+ICAgICAtIENoYW5nZSBvZiB0aGUgUklEIGRvbWFpbiB3aGls ZSBQQVNJRHMgYXJlIGF0dGFjaGVkCj4gCj4gIC0gU3RyZWFtbGluZWQgU1ZBIHN1cHBvcnQgdXNp bmcgdGhlIGNvcmUgaW5mcmFzdHJ1Y3R1cmUKPiAKPiAgLSBIaXRsZXNzLCB3aGVuZXZlciBwb3Nz aWJsZSwgY2hhbmdlIGJldHdlZW4gdHdvIGRvbWFpbnMKPiAKPiAgLSBpb21tdWZkIElPTU1VX0dF VF9IV19JTkZPLCBJT01NVV9IV1BUX0FMTE9DX05FU1RfUEFSRU5ULCBhbmQKPiAgICBJT01NVV9E T01BSU5fTkVTVEVEIHN1cHBvcnQKPiAKPiBPdmVyIGFsbCB0aGVzZSB0aGluZ3MgYXJlIGdvaW5n IHRvIGJlY29tZSBtb3JlIGFjY2Vzc2libGUgdG8gaW9tbXVmZCwgYW5kCj4gZXhwb3NlZCB0byBW TXMsIHNvIGl0IGlzIGltcG9ydGFudCBmb3IgdGhlIGRyaXZlciB0byBoYXZlIGEgcm9idXN0Cj4g aW1wbGVtZW50YXRpb24gb2YgdGhlIEFQSS4KPiAKPiBUaGUgd29yayBpcyBzcGxpdCBpbnRvIHRo cmVlIHBhcnRzLCB3aXRoIHRoaXMgcGFydCBsYXJnZWx5IGZvY3VzaW5nIG9uIHRoZQo+IFNURSBh bmQgYnVpbGRpbmcgdXAgdG8gdGhlIEJMT0NLRUQgJiBJREVOVElUWSBnbG9iYWwgc3RhdGljIGRv bWFpbnMuCj4gCj4gVGhlIHNlY29uZCBwYXJ0IGxhcmdlbHkgZm9jdXNlcyBvbiB0aGUgQ0QgYW5k IGJ1aWxkcyB1cCB0byBoYXZpbmcgYSBjb21tb24KPiBQQVNJRCBpbmZyYXN0cnVjdHVyZSB0aGF0 IFNWQSBhbmQgUzEgZG9tYWlucyBlcXVhbGx5IHVzZS4KPiAKPiBUaGUgdGhpcmQgcGFydCBoYXMg c29tZSByYW5kb20gY2xlYW51cHMgYW5kIHRoZSBpb21tdWZkIHJlbGF0ZWQgcGFydHMuCj4gCj4g T3ZlcmFsbCB0aGlzIHRha2VzIHRoZSBhcHByb2FjaCBvZiB0dXJuaW5nIHRoZSBTVEUvQ0QgcHJv Z3JhbW1pbmcgdXBzaWRlCj4gZG93biB3aGVyZSB0aGUgQ0QvU1RFIHZhbHVlIGlzIGNvbXB1dGVk IHJpZ2h0IGF0IGEgZHJpdmVyIGNhbGxiYWNrCj4gZnVuY3Rpb24gYW5kIHRoZW4gcHVzaGVkIGRv d24gaW50byBwcm9ncmFtbWluZyBsb2dpYy4gVGhlIHByb2dyYW1taW5nCj4gbG9naWMgaGlkZXMg dGhlIGRldGFpbHMgb2YgdGhlIHJlcXVpcmVkIENEL1NURSB0ZWFyLWxlc3MgdXBkYXRlLiBUaGlz Cj4gbWFrZXMgdGhlIENEL1NURSBmdW5jdGlvbnMgaW5kZXBlbmRlbnQgb2YgdGhlIGFybV9zbW11 X2RvbWFpbiB3aGljaCBtYWtlcwo+IGl0IGZhaXJseSBzdHJhaWdodGZvcndhcmQgdG8gdW50YW5n bGUgYWxsIHRoZSBkaWZmZXJlbnQgY2FsbCBjaGFpbnMsIGFuZAo+IGFkZCBuZXdzIG9uZXMuCj4g Cj4gRnVydGhlciwgdGhpcyBmcmVlcyB0aGUgYXJtX3NtbXVfZG9tYWluIHJlbGF0ZWQgbG9naWMg ZnJvbSBrZWVwaW5nIHRyYWNrCj4gb2Ygd2hhdCBzdGF0ZSB0aGUgU1RFL0NEIGlzIGN1cnJlbnRs eSBpbiBzbyBpdCBjYW4gY2FyZWZ1bGx5IHNlcXVlbmNlIHRoZQo+IGNvcnJlY3QgdXBkYXRlLiBU aGVyZSBhcmUgbWFueSBuZXcgdXBkYXRlIHBhaXJzIHRoYXQgYXJlIHN1YnRseSBpbnRyb2R1Y2Vk Cj4gYXMgdGhlIHdvcmsgcHJvZ3Jlc3Nlcy4KPiAKPiBUaGUgbG9ja2luZyB0byBzdXBwb3J0IEJU TSB2aWEgYXJtX3NtbXVfYXNpZF9sb2NrIGlzIGEgYml0IHN1YnRsZSByaWdodAo+IG5vdyBhbmQg cGF0Y2hlcyB0aHJvdWdob3V0IHRoaXMgd29yayBhZGp1c3QgYW5kIHRpZ2h0ZW4gdGhpcyBzbyB0 aGF0IGl0IGlzCj4gY2xlYXJlciBhbmQgZG9lc24ndCBnZXQgYnJva2VuLgo+IAo+IE9uY2UgdGhl IGxvd2VyIFNURSBsYXllcnMgbm8gbG9uZ2VyIG5lZWQgdG8gdG91Y2ggYXJtX3NtbXVfZG9tYWlu IHdlIGNhbgo+IGlzb2xhdGUgc3RydWN0IGFybV9zbW11X2RvbWFpbiB0byBiZSBvbmx5IHVzZWQg Zm9yIFBBR0lORyBkb21haW5zLCBhdWRpdAo+IGFsbCB0aGUgdG9fc21tdV9kb21haW4oKSBjYWxs cyB0byBiZSBvbmx5IGluIFBBR0lORyBkb21haW4gb3BzLCBhbmQKPiBpbnRyb2R1Y2UgdGhlIG5v cm1hbCBnbG9iYWwgc3RhdGljIEJMT0NLRUQvSURFTlRJVFkgZG9tYWlucyB1c2luZyB0aGUgbmV3 Cj4gU1RFIGluZnJhc3RydWN0dXJlLiBQYXJ0IDIgd2lsbCB1bHRpbWF0ZWx5IG1pZ3JhdGUgU1ZB IG92ZXIgdG8gdXNlCj4gYXJtX3NtbXVfZG9tYWluIGFzIHdlbGwuCj4gCj4gQWxsIHBhcnRzIGFy ZSBvbiBnaXRodWI6Cj4gCj4gIGh0dHBzOi8vZ2l0aHViLmNvbS9qZ3VudGhvcnBlL2xpbnV4L2Nv bW1pdHMvc21tdXYzX25ld2FwaQpJIGFkZGVkIHNvbWUgY29tbWVudHMvcXVlc3Rpb25zIGZvciB0 aGlzIHNlcmllcywgYnV0IGRpZG7igJl0IHJldmlldyBpdAp0aG9yb3VnaGx5IGFzIEkgc2VlIHRo ZSBjb2RlIG9uIGdpdGh1YiBpcyBxdWl0ZSBkaWZmZXJlbnQgZnJvbSB0aGVzZSBwYXRjaGVzLAph bmQgaXQgc2VlbXMgdG8gYmUgdGFyZ2V0ZWQgZm9yIHY0LiBEbyB5b3UgaGF2ZSBhbnkgcGxhbnMg dG8gc2VuZCBpdCBzb29uPwoKPiAKPiB2MzoKPiAgLSBVc2Ugc29tZSBsb2NhbCB2YXJpYWJsZXMg aW4gYXJtX3NtbXVfZ2V0X3N0ZXBfZm9yX3NpZCgpIGZvciBjbGFyaXR5Cj4gIC0gV2hpdGUgc3Bh Y2UgYW5kIHNwZWxsaW5nIGNoYW5nZXMKPiAgLSBDb21taXQgbWVzc2FnZSB1cGRhdGVzCj4gIC0g S2VlcCBtYXN0ZXItPmRvbWFpbl9oZWFkIGluaXRpYWxpemVkIHRvIGF2b2lkIGEgbGlzdF9kZWwg Y29ycnVwdGlvbgo+IHYyOiBodHRwczovL2xvcmUua2VybmVsLm9yZy9yLzAtdjItZGU4YjEwNTkw YmY1KzQwMC1zbW11djNfbmV3YXBpX3AxX2pnZ0BudmlkaWEuY29tCj4gIC0gUmViYXNlZCBvbiB2 Ni43LXJjMQo+ICAtIEltcHJvdmUgdGhlIGNvbW1lbnQgZm9yIGFybV9zbW11X3dyaXRlX2VudHJ5 X3N0ZXAoKQo+ICAtIEZpeCB0aGUgYm90Y2hlZCBtZW1jbXAKPiAgLSBEb2N1bWVudCB0aGUgc3Bl YyBqdXN0aWZpY2F0aW9uIGZvciB0aGUgU0hDRkcgZXhjbHVzaW9uIGluIHVzZWQKPiAgLSBJbmNs dWRlIFNUUlRBQl9TVEVfMV9TSENGRyBmb3IgU1RSVEFCX1NURV8wX0NGR19TMl9UUkFOUyBpbiB1 c2VkCj4gIC0gV0FSTl9PTiBmb3IgdW5rbm93biBTVEVzIGluIHVzZWQKPiAgLSBGaXggZXJyb3Ig dW53aW5kIGluIGFybV9zbW11X2F0dGFjaF9kZXYoKQo+ICAtIFdoaXRlc3BhY2UsIHNwZWxsaW5n LCBhbmQgY2hlY2twYXRjaCByZWxhdGVkIGl0ZW1zCj4gdjE6IGh0dHBzOi8vbG9yZS5rZXJuZWwu b3JnL3IvMC12MS1lMjg5Y2E5MTIxYmUrMmJlLXNtbXV2M19uZXdhcGlfcDFfamdnQG52aWRpYS5j b20KPiAKPiBKYXNvbiBHdW50aG9ycGUgKDE5KToKPiAgIGlvbW11L2FybS1zbW11LXYzOiBBZGQg YSB0eXBlIGZvciB0aGUgU1RFCj4gICBpb21tdS9hcm0tc21tdS12MzogTWFzdGVyIGNhbm5vdCBi ZSBOVUxMIGluCj4gICAgIGFybV9zbW11X3dyaXRlX3N0cnRhYl9lbnQoKQo+ICAgaW9tbXUvYXJt LXNtbXUtdjM6IFJlbW92ZSBBUk1fU01NVV9ET01BSU5fTkVTVEVECj4gICBpb21tdS9hcm0tc21t dS12MzogTWFrZSBTVEUgcHJvZ3JhbW1pbmcgaW5kZXBlbmRlbnQgb2YgdGhlIGNhbGxlcnMKPiAg IGlvbW11L2FybS1zbW11LXYzOiBDb25zb2xpZGF0ZSB0aGUgU1RFIGdlbmVyYXRpb24gZm9yIGFi b3J0L2J5cGFzcwo+ICAgaW9tbXUvYXJtLXNtbXUtdjM6IE1vdmUgYXJtX3NtbXVfcm1yX2luc3Rh bGxfYnlwYXNzX3N0ZSgpCj4gICBpb21tdS9hcm0tc21tdS12MzogTW92ZSB0aGUgU1RFIGdlbmVy YXRpb24gZm9yIFMxIGFuZCBTMiBkb21haW5zIGludG8KPiAgICAgZnVuY3Rpb25zCj4gICBpb21t dS9hcm0tc21tdS12MzogQnVpbGQgdGhlIHdob2xlIFNURSBpbgo+ICAgICBhcm1fc21tdV9tYWtl X3MyX2RvbWFpbl9zdGUoKQo+ICAgaW9tbXUvYXJtLXNtbXUtdjM6IEhvbGQgYXJtX3NtbXVfYXNp ZF9sb2NrIGR1cmluZyBhbGwgb2YgYXR0YWNoX2Rldgo+ICAgaW9tbXUvYXJtLXNtbXUtdjM6IENv bXB1dGUgdGhlIFNURSBvbmx5IG9uY2UgZm9yIGVhY2ggbWFzdGVyCj4gICBpb21tdS9hcm0tc21t dS12MzogRG8gbm90IGNoYW5nZSB0aGUgU1RFIHR3aWNlIGR1cmluZwo+ICAgICBhcm1fc21tdV9h dHRhY2hfZGV2KCkKPiAgIGlvbW11L2FybS1zbW11LXYzOiBQdXQgd3JpdGluZyB0aGUgY29udGV4 dCBkZXNjcmlwdG9yIGluIHRoZSByaWdodAo+ICAgICBvcmRlcgo+ICAgaW9tbXUvYXJtLXNtbXUt djM6IFBhc3Mgc21tdV9kb21haW4gdG8gYXJtX2VuYWJsZS9kaXNhYmxlX2F0cygpCj4gICBpb21t dS9hcm0tc21tdS12MzogUmVtb3ZlIGFybV9zbW11X21hc3Rlci0+ZG9tYWluCj4gICBpb21tdS9h cm0tc21tdS12MzogQWRkIGEgZ2xvYmFsIHN0YXRpYyBJREVOVElUWSBkb21haW4KPiAgIGlvbW11 L2FybS1zbW11LXYzOiBBZGQgYSBnbG9iYWwgc3RhdGljIEJMT0NLRUQgZG9tYWluCj4gICBpb21t dS9hcm0tc21tdS12MzogVXNlIHRoZSBpZGVudGl0eS9ibG9ja2VkIGRvbWFpbiBkdXJpbmcgcmVs ZWFzZQo+ICAgaW9tbXUvYXJtLXNtbXUtdjM6IFBhc3MgYXJtX3NtbXVfZG9tYWluIGFuZCBhcm1f c21tdV9kZXZpY2UgdG8KPiAgICAgZmluYWxpemUKPiAgIGlvbW11L2FybS1zbW11LXYzOiBDb252 ZXJ0IHRvIGRvbWFpbl9hbGxvY19wYWdpbmcoKQo+IAo+ICBkcml2ZXJzL2lvbW11L2FybS9hcm0t c21tdS12My9hcm0tc21tdS12My5jIHwgNzI5ICsrKysrKysrKysrKystLS0tLS0tCj4gIGRyaXZl cnMvaW9tbXUvYXJtL2FybS1zbW11LXYzL2FybS1zbW11LXYzLmggfCAgMTIgKy0KPiAgMiBmaWxl cyBjaGFuZ2VkLCA0NzcgaW5zZXJ0aW9ucygrKSwgMjY0IGRlbGV0aW9ucygtKQo+IAo+IAo+IGJh c2UtY29tbWl0OiBjYTdmY2FmZjU3N2M5MmQ4NWYwZTA1Y2M3YmU3OTc1OTE1NWZlMzI4Cj4gLS0g Cj4gMi40My4wCj4KVGhhbmtzLApNb3N0YWZhCgpfX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fXwpsaW51eC1hcm0ta2VybmVsIG1haWxpbmcgbGlzdApsaW51eC1h cm0ta2VybmVsQGxpc3RzLmluZnJhZGVhZC5vcmcKaHR0cDovL2xpc3RzLmluZnJhZGVhZC5vcmcv bWFpbG1hbi9saXN0aW5mby9saW51eC1hcm0ta2VybmVsCg==