From nobody Mon Apr 29 17:47:17 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+42739+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+42739+1787277+3901457@groups.io;
	dmarc=fail(p=none dis=none)  header.from=intel.com
ARC-Seal: i=1; a=rsa-sha256; t=1561371993; cv=none;
	d=zoho.com; s=zohoarc;
	b=N3N32qNoSv720kifxo6Btb6elHbL1IEFiN9Oqq0SiPBW1sQywxt4Eha0YomsUjS3gIsofYpKSd8VUI+0xZBpdxmztRt8l2dauMt3CN0yzCLoc8VbjKrGXaFliLq03OYOP0bhb9WR7MVTu73eaKIRWNdzSaU4Fs3F2cafUlNBIDY=
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zoho.com;
 s=zohoarc;
	t=1561371993;
 h=Content-Type:Cc:Date:From:List-Id:List-Unsubscribe:MIME-Version:Message-ID:Reply-To:Sender:Subject:To:ARC-Authentication-Results;
	bh=U07/h5V9IKodfUIeGYT2PSEJhCgAbMFxY4esDekPEKs=;
	b=lVD6z+vPocaq8CPYRx7XhQTbcjP3HcJuba5XuRGDrGQ73QupkXwSkFpeptHh/I7ma62H3U95PwAC08ZwEsjIcq3A+e6wVr5tiAHmM9ZA+FRwuDkWLWTWAoGYSWBuWHKxuJCF6kxAQkm4WBiATj6htVHCnl20UNxaXQzG+O781Po=
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+42739+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 1561371993016852.1358698963513;
 Mon, 24 Jun 2019 03:26:33 -0700 (PDT)
Return-Path: <bounce+27952+42739+1787277+3901457@groups.io>
X-Received: from mga09.intel.com (mga09.intel.com [134.134.136.24])
 by groups.io with SMTP; Mon, 24 Jun 2019 03:26:31 -0700
X-Amp-Result: UNSCANNABLE
X-Amp-File-Uploaded: False
X-Received: from fmsmga004.fm.intel.com ([10.253.24.48])
  by orsmga102.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384;
 24 Jun 2019 03:26:31 -0700
X-ExtLoop1: 1
X-IronPort-AV: E=Sophos;i="5.63,411,1557212400";
   d="dat'59?scan'59,208,59";a="184094212"
X-Received: from fmsmsx106.amr.corp.intel.com ([10.18.124.204])
  by fmsmga004.fm.intel.com with ESMTP; 24 Jun 2019 03:26:30 -0700
X-Received: from fmsmsx161.amr.corp.intel.com (10.18.125.9) by
 FMSMSX106.amr.corp.intel.com (10.18.124.204) with Microsoft SMTP Server (TLS)
 id 14.3.439.0; Mon, 24 Jun 2019 03:26:30 -0700
X-Received: from shsmsx153.ccr.corp.intel.com (10.239.6.53) by
 FMSMSX161.amr.corp.intel.com (10.18.125.9) with Microsoft SMTP Server (TLS)
 id 14.3.439.0; Mon, 24 Jun 2019 03:26:30 -0700
X-Received: from shsmsx101.ccr.corp.intel.com ([169.254.1.87]) by
 SHSMSX153.ccr.corp.intel.com ([169.254.12.76]) with mapi id 14.03.0439.000;
 Mon, 24 Jun 2019 18:26:28 +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 V4] BaseTools:Add DetectNotUsedItem.py to
 Edk2\BaseTools\Scripts
Thread-Topic: [PATCH V4] BaseTools:Add DetectNotUsedItem.py to
 Edk2\BaseTools\Scripts
Thread-Index: AdUqdz3HJY+EOM9WQs6+ALaQrF7ffg==
Date: Mon, 24 Jun 2019 10:26:27 +0000
Message-ID: 
 <FAD0D7E0AE0FA54D987F6E72435CAFD50AF845B6@SHSMSX101.ccr.corp.intel.com>
Accept-Language: en-US
X-MS-Has-Attach: 
X-MS-TNEF-Correlator: 
 <FAD0D7E0AE0FA54D987F6E72435CAFD50AF845B6@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_FAD0D7E0AE0FA54D987F6E72435CAFD50AF845B6SHSMSX101ccrcor_"
Content-Language: en-US
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io;
 q=dns/txt; s=20140610; t=1561371992;
 bh=AOGNuKt3iAyKi1x8pSp6neSsuOrZ+g6UEkCfQek6czE=;
 h=CC:Content-Type:Date:From:Reply-To:Subject:To;
 b=puyG4O7KLQbXzQhoMti0wDwVJqPR2zbPQZz3GYSvJSsiz/uibc9RaWZfMON0pLPks+m
 J0/jly32klcTBvhK6QPrb5Yrcr1cQ0XCWjvrFrs4Wrj1Q9trlwYyOa+2q7tYCoYE93Kk3
 eJTJuKQKdJPw+2rL1LarJUHc9VoU4PMbw5I=
