From nobody Mon Apr 29 02:41:34 2024
Delivered-To: importer@patchew.org
Received-SPF: pass (zoho.com: domain of groups.io designates 66.175.222.12 as
 permitted sender) client-ip=66.175.222.12;
 envelope-from=bounce+27952+42407+1787277+3901457@groups.io;
 helo=web01.groups.io;
Authentication-Results: mx.zohomail.com;
	dkim=pass;
	spf=pass (zoho.com: domain of groups.io designates 66.175.222.12 as permitted
 sender)  smtp.mailfrom=bounce+27952+42407+1787277+3901457@groups.io;
	dmarc=fail(p=none dis=none)  header.from=intel.com
ARC-Seal: i=1; a=rsa-sha256; t=1560478484; cv=none;
	d=zoho.com; s=zohoarc;
	b=Fnf6D0QQRPT7RaR+ld0X/Uk0hSkZlwokQ1gsYAXDGu/0TlcQmtoJIUGSd4lBp2h7CIzY+g/ioOMEwLMMzdWTsZl4yqWilP0ienz1VSB5v0O1MYsTob9XYnQxvF02xLPzdfqTuZ/C7cUBlrogr75RdhNJO3ZwmE1FkOhTp3SxwZ4=
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zoho.com;
 s=zohoarc;
	t=1560478484;
 h=Content-Type:Cc:Date:From:List-Id:List-Unsubscribe:MIME-Version:Message-ID:Reply-To:Sender:Subject:To:ARC-Authentication-Results;
	bh=Q0Fhma8gP79phu7zrdMPMx1R5c0i29j5vGzEfPcylEA=;
	b=oBX+FmyWaLf2FDldox600IB7c9x+PifD4G26U2xi8Rdg6BBi0Us7uX9J8n1UC8HsGd+ALz+7J6i96IgHtwvEWspfvVFx2VRBpMqz+BC6oIgTDzElXoI4Z74Y0xpuRF8VAaAYxK6qI94sVnpirXZuk4E8kHwBt3GOnAUU2r5CHgM=
ARC-Authentication-Results: i=1; mx.zoho.com;
	dkim=pass;
	spf=pass (zoho.com: domain of groups.io designates 66.175.222.12 as permitted
 sender)  smtp.mailfrom=bounce+27952+42407+1787277+3901457@groups.io;
	dmarc=fail header.from=<zhijux.fan@intel.com> (p=none dis=none)
 header.from=<zhijux.fan@intel.com>
Received: from web01.groups.io (web01.groups.io [66.175.222.12]) by
 mx.zohomail.com
	with SMTPS id 1560478483929617.8808532254833;
 Thu, 13 Jun 2019 19:14:43 -0700 (PDT)
Return-Path: <bounce+27952+42407+1787277+3901457@groups.io>
X-Received: from mga04.intel.com (mga04.intel.com [192.55.52.120])
 by groups.io with SMTP; Thu, 13 Jun 2019 19:14:43 -0700
X-Amp-Result: UNKNOWN
X-Amp-Original-Verdict: FILE UNKNOWN
X-Amp-File-Uploaded: False
X-Received: from orsmga001.jf.intel.com ([10.7.209.18])
  by fmsmga104.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384;
 13 Jun 2019 19:14:42 -0700
X-ExtLoop1: 1
X-Received: from fmsmsx107.amr.corp.intel.com ([10.18.124.205])
  by orsmga001.jf.intel.com with ESMTP; 13 Jun 2019 19:14:42 -0700
X-Received: from fmsmsx122.amr.corp.intel.com (10.18.125.37) by
 fmsmsx107.amr.corp.intel.com (10.18.124.205) with Microsoft SMTP Server (TLS)
 id 14.3.408.0; Thu, 13 Jun 2019 19:14:42 -0700
X-Received: from shsmsx154.ccr.corp.intel.com (10.239.6.54) by
 fmsmsx122.amr.corp.intel.com (10.18.125.37) with Microsoft SMTP Server (TLS)
 id 14.3.408.0; Thu, 13 Jun 2019 19:14:42 -0700
X-Received: from shsmsx101.ccr.corp.intel.com ([169.254.1.104]) by
 SHSMSX154.ccr.corp.intel.com ([169.254.7.156]) with mapi id 14.03.0439.000;
 Fri, 14 Jun 2019 10:14:32 +0800
