Private/Tools/Resolve-AvmTool.ps1
|
function Resolve-AvmTool { <# .SYNOPSIS Resolve the on-disk path to a managed binary or PowerShell module. .DESCRIPTION Engine code calls this helper to obtain a usable path to bicep, terraform, tflint, etc. before invoking the binary. The resolution order mirrors Get-AvmTool's status logic: 1. Cached + verified under <Tools>/<name>/<version>/<entry>[.exe]. 2. On PATH and reporting the lock-pinned version (-AllowPathFallback). On a cache miss the helper installs the pinned tool on demand through the verified Install-AvmToolFromPins pipeline (SHA256 + atomic rename + cross-process lock, honouring AVM_HOME), then re-resolves. This keeps `avm` self-sufficient: consumers never have to run `avm tool install` first, locally or in CI. Set AVM_NO_AUTO_INSTALL=1 (or pass -NoAutoInstall) to disable implicit installation for locked-down or air-gapped environments; resolution then hard-fails with a remediation hint pointing at `avm tool install <name>`. .PARAMETER Name The exact tool or PowerShell module name from avm.pins.jsonc. .PARAMETER PinsPath Override the bundled lock file. For tests. .PARAMETER ModuleRoot Repository context for .avm/tool-version-overrides.json. .PARAMETER AllowPathFallback When set, accept a PATH-resolved binary that self-reports the lock-pinned version. Defaults to off (engines should prefer the managed cache for reproducibility). .PARAMETER NoAutoInstall Disable on-demand installation of a missing pinned tool. Equivalent to AVM_NO_AUTO_INSTALL=1. Resolution then hard-fails instead of installing. For locked-down environments and tests. .PARAMETER AllowFileUrls Test-only escape hatch passed through to Read-AvmPins. .OUTPUTS pscustomobject with: Name, Version, Platform, Source, Path. #> [CmdletBinding()] [OutputType([pscustomobject])] param( [Parameter(Mandatory)] [string] $Name, [string] $PinsPath, [string] $ModuleRoot, [switch] $AllowPathFallback, [switch] $NoAutoInstall, [Parameter(DontShow)] [switch] $AllowFileUrls ) Set-StrictMode -Version 3.0 $ErrorActionPreference = 'Stop' $lock = if ($PinsPath) { Read-AvmPins -Path $PinsPath -ModuleRoot $ModuleRoot -AllowFileUrls:$AllowFileUrls } else { Read-AvmPins -ModuleRoot $ModuleRoot } $tool = Get-AvmToolDefinition -Pins $lock | Where-Object { $_.name -ceq $Name } | Select-Object -First 1 if (-not $tool) { throw [System.ArgumentException]::new( "Unknown tool '$Name' (not in avm.pins).") } Write-AvmToolVersionOverride -Tool $tool $versionOverride = if ($tool.ContainsKey('versionOverride')) { [pscustomobject]$tool.versionOverride } else { $null } $platform = Get-AvmToolPlatform Write-AvmLog ("tool: resolving {0}/{1} for {2}" -f $tool.name, $tool.version, $platform) -Level Verbose | Out-Null if ($tool.ContainsKey('unsupportedPlatforms') -and (@($tool.unsupportedPlatforms) -ccontains $platform)) { throw [AvmToolException]::new( ("Tool '{0}' does not ship a release for '{1}'." -f $tool.name, $platform), 'AVM1012') } $cache = Get-AvmToolCacheEntry -Tool $tool -Platform $platform $entrypoint = $cache.Path $isModule = $tool.ContainsKey('kind') -and $tool.kind -ceq 'powershell-module' $kind = if ($isModule) { 'powershell-module' } else { 'binary' } if ($cache.Cached) { Write-AvmLog ("tool: cache hit for {0} at {1}" -f $tool.name, $entrypoint) -Level Verbose | Out-Null return [pscustomobject][ordered]@{ Name = $tool.name Version = $tool.version Platform = $platform Source = 'cache' Path = $entrypoint Kind = $kind VersionOverride = $versionOverride } } if ($isModule) { $installedModule = Find-AvmPowerShellModule -Name $tool.name -Version $tool.version if ($installedModule) { return [pscustomobject]@{ Name = $tool.name; Version = $tool.version; Platform = $platform Source = 'module-path'; Path = Join-Path $installedModule.ModuleBase "$Name.psd1"; Kind = $kind VersionOverride = $versionOverride } } } elseif ($AllowPathFallback) { Write-AvmLog ("tool: checking PATH fallback for {0}" -f $tool.name) -Level Verbose | Out-Null $hit = Find-AvmToolOnPath -Entrypoint $tool.entrypoint -ExpectedVersion $tool.version if ($hit -and $hit.Matches) { Write-AvmLog ("tool: using PATH fallback for {0} at {1}" -f $tool.name, $hit.Path) -Level Verbose | Out-Null return [pscustomobject][ordered]@{ Name = $tool.name Version = $tool.version Platform = $platform Source = 'path' Path = $hit.Path Kind = $kind VersionOverride = $versionOverride } } } if (Test-AvmAutoInstallDisabled -Explicit:$NoAutoInstall) { Write-AvmLog ("tool: automatic install disabled for {0}" -f $tool.name) -Level Verbose | Out-Null throw [AvmToolException]::new( ("Tool '{0}' (version {1}) is not installed and automatic installation is disabled (AVM_NO_AUTO_INSTALL). Run: avm tool install {0}" -f $tool.name, $tool.version), 'AVM1014') } Write-AvmLog ("Installing {0} {1} ({2})..." -f $tool.name, $tool.version, $platform) -Level Install | Out-Null $installed = Install-AvmToolFromPins -Tool $tool -Platform $platform Write-AvmLog ("tool: install action for {0} = {1}" -f $tool.name, $installed.Action) -Level Verbose | Out-Null if (-not (Get-AvmToolCacheEntry -Tool $tool -Platform $platform).Cached) { throw [AvmToolException]::new( ("Tool '{0}' (version {1}) could not be installed automatically. Run: avm tool install {0}" -f $tool.name, $tool.version), 'AVM1014') } $source = if ($installed -and $installed.Action -eq 'installed') { 'installed' } else { 'cache' } Write-AvmLog ("Installed {0} {1} at {2}" -f $tool.name, $tool.version, $entrypoint) -Level Install | Out-Null return [pscustomobject][ordered]@{ Name = $tool.name Version = $tool.version Platform = $platform Source = $source Path = $entrypoint Kind = $kind VersionOverride = $versionOverride } } # SIG # Begin signature block # MIInTwYJKoZIhvcNAQcCoIInQDCCJzwCAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCCbBfGcmpe2PFu7 # 4a/yMtj0vb/xwTKbgCfB3kQgDWZxQaCCDMkwggYEMIID7KADAgECAhMzAAACHPrN # xZvoL37EAAAAAAIcMA0GCSqGSIb3DQEBCwUAMFcxCzAJBgNVBAYTAlVTMR4wHAYD # VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBD # b2RlIFNpZ25pbmcgUENBIDIwMjQwHhcNMjYwNDE2MTg1OTQxWhcNMjcwNDE1MTg1 # OTQxWjB0MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE # BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYD # VQQDExVNaWNyb3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IB # DwAwggEKAoIBAQDVsZfgOKmM31HPfoWOoNEiw0SlCiIxUMC0I9NMWbucKOw/e9lP # oAoehQVu6SG65V4EPzrYsnBnFPNoi4/HoOdjhz1qkrEt4I6tEcxXU6oOeY9zGveC # /3iBeuhLYxM3M/PkcUoebF+Nednm8OkdSPoDu8imViHPQq/8CQUu0WRR4rE+dMRf # rpVqfmNi2qWCX94T4MsepijGVkwE//tJg0ryAiYdHT34LSnlG/RSBZmQRGWZ5g8j # qnKjRParSqMft1gvjuUTVgtWNZfgcLFSK5Wa0myrq8OPcgTGGsRgun+tnSS+IxDT # xVsAPH1OzvPjwomguByhUe/OcvUN0D5Wmp7xAgMBAAGjggGqMIIBpjAOBgNVHQ8B # Af8EBAMCB4AwHwYDVR0lBBgwFgYKKwYBBAGCN0wIAQYIKwYBBQUHAwMwHQYDVR0O # BBYEFNoH7a2YDjOSwpkp6DHcmUS7J+0yMFQGA1UdEQRNMEukSTBHMS0wKwYDVQQL # EyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxFjAUBgNVBAUT # DTIzMDAxMis1MDc1NjkwHwYDVR0jBBgwFoAUf1k/VCHarU/vBeXmo9ctBpQSCDEw # YAYDVR0fBFkwVzBVoFOgUYZPaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9w # cy9jcmwvTWljcm9zb2Z0JTIwQ29kZSUyMFNpZ25pbmclMjBQQ0ElMjAyMDI0LmNy # bDBtBggrBgEFBQcBAQRhMF8wXQYIKwYBBQUHMAKGUWh0dHA6Ly93d3cubWljcm9z # b2Z0LmNvbS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwQ29kZSUyMFNpZ25pbmcl # MjBQQ0ElMjAyMDI0LmNydDAMBgNVHRMBAf8EAjAAMA0GCSqGSIb3DQEBCwUAA4IC # AQAUnEqhaRXe0T3hIJjvdQErEkrA/7bByjn6t5IArODkkRjzkYwtKMc2yYj2quaN # rLutWw2YZcngKPy1b71YyDJQTy4NDRwaSh9Tw5thrk3NmcPrAHia5vtcBJ1CgtKK # 7mQbIcQ22d/N3813ayCDDFewu1+jsZmX+r/aTEqaOM4TVxVtRSkuCy8nAXKuChOK # Li/zA4XuH8iEYqIsj2YoNaeSxVmeGiERXpKdo3dDmYi0kO5w2D8VS4c3+9h6gElY # BaAAg/dYErBg27qT3vv0zRDJhJufvCNylA8S7/+8H5E/PV5cng6na9VV/w9OV3qu # uND6zdGa2EX38Glp50F9AIQk3p2xXmcvorDeM4XJ7UlWYBi6g80J1SSOQnInCYFE # msfUNn3+1AaTJKSJL83quKArTac2pKhu0Yzzzrzo6HrsRiQKzpnRBb1/dMa6P3hz # 75XbMRBctNsFhZC07WCmjExdLg2eHW5uV0TY8D5+6wozJf7vF3+WHkYPO85Z+BC6 # U4FkNbYNycZ9cE4j1tXRdyDCfml6c0HWPHjNVDObrv9lKt3qUqFpX38VCqVCyNOO # 1UcXfQiVjJw32U2WUKZjt/neJKHEBsm9kFsLuWzkQ53+qcaSaytmsCnk2gOglrlD # 5d3kKyvvAw+rzm0lT8K38P6PLxfZQHhu4W8dV7Av8N2ZmDCCBr0wggSloAMCAQIC # EzMAAAA5O7Y3Gb8GHWcAAAAAADkwDQYJKoZIhvcNAQEMBQAwgYgxCzAJBgNVBAYT # AlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYD # VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBS # b290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDExMB4XDTI0MDgwODIwNTQxOFoX # DTM2MDMyMjIyMTMwNFowVzELMAkGA1UEBhMCVVMxHjAcBgNVBAoTFU1pY3Jvc29m # dCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9zb2Z0IENvZGUgU2lnbmluZyBQ # Q0EgMjAyNDCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANgBnB7jOMeq # lRYHNa265v4IY9fH8TKhemHfPINe1gpLaV3dhg324WwH06LcHbpnsBukCDNitryo # 0dtS/EW6I/yEL/bLSY8hKpbfQuWusBPr9qazYcDxCW/qnjb5JsI1s8bNOg3bVATv # QVL4tcf03aTycsz8QeCdM0l/yHRObJ9QqazM1r6VPEOJ7LL+uEEb73w6QCuhs89a # 1uv1zerOYMnsneRRwCbpyW11IcggU0cRKDDq1pjVJzIbIF6+oiXXbReOsgeI8zu1 # FyQfK0fVkaya8SmVHQ/tOf23mZ4W9k0Ri22QW9p3UgSC5OUDktKxxcCmGL6tXLfO # GSWHIIV4YrTJTT6PNty5REojHJuZHArkF9VnHTERWoTjAzfI3kP+5b4alUdhgAZ7 # ttOu1bVnXfHaqPYl2rPs20ji03LOVWsh/radgE17es5hL+t6lV0eVHrVhsssROWJ # uz2MXMCt7iw7lFPG9LXKGjsmonn2gotGdHIuEg5JnJMJVmixd5LRlkmgYRZKzhxS # CwyoGIq0PhaA7Y+VPct5pCHkijcIIDm0nlkK+0KyepolcqGm0T/GYQRMhHJlGOOm # VQop36wUVUYklUy++vDWeEgEo4s7hxN6mIbf2MSIQ/iIfMZgJxC69oukMUXCrOC3 # SkE/xIkgpfl22MM1itkZ35nNXkMolU1lAgMBAAGjggFOMIIBSjAOBgNVHQ8BAf8E # BAMCAYYwEAYJKwYBBAGCNxUBBAMCAQAwHQYDVR0OBBYEFH9ZP1Qh2q1P7wXl5qPX # LQaUEggxMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBBMA8GA1UdEwEB/wQFMAMB # Af8wHwYDVR0jBBgwFoAUci06AjGQQ7kUBU7h6qfHMdEjiTQwWgYDVR0fBFMwUTBP # oE2gS4ZJaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMv # TWljUm9vQ2VyQXV0MjAxMV8yMDExXzAzXzIyLmNybDBeBggrBgEFBQcBAQRSMFAw # TgYIKwYBBQUHMAKGQmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMv # TWljUm9vQ2VyQXV0MjAxMV8yMDExXzAzXzIyLmNydDANBgkqhkiG9w0BAQwFAAOC # AgEAFJQfOChP7onn6fLIMKrSlN1WYKwDFgAddymOUO3FrM8d7B/W/iQ6DxXsDn7D # 5W4wMwYeLystcEqfkjz4NURRgazyMu5yRzQh4LqjA4tStTcJh1opExo7nn5PuPBY # nbu0+THSuVHTe0VTTPVhily/piFrDo3axQ9P4C+Ol5yet+2gTfekICS5xS+cYfSI # vgn0JksVBVMYVI5QFu/qhnLhsEFEUzG8fvv0hjgkO+lkpV9ty6GkN4vdnd7ya6Q6 # aR9y34aiM1qmxaxBi6OUnyNl6fkuun/diTFnYDLTppOkr/mg5WSfCiDVMNCxtj4w # PKC5OmHm1DQIt/MNokbbH3UGsFP1QbzsLocuSqLCvH09Io3fDPTmscR9Y75G4qX7 # RTX8AdBPo0I6OEojf39zuFZt0qOHm65YWQE69cZM2ueE1MB05dNNgHK9gTE7zKvK # /fg8B2qjW88MT/WF5V5uvZGtqa9FSL2RazArA+rDPuf6JGYz4HpgMZHB4S6szWSK # YBv0VisCzfxgeU+dquXW9bd0auYlOB58DPcOYKdc3Se94g+xL4pcEhbB54JOgAkw # YTu/9dLeH2pDqeJZAABVDWRQCaXfO5LgyKwKCLYXpigrZYCjUSBcr+Ve8PFWMhVT # Ql0v4q8J/AUmQN5W4n101cY2L4A7GTQG1h32HHAvfQESWP0xghncMIIZ2AIBATBu # MFcxCzAJBgNVBAYTAlVTMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x # KDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMjQCEzMAAAIc # +s3Fm+gvfsQAAAAAAhwwDQYJYIZIAWUDBAIBBQCggZAwGQYJKoZIhvcNAQkDMQwG # CisGAQQBgjcCAQQwLwYJKoZIhvcNAQkEMSIEIHstlvXLC4PL5tScS9MmJN1F+yVR # sXkbD7L0ST73OMyyMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBv # AGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAE # ggEAXoTzcnbtMhha1rVokEVKldYQtN0Xq5HUrSvf3clvlBaGMjATpNFlnV/kAFSu # 0laX4YlWuvfGIlTb4G5pD+8lVvMhTn7ZH0BxwLXOG7ppW6Bscf1mVBGB4Hj+hh/p # NdaAIObwLjhySU9XENd4YONOQ7C0NLC5Y91oqD63YajEcuoqSJeaK23pN+DLB4XH # 7ESgaxW0hayjbBtD+nI/NR/JpOqasRgIVeXDOlGIcqT8vDSValopq4EicgLnvC99 # aAAg+ZlYXBBYMm7gR73pSp4ljdoLn9MNqIiasWkg3evl5MjSZlZvft854GnMJx9h # 03Yib50qb/41fQGf4nzX2QIbvaGCF6wwgheoBgorBgEEAYI3AwMBMYIXmDCCF5QG # CSqGSIb3DQEHAqCCF4UwgheBAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFZBgsqhkiG # 9w0BCRABBKCCAUgEggFEMIIBQAIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQC # AQUABCCKF5T6Rz9aq6vhoOxVhRlOVEERNNsrBJMpHzFscyaXdQIGavNsOtjxGBIy # MDI2MTExOTE2MjQxMy4zM1owBIACAfSggdmkgdYwgdMxCzAJBgNVBAYTAlVTMRMw # EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN # aWNyb3NvZnQgQ29ycG9yYXRpb24xLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5k # IE9wZXJhdGlvbnMgTGltaXRlZDEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjZG # MUEtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2 # aWNloIIR+zCCBygwggUQoAMCAQICEzMAAAIzEF+3NtqoQFIAAQAAAjMwDQYJKoZI # hvcNAQELBQAwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAO # BgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEm # MCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwHhcNMjYxMDE1 # MTgzNzQwWhcNMjgwMTExMTgzNzQwWjCB0zELMAkGA1UEBhMCVVMxEzARBgNVBAgT # Cldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29m # dCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWljcm9zb2Z0IElyZWxhbmQgT3BlcmF0 # aW9ucyBMaW1pdGVkMScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046NkYxQS0wNUUw # LUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2UwggIi # MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC8l5hSmRcLNSX1OAtiblnbTOjV # i3VdcPzuwTMCzmZwYGvqsze6jiLl8wB+WOSKMl/BjfKl+cG49fwhhL9IqrmTerRn # YHOtXMwswtMDzU482BT8eykyP3B38DES7PsDTAfm+K8tBY6uJshpfkR+ng4W3e9L # UVLZsM0vyiOG/W/7JUpFfRYCZw3WPWUYqX/uqA93Z8mdAkBsxVLo2MBbXqXuAsli # sURP8P2CVA0C3Rmg2+02FZAfdPGg6+0eXdVUVmlul1ui1cx0tvTfX8NNcFVxXBwo # T7Pb1nMq6X9lB/XHIFAVu+oRuyN4GmU6hjCUh+dmycTEK+nNreYYr0Xj1QiNHgWD # 3wOQ4DLXjnGSJMb+U7UBZwGjmToiCeIp49J66zhNE4wQUOH39OsrtKHHg8W8tBhO # w3Tzxa0gF3Wcz8BvRdY+UGmgok3a1UImz+3svu3uvRacd2GKo1wzsJ1QCBbCtwjJ # EeE18cWhHy1mZcb4PVcNxUPzfbAupPF+ERkNl/ow5bIUz+nvmlV2lSMwrovsFG0u # qarv7eyW0aBVO4LLbc5O8ozNnQyDPNIhDnv9chnLJSXpWloQFHy+PEiNV88KBJZQ # hIr2M1q0sUdB5kmZDRhlsSaEE0UZtwcj6VJetNeJUlDrlT1V2krlD6IPgZa/NOg0 # 3duyOKpEZnVyfTPSBQIDAQABo4IBSTCCAUUwHQYDVR0OBBYEFDTcA1da+VN0e9H9 # +gL+81bOCZ6yMB8GA1UdIwQYMBaAFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMF8GA1Ud # HwRYMFYwVKBSoFCGTmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY3Js # L01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNybDBsBggr # BgEFBQcBAQRgMF4wXAYIKwYBBQUHMAKGUGh0dHA6Ly93d3cubWljcm9zb2Z0LmNv # bS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUyMDIw # MTAoMSkuY3J0MAwGA1UdEwEB/wQCMAAwFgYDVR0lAQH/BAwwCgYIKwYBBQUHAwgw # DgYDVR0PAQH/BAQDAgeAMA0GCSqGSIb3DQEBCwUAA4ICAQBUF0lu8s2Eux08/MSG # D79uQsl5EPEByxSD+em44YOrxILObuNdMKObxlMQ18DEf/aC7D+esFks57mQts+P # eA8uBib2T0Y6wGGzAyLjyu2XpXSBvU45yRVBCQJJBfKPI6yMjMiCkh7Ge5999rA5 # 4MLm3ausyk6/HWa2pWd81kgYynKCmgaHmpsX8/vi6E25oznZQQDf5XFdR/11JQ/0 # uBjNjiQseucm6WRJDpAeLExrYiYY1iIY/t+2l7yTx2S+NsbNOi6iWOWoKoeImZiu # M+XrzH2s+vf6SKUq56a9rDIu1DrNvRbO9IotK/ou8TwNua4B5ydtHwKMM3J4qJWq # fJjthUqHzFwpca/bQxYVWJE2snAPrrZGYqM6uul8SL4vNNV99HsUH0hNGd+UwJuh # GI8ibi6ce/vMoYUM/Z7tChbXt0DLRAYYF5HjRTH/MMVTZgJEwHzQ7FRgSCanqMfT # p0hZ5Hrlv/ACbbJvaHSRrhuBJ7vsHkv95kVGLZbBjt/sEULfoen99eQwyjlDxccQ # NB9C1QdZjfFEPWwKJFRPSD0m8D1Tb61GH9Rev6ucdb3UQhbbGqsTAsKfCtHpiqYf # hUrgtJAnzn+a2sPMTTAo6EFxkI+ApIVjFhNcMheDmrXF4TfZjyLUFhircZ0bu5dT # u1Oc0TdZwu0jaJ1wtN3IG1ehmjCCB3EwggVZoAMCAQICEzMAAAAVxedrngKbSZkA # AAAAABUwDQYJKoZIhvcNAQELBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpX # YXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQg # Q29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmljYXRl # IEF1dGhvcml0eSAyMDEwMB4XDTIxMDkzMDE4MjIyNVoXDTMwMDkzMDE4MzIyNVow # fDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1Jl # ZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMd # TWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwggIiMA0GCSqGSIb3DQEBAQUA # A4ICDwAwggIKAoICAQDk4aZM57RyIQt5osvXJHm9DtWC0/3unAcH0qlsTnXIyjVX # 9gF/bErg4r25PhdgM/9cT8dm95VTcVrifkpa/rg2Z4VGIwy1jRPPdzLAEBjoYH1q # UoNEt6aORmsHFPPFdvWGUNzBRMhxXFExN6AKOG6N7dcP2CZTfDlhAnrEqv1yaa8d # q6z2Nr41JmTamDu6GnszrYBbfowQHJ1S/rboYiXcag/PXfT+jlPP1uyFVk3v3byN # pOORj7I5LFGc6XBpDco2LXCOMcg1KL3jtIckw+DJj361VI/c+gVVmG1oO5pGve2k # rnopN6zL64NF50ZuyjLVwIYwXE8s4mKyzbnijYjklqwBSru+cakXW2dg3viSkR4d # Pf0gz3N9QZpGdc3EXzTdEonW/aUgfX782Z5F37ZyL9t9X4C626p+Nuw2TPYrbqgS # Uei/BQOj0XOmTTd0lBw0gg/wEPK3Rxjtp+iZfD9M269ewvPV2HM9Q07BMzlMjgK8 # QmguEOqEUUbi0b1qGFphAXPKZ6Je1yh2AuIzGHLXpyDwwvoSCtdjbwzJNmSLW6Cm # gyFdXzB0kZSU2LlQ+QuJYfM2BjUYhEfb3BvR/bLUHMVr9lxSUV0S2yW6r1AFemzF # ER1y7435UsSFF5PAPBXbGjfHCBUYP3irRbb1Hode2o+eFnJpxq57t7c+auIurQID # AQABo4IB3TCCAdkwEgYJKwYBBAGCNxUBBAUCAwEAATAjBgkrBgEEAYI3FQIEFgQU # KqdS/mTEmr6CkTxGNSnPEP8vBO4wHQYDVR0OBBYEFJ+nFV0AXmJdg/Tl0mWnG1M1 # GelyMFwGA1UdIARVMFMwUQYMKwYBBAGCN0yDfQEBMEEwPwYIKwYBBQUHAgEWM2h0 # dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvRG9jcy9SZXBvc2l0b3J5Lmh0 # bTATBgNVHSUEDDAKBggrBgEFBQcDCDAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMA # QTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBTV9lbL # j+iiXGJo0T2UkFvXzpoYxDBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8vY3JsLm1p # Y3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXRfMjAxMC0w # Ni0yMy5jcmwwWgYIKwYBBQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRwOi8vd3d3 # Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIz # LmNydDANBgkqhkiG9w0BAQsFAAOCAgEAnVV9/Cqt4SwfZwExJFvhnnJL/Klv6lwU # tj5OR2R4sQaTlz0xM7U518JxNj/aZGx80HU5bbsPMeTCj/ts0aGUGCLu6WZnOlNN # 3Zi6th542DYunKmCVgADsAW+iehp4LoJ7nvfam++Kctu2D9IdQHZGN5tggz1bSNU # 5HhTdSRXud2f8449xvNo32X2pFaq95W2KFUn0CS9QKC/GbYSEhFdPSfgQJY4rPf5 # KYnDvBewVIVCs/wMnosZiefwC2qBwoEZQhlSdYo2wh3DYXMuLGt7bj8sCXgU6ZGy # qVvfSaN0DLzskYDSPeZKPmY7T7uG+jIa2Zb0j/aRAfbOxnT99kxybxCrdTDFNLB6 # 2FD+CljdQDzHVG2dY3RILLFORy3BFARxv2T5JL5zbcqOCb2zAVdJVGTZc9d/HltE # AY5aGZFrDZ+kKNxnGSgkujhLmm77IVRrakURR6nxt67I6IleT53S0Ex2tVdUCbFp # AUR+fKFhbHP+CrvsQWY9af3LwUFJfn6Tvsv4O+S3Fb+0zj6lMVGEvL8CwYKiexcd # FYmNcP7ntdAoGokLjzbaukz5m/8K6TT4JDVnK+ANuOaMmdbhIurwJ0I9JZTmdHRb # atGePu1+oDEzfbzL6Xu/OHBE0ZDxyKs6ijoIYn/ZcGNTTY3ugm2lBRDBcQZqELQd # VTNYs6FwZvKhggNWMIICPgIBATCCAQGhgdmkgdYwgdMxCzAJBgNVBAYTAlVTMRMw # EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN # aWNyb3NvZnQgQ29ycG9yYXRpb24xLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5k # IE9wZXJhdGlvbnMgTGltaXRlZDEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjZG # MUEtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2 # aWNloiMKAQEwBwYFKw4DAhoDFQBbE8osOLFy7jKCPdFImKD+e14MFKCBgzCBgKR+ # MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdS # ZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMT # HU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMA0GCSqGSIb3DQEBCwUAAgUA # 7qkeTjAiGA8yMDI2MTExOTA3MDU1MFoYDzIwMjYxMTIwMDcwNTUwWjB0MDoGCisG # AQQBhFkKBAExLDAqMAoCBQDuqR5OAgEAMAcCAQACAiqJMAcCAQACAhLgMAoCBQDu # qm/OAgEAMDYGCisGAQQBhFkKBAIxKDAmMAwGCisGAQQBhFkKAwKgCjAIAgEAAgMH # oSChCjAIAgEAAgMBhqAwDQYJKoZIhvcNAQELBQADggEBAAx2gPwsCJCJntJbFBnk # dRF1iEEl7u2qPtM801jDZIEmZ6V2XvzkTzrKrCSt8zTWbujzukuuZtwosOEnCGyz # umQruj9nXvlC3oSVtj3sFVdJ+yHc4JwU0c4LkPdgcWD7tfVPnSYrG9qV3rHObzEh # Woomdt1Ug0E93LVaWA/1oUvnxdUkeaOr4HskyigPoCGB3Kc3VroCHAdtYNtPYqRg # 9WlXTPah0tikB4mlKtsURUiVUTBVYUFwcwORV8nbCbpwmd5dQJi3EA6pycWT7eug # veRa5niTp4lLZEWD2J2GD4DqldvYGSDsDcImhGc66V5Bof7AtWhZ26Nho6F2bdRP # iZExggQNMIIECQIBATCBkzB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu # Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv # cmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAIT # MwAAAjMQX7c22qhAUgABAAACMzANBglghkgBZQMEAgEFAKCCAUowGgYJKoZIhvcN # AQkDMQ0GCyqGSIb3DQEJEAEEMC8GCSqGSIb3DQEJBDEiBCDT0NvLbcUH51FuGNEg # I5u1FjtGx/ai4DSswPc6gkqb+DCB+gYLKoZIhvcNAQkQAi8xgeowgecwgeQwgb0E # IJa57mILS0hdZpTRBP9SncxQtlRvlT173qrjREHSDjmXMIGYMIGApH4wfDELMAkG # A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQx # HjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9z # b2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAIzEF+3NtqoQFIAAQAAAjMwIgQg # P/J6jbVyCWpB2+GDIrKiONRVmLUwrtIRCTXukDKjxtkwDQYJKoZIhvcNAQELBQAE # ggIAT2WeIhblsDoYrb5E2EFw9LjloS9ePNOQU9W5G/viomLkPixFxphbK1KjSB4F # B8ZDCB2wRyjZKUbYC1/Stw7pZiGcnjHEV4u8UM5kZfC5FF29YZPsQ2JcxbdyFLcE # PN+0OtA5cyHM9F/9eYeJCh81BuOfQIFGIcIJbbUimhI7zdQJUc2a5ROaAhIch1xs # 1ahX3vJrHp31wzHa850zUD8cPDpvpuTaHTlgl6EiisJDUvWQwoQKluRzu/U0Mnd/ # HW+jpIXdP1HwmgXHugz79C759hITWCstmivJZdYIFqs65X0cBvk4R4v5+2hS9bQP # APmbEhodyqDXD+JtFEvFXlxiyTmXPT6F2p6EJJLbLtdrY7BXsTZEvcVG/YQZHBwe # qn9pQn4JOuY8/W1bpzouRgbNBJF9DS1Nj3dLogUIUMZ3n0xJlb9ZFUUWyOTsu2wC # UE3+f/tHUynWEN1MGu2si1FZ3si7nkTa+9UvrSMFuA9af7KvhvTbh6Tbsh3XiOeo # E9x3mahiUysdIEn5dsIaNaCS7P3UpRsjZ/Xsy2FQje2/VzIW9Peydi4p+N1/RwFh # MTW54tt285b6wMYE3l1dKt/tYrCmAiYtU2w5cNo7tWE5o9mkhxRVc14DPBceuc3j # Prz+FCbo6waQLqFbqlDKwUSB+XIeQ6JdZuECwGtg6irqr/E= # SIG # End signature block |