diff options
| -rw-r--r-- | abrt.spec.in | 1 | ||||
| -rw-r--r-- | src/plugins/Makefile.am | 1 | ||||
| -rw-r--r-- | src/plugins/abrt-action-generate-backtrace.c | 4 | ||||
| -rw-r--r-- | src/plugins/abrt-action-generate-backtrace.txt | 47 |
4 files changed, 51 insertions, 2 deletions
diff --git a/abrt.spec.in b/abrt.spec.in index 3c300972..ee22b0f0 100644 --- a/abrt.spec.in +++ b/abrt.spec.in @@ -543,6 +543,7 @@ fi %{_sysconfdir}/%{name}/events/reanalyze_LocalGDB.xml %{_sysconfdir}/%{name}/events/analyze_RetraceServer.xml %{_sysconfdir}/%{name}/events/reanalyze_RetraceServer.xml +%{_mandir}/man*/abrt-action-generate-backtrace.* %{_mandir}/man*/abrt-action-analyze-backtrace.* %files addon-kerneloops diff --git a/src/plugins/Makefile.am b/src/plugins/Makefile.am index 482ac39f..476c2b13 100644 --- a/src/plugins/Makefile.am +++ b/src/plugins/Makefile.am @@ -61,6 +61,7 @@ man_MANS = \ abrt-plugins.7 MAN_TXT = \ + abrt-action-generate-backtrace.txt \ abrt-action-analyze-backtrace.txt \ abrt-action-mailx.txt diff --git a/src/plugins/abrt-action-generate-backtrace.c b/src/plugins/abrt-action-generate-backtrace.c index 561b2165..44ec752c 100644 --- a/src/plugins/abrt-action-generate-backtrace.c +++ b/src/plugins/abrt-action-generate-backtrace.c @@ -242,7 +242,7 @@ int main(int argc, char **argv) const char *program_usage_string = _( PROGNAME" [options] -d DIR\n" "\n" - "Generates and saves backtrace for coredump in dump directory DIR" + "Analyzes coredump in dump directory DIR, generates and saves backtrace" ); enum { OPT_v = 1 << 0, @@ -255,7 +255,7 @@ int main(int argc, char **argv) OPT__VERBOSE(&g_verbose), OPT_STRING( 'd', NULL, &dump_dir_name , "DIR" , _("Dump directory")), OPT_STRING( 'i', NULL, &i_opt , "DIR1[:DIR2]...", _("Additional debuginfo directories")), - OPT_INTEGER('t', NULL, &exec_timeout_sec, _("Kill gdb if it runs for more than N seconds")), + OPT_INTEGER('t', NULL, &exec_timeout_sec, _("Kill gdb if it runs for more than NUM seconds")), OPT_END() }; /*unsigned opts =*/ parse_opts(argc, argv, program_options, program_usage_string); diff --git a/src/plugins/abrt-action-generate-backtrace.txt b/src/plugins/abrt-action-generate-backtrace.txt new file mode 100644 index 00000000..75340f23 --- /dev/null +++ b/src/plugins/abrt-action-generate-backtrace.txt @@ -0,0 +1,47 @@ +abrt-action-generate-backtrace(1) +================================ + +NAME +---- +abrt-action-generate-backtrace - Analyzes coredump, generates and saves backtrace. + +SYNOPSIS +-------- +'abrt-action-generate-backtrace' [-v] [-d DIR] [-i DIR1[:DIR2]...] [-t NUM] + +DESCRIPTION +----------- +This tool runs gdb(1) on a file named 'coredump' in dump directory DIR. +gdb(1) generates backtrace and other diagnostic information about the state +of the application at the moment when coredump was generated. +Then the tool saves it as new element 'backtrace' in this dump directory. + +Integration with ABRT events +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +'abrt-action-generate-backtrace' can be used as an analyzer for +application crashes which dump core. + +Example usage in abrt_event.conf: + +------------ +EVENT=analyze analyzer=CCpp + abrt-action-generate-backtrace +------------ + +OPTIONS +------- +-d DIR:: + Path to dump directory. + +-v:: + Be more verbose. Can be given multiple times. + +-i DIR1[:DIR2]:: + Additional debuginfo directories + +-t NUM:: + Kill gdb if it runs for more than NUM seconds + +AUTHORS +------- +* ABRT team |