From: "Fan, ZhijuX" <zhijux.fan@intel.com>
To: "devel@edk2.groups.io" <devel@edk2.groups.io>
CC: "Gao, Liming" <liming.gao@intel.com>, "Feng, Bob C" <bob.c.feng@intel.com>
Subject: [edk2-devel] [PATCH V2] BaseTools:Add DetectNotUsedItem.py to
 Edk2\BaseTools\Scripts
Thread-Topic: [PATCH V2] BaseTools:Add DetectNotUsedItem.py to
 Edk2\BaseTools\Scripts
Thread-Index: AdUiVuR4nF7eqBn/Tf2Zhy+Cd5Tc+Q==
Date: Fri, 14 Jun 2019 02:14:31 +0000
Message-ID: 
 <FAD0D7E0AE0FA54D987F6E72435CAFD50AF81F35@SHSMSX101.ccr.corp.intel.com>
Accept-Language: en-US
X-MS-Has-Attach: 
X-MS-TNEF-Correlator: 
 <FAD0D7E0AE0FA54D987F6E72435CAFD50AF81F35@SHSMSX101.ccr.corp.intel.com>
dlp-product: dlpe-windows
dlp-version: 11.0.600.7
dlp-reaction: no-action
x-originating-ip: [10.239.127.40]
MIME-Version: 1.0
Precedence: Bulk
List-Unsubscribe: <https://edk2.groups.io/g/devel/unsub>
Sender: devel@edk2.groups.io
List-Id: <devel.edk2.groups.io>
Mailing-List: list devel@edk2.groups.io; contact devel+owner@edk2.groups.io
Reply-To: devel@edk2.groups.io,zhijux.fan@intel.com
Content-Type: multipart/mixed;
	boundary="_000_FAD0D7E0AE0FA54D987F6E72435CAFD50AF81F35SHSMSX101ccrcor_"
Content-Language: en-US
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io;
 q=dns/txt; s=20140610; t=1560478483;
 bh=ZUXcH0IEWNBfvKvxaWDWJGhbYNA5g2Ng9LQZER2d9zE=;
 h=CC:Content-Type:Date:From:Reply-To:Subject:To;
 b=AxoGg5Wt5NuImL7NJdhoPEm/7EPS6BFt7Gfh0aJE6p604CIklsB55Xjt3iv9i4adzt1
 wXWeDw+0VINnT6xLNZfSaeVqVxWYEWkr2C9XxsrYcoN5BmPAlG74cF6SIyAK2FkFlHoOo
 OmXhotuxJADyNAPMNb3LHjHAdVmEXRrxOeo=
X-Zoho-Virus-Status: 1
X-ZohoMail-DKIM: pass (identity @groups.io)

--_000_FAD0D7E0AE0FA54D987F6E72435CAFD50AF81F35SHSMSX101ccrcor_
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
Content-Type: text/plain; charset="utf-8"

BZ:https://bugzilla.tianocore.org/show_bug.cgi?id=3D1850

This script is used to Detect unreferenced PCD and GUID/Protocols/PPIs.
The input parameters are Dec file and package directory.

This script can be run in both Py2 and Py3.

Cc: Bob Feng <bob.c.feng@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Signed-off-by: Zhiju.Fan <zhijux.fan@intel.com>
---
 BaseTools/Scripts/DetectNotUsedItem.py | 199 +++++++++++++++++++++++++++++=
++++
 1 file changed, 199 insertions(+)
 create mode 100644 BaseTools/Scripts/DetectNotUsedItem.py

