Merge Chromium + Blink git repositories
[chromium-blink-merge.git] / tools / win / RetrieveSymbols / ReadMe.txt
blobfb9c5106fe7d07abb5e27baf6309149c3a617617
1 This tool is designed to download PE files and symbols from symbol servers.
2 Normally this is done automatically by tools such as windbg but it can be
3 helpful to be able to download these files on demand.
5 Sample usage:
7 > rem Add the VS tools to the path, for access to dumpbin
8 > "%vs120comntools%vsvars32.bat"
10 D:\src\chromium\src\tools\win>dumpbin /headers "c:\Program Files (x86)\Google\Chrome\Application\chrome.exe" | findstr "RSDS date image"
11         54E3AECF time date stamp Tue Feb 17 13:12:47 2015
12           400000 image base (00400000 to 004D2FFF)
13             0.00 image version
14            D3000 size of image
15     54E3AECF cv           5D 0008DF80    8D380    Format: RSDS, {283A66AE-3EF3-4383-8798-F6617112B1F6}, 1, C:\b\build\slave\win\build\src\out\Release\initialexe\chrome.exe.pdb
17 > RetrieveSymbols {283A66AE-3EF3-4383-8798-F6617112B1F6}, 1 chrome.exe.pdb
18 Parsing symbol data for a PDB file.
19 Looking for 283A66AE3EF343838798F6617112B1F6 1 chrome.exe.pdb.
20 Found symbol file - placed it in d:\src\symbols\chrome.exe.pdb\283A66AE3EF343838798F6617112B1F61\chrome.exe.pdb.
22 > RetrieveSymbols 54E3AECF D3000 chrome.exe
23 Parsing symbol data for a PE (.dll or .exe) file.
24 Looking for chrome.exe 54e3aecf d3000.
25 Found symbol file - placed it in d:\src\symbols\chrome.exe\54E3AECFd3000\chrome.exe.
27 The first invocation of RetrieveSymbols uses the GUID, age, and PDB name from
28 the RSDS line of the dumpbin output -- the extraneous '{', '}', ',' and '-'
29 characters are stripped out.
31 The second invocation of RetrieveSymbols uses the time date stamp from the
32 first line of the dumpbin output, the "size of image" data, and the
33 executable name.
35 This information can also be obtained from breakpad reports, from windbg
36 by using "lmv m chrome_elf" and "!lmi chrome_elf.dll", from ETW traces,
37 and from other sources.