summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--abrt.spec.in1
-rw-r--r--src/plugins/Makefile.am1
-rw-r--r--src/plugins/abrt-action-analyze-backtrace.c2
-rw-r--r--src/plugins/abrt-action-analyze-backtrace.txt53
4 files changed, 56 insertions, 1 deletions
diff --git a/abrt.spec.in b/abrt.spec.in
index 59848c12..3c300972 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-analyze-backtrace.*
%files addon-kerneloops
%defattr(-,root,root,-)
diff --git a/src/plugins/Makefile.am b/src/plugins/Makefile.am
index 8744a7d9..482ac39f 100644
--- a/src/plugins/Makefile.am
+++ b/src/plugins/Makefile.am
@@ -61,6 +61,7 @@ man_MANS = \
abrt-plugins.7
MAN_TXT = \
+ abrt-action-analyze-backtrace.txt \
abrt-action-mailx.txt
# Manual pages are generated from .txt via Docbook
diff --git a/src/plugins/abrt-action-analyze-backtrace.c b/src/plugins/abrt-action-analyze-backtrace.c
index f25f379c..0e41b6eb 100644
--- a/src/plugins/abrt-action-analyze-backtrace.c
+++ b/src/plugins/abrt-action-analyze-backtrace.c
@@ -21,7 +21,7 @@
#include "../btparser/location.h"
#include "parse_options.h"
-#define PROGNAME "abrt-action-generate-backtrace"
+#define PROGNAME "abrt-action-analyze-backtrace"
static const char *dump_dir_name = ".";
diff --git a/src/plugins/abrt-action-analyze-backtrace.txt b/src/plugins/abrt-action-analyze-backtrace.txt
new file mode 100644
index 00000000..7a3f096c
--- /dev/null
+++ b/src/plugins/abrt-action-analyze-backtrace.txt
@@ -0,0 +1,53 @@
+abrt-action-analyze-backtrace(1)
+================================
+
+NAME
+----
+abrt-action-analyze-backtrace - Analyzes C/C++ backtrace, generates
+duplication hash, backtrace rating, and identifies crash function
+in dump directory DIR.
+
+
+SYNOPSIS
+--------
+'abrt-action-analyze-backtrace' [-v] [-d DIR]
+
+DESCRIPTION
+-----------
+The tool reads a file named 'backtrace' from problem dump directory,
+generates duplication hash, backtrace rating, and identifies
+crash function. Then it saves this data as new elements 'global_uuid',
+'rating', 'crash_function' in this dump directory.
+
+Integration with ABRT events
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+'abrt-action-analyze-backtrace' can be used as a secondary analyzer,
+after backtrace has been generated. The data generated by
+'abrt-action-analyze-backtrace' is useful for reporting the crash
+to bug databases: rating makes it possible to prevent reporting of bugs
+with low quality (non-informative) backtraces, duplication hash
+is used to find already filed bugs about similar crashes.
+
+Example usage in abrt_event.conf:
+
+------------
+EVENT=analyze analyzer=CCpp
+ abrt-action-generate-backtrace || exit $?
+ abrt-action-analyze-backtrace
+------------
+
+OPTIONS
+-------
+-d DIR::
+ Path to dump directory.
+
+-v::
+ Be more verbose. Can be given multiple times.
+
+AUTHORS
+-------
+* ABRT team
+
+SEE ALSO
+--------
+abrt-action-generate-backtrace