X-Zoho-Virus-Status: 1
X-ZohoMail-DKIM: pass (identity @groups.io)

--_000_FAD0D7E0AE0FA54D987F6E72435CAFD50AF845B6SHSMSX101ccrcor_
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>
Reviewed-by: Bob Feng <bob.c.feng@intel.com>
---
 BaseTools/Scripts/DetectNotUsedItem.py | 198 +++++++++++++++++++++++++++++=
++++
 1 file changed, 198 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,198 @@
+## @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)
+            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 (#42739): https://edk2.groups.io/g/devel/message/42739
Mute This Topic: https://groups.io/mt/32190455/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_FAD0D7E0AE0FA54D987F6E72435CAFD50AF845B6SHSMSX101ccrcor_
Content-Disposition: attachment; filename="winmail.dat"
Content-Transfer-Encoding: base64
Content-Type: application/ms-tnef; name="winmail.dat"

eJ8+IqIGAQaQCAAEAAAAAAABAAEAAQeQBgAIAAAA5AQAAAAAAADoAAEJgAEAIQAAAEZGMkVDQ0U2
MjU3NjYwNDNCRjQ3NTEyNTkzMjZCNzFFACgHAQ2ABAACAAAAAgACAAEFgAMADgAAAOMHBgAYAAoA
GgAbAAEASAEBIIADAA4AAADjBwYAGAAKABoAGwABAEgBAQiABwAYAAAASVBNLk1pY3Jvc29mdCBN
YWlsLk5vdGUAMQgBBIABAEgAAABbUEFUQ0ggVjRdIEJhc2VUb29sczpBZGQgRGV0ZWN0Tm90VXNl
ZEl0ZW0ucHkgdG8gRWRrMlxCYXNlVG9vbHNcU2NyaXB0cwA3GQELgAEAIQAAAEZGMkVDQ0U2MjU3
NjYwNDNCRjQ3NTEyNTkzMjZCNzFFACgHAQOQBgD8GAAANAAAAAIBfwABAAAASAAAADxGQUQwRDdF
MEFFMEZBNTREOTg3RjZFNzI0MzVDQUZENTBBRjg0NUI2QFNIU01TWDEwMS5jY3IuY29ycC5pbnRl
bC5jb20+AAsAHw4BAAAAAgEJEAEAAAALDwAABw8AAMMoAABMWkZ1UPqhD2EACmZiaWQEAABjY8Bw
ZzEyNTIA/gND8HRleHQB9wKkA+MCAARjaArAc2V0MCDvB20CgwBQEU0yCoAGtAKAln0KgAjIOwli
MTkOwL8JwxZyCjIWcQKAFWIqCbBzCfAEkGF0BbIOUANgc6JvAYAgRXgRwW4YMF0GUnYEkBe2AhBy
AMB0fQhQbhoxECAFwAWgG2RkmiADUiAQIheyXHYIkOR3awuAZDUdUwTwB0ANF3AwCnEX8mJrbWsG
cwGQACAgQk1fQuBFR0lOfQr8AfEL8REfsFo6aAJAcHM6wC8vYnVnegMQC2AkLnQHMG5vBaFlLgEF
sGcvc2hvd19BIlEuY2dpPw3QPagxODUBQGwLgGUKgWklFFRoBAAgBPUmAXXnEgAcYBiQIEQSEAWQ
BUC0dW4JcGYEkAnwYxxRMFBDRCAAcBxgR1VwSUQvUANgGJAI4XPhKVBQSXMuJXcZ4AuA7HB1BUAK
sWEHgBuhBCD3CsAZ4CdQYxxwAxAZ4CjS8QqwY2thGdEN4AlwJ5B9BbB5KkYlfwVAHlADoGK9GeBy
J8Aq8TAQKYBoKIAseTIowzEQMy49Q2NCOh+wb2IgRgnwZ9QgPAbgYiRALigAGcC2QAuAECBsJEAD
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
bTABwWpUKO8hsGc9X184AjhQLC+f/znvOqlEAGrASLHoEjhBO7lPOFC3sThQdDBweUiwZ9xodDi/
P0/bL2bU4GCgzl/kQLSgdIByPctAznBcb2wxoNKgNT9ynUBkLGRfNoE3Qyj6MGkn59JR+kDvAXV0
RSG5kEkgs/lAQjAiIu/gO7F0QkCvW1BFoeYBRSFoYZBwRnC/RyNgUOPBK7KGwLmBLqVwb0L/RA/6
VEXsYWCgPDIn/51URSFGxPBSRSA+f0+9R9TmVEfQ+ZFja3nA5CDzEfNgkSTgeS7ggCuQjMBgkN0E
gHnu0CTgUchpznDv4H+M0H/QAUCO0SFwG/ARIGj/baAhUegSSW9Kf0uC5NNFIXdM9m2wU1FfXMDc
YE3TZvhhdWxG8HoTRqa7c06vf1zPR9S7c1Ux5CABEHOgZl/qcLSQLlD5gODRbSKwZv/vMMQgSJZV
/1cPS4Ix0UXf/0bhKuIrskaTWkpb71z/R/L+UEhhMdJ8MVLEVBD5gEjT9cuRd++wbNLC6DENIUKB
/2DeVZTNgmHVNfNEUs6NEvL9bJQuRyYvj4al7ND1nG9O39KxtKBvP/XwtKBz0TKtsP8XcFPApXFw
T/gP+RdIl0WD/+Umcs9wX28o84+B182R7JP/e1+CEx5h7whvTu/gfJqCaP+7c4JoZMV/P95Pdx/4
016i+/nwapBv0TDVsDZyN0MEcJMisMdQcXVR8WQ6+jY/YO2GX4eviL+Jz4rSaS9/RWZg6QrOBIE9
QBeyPUE9/cgQJz1A7uI9QPqghqo0xAuGpfpAIIalMi4xNPeXEChAJWBkjxD9ELhwhrQZhqV9fWaQ
mSAAHwBCAAEAAAAYAAAARgBhAG4ALAAgAFoAaABpAGoAdQBYAAAAHwBlAAEAAAAqAAAAegBoAGkA
agB1AHgALgBmAGEAbgBAAGkAbgB0AGUAbAAuAGMAbwBtAAAAAAAfAGQAAQAAAAoAAABTAE0AVABQ
AAAAAAACAUEAAQAAAGQAAAAAAAAAgSsfpL6jEBmdbgDdAQ9UAgAAAIBGAGEAbgAsACAAWgBoAGkA
agB1AFgAAABTAE0AVABQAAAAegBoAGkAagB1AHgALgBmAGEAbgBAAGkAbgB0AGUAbAAuAGMAbwBt
AAAAHwACXQEAAAAqAAAAegBoAGkAagB1AHgALgBmAGEAbgBAAGkAbgB0AGUAbAAuAGMAbwBtAAAA
AAAfAOVfAQAAADIAAABzAGkAcAA6AHoAaABpAGoAdQB4AC4AZgBhAG4AQABpAG4AdABlAGwALgBj
AG8AbQAAAAAAHwAaDAEAAAAYAAAARgBhAG4ALAAgAFoAaABpAGoAdQBYAAAAHwAfDAEAAAAqAAAA
egBoAGkAagB1AHgALgBmAGEAbgBAAGkAbgB0AGUAbAAuAGMAbwBtAAAAAAAfAB4MAQAAAAoAAABT
AE0AVABQAAAAAAACARkMAQAAAGQAAAAAAAAAgSsfpL6jEBmdbgDdAQ9UAgAAAIBGAGEAbgAsACAA
WgBoAGkAagB1AFgAAABTAE0AVABQAAAAegBoAGkAagB1AHgALgBmAGEAbgBAAGkAbgB0AGUAbAAu
AGMAbwBtAAAAHwABXQEAAAAqAAAAegBoAGkAagB1AHgALgBmAGEAbgBAAGkAbgB0AGUAbAAuAGMA
bwBtAAAAAAAfAPg/AQAAABgAAABGAGEAbgAsACAAWgBoAGkAagB1AFgAAAAfACNAAQAAACoAAAB6
AGgAaQBqAHUAeAAuAGYAYQBuAEAAaQBuAHQAZQBsAC4AYwBvAG0AAAAAAB8AIkABAAAACgAAAFMA
TQBUAFAAAAAAAAIB+T8BAAAAZAAAAAAAAACBKx+kvqMQGZ1uAN0BD1QCAAAAgEYAYQBuACwAIABa
AGgAaQBqAHUAWAAAAFMATQBUAFAAAAB6AGgAaQBqAHUAeAAuAGYAYQBuAEAAaQBuAHQAZQBsAC4A
YwBvAG0AAAAfAAldAQAAACoAAAB6AGgAaQBqAHUAeAAuAGYAYQBuAEAAaQBuAHQAZQBsAC4AYwBv
AG0AAAAAAAsAQDoBAAAAHwAaAAEAAAASAAAASQBQAE0ALgBOAG8AdABlAAAAAAADAPE/CQQAAAsA
QDoBAAAAAwD9P+QEAAACAQswAQAAABAAAAD/LszmJXZgQ79HUSWTJrceAwAXAAEAAABAADkAgMu3
R3cq1QFAAAgwOLbnR3cq1QEfAACAhgMCAAAAAADAAAAAAAAARgEAAAAeAAAAYQBjAGMAZQBwAHQA
bABhAG4AZwB1AGEAZwBlAAAAAAABAAAADAAAAGUAbgAtAFUAUwAAAB8ANwABAAAAkAAAAFsAUABB
AFQAQwBIACAAVgA0AF0AIABCAGEAcwBlAFQAbwBvAGwAcwA6AEEAZABkACAARABlAHQAZQBjAHQA
TgBvAHQAVQBzAGUAZABJAHQAZQBtAC4AcAB5ACAAdABvACAARQBkAGsAMgBcAEIAYQBzAGUAVABv
AG8AbABzAFwAUwBjAHIAaQBwAHQAcwAAAB8APQABAAAAAgAAAAAAAAADADYAAAAAAAIBcQABAAAA
FgAAAAHVKnc9xyWPhDjPVkLOvgC2kKxe334AAB8AcAABAAAAkAAAAFsAUABBAFQAQwBIACAAVgA0
AF0AIABCAGEAcwBlAFQAbwBvAGwAcwA6AEEAZABkACAARABlAHQAZQBjAHQATgBvAHQAVQBzAGUA
ZABJAHQAZQBtAC4AcAB5ACAAdABvACAARQBkAGsAMgBcAEIAYQBzAGUAVABvAG8AbABzAFwAUwBj
AHIAaQBwAHQAcwAAAB8ANRABAAAAkAAAADwARgBBAEQAMABEADcARQAwAEEARQAwAEYAQQA1ADQA
RAA5ADgANwBGADYARQA3ADIANAAzADUAQwBBAEYARAA1ADAAQQBGADgANAA1AEIANgBAAFMASABT
AE0AUwBYADEAMAAxAC4AYwBjAHIALgBjAG8AcgBwAC4AaQBuAHQAZQBsAC4AYwBvAG0APgAAAAMA
3j+fTgAAQAAHMNhU5Ud3KtUBAgELAAEAAAAQAAAA/y7M5iV2YEO/R1Elkya3HgMAJgAAAAAAAgFH
AAEAAAAzAAAAYz1VUzthPU1DSTtwPUludGVsO2w9U0hTTVNYMTAxLTE5MDYyNDEwMjYyN1otMTA2
MTkAAAIBEDABAAAARgAAAAAAAAAmd705O+w4SaSmFT3LpXtCBwD60Nfgrg+lTZh/bnJDXK/VAAAA
RBFeAACmk2g2iHZsS6dK0+tHmkxkAAAJVI/EAAAAAB8A+j8BAAAAGAAAAEYAYQBuACwAIABaAGgA
aQBqAHUAWAAAAAMACVkBAAAAQAAAgAggBgAAAAAAwAAAAAAAAEYAAAAAv4UAANChI0d3KtUBCwAA
gAggBgAAAAAAwAAAAAAAAEYAAAAAgoUAAAAAAAADAACACCAGAAAAAADAAAAAAAAARgAAAADrhQAA
CQQAAB8AAICGAwIAAAAAAMAAAAAAAABGAQAAABgAAABkAGwAcAAtAHAAcgBvAGQAdQBjAHQAAAAB
AAAAGgAAAGQAbABwAGUALQB3AGkAbgBkAG8AdwBzAAAAAAAfAACAhgMCAAAAAADAAAAAAAAARgEA
AAAYAAAAZABsAHAALQB2AGUAcgBzAGkAbwBuAAAAAQAAABYAAAAxADEALgAwAC4ANgAwADAALgA3
AAAAAAAfAACAhgMCAAAAAADAAAAAAAAARgEAAAAaAAAAZABsAHAALQByAGUAYQBjAHQAaQBvAG4A
AAAAAAEAAAAUAAAAbgBvAC0AYQBjAHQAaQBvAG4AAAADAA00/T8AAB8AAICGAwIAAAAAAMAAAAAA
AABGAQAAACAAAAB4AC0AbQBzAC0AaABhAHMALQBhAHQAdABhAGMAaAAAAAEAAAACAAAAAAAAAB8A
AICGAwIAAAAAAMAAAAAAAABGAQAAACIAAAB4AC0AbwByAGkAZwBpAG4AYQB0AGkAbgBnAC0AaQBw
AAAAAAABAAAAIAAAAFsAMQAwAC4AMgAzADkALgAxADIANwAuADQAMABdAAAAk1I=

--_000_FAD0D7E0AE0FA54D987F6E72435CAFD50AF845B6SHSMSX101ccrcor_--