From nobody Thu May  2 01:09:53 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+41471+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+41471+1787277+3901457@groups.io;
	dmarc=fail(p=none dis=none)  header.from=intel.com
ARC-Seal: i=1; a=rsa-sha256; t=1559035960; cv=none;
	d=zoho.com; s=zohoarc;
	b=RzsMQr5uAOvA50bGXvGBQCFP6aJ9ertSpaQuBiMp5tGMcyPJ/iLCcmz7mY9QWrfy1CYMKE4Zjg0d3ZotRuzntbnGTmKaCf/Q87BY0xz2ad6gqBTqmBG4/G/Ws9iLvbMWEQXRjpDkegHkOg1tO0ypF2PNBHB6Z1v+KnQdoKpNgsw=
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zoho.com;
 s=zohoarc;
	t=1559035960;
 h=Content-Type:Cc:Date:From:List-Id:List-Unsubscribe:MIME-Version:Message-ID:Reply-To:Sender:Subject:To:ARC-Authentication-Results;
	bh=+3Kd0Rlxri9dAihGi1mRB6wIPTOWA5wuuwU71R9pCaY=;
	b=Hlj5gL5avstjhLFd9GvnQhaeyd0nwAE0fSjr8eo65FR9WErFoYsl31Synskyvl3FtY6BT5jSS3Gu3W6XA92VPd7w7U2daGrulNAyi9qE0taGx/T/BAx0loOOYFPLXsaczgB16BsM9ESnBEP+pAfWzn2r3AnMFLdpk/GIHnfniDM=
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+41471+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 155903595993774.81624966762888;
 Tue, 28 May 2019 02:32:39 -0700 (PDT)
Return-Path: <bounce+27952+41471+1787277+3901457@groups.io>
X-Received: from mga11.intel.com (mga11.intel.com [192.55.52.93])
 by groups.io with SMTP; Tue, 28 May 2019 02:32:38 -0700
X-Amp-Result: UNKNOWN
X-Amp-Original-Verdict: FILE UNKNOWN
X-Amp-File-Uploaded: False
X-Received: from orsmga004.jf.intel.com ([10.7.209.38])
  by fmsmga102.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384;
 28 May 2019 02:32:38 -0700
X-ExtLoop1: 1
X-Received: from fmsmsx108.amr.corp.intel.com ([10.18.124.206])
  by orsmga004.jf.intel.com with ESMTP; 28 May 2019 02:32:37 -0700
X-Received: from fmsmsx154.amr.corp.intel.com (10.18.116.70) by
 FMSMSX108.amr.corp.intel.com (10.18.124.206) with Microsoft SMTP Server (TLS)
 id 14.3.408.0; Tue, 28 May 2019 02:32:37 -0700
X-Received: from shsmsx104.ccr.corp.intel.com (10.239.4.70) by
 FMSMSX154.amr.corp.intel.com (10.18.116.70) with Microsoft SMTP Server (TLS)
 id 14.3.408.0; Tue, 28 May 2019 02:32:36 -0700
X-Received: from shsmsx101.ccr.corp.intel.com ([169.254.1.129]) by
 SHSMSX104.ccr.corp.intel.com ([169.254.5.33]) with mapi id 14.03.0415.000;
 Tue, 28 May 2019 17:32:35 +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] BaseTools:Add DetectNotUsedItem.py to
 Edk2\BaseTools\Scripts
Thread-Topic: [PATCH] BaseTools:Add DetectNotUsedItem.py to
 Edk2\BaseTools\Scripts
Thread-Index: AdUVODvoQioEnMiHSEKe1Y9pnbE06Q==
Date: Tue, 28 May 2019 09:32:35 +0000
Message-ID: 
 <FAD0D7E0AE0FA54D987F6E72435CAFD50AF62DAA@SHSMSX101.ccr.corp.intel.com>
Accept-Language: en-US
X-MS-Has-Attach: 
X-MS-TNEF-Correlator: 
 <FAD0D7E0AE0FA54D987F6E72435CAFD50AF62DAA@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_FAD0D7E0AE0FA54D987F6E72435CAFD50AF62DAASHSMSX101ccrcor_"