diff --git a/BaseTools/Scripts/DetectNotUsedItem.py b/BaseTools/Scripts/Det=
ectNotUsedItem.py
new file mode 100644
index 0000000000..7e3568fcf9
--- /dev/null
+++ b/BaseTools/Scripts/DetectNotUsedItem.py
@@ -0,0 +1,199 @@
+## @file
+# Detect unreferenced PCD and GUID/Protocols/PPIs.
+#
+# Copyright (c) 2019, Intel Corporation. All rights reserved.
+#
+# SPDX-License-Identifier: BSD-2-Clause-Patent
+#
+
+'''
+DetectNotUsedItem
+'''
+import re
+import os
+import sys
+import argparse
+
+#
+# Globals for help information
+#
+__prog__ =3D 'DetectNotUsedItem'
+__version__ =3D '%s Version %s' % (__prog__, '0.1')
+__copyright__ =3D 'Copyright (c) 2019, Intel Corporation. All rights reser=
ved.'
+__description__ =3D "Detect unreferenced PCD and GUID/Protocols/PPIs.\n"
+
+SectionList =3D ["LibraryClasses", "Guids", "Ppis", "Protocols", "Pcd"]
+
+
+class PROCESS(object):
+
+    def __init__(self, DecPath, InfDirs):
+        self.Dec =3D DecPath
+        self.InfPath =3D InfDirs
+        self.Log =3D []
+
+    def ParserDscFdfInfFile(self):
+        AllContentList =3D []
+        for File in self.SearchbyExt([".dsc", ".fdf", ".inf"]):
+            AllContentList +=3D self.ParseDscFdfInfContent(File)
+        return AllContentList
+
+    # Search File by extension name
+    def SearchbyExt(self, ExtList):
+        FileList =3D []
+        for path in self.InfPath:
+            if type(ExtList) =3D=3D type(''):
+                for root, _, files in os.walk(path, topdown=3DTrue, follow=
links=3DFalse):
+                    for filename in files:
+                        if filename.endswith(ExtList):
+                            FileList.append(os.path.join(root, filename))
+            elif type(ExtList) =3D=3D type([]):
+                for root, _, files in os.walk(path, topdown=3DTrue, follow=
links=3DFalse):
+                    for filename in files:
+                        for Ext in ExtList:
+                            if filename.endswith(Ext):
+                                FileList.append(os.path.join(root, filenam=
e))
+        return FileList
+
+    # Parse DEC file to get Line number and Name
+    # return section name, the Item Name and comments line number
+    def ParseDecContent(self):
+        SectionRE =3D re.compile(r'\[(.*)\]')
+        Flag =3D False
+        Comments =3D {}
+        Comment_Line =3D []
+        ItemName =3D {}
+        with open(self.Dec, 'r') as F:
+            for Index, content in enumerate(F):
+                NotComment =3D not content.strip().startswith("#")
+                Section =3D SectionRE.findall(content)
+                if Section and NotComment:
+                    Flag =3D self.IsNeedParseSection(Section[0])
+                if Flag:
+                    Comment_Line.append(Index)
+                    if NotComment:
+                        if content !=3D "\n" and content !=3D "\r\n":
+                            ItemName[Index] =3D content.split('=3D')[0].sp=
lit('|')[0].split('#')[0].strip()
+                            Comments[Index] =3D Comment_Line
+                            Comment_Line =3D []
+        return ItemName, Comments
+
+    def IsNeedParseSection(self, SectionName):
+        for item in SectionList:
+            if item in SectionName:
+                return True
+        return False
+
+    # Parse DSC, FDF, INF File, remove comments, return Lines list
+    def ParseDscFdfInfContent(self, File):
+        with open(File, 'r') as F:
+            lines =3D F.readlines()
+        for Index in range(len(lines) - 1, -1, -1):
+            if lines[Index].strip().startswith("#") or lines[Index] =3D=3D=
 "\n" or lines[Index] =3D=3D "\r\n":
