Roll src/third_party/WebKit f007c95:0171005 (svn 185074:185088)
[chromium-blink-merge.git] / tools / find_runtime_symbols / README
blobee5c2ac88ca5d0b2e6dda3b6fb34e092ed83f9c8
1 This script maps runtime addresses to symbol names.  It is robust over
2 Address Space Layout Randomization (ASLR) since it uses runtime addresses with
3 runtime mapping information (/proc/.../maps).
4 Like 'pprof --symbols' in gperftools <http://code.google.com/p/gperftools/>.
7 Step 1: Prepare symbol information.
9 It is required to collect symbol information before mapping runtime addresses
10 to symbol names.
12 ./prepare_symbol_info.py /path/to/maps [/another/path/to/symbol_info_dir]
14 The required 'maps' file is /proc/.../maps of the process at runtime.
17 Step 2: Find symbols.
19 ./find_runtime_symbols.py /path/to/symbol_info_dir < addresses.txt
21 'symbol_info_dir' is the result of the Step 1.
22 The stdin should be a list of hex addresses to map, one per line.
24 The results will be printed to stdout like 'pprof --symbols'.