Content-Language: en-US
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=groups.io;
 q=dns/txt; s=20140610; t=1559035959;
 bh=g/1BhLS70JtMLoQ8UobluA6iMwdMi527nW4Hc0TzciY=;
 h=CC:Content-Type:Date:From:Reply-To:Subject:To;
 b=MdHYUnxnC4iDvBgRLcSRKe9ze0ni/6jG8Dhf8ZkyeXOH1+Nk3CzmAwdjkiRHjw2RE0e
 jxB/5jlNG66b1gtdxSQ/f5fav57eZn3ydi/Si3TwiCTEEnK0yWBZc3nH6SS4wjWMOCQMK
 CPBUcLsW4Q7Fzt4KScz/vPp51KUEMJfsLAs=
X-Zoho-Virus-Status: 1
X-ZohoMail-DKIM: pass (identity @groups.io)

--_000_FAD0D7E0AE0FA54D987F6E72435CAFD50AF62DAASHSMSX101ccrcor_
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 | 185 +++++++++++++++++++++++++++++=
++++
 1 file changed, 185 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..655fb65a96
--- /dev/null
+++ b/BaseTools/Scripts/DetectNotUsedItem.py
@@ -0,0 +1,185 @@
+## @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 res=
erved.'
+__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") + self.SearchbyExt(".fdf") + sel=
f.SearchbyExt(".inf")):
+      AllContentList +=3D self.ParseDscFdfInfContent(File)
+    return AllContentList
+
+  #Search File by extension name
+  def SearchbyExt(self, Ext):
+    FileList =3D []
+    for path in self.InfPath:
+      for root, _, files in os.walk(path, topdown=3DTrue, followlinks=3DFa=
lse):
+        for filename in files:
+          if filename.endswith(Ext):
+            FileList.append(os.path.join(root, filename))
+    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].split('|')[0].sp=
lit('#')[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_-])" % D=
ecItemName)
+      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 Number"=
),"{:<0}".format("Unused Item")))
+    self.Log.append("DEC File:\n%s\n%s%s\n" % (self.Dec, "{:<15}".format("=
Line Number"),"{:<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}".format(Ite=
mName)))
+      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__ + __copyrigh=
t__,
+                                conflict_handler=3D'resolve')
+  parser.add_argument('-i', '--input', metavar=3D"", dest=3D'InputDec', he=
lp=3D"Input DEC file name.")
+  parser.add_argument('--dirs', metavar=3D"", action=3D'append', dest=3D'D=
irs',
+                        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=3DF=
alse, help=3D"Put log in specified file as well as on console.")
+  options =3D parser.parse_args()
+  if options.InputDec:
+    if not (os.path.exists(options.InputDec) and options.InputDec.endswith=
(".dec")):
+      print("Error: Invalid DEC file input: %s" % options.InputDec)
+    if options.Dirs:
+      M =3D Main()
+      M.mainprocess(options.InputDec, options.Dirs, options.Clean, options=
.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 (#41471): https://edk2.groups.io/g/devel/message/41471
Mute This Topic: https://groups.io/mt/31819811/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_FAD0D7E0AE0FA54D987F6E72435CAFD50AF62DAASHSMSX101ccrcor_
Content-Disposition: attachment; filename="winmail.dat"
Content-Transfer-Encoding: base64
Content-Type: application/ms-tnef; name="winmail.dat"

eJ8+ItcfAQaQCAAEAAAAAAABAAEAAQeQBgAIAAAA5AQAAAAAAADoAAEJgAEAIQAAAEZGRTlBNzk0
RkIxNjg0NDg5NUI1MEYwNjc0QjJGQjFEAFMHAQ2ABAACAAAAAgACAAEFgAMADgAAAOMHBQAcAAkA
IAAjAAIAWQEBIIADAA4AAADjBwUAHAAJACAAIwACAFkBAQiABwAYAAAASVBNLk1pY3Jvc29mdCBN
YWlsLk5vdGUAMQgBBIABAEUAAABbUEFUQ0hdIEJhc2VUb29sczpBZGQgRGV0ZWN0Tm90VXNlZEl0
ZW0ucHkgdG8gRWRrMlxCYXNlVG9vbHNcU2NyaXB0cwCNGAELgAEAIQAAAEZGRTlBNzk0RkIxNjg0
NDg5NUI1MEYwNjc0QjJGQjFEAFMHAQOQBgBgGAAANAAAAAIBfwABAAAASAAAADxGQUQwRDdFMEFF
MEZBNTREOTg3RjZFNzI0MzVDQUZENTBBRjYyREFBQFNIU01TWDEwMS5jY3IuY29ycC5pbnRlbC5j
b20+AAsAHw4BAAAAAgEJEAEAAAB4DgAAdA4AAKsjAABMWkZ1K7c+nWEACmZiaWQEAABjY8BwZzEy
NTIA/gND8HRleHQB9wKkA+MCAARjaArAc2V0MCDvB20CgwBQEU0yCoAGtAKAln0KgAjIOwliMTkO
wL8JwxZyCjIWcQKAFWIqCbBzCfAEkGF0BbIOUANgc6JvAYAgRXgRwW4YMF0GUnYEkBe2AhByAMB0
fQhQbhoxECAFwAWgG2RkmiADUiAQIheyXHYIkOR3awuAZDUdUwTwB0ANF3AwCnEX8mJrbWsGcwGQ
ACAgQk1fQuBFR0lOfQr8AfEL8REfsFo6aAJAcHM6wC8vYnVnegMQC2AkLnQHMG5vBaFlLgEFsGcv
c2hvd19BIlEuY2dpPw3QPagxODUBQGwLgGUKgWklFFRoBAAgBPUmAXXnEgAcYBiQIEQSEAWQBUC0
dW4JcGYEkAnwYxxRMFBDRCAAcBxgR1VwSUQvUANgGJAI4XPhKVBQSXMuJXcZ4AuA7HB1BUAKsWEH
gBuhBCD3CsAZ4CdQYxxwAxAZ4CjS8QqwY2thGdEN4AlwJ5B9BbB5KkYlfwVAHlADoGK9GeByJ8Aq
8TAQKYBoKIAseTIowzEQMy49Q2NCOh+wb2IgRgnwZ9QgPAbgYiRALigAGcC2QAuAECBsJEADcD4y
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
gPvBlnH7QWgyEP5w/JD9QzDQpHHiYlKggJG+Lh0A+T/6TbiE/AxhBkP/+IBndPtB/OSvovtA9Q8F
vc399FT98LfBY2tIIA0w57IhMRHc0HkuoZDiQChQuzEQwXB5riDc0AfIaRVg/68wV/CTAOUQDeET
INEQzLD+aIqQEwGoYv+PAJ+4cKWDt/tBAvSSgSeKoAlRXxvAw57QA9NmYXVs/RBIc//8xoJj/ceC
YwsxCXC+QEJgvmaqYGeg5lC3sKHhbdtA/ma3AIow/rYL/w0PuHDbYX/7//0B4ZLiYvyzEEv99FD/
/oHpUkoxCMQKELew/vOQ4fp3MhBslxKogclR+MEU7P8LlDYyFcXs0/pyk3vOAh50/i79RspuUrKs
QLRMIQ6XAe9nsCD/tKBnsHPZomfQ0eD/MRBuQakftp+3of63+6O45v8kT8C9IQayn0eRkoGsA0bO
/9dxrlghDq8wLXoyiIJjMoh/GLWm3KAvKK0SsrggHJBvf9mgmYDtUu4jikDbQEJgcfJ1B/FkOrhm
FPs2Pzdv8zh/OY9pL/uGFPkExsFx9/PQ0iLz0T0PIfPQrjLz0F+40ATI68QExbhwIATFMrguMTRF
kKGwSjBkPjDPusB/gATUBMV9fQUQR6AfAEIAAQAAABgAAABGAGEAbgAsACAAWgBoAGkAagB1AFgA
AAAfAGUAAQAAACoAAAB6AGgAaQBqAHUAeAAuAGYAYQBuAEAAaQBuAHQAZQBsAC4AYwBvAG0AAAAA
AB8AZAABAAAACgAAAFMATQBUAFAAAAAAAAIBQQABAAAAZAAAAAAAAACBKx+kvqMQGZ1uAN0BD1QC
AAAAgEYAYQBuACwAIABaAGgAaQBqAHUAWAAAAFMATQBUAFAAAAB6AGgAaQBqAHUAeAAuAGYAYQBu
AEAAaQBuAHQAZQBsAC4AYwBvAG0AAAAfAAJdAQAAACoAAAB6AGgAaQBqAHUAeAAuAGYAYQBuAEAA
aQBuAHQAZQBsAC4AYwBvAG0AAAAAAB8A5V8BAAAAMgAAAHMAaQBwADoAegBoAGkAagB1AHgALgBm
AGEAbgBAAGkAbgB0AGUAbAAuAGMAbwBtAAAAAAAfABoMAQAAABgAAABGAGEAbgAsACAAWgBoAGkA
agB1AFgAAAAfAB8MAQAAACoAAAB6AGgAaQBqAHUAeAAuAGYAYQBuAEAAaQBuAHQAZQBsAC4AYwBv
AG0AAAAAAB8AHgwBAAAACgAAAFMATQBUAFAAAAAAAAIBGQwBAAAAZAAAAAAAAACBKx+kvqMQGZ1u
AN0BD1QCAAAAgEYAYQBuACwAIABaAGgAaQBqAHUAWAAAAFMATQBUAFAAAAB6AGgAaQBqAHUAeAAu
AGYAYQBuAEAAaQBuAHQAZQBsAC4AYwBvAG0AAAAfAAFdAQAAACoAAAB6AGgAaQBqAHUAeAAuAGYA
YQBuAEAAaQBuAHQAZQBsAC4AYwBvAG0AAAAAAB8A+D8BAAAAGAAAAEYAYQBuACwAIABaAGgAaQBq
AHUAWAAAAB8AI0ABAAAAKgAAAHoAaABpAGoAdQB4AC4AZgBhAG4AQABpAG4AdABlAGwALgBjAG8A
bQAAAAAAHwAiQAEAAAAKAAAAUwBNAFQAUAAAAAAAAgH5PwEAAABkAAAAAAAAAIErH6S+oxAZnW4A
3QEPVAIAAACARgBhAG4ALAAgAFoAaABpAGoAdQBYAAAAUwBNAFQAUAAAAHoAaABpAGoAdQB4AC4A
ZgBhAG4AQABpAG4AdABlAGwALgBjAG8AbQAAAB8ACV0BAAAAKgAAAHoAaABpAGoAdQB4AC4AZgBh
AG4AQABpAG4AdABlAGwALgBjAG8AbQAAAAAACwBAOgEAAAAfABoAAQAAABIAAABJAFAATQAuAE4A
bwB0AGUAAAAAAAMA8T8JBAAACwBAOgEAAAADAP0/5AQAAAIBCzABAAAAEAAAAP/pp5T7FoRIlbUP
BnSy+x0DABcAAQAAAEAAOQCAeyRIOBXVAUAACDDePVVIOBXVAR8AAICGAwIAAAAAAMAAAAAAAABG
AQAAAB4AAABhAGMAYwBlAHAAdABsAGEAbgBnAHUAYQBnAGUAAAAAAAEAAAAMAAAAZQBuAC0AVQBT
AAAAHwA3AAEAAACKAAAAWwBQAEEAVABDAEgAXQAgAEIAYQBzAGUAVABvAG8AbABzADoAQQBkAGQA
IABEAGUAdABlAGMAdABOAG8AdABVAHMAZQBkAEkAdABlAG0ALgBwAHkAIAB0AG8AIABFAGQAawAy
AFwAQgBhAHMAZQBUAG8AbwBsAHMAXABTAGMAcgBpAHAAdABzAAAAAAAfAD0AAQAAAAIAAAAAAAAA
AwA2AAAAAAACAXEAAQAAABYAAAAB1RU4O+hCKgScyIdIQp7Vj2mdsTTpAAAfAHAAAQAAAIoAAABb
AFAAQQBUAEMASABdACAAQgBhAHMAZQBUAG8AbwBsAHMAOgBBAGQAZAAgAEQAZQB0AGUAYwB0AE4A
bwB0AFUAcwBlAGQASQB0AGUAbQAuAHAAeQAgAHQAbwAgAEUAZABrADIAXABCAGEAcwBlAFQAbwBv
AGwAcwBcAFMAYwByAGkAcAB0AHMAAAAAAB8ANRABAAAAkAAAADwARgBBAEQAMABEADcARQAwAEEA
RQAwAEYAQQA1ADQARAA5ADgANwBGADYARQA3ADIANAAzADUAQwBBAEYARAA1ADAAQQBGADYAMgBE
AEEAQQBAAFMASABTAE0AUwBYADEAMAAxAC4AYwBjAHIALgBjAG8AcgBwAC4AaQBuAHQAZQBsAC4A
YwBvAG0APgAAAAMA3j+fTgAAQAAHMHvcUkg4FdUBAgELAAEAAAAQAAAA/+mnlPsWhEiVtQ8GdLL7
HQMAJgAAAAAAAgFHAAEAAAAzAAAAYz1VUzthPU1DSTtwPUludGVsO2w9U0hTTVNYMTAxLTE5MDUy
ODA5MzIzNVotMjYxNDEAAAIBEDABAAAARgAAAAAAAAAmd705O+w4SaSmFT3LpXtCBwD60Nfgrg+l
TZh/bnJDXK/VAAAARBFeAACmk2g2iHZsS6dK0+tHmkxkAAAJVI+LAAAAAB8A+j8BAAAAGAAAAEYA
YQBuACwAIABaAGgAaQBqAHUAWAAAAAMACVkBAAAAQAAAgAggBgAAAAAAwAAAAAAAAEYAAAAAv4UA
ALCCZkc4FdUBCwAAgAggBgAAAAAAwAAAAAAAAEYAAAAAgoUAAAAAAAADAACACCAGAAAAAADAAAAA
AAAARgAAAADrhQAACQQAAB8AAICGAwIAAAAAAMAAAAAAAABGAQAAABgAAABkAGwAcAAtAHAAcgBv
AGQAdQBjAHQAAAABAAAAGgAAAGQAbABwAGUALQB3AGkAbgBkAG8AdwBzAAAAAAAfAACAhgMCAAAA
AADAAAAAAAAARgEAAAAYAAAAZABsAHAALQB2AGUAcgBzAGkAbwBuAAAAAQAAABYAAAAxADEALgAw
AC4ANgAwADAALgA3AAAAAAAfAACAhgMCAAAAAADAAAAAAAAARgEAAAAaAAAAZABsAHAALQByAGUA
YQBjAHQAaQBvAG4AAAAAAAEAAAAUAAAAbgBvAC0AYQBjAHQAaQBvAG4AAAADAA00/T8AAB8AAICG
AwIAAAAAAMAAAAAAAABGAQAAACAAAAB4AC0AbQBzAC0AaABhAHMALQBhAHQAdABhAGMAaAAAAAEA
AAACAAAAAAAAAB8AAICGAwIAAAAAAMAAAAAAAABGAQAAACIAAAB4AC0AbwByAGkAZwBpAG4AYQB0
AGkAbgBnAC0AaQBwAAAAAAABAAAAIAAAAFsAMQAwAC4AMgAzADkALgAxADIANwAuADQAMABdAAAA
twM=

--_000_FAD0D7E0AE0FA54D987F6E72435CAFD50AF62DAASHSMSX101ccrcor_--