+                lines.remove(lines[Index])
+            elif "#" in lines[Index]:
+                lines[Index] =3D lines[Index].split("#")[0].strip()
+            else:
+                lines[Index] =3D lines[Index].strip()
+        return lines
+
+    def DetectNotUsedItem(self):
+        NotUsedItem =3D {}
+        DecItem, DecComments =3D self.ParseDecContent()
+        InfDscFdfContent =3D self.ParserDscFdfInfFile()
+        for LineNum in list(DecItem.keys()):
+            DecItemName =3D DecItem[LineNum]
+            Match_reg =3D re.compile("(?<![a-zA-Z0-9_-])%s(?![a-zA-Z0-9_-]=
)" % DecItemName)
+            MatchFlag =3D False
+            for Line in InfDscFdfContent:
+                if Match_reg.search(Line):
+                    MatchFlag =3D True
+                    break
+            if not MatchFlag:
+                NotUsedItem[LineNum] =3D DecItemName
+        self.Display(NotUsedItem)
+        return NotUsedItem, DecComments
+
+    def Display(self, UnuseDict):
+        print("DEC File:\n%s\n%s%s" % (self.Dec, "{:<15}".format("Line Num=
ber"), "{:<0}".format("Unused Item")))
+        self.Log.append(
+            "DEC File:\n%s\n%s%s\n" % (self.Dec, "{:<15}".format("Line Num=
ber"), "{:<0}".format("Unused Item")))
+        for num in list(sorted(UnuseDict.keys())):
+            ItemName =3D UnuseDict[num]
+            print("%s%s%s" % (" " * 3, "{:<12}".format(num + 1), "{:<1}".f=
ormat(ItemName)))
+            self.Log.append(("%s%s%s\n" % (" " * 3, "{:<12}".format(num + =
1), "{:<1}".format(ItemName))))
+
+    def Clean(self, UnUseDict, Comments):
+        removednum =3D []
+        for num in list(UnUseDict.keys()):
+            if num in list(Comments.keys()):
+                removednum +=3D Comments[num]
+        with open(self.Dec, 'r') as Dec:
+            lines =3D Dec.readlines()
+        try:
+            with open(self.Dec, 'w+') as T:
+                for linenum in range(len(lines)):
+                    if linenum in removednum:
+                        continue
+                    else:
+                        T.write(lines[linenum])
+            print("DEC File has been clean: %s" % (self.Dec))
+        except Exception as err:
+            print(err)
+
+
+class Main(object):
+
+    def mainprocess(self, Dec, Dirs, Isclean, LogPath):
+        for dir in Dirs:
+            if not os.path.exists(dir):
+                print("Error: Invalid path for '--dirs': %s" % dir)
+                sys.exit(1)
+        Pa =3D PROCESS(Dec, Dirs)
+        unuse, comment =3D Pa.DetectNotUsedItem()
+        if Isclean:
+            Pa.Clean(unuse, comment)
+        self.Logging(Pa.Log, LogPath)
+
+    def Logging(self, content, LogPath):
+        if LogPath:
+            try:
+                if os.path.isdir(LogPath):
+                    FilePath =3D os.path.dirname(LogPath)
+                    if not os.path.exists(FilePath):
+                        os.makedirs(FilePath)
+                with open(LogPath, 'w+') as log:
+                    for line in content:
+                        log.write(line)
+                print("Log save to file: %s" % LogPath)
+                log.close()
+            except Exception as e:
+                print("Save log Error: %s" % e)
+
+
+def main():
+    parser =3D argparse.ArgumentParser(prog=3D__prog__,
+                                     description=3D__description__ + __cop=
yright__,
+                                     conflict_handler=3D'resolve')
+    parser.add_argument('-i', '--input', metavar=3D"", dest=3D'InputDec', =
help=3D"Input DEC file name.")
+    parser.add_argument('--dirs', metavar=3D"", action=3D'append', dest=3D=
'Dirs',
+                        help=3D"The package directory. To specify more dir=
ectories, please repeat this option.")
+    parser.add_argument('--clean', action=3D'store_true', default=3DFalse,=
 dest=3D'Clean',
+                        help=3D"Clean the unreferenced items from DEC file=
.")
+    parser.add_argument('--log', metavar=3D"", dest=3D"Logfile", default=
=3DFalse,
+                        help=3D"Put log in specified file as well as on co=
nsole.")
+    options =3D parser.parse_args()
+    if options.InputDec:
+        if not (os.path.exists(options.InputDec) and options.InputDec.ends=
with(".dec")):
+            print("Error: Invalid DEC file input: %s" % options.InputDec)
+        if options.Dirs:
+            M =3D Main()
+            M.mainprocess(options.InputDec, options.Dirs, options.Clean, o=
ptions.Logfile)
+        else:
+            print("Error: the following argument is required:'--dirs'.")
+    else:
+        print("Error: the following argument is required:'-i/--input'.")
+
+
+if __name__ =3D=3D '__main__':
+    main()
--=20
2.14.1.windows.1


-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-
Groups.io Links: You receive all messages sent to this group.

View/Reply Online (#42407): https://edk2.groups.io/g/devel/message/42407
Mute This Topic: https://groups.io/mt/32059660/1787277
Group Owner: devel+owner@edk2.groups.io
Unsubscribe: https://edk2.groups.io/g/devel/unsub  [importer@patchew.org]
-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-=3D-

--_000_FAD0D7E0AE0FA54D987F6E72435CAFD50AF81F35SHSMSX101ccrcor_
Content-Disposition: attachment; filename="winmail.dat"
Content-Transfer-Encoding: base64
Content-Type: application/ms-tnef; name="winmail.dat"

eJ8+IjZuAQaQCAAEAAAAAAABAAEAAQeQBgAIAAAA5AQAAAAAAADoAAEJgAEAIQAAAEVGNTU3NTA4
MjBDODNDNEVBRkI0MUE0RUQ0NkIyNTU0AD0HAQ2ABAACAAAAAgACAAEFgAMADgAAAOMHBgAOAAIA
DgAfAAUAMgEBIIADAA4AAADjBwYADgACAA4AHwAFADIBAQiABwAYAAAASVBNLk1pY3Jvc29mdCBN
YWlsLk5vdGUAMQgBBIABAEgAAABbUEFUQ0ggVjJdIEJhc2VUb29sczpBZGQgRGV0ZWN0Tm90VXNl
ZEl0ZW0ucHkgdG8gRWRrMlxCYXNlVG9vbHNcU2NyaXB0cwA1GQELgAEAIQAAAEVGNTU3NTA4MjBD
ODNDNEVBRkI0MUE0RUQ0NkIyNTU0AD0HAQOQBgAEGQAANAAAAAIBfwABAAAASAAAADxGQUQwRDdF
MEFFMEZBNTREOTg3RjZFNzI0MzVDQUZENTBBRjgxRjM1QFNIU01TWDEwMS5jY3IuY29ycC5pbnRl
bC5jb20+AAsAHw4BAAAAAgEJEAEAAAAUDwAAEA8AAOYoAABMWkZ1vhVCHGEACmZiaWQEAABjY8Bw
ZzEyNTIA/gND8HRleHQB9wKkA+MCAARjaArAc2V0MCDvB20CgwBQEU0yCoAGtAKAln0KgAjIOwli
MTkOwL8JwxZyCjIWcQKAFWIqCbBzCfAEkGF0BbIOUANgc6JvAYAgRXgRwW4YMF0GUnYEkBe2AhBy
AMB0fQhQbhoxECAFwAWgG2RkmiADUiAQIheyXHYIkOR3awuAZDUdUwTwB0ANF3AwCnEX8mJrbWsG
cwGQACAgQk1fQuBFR0lOfQr8AfEL8REfsFo6aAJAcHM6wC8vYnVnegMQC2AkLnQHMG5vBaFlLgEF
sGcvc2hvd19BIlEuY2dpPw3QPagxODUBQGwLgGUKgWklFFRoBAAgBPUmAXXnEgAcYBiQIEQSEAWQ
BUC0dW4JcGYEkAnwYxxRMFBDRCAAcBxgR1VwSUQvUANgGJAI4XPhKVBQSXMuJXcZ4AuA7HB1BUAK
sWEHgBuhBCD3CsAZ4CdQYxxwAxAZ4CjS8QqwY2thGdEN4AlwJ5B9BbB5KkYlfwVAHlADoGK9GeBy
J8Aq8TAQKYBoKIAseTIowzEQMy49Q2NCOh+wb2IgRgnwZ9QgPAbgYiRALigAGcC2QAuAECBsJEAD
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
4Gc4Iy5BOMBtMAsBwWpUKO8hZz1fX/s6MjqALDHPPB882UQAasD/SLHoEjpxPek6gLexOoB0MMRw
eUiwZ2h0Ou9Bf+3bL2bU4GCgX+RAtKB0gMxyPctAznBvbDPQ0qDFN29ynUBkZF84sTlzcij6MGkn
0lH6QO8BdTZ0R1G5kHQrQH/gPSL2Iu/gPeF0RHBbUEfR5gH1R1FoYZBwSKBJU2BQ48H3K7KGwLmB
LqVwRS9GP/pU7UgcYWCgPmInnVRHUUj03/BSR1BAr1HtSgRUSgD5kXxja3nA5CDzEWCRJOB5vi7g
gCuQjMBgkASAee7Q+yTgU/hpznDv4IzQf9Au4O+O0SFwG/ARIGhtoCFR6BL/S59Mr02y5NNHUU8m
bbBVgQ5fETDcYFADZmF1bP9JIHoTSNa7c1DfXv9KBLtz71dh5CABEHOgZupwtJAwgOv5gODRbSKw
Zu8wxCBKxv9YL1k/TbI0AUgPSREq4iuy30jDXHpeH18vSiJQSpE0Ar98MVT0VkD5gEsDy5F377D+
bNLC6DENIUSxYw5XxM2Cv2QFOCNGgs6NEvJuxC5JVv8xv4al7ND1nHF+0rG0oHFv+/XwtKBz0TKt
sBdwVfClcf9yf/gP+RdKx0ez5SZ0/3KP/3FY84+B182R7JN9j4CTHmH/7whxfu/gfsqEmLtzhJhm
9X+Bb95PeU/402DS+fBswG9/0TDVsDiiOXMEcCKwx1Bx8nVUIWQ6+jZjHYiPid/niu+L/40CaS9H
lmMZCs6vBIE/cBeyP3E9yBAnP3B/7uI/cPqgiNo29IjV+kAg4YjVMi4xNJlAKEAlYD5kkUD9ELhw
iOSI1X19A2jAm1AfAEIAAQAAABgAAABGAGEAbgAsACAAWgBoAGkAagB1AFgAAAAfAGUAAQAAACoA
AAB6AGgAaQBqAHUAeAAuAGYAYQBuAEAAaQBuAHQAZQBsAC4AYwBvAG0AAAAAAB8AZAABAAAACgAA
AFMATQBUAFAAAAAAAAIBQQABAAAAZAAAAAAAAACBKx+kvqMQGZ1uAN0BD1QCAAAAgEYAYQBuACwA
IABaAGgAaQBqAHUAWAAAAFMATQBUAFAAAAB6AGgAaQBqAHUAeAAuAGYAYQBuAEAAaQBuAHQAZQBs
AC4AYwBvAG0AAAAfAAJdAQAAACoAAAB6AGgAaQBqAHUAeAAuAGYAYQBuAEAAaQBuAHQAZQBsAC4A
YwBvAG0AAAAAAB8A5V8BAAAAMgAAAHMAaQBwADoAegBoAGkAagB1AHgALgBmAGEAbgBAAGkAbgB0
AGUAbAAuAGMAbwBtAAAAAAAfABoMAQAAABgAAABGAGEAbgAsACAAWgBoAGkAagB1AFgAAAAfAB8M
AQAAACoAAAB6AGgAaQBqAHUAeAAuAGYAYQBuAEAAaQBuAHQAZQBsAC4AYwBvAG0AAAAAAB8AHgwB
AAAACgAAAFMATQBUAFAAAAAAAAIBGQwBAAAAZAAAAAAAAACBKx+kvqMQGZ1uAN0BD1QCAAAAgEYA
YQBuACwAIABaAGgAaQBqAHUAWAAAAFMATQBUAFAAAAB6AGgAaQBqAHUAeAAuAGYAYQBuAEAAaQBu
AHQAZQBsAC4AYwBvAG0AAAAfAAFdAQAAACoAAAB6AGgAaQBqAHUAeAAuAGYAYQBuAEAAaQBuAHQA
ZQBsAC4AYwBvAG0AAAAAAB8A+D8BAAAAGAAAAEYAYQBuACwAIABaAGgAaQBqAHUAWAAAAB8AI0AB
AAAAKgAAAHoAaABpAGoAdQB4AC4AZgBhAG4AQABpAG4AdABlAGwALgBjAG8AbQAAAAAAHwAiQAEA
AAAKAAAAUwBNAFQAUAAAAAAAAgH5PwEAAABkAAAAAAAAAIErH6S+oxAZnW4A3QEPVAIAAACARgBh
AG4ALAAgAFoAaABpAGoAdQBYAAAAUwBNAFQAUAAAAHoAaABpAGoAdQB4AC4AZgBhAG4AQABpAG4A
dABlAGwALgBjAG8AbQAAAB8ACV0BAAAAKgAAAHoAaABpAGoAdQB4AC4AZgBhAG4AQABpAG4AdABl
AGwALgBjAG8AbQAAAAAACwBAOgEAAAAfABoAAQAAABIAAABJAFAATQAuAE4AbwB0AGUAAAAAAAMA
8T8JBAAACwBAOgEAAAADAP0/5AQAAAIBCzABAAAAEAAAAO9VdQggyDxOr7QaTtRrJVQDABcAAQAA
AEAAOQCAHa7mViLVAUAACDBBvgznViLVAR8AAICGAwIAAAAAAMAAAAAAAABGAQAAAB4AAABhAGMA
YwBlAHAAdABsAGEAbgBnAHUAYQBnAGUAAAAAAAEAAAAMAAAAZQBuAC0AVQBTAAAAHwA3AAEAAACQ
AAAAWwBQAEEAVABDAEgAIABWADIAXQAgAEIAYQBzAGUAVABvAG8AbABzADoAQQBkAGQAIABEAGUA
dABlAGMAdABOAG8AdABVAHMAZQBkAEkAdABlAG0ALgBwAHkAIAB0AG8AIABFAGQAawAyAFwAQgBh
AHMAZQBUAG8AbwBsAHMAXABTAGMAcgBpAHAAdABzAAAAHwA9AAEAAAACAAAAAAAAAAMANgAAAAAA
AgFxAAEAAAAWAAAAAdUiVuR4nF7eqBn/Tf2Zhy+Cd5Tc+QAAHwBwAAEAAACQAAAAWwBQAEEAVABD
AEgAIABWADIAXQAgAEIAYQBzAGUAVABvAG8AbABzADoAQQBkAGQAIABEAGUAdABlAGMAdABOAG8A
dABVAHMAZQBkAEkAdABlAG0ALgBwAHkAIAB0AG8AIABFAGQAawAyAFwAQgBhAHMAZQBUAG8AbwBs
AHMAXABTAGMAcgBpAHAAdABzAAAAHwA1EAEAAACQAAAAPABGAEEARAAwAEQANwBFADAAQQBFADAA
RgBBADUANABEADkAOAA3AEYANgBFADcAMgA0ADMANQBDAEEARgBEADUAMABBAEYAOAAxAEYAMwA1
AEAAUwBIAFMATQBTAFgAMQAwADEALgBjAGMAcgAuAGMAbwByAHAALgBpAG4AdABlAGwALgBjAG8A
bQA+AAAAAwDeP59OAABAAAcwse0I51Yi1QECAQsAAQAAABAAAADvVXUIIMg8Tq+0Gk7UayVUAwAm
AAAAAAACAUcAAQAAADIAAABjPVVTO2E9TUNJO3A9SW50ZWw7bD1TSFNNU1gxMDEtMTkwNjE0MDIx
NDMxWi0yNjQzAAAAAgEQMAEAAABGAAAAAAAAACZ3vTk77DhJpKYVPcule0IHAPrQ1+CuD6VNmH9u
ckNcr9UAAABEEV4AAKaTaDaIdmxLp0rT60eaTGQAAAlUj6oAAAAAHwD6PwEAAAAYAAAARgBhAG4A
LAAgAFoAaABpAGoAdQBYAAAAAwAJWQEAAABAAACACCAGAAAAAADAAAAAAAAARgAAAAC/hQAAkLNd
5lYi1QELAACACCAGAAAAAADAAAAAAAAARgAAAACChQAAAAAAAAMAAIAIIAYAAAAAAMAAAAAAAABG
AAAAAOuFAAAJBAAAHwAAgIYDAgAAAAAAwAAAAAAAAEYBAAAAGAAAAGQAbABwAC0AcAByAG8AZAB1
AGMAdAAAAAEAAAAaAAAAZABsAHAAZQAtAHcAaQBuAGQAbwB3AHMAAAAAAB8AAICGAwIAAAAAAMAA
AAAAAABGAQAAABgAAABkAGwAcAAtAHYAZQByAHMAaQBvAG4AAAABAAAAFgAAADEAMQAuADAALgA2
ADAAMAAuADcAAAAAAB8AAICGAwIAAAAAAMAAAAAAAABGAQAAABoAAABkAGwAcAAtAHIAZQBhAGMA
dABpAG8AbgAAAAAAAQAAABQAAABuAG8ALQBhAGMAdABpAG8AbgAAAAMADTT9PwAAHwAAgIYDAgAA
AAAAwAAAAAAAAEYBAAAAIAAAAHgALQBtAHMALQBoAGEAcwAtAGEAdAB0AGEAYwBoAAAAAQAAAAIA
AAAAAAAAHwAAgIYDAgAAAAAAwAAAAAAAAEYBAAAAIgAAAHgALQBvAHIAaQBnAGkAbgBhAHQAaQBu
AGcALQBpAHAAAAAAAAEAAAAgAAAAWwAxADAALgAyADMAOQAuADEAMgA3AC4ANAAwAF0AAADKVw==

--_000_FAD0D7E0AE0FA54D987F6E72435CAFD50AF81F35SHSMSX101ccrcor_--