]> git.proxmox.com Git - mirror_edk2.git/blame - BaseTools/Scripts/SmiHandlerProfileSymbolGen.py
BaseTools: Replace BSD License with BSD+Patent License
[mirror_edk2.git] / BaseTools / Scripts / SmiHandlerProfileSymbolGen.py
CommitLineData
88dab294
JY
1##\r
2# Generate symbal for SMI handler profile info.\r
3#\r
4# This tool depends on DIA2Dump.exe (VS) or nm (gcc) to parse debug entry.\r
5#\r
6# Copyright (c) 2017, Intel Corporation. All rights reserved.<BR>\r
2e351cbe 7# SPDX-License-Identifier: BSD-2-Clause-Patent\r
88dab294
JY
8#\r
9##\r
10\r
72443dd2 11from __future__ import print_function\r
88dab294
JY
12import os\r
13import re\r
14import sys\r
15from optparse import OptionParser\r
16\r
17from xml.dom.minidom import parse\r
18import xml.dom.minidom\r
19\r
20versionNumber = "1.1"\r
21__copyright__ = "Copyright (c) 2016, Intel Corporation. All rights reserved."\r
22\r
23class Symbols:\r
24 def __init__(self):\r
25 self.listLineAddress = []\r
26 self.pdbName = ""\r
27 # Cache for function\r
28 self.functionName = ""\r
29 # Cache for line\r
30 self.sourceName = ""\r
31\r
32\r
33 def getSymbol (self, rva):\r
34 index = 0\r
35 lineName = 0\r
36 sourceName = "??"\r
37 while index + 1 < self.lineCount :\r
38 if self.listLineAddress[index][0] <= rva and self.listLineAddress[index + 1][0] > rva :\r
39 offset = rva - self.listLineAddress[index][0]\r
40 functionName = self.listLineAddress[index][1]\r
41 lineName = self.listLineAddress[index][2]\r
42 sourceName = self.listLineAddress[index][3]\r
43 if lineName == 0 :\r
44 return [functionName]\r
45 else :\r
46 return [functionName, sourceName, lineName]\r
47 index += 1\r
48\r
49 return []\r
50\r
51 def parse_debug_file(self, driverName, pdbName):\r
52 if cmp (pdbName, "") == 0 :\r
53 return\r
54 self.pdbName = pdbName;\r
55\r
56 try:\r
57 nmCommand = "nm"\r
58 nmLineOption = "-l"\r
72443dd2 59 print("parsing (debug) - " + pdbName)\r
88dab294
JY
60 os.system ('%s %s %s > nmDump.line.log' % (nmCommand, nmLineOption, pdbName))\r
61 except :\r
72443dd2 62 print('ERROR: nm command not available. Please verify PATH')\r
88dab294
JY
63 return\r
64\r
65 #\r
66 # parse line\r
67 #\r
68 linefile = open("nmDump.line.log")\r
69 reportLines = linefile.readlines()\r
70 linefile.close()\r
71\r
72 # 000113ca T AllocatePool c:\home\edk-ii\MdePkg\Library\UefiMemoryAllocationLib\MemoryAllocationLib.c:399\r
73 patchLineFileMatchString = "([0-9a-fA-F]*)\s+[T|D|t|d]\s+(\w+)\s*((?:[a-zA-Z]:)?[\w+\-./_a-zA-Z0-9\\\\]*):?([0-9]*)"\r
74\r
75 for reportLine in reportLines:\r
76 match = re.match(patchLineFileMatchString, reportLine)\r
77 if match is not None:\r
78 rva = int (match.group(1), 16)\r
79 functionName = match.group(2)\r
80 sourceName = match.group(3)\r
81 if cmp (match.group(4), "") != 0 :\r
82 lineName = int (match.group(4))\r
83 else :\r
84 lineName = 0\r
85 self.listLineAddress.append ([rva, functionName, lineName, sourceName])\r
86\r
87 self.lineCount = len (self.listLineAddress)\r
88\r
89 self.listLineAddress = sorted(self.listLineAddress, key=lambda symbolAddress:symbolAddress[0])\r
90\r
91 def parse_pdb_file(self, driverName, pdbName):\r
92 if cmp (pdbName, "") == 0 :\r
93 return\r
94 self.pdbName = pdbName;\r
95\r
96 try:\r
97 #DIA2DumpCommand = "\"C:\\Program Files (x86)\Microsoft Visual Studio 14.0\\DIA SDK\\Samples\\DIA2Dump\\x64\\Debug\\Dia2Dump.exe\""\r
98 DIA2DumpCommand = "Dia2Dump.exe"\r
99 #DIA2SymbolOption = "-p"\r
100 DIA2LinesOption = "-l"\r
72443dd2 101 print("parsing (pdb) - " + pdbName)\r
88dab294
JY
102 #os.system ('%s %s %s > DIA2Dump.symbol.log' % (DIA2DumpCommand, DIA2SymbolOption, pdbName))\r
103 os.system ('%s %s %s > DIA2Dump.line.log' % (DIA2DumpCommand, DIA2LinesOption, pdbName))\r
104 except :\r
72443dd2 105 print('ERROR: DIA2Dump command not available. Please verify PATH')\r
88dab294
JY
106 return\r
107\r
108 #\r
109 # parse line\r
110 #\r
111 linefile = open("DIA2Dump.line.log")\r
112 reportLines = linefile.readlines()\r
113 linefile.close()\r
114\r
115 # ** GetDebugPrintErrorLevel\r
116 # line 32 at [0000C790][0001:0000B790], len = 0x3 c:\home\edk-ii\mdepkg\library\basedebugprinterrorlevellib\basedebugprinterrorlevellib.c (MD5: 687C0AE564079D35D56ED5D84A6164CC)\r
117 # line 36 at [0000C793][0001:0000B793], len = 0x5\r
118 # line 37 at [0000C798][0001:0000B798], len = 0x2\r
119\r
120 patchLineFileMatchString = "\s+line ([0-9]+) at \[([0-9a-fA-F]{8})\]\[[0-9a-fA-F]{4}\:[0-9a-fA-F]{8}\], len = 0x[0-9a-fA-F]+\s*([\w+\-\:./_a-zA-Z0-9\\\\]*)\s*"\r
121 patchLineFileMatchStringFunc = "\*\*\s+(\w+)\s*"\r
122\r
123 for reportLine in reportLines:\r
124 match = re.match(patchLineFileMatchString, reportLine)\r
125 if match is not None:\r
126 if cmp (match.group(3), "") != 0 :\r
127 self.sourceName = match.group(3)\r
128 sourceName = self.sourceName\r
129 functionName = self.functionName\r
130\r
131 rva = int (match.group(2), 16)\r
132 lineName = int (match.group(1))\r
133 self.listLineAddress.append ([rva, functionName, lineName, sourceName])\r
134 else :\r
135 match = re.match(patchLineFileMatchStringFunc, reportLine)\r
136 if match is not None:\r
137 self.functionName = match.group(1)\r
138\r
139 self.lineCount = len (self.listLineAddress)\r
140 self.listLineAddress = sorted(self.listLineAddress, key=lambda symbolAddress:symbolAddress[0])\r
141\r
142class SymbolsFile:\r
143 def __init__(self):\r
144 self.symbolsTable = {}\r
145\r
146symbolsFile = ""\r
147\r
148driverName = ""\r
149rvaName = ""\r
150symbolName = ""\r
151\r
152def getSymbolName(driverName, rva):\r
153 global symbolsFile\r
154\r
155 try :\r
156 symbolList = symbolsFile.symbolsTable[driverName]\r
157 if symbolList is not None:\r
158 return symbolList.getSymbol (rva)\r
159 else:\r
160 return []\r
161 except Exception:\r
162 return []\r
163\r
164def myOptionParser():\r
165 usage = "%prog [--version] [-h] [--help] [-i inputfile [-o outputfile] [-g guidreffile]]"\r
166 Parser = OptionParser(usage=usage, description=__copyright__, version="%prog " + str(versionNumber))\r
167 Parser.add_option("-i", "--inputfile", dest="inputfilename", type="string", help="The input memory profile info file output from MemoryProfileInfo application in MdeModulePkg")\r
168 Parser.add_option("-o", "--outputfile", dest="outputfilename", type="string", help="The output memory profile info file with symbol, MemoryProfileInfoSymbol.txt will be used if it is not specified")\r
169 Parser.add_option("-g", "--guidref", dest="guidreffilename", type="string", help="The input guid ref file output from build")\r
170\r
171 (Options, args) = Parser.parse_args()\r
172 if Options.inputfilename is None:\r
173 Parser.error("no input file specified")\r
174 if Options.outputfilename is None:\r
175 Options.outputfilename = "SmiHandlerProfileInfoSymbol.xml"\r
176 return Options\r
177\r
178dictGuid = {\r
179 '00000000-0000-0000-0000-000000000000':'gZeroGuid',\r
180 '2A571201-4966-47F6-8B86-F31E41F32F10':'gEfiEventLegacyBootGuid',\r
181 '27ABF055-B1B8-4C26-8048-748F37BAA2DF':'gEfiEventExitBootServicesGuid',\r
182 '7CE88FB3-4BD7-4679-87A8-A8D8DEE50D2B':'gEfiEventReadyToBootGuid',\r
183 '02CE967A-DD7E-4FFC-9EE7-810CF0470880':'gEfiEndOfDxeEventGroupGuid',\r
184 '60FF8964-E906-41D0-AFED-F241E974E08E':'gEfiDxeSmmReadyToLockProtocolGuid',\r
185 '18A3C6DC-5EEA-48C8-A1C1-B53389F98999':'gEfiSmmSwDispatch2ProtocolGuid',\r
186 '456D2859-A84B-4E47-A2EE-3276D886997D':'gEfiSmmSxDispatch2ProtocolGuid',\r
187 '4CEC368E-8E8E-4D71-8BE1-958C45FC8A53':'gEfiSmmPeriodicTimerDispatch2ProtocolGuid',\r
188 'EE9B8D90-C5A6-40A2-BDE2-52558D33CCA1':'gEfiSmmUsbDispatch2ProtocolGuid',\r
189 '25566B03-B577-4CBF-958C-ED663EA24380':'gEfiSmmGpiDispatch2ProtocolGuid',\r
190 '7300C4A1-43F2-4017-A51B-C81A7F40585B':'gEfiSmmStandbyButtonDispatch2ProtocolGuid',\r
191 '1B1183FA-1823-46A7-8872-9C578755409D':'gEfiSmmPowerButtonDispatch2ProtocolGuid',\r
192 '58DC368D-7BFA-4E77-ABBC-0E29418DF930':'gEfiSmmIoTrapDispatch2ProtocolGuid',\r
193 }\r
194\r
195def genGuidString(guidreffile):\r
196 guidLines = guidreffile.readlines()\r
197 for guidLine in guidLines:\r
198 guidLineList = guidLine.split(" ")\r
199 if len(guidLineList) == 2:\r
200 guid = guidLineList[0]\r
201 guidName = guidLineList[1]\r
98120f5f 202 if guid not in dictGuid :\r
88dab294
JY
203 dictGuid[guid] = guidName\r
204\r
205def createSym(symbolName):\r
206 SymbolNode = xml.dom.minidom.Document().createElement("Symbol")\r
207 SymbolFunction = xml.dom.minidom.Document().createElement("Function")\r
208 SymbolFunctionData = xml.dom.minidom.Document().createTextNode(symbolName[0])\r
209 SymbolFunction.appendChild(SymbolFunctionData)\r
210 SymbolNode.appendChild(SymbolFunction)\r
211 if (len(symbolName)) >= 2:\r
212 SymbolSourceFile = xml.dom.minidom.Document().createElement("SourceFile")\r
213 SymbolSourceFileData = xml.dom.minidom.Document().createTextNode(symbolName[1])\r
214 SymbolSourceFile.appendChild(SymbolSourceFileData)\r
215 SymbolNode.appendChild(SymbolSourceFile)\r
216 if (len(symbolName)) >= 3:\r
217 SymbolLineNumber = xml.dom.minidom.Document().createElement("LineNumber")\r
218 SymbolLineNumberData = xml.dom.minidom.Document().createTextNode(str(symbolName[2]))\r
219 SymbolLineNumber.appendChild(SymbolLineNumberData)\r
220 SymbolNode.appendChild(SymbolLineNumber)\r
221 return SymbolNode\r
222\r
223def main():\r
224 global symbolsFile\r
225 global Options\r
226 Options = myOptionParser()\r
227\r
228 symbolsFile = SymbolsFile()\r
229\r
230 try :\r
231 DOMTree = xml.dom.minidom.parse(Options.inputfilename)\r
232 except Exception:\r
72443dd2 233 print("fail to open input " + Options.inputfilename)\r
88dab294
JY
234 return 1\r
235\r
236 if Options.guidreffilename is not None:\r
237 try :\r
238 guidreffile = open(Options.guidreffilename)\r
239 except Exception:\r
72443dd2 240 print("fail to open guidref" + Options.guidreffilename)\r
88dab294
JY
241 return 1\r
242 genGuidString(guidreffile)\r
243 guidreffile.close()\r
244\r
245 SmiHandlerProfile = DOMTree.documentElement\r
246\r
247 SmiHandlerDatabase = SmiHandlerProfile.getElementsByTagName("SmiHandlerDatabase")\r
248 SmiHandlerCategory = SmiHandlerDatabase[0].getElementsByTagName("SmiHandlerCategory")\r
249 for smiHandlerCategory in SmiHandlerCategory:\r
250 SmiEntry = smiHandlerCategory.getElementsByTagName("SmiEntry")\r
251 for smiEntry in SmiEntry:\r
252 if smiEntry.hasAttribute("HandlerType"):\r
253 guidValue = smiEntry.getAttribute("HandlerType")\r
98120f5f 254 if guidValue in dictGuid:\r
88dab294
JY
255 smiEntry.setAttribute("HandlerType", dictGuid[guidValue])\r
256 SmiHandler = smiEntry.getElementsByTagName("SmiHandler")\r
257 for smiHandler in SmiHandler:\r
258 Module = smiHandler.getElementsByTagName("Module")\r
259 Pdb = Module[0].getElementsByTagName("Pdb")\r
260 if (len(Pdb)) >= 1:\r
261 driverName = Module[0].getAttribute("Name")\r
262 pdbName = Pdb[0].childNodes[0].data\r
263\r
264 Module[0].removeChild(Pdb[0])\r
265\r
266 symbolsFile.symbolsTable[driverName] = Symbols()\r
267\r
268 if cmp (pdbName[-3:], "pdb") == 0 :\r
269 symbolsFile.symbolsTable[driverName].parse_pdb_file (driverName, pdbName)\r
270 else :\r
271 symbolsFile.symbolsTable[driverName].parse_debug_file (driverName, pdbName)\r
272\r
273 Handler = smiHandler.getElementsByTagName("Handler")\r
274 RVA = Handler[0].getElementsByTagName("RVA")\r
72443dd2 275 print(" Handler RVA: %s" % RVA[0].childNodes[0].data)\r
88dab294
JY
276\r
277 if (len(RVA)) >= 1:\r
278 rvaName = RVA[0].childNodes[0].data\r
279 symbolName = getSymbolName (driverName, int(rvaName, 16))\r
280\r
281 if (len(symbolName)) >= 1:\r
282 SymbolNode = createSym(symbolName)\r
283 Handler[0].appendChild(SymbolNode)\r
284\r
285 Caller = smiHandler.getElementsByTagName("Caller")\r
286 RVA = Caller[0].getElementsByTagName("RVA")\r
72443dd2 287 print(" Caller RVA: %s" % RVA[0].childNodes[0].data)\r
88dab294
JY
288\r
289 if (len(RVA)) >= 1:\r
290 rvaName = RVA[0].childNodes[0].data\r
291 symbolName = getSymbolName (driverName, int(rvaName, 16))\r
292\r
293 if (len(symbolName)) >= 1:\r
294 SymbolNode = createSym(symbolName)\r
295 Caller[0].appendChild(SymbolNode)\r
296\r
297 try :\r
298 newfile = open(Options.outputfilename, "w")\r
299 except Exception:\r
72443dd2 300 print("fail to open output" + Options.outputfilename)\r
88dab294
JY
301 return 1\r
302\r
303 newfile.write(DOMTree.toprettyxml(indent = "\t", newl = "\n", encoding = "utf-8"))\r
304 newfile.close()\r
305\r
306if __name__ == '__main__':\r
307 sys.exit(main())\r