|
3 | 3 | # log-malloc2 / backtrace2line |
4 | 4 | # Translate backtrace() output into functions, file names and line numbers (supports ASLR) |
5 | 5 | # |
6 | | -# Author: Samuel Behan <_samuel_._behan_(at)_dob_._sk> (C) 2013-2014 |
| 6 | +# Author: Samuel Behan <_samuel_._behan_(at)_dob_._sk> (C) 2013-2015 |
7 | 7 | # |
8 | 8 | # License: GNU GPLv3 (http://www.gnu.org/licenses/gpl.html) |
9 | 9 | # |
@@ -303,7 +303,7 @@ ($$$@) |
303 | 303 | { |
304 | 304 | if($WARNING == 0 && !%libs) |
305 | 305 | { |
306 | | - warn("WARNING: incomplete SYMBOL (without libname), but no --pid or --maps-file provided!\n"); |
| 306 | + warn("WARNING: incomplete SYMBOL (without libname), but no --pid or --maps-file provided !\n"); |
307 | 307 | $WARNING = 1; |
308 | 308 | } |
309 | 309 |
|
@@ -527,23 +527,25 @@ =head1 OPTIONS |
527 | 527 |
|
528 | 528 | =item B<--pid> I<PID> |
529 | 529 |
|
530 | | -Pid of a B<still> running process, that generated given backtrace (needed only if ASLR active). Pid |
531 | | -is esed to get process memory map (from /proc/<pid>/maps). |
| 530 | +Pid of a B<still> running process, that generated given backtrace (needed only if ASLR active or |
| 531 | +if backtrace sumbol contains no library, like when libunwind is used). |
| 532 | +Pid is used to get process memory map (from /proc/<pid>/maps). |
532 | 533 |
|
533 | 534 | =item B<-m> I<MAPS-FILE> |
534 | 535 |
|
535 | 536 | =item B<--maps-file> I<MAPS-FILE> |
536 | 537 |
|
537 | | -Path to a file with process memory map of a backtraced process. This is required if if ALSR is |
538 | | -active. Data from maps file are also used to find full path of the application/libraries from |
539 | | -symbol(s). |
| 538 | +Path to a file with process memory map of a backtraced process. This is required if ALSR is |
| 539 | +active or if backtrace has been generated by libunwind. |
| 540 | +Data from maps file is used to identify functions location (IP is checked against mapped range) |
| 541 | +or to find full path of the application/libraries from symbol(s). |
540 | 542 |
|
541 | 543 | =item B<-wd> I<WORK-DIR> |
542 | 544 |
|
543 | 545 | =item B<--work-dir> I<WORK-DIR> |
544 | 546 |
|
545 | 547 | Original work or start dir of backtraced process (needed only if backtrace contains relative paths, |
546 | | -and maps files has not been provided). |
| 548 | +and maps file has not been provided). |
547 | 549 |
|
548 | 550 | =item B<--demangle> I<STYLE> |
549 | 551 |
|
|
0 commit comments