added abrt-action-generate-backtrace manpage

Signed-off-by: Denys Vlasenko <dvlasenk@redhat.com>

1 files changed, 47 insertions, 0 deletions

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