Related to abrt/abrt#672

Signed-off-by: Jakub Filak jfilak@redhat.com --- doc/Makefile.am | 3 +++ doc/report-gtk.txt | 44 ++++++++++++++++++++++++++++++++++++++++++++ doc/report-newt.txt | 27 +++++++++++++++++++++++++++ doc/reporter-ureport.txt | 47 +++++++++++++++++++++++++++++++++++++++++++++++ 4 files changed, 121 insertions(+) create mode 100644 doc/report-gtk.txt create mode 100644 doc/report-newt.txt create mode 100644 doc/reporter-ureport.txt

diff --git a/doc/Makefile.am b/doc/Makefile.am index b52a043..11e2c4d 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -9,6 +9,8 @@ XMLTO_SILENT_0 = @echo " XMLTO " $@;

MAN1_TXT = MAN1_TXT += report-cli.txt +MAN1_TXT += report-newt.txt +MAN1_TXT += report-gtk.txt

if BUILD_BUGZILLA MAN1_TXT += reporter-bugzilla.txt @@ -20,6 +22,7 @@ MAN1_TXT += reporter-mailx.txt MAN1_TXT += reporter-print.txt MAN1_TXT += reporter-rhtsupport.txt MAN1_TXT += reporter-upload.txt +MAN1_TXT += reporter-ureport.txt

MAN5_TXT = MAN5_TXT += report_event.conf.txt diff --git a/doc/report-gtk.txt b/doc/report-gtk.txt new file mode 100644 index 0000000..20e3685 --- /dev/null +++ b/doc/report-gtk.txt @@ -0,0 +1,44 @@ +report-gtk(1) +=========== + +NAME +---- +report-gtk - GUI tool to analyze and report ABRT problems + +SYNOPSIS +-------- +'report-gtk' [-vpdx] [-e EVENT] [-g GUI_FILE] PROBLEM_DIR + +DESCRIPTION +----------- +'report-gtk' is a graphical tool that reports application crashes and other +problems caught by abrtd daemon, or created by other programs using libreport. +report-gtk works with a single problem saved in specified PROBLEM_DIR. +In the expert mode it enables access to and manipulation of problem data. + +OPTIONS +------- +-d, --delete:: + Remove PROBLEM_DIR after reporting + +-e EVENT:: + Run only theset EVENTs on PROBLEM_DIR + +-g FILE:: + Alternate GUI file + +-p:: + Add program names to log + +-v, --verbose:: + Be verbose + +-V, --version:: + Display version and exit + +-x, --expert:: + Enabled advanced features + +AUTHORS +------- +* ABRT team diff --git a/doc/report-newt.txt b/doc/report-newt.txt new file mode 100644 index 0000000..63e8ed0 --- /dev/null +++ b/doc/report-newt.txt @@ -0,0 +1,27 @@ +report-newt(1) +============ + +NAME +---- +report-newt - Reports ABRT problem to various bug tracking tools. + +SYNOPSIS +-------- +'report-newt' [-d] PROBLEM_DIR + +DESCRIPTION +----------- +'report-newt' is a command line tool that reports application crashes and other +problems caught by abrtd daemon, or created by other programs using libreport. + +OPTIONS +------- +-d, --delete:: + Remove PROBLEM_DIR after reporting + +-V, --version:: + Display version and exit + +AUTHORS +------- +* ABRT team diff --git a/doc/reporter-ureport.txt b/doc/reporter-ureport.txt new file mode 100644 index 0000000..1da336d --- /dev/null +++ b/doc/reporter-ureport.txt @@ -0,0 +1,47 @@ +reporter-ureport(1) +================= + +NAME +---- +reporter-ureport - Reports ABRT problems in format of micro report + +SYNOPSIS +-------- +'reporter-ureport' [-v] [-u URL] [-k] [-a bthash -b bug-id] [-r] [-d DIR] + +DESCRIPTION +----------- +The tool reads problem directory DIR, assembles an micro report from the loaded +problem data and sends the micro report to uReport server for updating +statistics and fast analysis. The results of the analysis are stored in problem +data in form of problems elements. 'reporter-ureport' updates 'reported_to' +element with links to duplicates and saves solutions in 'not-reportable' element. + + +OPTIONS +------- +-a, --attach BTHASH:: + bthash of uReport to attach + +-b, --bug-id NUM:: + Attach RHBZ bug (requires -a) + +-d DIR:: + Path to problem directory. + +-k,--insecure:: + Allow insecure connection to ureport server + +-r, --attach-reported-to:: + Attach contents of reported_to + +-v:: + Be more verbose. Can be given multiple times. + +-u, --url URL:: + Specify server URL + + +AUTHORS +------- +* ABRT team

Related to abrt/abrt#669

Signed-off-by: Jakub Filak jfilak@redhat.com --- libreport.spec.in | 21 --------------------- 1 file changed, 21 deletions(-)

diff --git a/libreport.spec.in b/libreport.spec.in index 51dc747..23089f3 100644 --- a/libreport.spec.in +++ b/libreport.spec.in @@ -165,11 +165,6 @@ server, usually to kerneloops.org. Summary: %{name}'s logger reporter plugin Group: System Environment/Libraries Requires: %{name} = %{version}-%{release} -Obsoletes: abrt-plugin-logger < 2.0.4 -Provides: report-plugin-localsave = 0:0.23-1 -Obsoletes: report-plugin-localsave < 0:0.23-1 -Provides: report-config-localsave = 0:0.23-1 -Obsoletes: report-config-localsave < 0:0.23-1

%description plugin-logger The simple reporter plugin which writes a report to a specified file. @@ -179,7 +174,6 @@ Summary: %{name}'s mailx reporter plugin Group: System Environment/Libraries Requires: %{name} = %{version}-%{release} Requires: mailx -Obsoletes: abrt-plugin-mailx < 2.0.4

%description plugin-mailx The simple reporter plugin which sends a report via mailx to a specified @@ -191,11 +185,6 @@ Summary: %{name}'s bugzilla plugin Group: System Environment/Libraries Requires: %{name} = %{version}-%{release} Requires: libreport-web = %{version}-%{release} -Obsoletes: abrt-plugin-bugzilla < 2.0.4 -Provides: report-plugin-bugzilla = 0:0.23-1 -Obsoletes: report-plugin-bugzilla < 0:0.23-1 -Provides: report-config-bugzilla-redhat-com = 0:0.23-1 -Obsoletes: report-config-bugzilla-redhat-com < 0:0.23-1

%description plugin-bugzilla Plugin to report bugs into the bugzilla. @@ -216,7 +205,6 @@ Summary: %{name}'s RHTSupport plugin Group: System Environment/Libraries Requires: %{name} = %{version}-%{release} Requires: libreport-web = %{version}-%{release} -Obsoletes: abrt-plugin-rhtsupport < 2.0.4

%description plugin-rhtsupport Plugin to report bugs into RH support system. @@ -238,15 +226,6 @@ Summary: %{name}'s reportuploader plugin Group: System Environment/Libraries Requires: %{name} = %{version}-%{release} Requires: libreport-web = %{version}-%{release} -Obsoletes: abrt-plugin-reportuploader < 2.0.4 -Provides: report-plugin-ftp = 0:0.23-1 -Obsoletes: report-plugin-ftp < 0:0.23-1 -Provides: report-config-ftp = 0:0.23-1 -Obsoletes: report-config-ftp < 0:0.23-1 -Provides: report-plugin-scp = 0:0.23-1 -Obsoletes: report-plugin-scp < 0:0.23-1 -Provides: report-config-scp = 0:0.23-1 -Obsoletes: report-config-scp < 0:0.23-1

%description plugin-reportuploader Plugin to report bugs into anonymous FTP site associated with ticketing system.

Related to #672

Signed-off-by: Jakub Filak jfilak@redhat.com --- doc/Makefile.am | 15 +++++++++ doc/abrt-action-analyze-core.txt | 33 ++++++++++++++++++++ doc/abrt-action-analyze-vulnerability.txt | 24 ++++++++++++++ doc/abrt-action-analyze-xorg.txt | 47 ++++++++++++++++++++++++++++ doc/abrt-action-install-debuginfo.txt | 44 ++++++++++++++++++++++++++ doc/abrt-action-perform-ccpp-analysis.txt | 40 ++++++++++++++++++++++++ doc/abrt-action-save-kernel-data.txt | 33 ++++++++++++++++++++ doc/abrt-applet.txt | 33 ++++++++++++++++++++ doc/abrt-dedup-client.txt | 52 +++++++++++++++++++++++++++++++ doc/abrt-dump-oops.txt | 49 +++++++++++++++++++++++++++++ doc/abrt-dump-xorg.txt | 46 +++++++++++++++++++++++++++ doc/abrt-harvest-uefioops.txt | 25 +++++++++++++++ doc/abrt-harvest-vmcore.txt | 32 +++++++++++++++++++ doc/abrt-merge-uefioops.txt | 30 ++++++++++++++++++ doc/abrt-watch-log.txt | 34 ++++++++++++++++++++ doc/system-config-abrt.txt | 19 +++++++++++ 16 files changed, 556 insertions(+) create mode 100644 doc/abrt-action-analyze-core.txt create mode 100644 doc/abrt-action-analyze-vulnerability.txt create mode 100644 doc/abrt-action-analyze-xorg.txt create mode 100644 doc/abrt-action-install-debuginfo.txt create mode 100644 doc/abrt-action-perform-ccpp-analysis.txt create mode 100644 doc/abrt-action-save-kernel-data.txt create mode 100644 doc/abrt-applet.txt create mode 100644 doc/abrt-dedup-client.txt create mode 100644 doc/abrt-dump-oops.txt create mode 100644 doc/abrt-dump-xorg.txt create mode 100644 doc/abrt-harvest-uefioops.txt create mode 100644 doc/abrt-harvest-vmcore.txt create mode 100644 doc/abrt-merge-uefioops.txt create mode 100644 doc/abrt-watch-log.txt create mode 100644 doc/system-config-abrt.txt

diff --git a/doc/Makefile.am b/doc/Makefile.am index 94d8f8f..872d210 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -8,17 +8,32 @@ MAN1_TXT += abrt-action-trim-files.txt MAN1_TXT += abrt-action-generate-backtrace.txt MAN1_TXT += abrt-action-generate-core-backtrace.txt MAN1_TXT += abrt-action-analyze-backtrace.txt +MAN1_TXT += abrt-action-analyze-core.txt MAN1_TXT += abrt-action-analyze-oops.txt MAN1_TXT += abrt-action-analyze-python.txt +MAN1_TXT += abrt-action-analyze-xorg.txt +MAN1_TXT += abrt-action-analyze-vulnerability.txt +MAN1_TXT += abrt-action-install-debuginfo.txt MAN1_TXT += abrt-action-list-dsos.txt +MAN1_TXT += abrt-action-perform-ccpp-analysis.txt +MAN1_TXT += abrt-applet.txt +MAN1_TXT += abrt-dump-oops.txt +MAN1_TXT += abrt-dump-xorg.txt MAN1_TXT += abrt-retrace-client.txt MAN1_TXT += abrt-handle-upload.txt +MAN1_TXT += abrt-harvest-uefioops.txt +MAN1_TXT += abrt-harvest-vmcore.txt +MAN1_TXT += abrt-merge-uefioops.txt MAN1_TXT += abrt-server.txt +MAN1_TXT += abrt-dedup-client.txt MAN1_TXT += abrt-cli.txt MAN1_TXT += abrt-action-save-package-data.txt +MAN1_TXT += abrt-action-save-kernel-data.txt MAN1_TXT += abrt-install-ccpp-hook.txt MAN1_TXT += abrt-action-analyze-vmcore.txt MAN1_TXT += abrt-action-analyze-ccpp-local.txt +MAN1_TXT += abrt-watch-log.txt +MAN1_TXT += system-config-abrt.txt if BUILD_BODHI MAN1_TXT += abrt-bodhi.txt endif diff --git a/doc/abrt-action-analyze-core.txt b/doc/abrt-action-analyze-core.txt new file mode 100644 index 0000000..750be2d --- /dev/null +++ b/doc/abrt-action-analyze-core.txt @@ -0,0 +1,33 @@ +abrt-action-analyze-core(1) +============================= + +NAME +---- +abrt-action-analyze-core - Extracts builds from a core dump + +SYNOPSIS +-------- +'abrt-action-analyze-core' [-v] [-o OUTFILE] -c COREFILE + +DESCRIPTION +----------- +The tool reads a core dump and extracts build ids of loaded modules and prints +the list to the standard output if the OUTFILE file is not configured. + +OPTIONS +------- +-c COREFILE:: + Path to a core dump. + +-v:: + Be more verbose. Can be given multiple times. + +-o OUTFILE:: + Output file + +-h, --help:: + Prints help text + +AUTHORS +------- +* ABRT team diff --git a/doc/abrt-action-analyze-vulnerability.txt b/doc/abrt-action-analyze-vulnerability.txt new file mode 100644 index 0000000..8dc118f --- /dev/null +++ b/doc/abrt-action-analyze-vulnerability.txt @@ -0,0 +1,24 @@ +abrt-action-analyze-vulnerability(1) +================================== + +NAME +---- +abrt-action-analyze-vulnerability - Provides assessment of potential exploitability of crash + +SYNOPSIS +-------- +abrt-action-analyze-vulnerability + +DESCRIPTION +----------- +This tool expects that file named 'coredump' is placed in the current directory +and runs abrt-gdb-exploitable gdb plugin on that file. The result of +vulnerability analysis is saved in 'exploitable' file in the current directory. + +This tool requires both 'gdb' and 'eu-readelf' executables placed in PATH. If +any of the required programs is missing the tool silently exits with 0 exit +code. + +AUTHORS +------- +* ABRT team diff --git a/doc/abrt-action-analyze-xorg.txt b/doc/abrt-action-analyze-xorg.txt new file mode 100644 index 0000000..880c6fb --- /dev/null +++ b/doc/abrt-action-analyze-xorg.txt @@ -0,0 +1,47 @@ +abrt-action-analyze-xorg(1) +=========================== + +NAME +---- +abrt-action-analyze-xorg - Calculate and save UUID and duplicate hash +for a problem data directory DIR with Xorg backtrace. + +SYNOPSIS +-------- +'abrt-action-analyze-xorg' [-v] [-d DIR] + +DESCRIPTION +----------- +The tool reads the file named 'Xorg.0.log' and checks if any black listed +module was loaded. If so, 'not-reportable' file is created with an appropriate +explanation text. If no black listed module was loaded, the tool reads the +file named 'backtrace' from a problem data directory record and generates a +duplication hash and a universally unique identifier (UUID). Then it saves +this data as new elements 'duphash' and 'uuid'. + +Integration with ABRT events +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +'abrt-action-analyze-xorg' can be used to generate the duplication +hash of a newly discovered Xorg backtraces. + +------------ +EVENT=post-create analyzer=Xorg abrt-action-analyze-xorg +------------ + +OPTIONS +------- +-d DIR:: + Path to a problem directory. Current working directory is used when + this option is not provided. + +-v:: + Be more verbose. Can be given multiple times. + +FILES +----- +/etc/abrt/xorg.conf + List of modules which, when loaded, should make Xorg crashes non-reportable. + +AUTHORS +------- +* ABRT team diff --git a/doc/abrt-action-install-debuginfo.txt b/doc/abrt-action-install-debuginfo.txt new file mode 100644 index 0000000..49a0ebd --- /dev/null +++ b/doc/abrt-action-install-debuginfo.txt @@ -0,0 +1,44 @@ +abrt-action-install-debuginfo(1) +============================== + +NAME +---- +abrt-action-install-debuginfo - Install debuginfos for build-ids + +SYNOPSIS +-------- +'abrt-action-install-debuginfo' [-vy] [--ids=BUILD_IDS_FILE] [--tmpdir=TMPDIR] [--cache=CACHEDIR[:DEBUGINFODIR1:DEBUGINFODIR2...]] [--size_mb=SIZE] [-e PATH] + +DESCRIPTION +----------- +Installs debuginfos for all build-ids listed in BUILD_IDS_FILE +to CACHEDIR, using TMPDIR as temporary staging area. +Old files in CACHEDIR are deleted until it is smaller than SIZE. + +OPTIONS +------- +-v:: + Be more verbose. Can be given multiple times. + +-y:: + Noninteractive, assume 'Yes' to all questions + +--ids:: + Path to file with list of build ids. Default: build_ids + +--tmpdir:: + Path to tmp directory. Default: /tmp/abrt-tmp-debuginfo-RANDOM_SUFFIX + +--cache:: + Path to cache directory. Default: /var/cache/abrt-di + +--size_mb:: + Default: 4096 + +-e,--exact:: + Download only specified files + +AUTHORS +------- +* ABRT team + diff --git a/doc/abrt-action-perform-ccpp-analysis.txt b/doc/abrt-action-perform-ccpp-analysis.txt new file mode 100644 index 0000000..3fac30f --- /dev/null +++ b/doc/abrt-action-perform-ccpp-analysis.txt @@ -0,0 +1,40 @@ +abrt-action-perform-ccpp-analysis(1) +================================== + +NAME +---- +abrt-action-perform-ccpp-analysis - Allows users to select acceptable way of core dump analysis + +SYNOPSIS +-------- +'abrt-action-perform-ccpp-analysis' [-h] [-d PROBLEM_DIR] + +DESCRIPTION +----------- +This tool allows user to select between local and remote core dump analysis. +The local analysis may require to download huge amount of data but is +completely safe. On the contrary the remote analysis only needs to upload the +core dump to retrace server but the core dump may contain security sensitive +data. + +Integration with ABRT events +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +'abrt-action-perform-ccpp-analysis' is used in the analyze step when processing +C/C++ crashes + +------------ +EVENT=analyze_CCpp analyzer=CCpp + abrt-action-perform-ccpp-analysis +------------ + +OPTIONS +------- +-d, --problem-dir PROBLEM_DIR:: + Problem directory [Default: current directory] + +-h, --help:: + Show help message + +AUTHORS +------- +* ABRT team diff --git a/doc/abrt-action-save-kernel-data.txt b/doc/abrt-action-save-kernel-data.txt new file mode 100644 index 0000000..f82fa35 --- /dev/null +++ b/doc/abrt-action-save-kernel-data.txt @@ -0,0 +1,33 @@ +abrt-action-save-kernel-data(1) +================================ + +NAME +---- +abrt-action-save-kernel-data - Creates uReport mandatory files for kernel oopses. + +SYNOPSIS +-------- +'abrt-action-save-kernel-data' + +DESCRIPTION +----------- +The tool reads problem directory DIR. It analyzes contents of 'kernel' element, +checks database of installed packages, and creates new elements +'pkg_name', 'pkg_arch', 'pkg_version', 'pkg_release'. + +These files are required by reporter-ureporter (mandatory in uReport). + +Integration with ABRT events +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +This tool can be used as an ABRT reporter. Example +fragment for /etc/libreport/report_event.conf: + +------------ +# Determine in which package/component the crash happened (if not yet done): +EVENT=post-create analyzer=Kerneloops + abrt-action-save-kernel-data +------------ + +AUTHORS +------- +* ABRT team diff --git a/doc/abrt-applet.txt b/doc/abrt-applet.txt new file mode 100644 index 0000000..3dfc00b --- /dev/null +++ b/doc/abrt-applet.txt @@ -0,0 +1,33 @@ +abrt-applet(1) +============ + +NAME +---- +abrt-applet - Applet which notifies user when new problems are detected by ABRT + +SYNOPSIS +-------- +'abrt-applet' [-v] + +DESCRIPTION +----------- +This tool listens on 'org.freedesktop.problems' D-Bus bus and waits for 'Crash' +signal. When the tool detects the signal, it notifies user about new problem +over a desktop specific notification pop-up. + +At start-up this tool checks for new problems which occurred while the tool was +not running and if it finds any of such problem it notifies user over a desktop +specific notification pop-up. + +OPTIONS +------- +-v, --verbose:: + Be more verbose. Can be given multiple times. + +SEE ALSO +-------- +abrt-dbus(8) + +AUTHORS +------- +* ABRT team diff --git a/doc/abrt-dedup-client.txt b/doc/abrt-dedup-client.txt new file mode 100644 index 0000000..b837fcd --- /dev/null +++ b/doc/abrt-dedup-client.txt @@ -0,0 +1,52 @@ +abrt-dedup-client(1) +================== + +NAME +---- +abrt-dedup-client - The ABRT dedup server client. + +SYNOPSIS +-------- +'abrt-dedup-client' [-vsk] [--url URL] [--port PORT] [-d DIR] [--headers] + +DESCRIPTION +----------- +'abrt-dedup-client' is the command-line tool for searching for duplicates. + +OPTIONS +------- +-v, --verbose:: + be verbose + +-s, --syslog:: + log to syslog + +-k, --insecure:: + allow insecure connection to dedup server + +--url URL:: + dedup server URL [Default: retrace.fedoraproject.org] + +--port NUM:: + dedup server port [Default: 443] + +-d, --dump-dir DIR:: + problem directory [Default: current directory] + +--headers:: + (debug) show received HTTP headers + +ENVIRONMENT +----------- +DEDUP_SERVER_URL:: + dedup server URL + +DEDUP_SERVER_PORT:: + dedup server PORT + +DEDUP_SERVER_INSECURE:: + Allow insecure connection to dedup server (use 'insecure') + +AUTHORS +------- +* ABRT team diff --git a/doc/abrt-dump-oops.txt b/doc/abrt-dump-oops.txt new file mode 100644 index 0000000..f63e53a --- /dev/null +++ b/doc/abrt-dump-oops.txt @@ -0,0 +1,49 @@ +abrt-dump-oops(1) +=============== + +NAME +---- +abrt-dump-oops - Extract oops from FILE (or standard input) + +SYNOPSIS +-------- +'abrt-dump-oops' [-vusoxm] [-d DIR]/[-D] [FILE] + +DESCRIPTION +----------- +This tool creates problem directory from, updates problem directory with or +prints oops extracted from FILE or standard input. + +OPTIONS +------- +-v, --verbose:: + Be more verbose. Can be given multiple times. + +-s:: + Log to syslog + +-o:: + Print found oopses on standard output + +-d DIR:: + Create new problem directory in DIR for every oops found + +-D:: + Same as -d DumpLocation, DumpLocation is specified in abrt.conf + +-u PROBLEM:: + Save the extracted information in PROBLEM directory + +-x:: + Make the problem directory world readable. Usable only with -d/-D + +-m:: + Print search string(s) for 'abrt-watch-log' to stdout and exit + +SEE ALSO +-------- +abrt-watch-log(1), abrt.conf(5) + +AUTHORS +------- +* ABRT team diff --git a/doc/abrt-dump-xorg.txt b/doc/abrt-dump-xorg.txt new file mode 100644 index 0000000..7fe7a79 --- /dev/null +++ b/doc/abrt-dump-xorg.txt @@ -0,0 +1,46 @@ +abrt-dump-xorg(1) +=============== + +NAME +---- +abrt-dump-xorg - Extract Xorg crash from FILE (or standard input) + +SYNOPSIS +-------- +'abrt-dump-xorg' [-vsoxm] [-d DIR]/[-D] [FILE] + +DESCRIPTION +----------- +This tool creates problem directory from or prints Xorg crash extracted from FILE +or standard input. + +OPTIONS +------- +-v, --verbose:: + Be more verbose. Can be given multiple times. + +-s:: + Log to syslog + +-o:: + Print found crash data on standard output + +-d DIR:: + Create new problem directory in DIR for every crash found + +-D:: + Same as -d DumpLocation, DumpLocation is specified in abrt.conf + +-x:: + Make the problem directory world readable. Usable only with -d/-D + +-m:: + Print search string(s) for 'abrt-watch-log' to stdout and exit + +SEE ALSO +-------- +abrt-watch-log(1), abrt.conf(5) + +AUTHORS +------- +* ABRT team diff --git a/doc/abrt-harvest-uefioops.txt b/doc/abrt-harvest-uefioops.txt new file mode 100644 index 0000000..efd6f3f --- /dev/null +++ b/doc/abrt-harvest-uefioops.txt @@ -0,0 +1,25 @@ +abrt-harvest-uefioops(1) +====================== + +NAME +---- +abrt-harvest-uefioops - Reconstruct oops from /sys/fs/pstore/* files, create ABRT problems and remove the files + +SYNOPSIS +-------- +'abrt-harvest-uefioops' + +DESCRIPTION +----------- +This script is meant to be run once at system startup after abrtd is up and +running. It scans /sys/fs/pstore/*, reconstructs oops text(s) from these files, +creates ABRT problem directories from them, then removes the files (UEFI +storage is a limited resource). + +SEE ALSO +-------- +abrt-merge-uefioops(1) + +AUTHORS +------- +* ABRT team diff --git a/doc/abrt-harvest-vmcore.txt b/doc/abrt-harvest-vmcore.txt new file mode 100644 index 0000000..0902afd --- /dev/null +++ b/doc/abrt-harvest-vmcore.txt @@ -0,0 +1,32 @@ +abrt-harvest-vmcore(1) +==================== + +NAME +---- +abrt-harvest-vmcore - Converts VMCores to ABRT problems + +SYNOPSIS +-------- +'abrt-harvest-vmcore' + +DESCRIPTION +----------- +This script is meant to be run once at system startup after abrtd is up and +running. It moves all vmcore directories in /var/crash (which are presumably +created by kdump) to abrtd spool directory. + +The goal is to let abrtd notice and process them as new problem data dirs. + +FILES +----- +/etc/abrt/abrt-harvest-vmcore.conf + Configuration file where user can enable copying or moving VMcore to ABRT + problem directory + +SEE ALSO +-------- +abrt.conf(5) + +AUTHORS +------- +* ABRT team diff --git a/doc/abrt-merge-uefioops.txt b/doc/abrt-merge-uefioops.txt new file mode 100644 index 0000000..8f7de86 --- /dev/null +++ b/doc/abrt-merge-uefioops.txt @@ -0,0 +1,30 @@ +abrt-merge-uefioops(1) +==================== + +NAME +---- +abrt-merge-uefioops - Scans files for split oops message. Can print and/or delete them. + +SYNOPSIS +-------- +'abrt-merge-uefioops' [-v] [-od] FILE... + +DESCRIPTION +----------- +This tool takes list of files, reads all of the files, scans them for split +oops messages and join oops parts to original oops message. + +OPTIONS +------- +-o:: + Print found oopses + +-d:: + Delete files with found oopses + +-v, --verbose:: + Be more verbose. Can be given multiple times. + +AUTHORS +------- +* ABRT team diff --git a/doc/abrt-watch-log.txt b/doc/abrt-watch-log.txt new file mode 100644 index 0000000..c393410 --- /dev/null +++ b/doc/abrt-watch-log.txt @@ -0,0 +1,34 @@ +abrt-watch-log(1) +=============== + +NAME +---- +abrt-watch-log - Watch log file and run command when it grows or is replaced + +SYNOPSIS +-------- +'abrt-watch-log' [-vs] [-F STR] ... FILE PROG [ARGS] + +OPTIONS +------- +-F STR:: + Don't run PROG if STRs aren't found + +-v, --verbose:: + Be more verbose. Can be given multiple times. + +-s:: + Log to syslog + +FILE:: + Watched file + +PROG:: + Path to an executable + +ARGS:: + Arguments for PROG + +AUTHORS +------- +* ABRT team diff --git a/doc/system-config-abrt.txt b/doc/system-config-abrt.txt new file mode 100644 index 0000000..cf431a7 --- /dev/null +++ b/doc/system-config-abrt.txt @@ -0,0 +1,19 @@ +system-config-abrt(1) +=================== + +NAME +---- +system-config-abrt - GUI tool to configure ABRT + +SYNOPSIS +-------- +'system-config-abrt' + +DESCRIPTION +----------- +'system-config-abrt' is a graphical tool that provides to users comfortable way +for changing ABRT's configuration files from one place. + +AUTHORS +------- +* ABRT team

Related to #669

Signed-off-by: Jakub Filak jfilak@redhat.com --- src/hooks/abrt_exception_handler.py.in | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/hooks/abrt_exception_handler.py.in b/src/hooks/abrt_exception_handler.py.in index 774a586..4ed34fd 100644 --- a/src/hooks/abrt_exception_handler.py.in +++ b/src/hooks/abrt_exception_handler.py.in @@ -16,7 +16,7 @@

## You should have received a copy of the GNU General Public License ## along with this program; if not, write to the Free Software -## Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. +## Foundation, Inc., 51 Franklin Street, Suite 500, Boston, MA 02110-1335 USA

""" Module for the ABRT exception handling hook

Related to abrt/abrt#669

Signed-off-by: Jakub Filak jfilak@redhat.com --- libreport.spec.in | 19 +++++++++++++++---- 1 file changed, 15 insertions(+), 4 deletions(-)

diff --git a/libreport.spec.in b/libreport.spec.in index 2a91739..4ae926d 100644 --- a/libreport.spec.in +++ b/libreport.spec.in @@ -76,7 +76,7 @@ Development libraries and headers for libreport

%package web Summary: Library providing network API for libreport -Group: Libraries +Group: System Environment/Libraries Requires: libreport = %{version}-%{release}

%description web @@ -253,6 +253,7 @@ Plugin to report bugs into anonymous FTP site associated with ticketing system. %package fedora Summary: Default configuration for reporting bugs via Fedora infrastructure Group: Applications/File +Requires: %{name} = %{version}-%{release}

%description fedora Default configuration for reporting bugs via Fedora infrastructure @@ -262,6 +263,7 @@ install this package and you're done. %package rhel Summary: Default configuration for reporting bugs via Red Hat infrastructure Group: Applications/File +Requires: %{name} = %{version}-%{release}

%description rhel Default configuration for reporting bugs via Red Hat infrastructure @@ -272,8 +274,9 @@ install this package and you're done. %package anaconda Summary: Default configuration for reporting anaconda bugs Group: Applications/File -Requires: libreport-plugin-reportuploader -Requires: libreport-plugin-bugzilla +Requires: %{name} = %{version}-%{release} +Requires: libreport-plugin-reportuploader = %{version}-%{release} +Requires: libreport-plugin-bugzilla = %{version}-%{release}

%description anaconda Default configuration for reporting Anaconda problems using Fedora @@ -341,6 +344,13 @@ fi %posttrans gtk gtk-update-icon-cache %{_datadir}/icons/hicolor &>/dev/null || :

+ +%post web -p /sbin/ldconfig + + +%postun web -p /sbin/ldconfig + + %files -f %{name}.lang %defattr(-,root,root,-) %doc README COPYING @@ -384,10 +394,11 @@ gtk-update-icon-cache %{_datadir}/icons/hicolor &>/dev/null || :

%files web %defattr(-,root,root,-) -%{_libdir}/libreport-web.so* +%{_libdir}/libreport-web.so.*

%files web-devel %defattr(-,root,root,-) +%{_libdir}/libreport-web.so %{_includedir}/libreport/libreport_curl.h %{_libdir}/pkgconfig/libreport-web.pc

Related to abrt/abrt#672

Signed-off-by: Jakub Filak jfilak@redhat.com --- libreport.spec.in | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/libreport.spec.in b/libreport.spec.in index 4ae926d..a9b134d 100644 --- a/libreport.spec.in +++ b/libreport.spec.in @@ -415,6 +415,7 @@ gtk-update-icon-cache %{_datadir}/icons/hicolor &>/dev/null || : %files newt %defattr(-,root,root,-) %{_bindir}/report-newt +%{_mandir}/man1/report-newt.1.gz

%files gtk %defattr(-,root,root,-) @@ -423,6 +424,7 @@ gtk-update-icon-cache %{_datadir}/icons/hicolor &>/dev/null || : %{_libdir}/libreport-gtk.so.* %config(noreplace) %{_sysconfdir}/libreport/events.d/emergencyanalysis_event.conf %{_datadir}/%{name}/events/report_EmergencyAnalysis.xml +%{_mandir}/man1/report-gtk.1.gz

%files gtk-devel %defattr(-,root,root,-) @@ -455,7 +457,7 @@ gtk-update-icon-cache %{_datadir}/icons/hicolor &>/dev/null || : %files plugin-ureport %defattr(-,root,root,-) %{_bindir}/reporter-ureport -#%{_mandir}/man1/reporter-ureport.1.gz +%{_mandir}/man1/reporter-ureport.1.gz %{_datadir}/%{name}/events/report_uReport.xml

%if %{with bugzilla}

Closes #668

Signed-off-by: Jakub Filak jfilak@redhat.com --- abrt.spec.in | 18 +++++++++--------- configure.ac | 2 +- 2 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/abrt.spec.in b/abrt.spec.in index 7bf9349..033622c 100644 --- a/abrt.spec.in +++ b/abrt.spec.in @@ -698,13 +698,13 @@ gtk-update-icon-cache %{_datadir}/icons/hicolor &>/dev/null || : %config(noreplace) %{_sysconfdir}/libreport/events.d/ccpp_event.conf %config(noreplace) %{_sysconfdir}/libreport/events.d/gconf_event.conf %config(noreplace) %{_sysconfdir}/libreport/events.d/vimrc_event.conf -%config(noreplace) %{_sysconfdir}/libreport/events/analyze_CCpp.xml -%config(noreplace) %{_sysconfdir}/libreport/events/analyze_LocalGDB.xml -%config(noreplace) %{_sysconfdir}/libreport/events/collect_xsession_errors.xml -%config(noreplace) %{_sysconfdir}/libreport/events/collect_GConf.xml -%config(noreplace) %{_sysconfdir}/libreport/events/collect_vimrc_user.xml -%config(noreplace) %{_sysconfdir}/libreport/events/collect_vimrc_system.xml -%config(noreplace) %{_sysconfdir}/libreport/events/post_report.xml +%{_datadir}/libreport/events/analyze_CCpp.xml +%{_datadir}/libreport/events/analyze_LocalGDB.xml +%{_datadir}/libreport/events/collect_xsession_errors.xml +%{_datadir}/libreport/events/collect_GConf.xml +%{_datadir}/libreport/events/collect_vimrc_user.xml +%{_datadir}/libreport/events/collect_vimrc_system.xml +%{_datadir}/libreport/events/post_report.xml %{_mandir}/man*/abrt-action-analyze-c.* %{_mandir}/man*/abrt-action-trim-files.* %{_mandir}/man*/abrt-action-generate-backtrace.* @@ -717,7 +717,7 @@ gtk-update-icon-cache %{_datadir}/icons/hicolor &>/dev/null || : %{_bindir}/abrt-retrace-client %{_mandir}/man1/abrt-retrace-client.1.gz %config(noreplace) %{_sysconfdir}/libreport/events.d/ccpp_retrace_event.conf -%config(noreplace) %{_sysconfdir}/libreport/events/analyze_RetraceServer.xml +%{_datadir}/libreport/events/analyze_RetraceServer.xml

%files addon-kerneloops %defattr(-,root,root,-) @@ -746,7 +746,7 @@ gtk-update-icon-cache %{_datadir}/icons/hicolor &>/dev/null || : %defattr(-,root,root,-) %config(noreplace) %{_sysconfdir}/libreport/events.d/vmcore_event.conf %config(noreplace) %{_sysconfdir}/%{name}/abrt-harvest-vmcore.conf -%config(noreplace) %{_sysconfdir}/libreport/events/analyze_VMcore.xml +%{_datadir}/libreport/events/analyze_VMcore.xml %if %{with systemd} %{_unitdir}/abrt-vmcore.service %else diff --git a/configure.ac b/configure.ac index 7b32618..4e69519 100644 --- a/configure.ac +++ b/configure.ac @@ -127,7 +127,7 @@ AC_CHECK_HEADERS([locale.h]) CONF_DIR='${sysconfdir}/${PACKAGE_NAME}' VAR_RUN='${localstatedir}/run' PLUGINS_CONF_DIR='${sysconfdir}/${PACKAGE_NAME}/plugins' -EVENTS_DIR='${sysconfdir}/libreport/events' +EVENTS_DIR='${datadir}/libreport/events' EVENTS_CONF_DIR='${sysconfdir}/libreport/events.d' ENABLE_SOCKET_OR_DBUS='-DENABLE_DBUS=1' DEFAULT_DUMP_DIR_MODE=$($PKG_CONFIG --variable=dd_mode libreport)

Related to #672

Signed-off-by: Jakub Filak jfilak@redhat.com --- doc/Makefile.am | 15 +++++++++ doc/abrt-action-analyze-core.txt | 33 ++++++++++++++++++++ doc/abrt-action-analyze-vulnerability.txt | 24 ++++++++++++++ doc/abrt-action-analyze-xorg.txt | 47 ++++++++++++++++++++++++++++ doc/abrt-action-install-debuginfo.txt | 44 ++++++++++++++++++++++++++ doc/abrt-action-perform-ccpp-analysis.txt | 40 ++++++++++++++++++++++++ doc/abrt-action-save-kernel-data.txt | 33 ++++++++++++++++++++ doc/abrt-applet.txt | 33 ++++++++++++++++++++ doc/abrt-dedup-client.txt | 52 +++++++++++++++++++++++++++++++ doc/abrt-dump-oops.txt | 49 +++++++++++++++++++++++++++++ doc/abrt-dump-xorg.txt | 46 +++++++++++++++++++++++++++ doc/abrt-harvest-uefioops.txt | 25 +++++++++++++++ doc/abrt-harvest-vmcore.txt | 32 +++++++++++++++++++ doc/abrt-merge-uefioops.txt | 30 ++++++++++++++++++ doc/abrt-watch-log.txt | 34 ++++++++++++++++++++ doc/system-config-abrt.txt | 19 +++++++++++ 16 files changed, 556 insertions(+) create mode 100644 doc/abrt-action-analyze-core.txt create mode 100644 doc/abrt-action-analyze-vulnerability.txt create mode 100644 doc/abrt-action-analyze-xorg.txt create mode 100644 doc/abrt-action-install-debuginfo.txt create mode 100644 doc/abrt-action-perform-ccpp-analysis.txt create mode 100644 doc/abrt-action-save-kernel-data.txt create mode 100644 doc/abrt-applet.txt create mode 100644 doc/abrt-dedup-client.txt create mode 100644 doc/abrt-dump-oops.txt create mode 100644 doc/abrt-dump-xorg.txt create mode 100644 doc/abrt-harvest-uefioops.txt create mode 100644 doc/abrt-harvest-vmcore.txt create mode 100644 doc/abrt-merge-uefioops.txt create mode 100644 doc/abrt-watch-log.txt create mode 100644 doc/system-config-abrt.txt

diff --git a/doc/Makefile.am b/doc/Makefile.am index 94d8f8f..872d210 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -8,17 +8,32 @@ MAN1_TXT += abrt-action-trim-files.txt MAN1_TXT += abrt-action-generate-backtrace.txt MAN1_TXT += abrt-action-generate-core-backtrace.txt MAN1_TXT += abrt-action-analyze-backtrace.txt +MAN1_TXT += abrt-action-analyze-core.txt MAN1_TXT += abrt-action-analyze-oops.txt MAN1_TXT += abrt-action-analyze-python.txt +MAN1_TXT += abrt-action-analyze-xorg.txt +MAN1_TXT += abrt-action-analyze-vulnerability.txt +MAN1_TXT += abrt-action-install-debuginfo.txt MAN1_TXT += abrt-action-list-dsos.txt +MAN1_TXT += abrt-action-perform-ccpp-analysis.txt +MAN1_TXT += abrt-applet.txt +MAN1_TXT += abrt-dump-oops.txt +MAN1_TXT += abrt-dump-xorg.txt MAN1_TXT += abrt-retrace-client.txt MAN1_TXT += abrt-handle-upload.txt +MAN1_TXT += abrt-harvest-uefioops.txt +MAN1_TXT += abrt-harvest-vmcore.txt +MAN1_TXT += abrt-merge-uefioops.txt MAN1_TXT += abrt-server.txt +MAN1_TXT += abrt-dedup-client.txt MAN1_TXT += abrt-cli.txt MAN1_TXT += abrt-action-save-package-data.txt +MAN1_TXT += abrt-action-save-kernel-data.txt MAN1_TXT += abrt-install-ccpp-hook.txt MAN1_TXT += abrt-action-analyze-vmcore.txt MAN1_TXT += abrt-action-analyze-ccpp-local.txt +MAN1_TXT += abrt-watch-log.txt +MAN1_TXT += system-config-abrt.txt if BUILD_BODHI MAN1_TXT += abrt-bodhi.txt endif diff --git a/doc/abrt-action-analyze-core.txt b/doc/abrt-action-analyze-core.txt new file mode 100644 index 0000000..750be2d --- /dev/null +++ b/doc/abrt-action-analyze-core.txt @@ -0,0 +1,33 @@ +abrt-action-analyze-core(1) +============================= + +NAME +---- +abrt-action-analyze-core - Extracts builds from a core dump + +SYNOPSIS +-------- +'abrt-action-analyze-core' [-v] [-o OUTFILE] -c COREFILE + +DESCRIPTION +----------- +The tool reads a core dump and extracts build ids of loaded modules and prints +the list to the standard output if the OUTFILE file is not configured. + +OPTIONS +------- +-c COREFILE:: + Path to a core dump. + +-v:: + Be more verbose. Can be given multiple times. + +-o OUTFILE:: + Output file + +-h, --help:: + Prints help text + +AUTHORS +------- +* ABRT team diff --git a/doc/abrt-action-analyze-vulnerability.txt b/doc/abrt-action-analyze-vulnerability.txt new file mode 100644 index 0000000..8dc118f --- /dev/null +++ b/doc/abrt-action-analyze-vulnerability.txt @@ -0,0 +1,24 @@ +abrt-action-analyze-vulnerability(1) +================================== + +NAME +---- +abrt-action-analyze-vulnerability - Provides assessment of potential exploitability of crash + +SYNOPSIS +-------- +abrt-action-analyze-vulnerability + +DESCRIPTION +----------- +This tool expects that file named 'coredump' is placed in the current directory +and runs abrt-gdb-exploitable gdb plugin on that file. The result of +vulnerability analysis is saved in 'exploitable' file in the current directory. + +This tool requires both 'gdb' and 'eu-readelf' executables placed in PATH. If +any of the required programs is missing the tool silently exits with 0 exit +code. + +AUTHORS +------- +* ABRT team diff --git a/doc/abrt-action-analyze-xorg.txt b/doc/abrt-action-analyze-xorg.txt new file mode 100644 index 0000000..880c6fb --- /dev/null +++ b/doc/abrt-action-analyze-xorg.txt @@ -0,0 +1,47 @@ +abrt-action-analyze-xorg(1) +=========================== + +NAME +---- +abrt-action-analyze-xorg - Calculate and save UUID and duplicate hash +for a problem data directory DIR with Xorg backtrace. + +SYNOPSIS +-------- +'abrt-action-analyze-xorg' [-v] [-d DIR] + +DESCRIPTION +----------- +The tool reads the file named 'Xorg.0.log' and checks if any black listed +module was loaded. If so, 'not-reportable' file is created with an appropriate +explanation text. If no black listed module was loaded, the tool reads the +file named 'backtrace' from a problem data directory record and generates a +duplication hash and a universally unique identifier (UUID). Then it saves +this data as new elements 'duphash' and 'uuid'. + +Integration with ABRT events +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +'abrt-action-analyze-xorg' can be used to generate the duplication +hash of a newly discovered Xorg backtraces. + +------------ +EVENT=post-create analyzer=Xorg abrt-action-analyze-xorg +------------ + +OPTIONS +------- +-d DIR:: + Path to a problem directory. Current working directory is used when + this option is not provided. + +-v:: + Be more verbose. Can be given multiple times. + +FILES +----- +/etc/abrt/xorg.conf + List of modules which, when loaded, should make Xorg crashes non-reportable. + +AUTHORS +------- +* ABRT team diff --git a/doc/abrt-action-install-debuginfo.txt b/doc/abrt-action-install-debuginfo.txt new file mode 100644 index 0000000..49a0ebd --- /dev/null +++ b/doc/abrt-action-install-debuginfo.txt @@ -0,0 +1,44 @@ +abrt-action-install-debuginfo(1) +============================== + +NAME +---- +abrt-action-install-debuginfo - Install debuginfos for build-ids + +SYNOPSIS +-------- +'abrt-action-install-debuginfo' [-vy] [--ids=BUILD_IDS_FILE] [--tmpdir=TMPDIR] [--cache=CACHEDIR[:DEBUGINFODIR1:DEBUGINFODIR2...]] [--size_mb=SIZE] [-e PATH] + +DESCRIPTION +----------- +Installs debuginfos for all build-ids listed in BUILD_IDS_FILE +to CACHEDIR, using TMPDIR as temporary staging area. +Old files in CACHEDIR are deleted until it is smaller than SIZE. + +OPTIONS +------- +-v:: + Be more verbose. Can be given multiple times. + +-y:: + Noninteractive, assume 'Yes' to all questions + +--ids:: + Path to file with list of build ids. Default: build_ids + +--tmpdir:: + Path to tmp directory. Default: /tmp/abrt-tmp-debuginfo-RANDOM_SUFFIX + +--cache:: + Path to cache directory. Default: /var/cache/abrt-di + +--size_mb:: + Default: 4096 + +-e,--exact:: + Download only specified files + +AUTHORS +------- +* ABRT team + diff --git a/doc/abrt-action-perform-ccpp-analysis.txt b/doc/abrt-action-perform-ccpp-analysis.txt new file mode 100644 index 0000000..3fac30f --- /dev/null +++ b/doc/abrt-action-perform-ccpp-analysis.txt @@ -0,0 +1,40 @@ +abrt-action-perform-ccpp-analysis(1) +================================== + +NAME +---- +abrt-action-perform-ccpp-analysis - Allows users to select acceptable way of core dump analysis + +SYNOPSIS +-------- +'abrt-action-perform-ccpp-analysis' [-h] [-d PROBLEM_DIR] + +DESCRIPTION +----------- +This tool allows user to select between local and remote core dump analysis. +The local analysis may require to download huge amount of data but is +completely safe. On the contrary the remote analysis only needs to upload the +core dump to retrace server but the core dump may contain security sensitive +data. + +Integration with ABRT events +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +'abrt-action-perform-ccpp-analysis' is used in the analyze step when processing +C/C++ crashes + +------------ +EVENT=analyze_CCpp analyzer=CCpp + abrt-action-perform-ccpp-analysis +------------ + +OPTIONS +------- +-d, --problem-dir PROBLEM_DIR:: + Problem directory [Default: current directory] + +-h, --help:: + Show help message + +AUTHORS +------- +* ABRT team diff --git a/doc/abrt-action-save-kernel-data.txt b/doc/abrt-action-save-kernel-data.txt new file mode 100644 index 0000000..f82fa35 --- /dev/null +++ b/doc/abrt-action-save-kernel-data.txt @@ -0,0 +1,33 @@ +abrt-action-save-kernel-data(1) +================================ + +NAME +---- +abrt-action-save-kernel-data - Creates uReport mandatory files for kernel oopses. + +SYNOPSIS +-------- +'abrt-action-save-kernel-data' + +DESCRIPTION +----------- +The tool reads problem directory DIR. It analyzes contents of 'kernel' element, +checks database of installed packages, and creates new elements +'pkg_name', 'pkg_arch', 'pkg_version', 'pkg_release'. + +These files are required by reporter-ureporter (mandatory in uReport). + +Integration with ABRT events +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +This tool can be used as an ABRT reporter. Example +fragment for /etc/libreport/report_event.conf: + +------------ +# Determine in which package/component the crash happened (if not yet done): +EVENT=post-create analyzer=Kerneloops + abrt-action-save-kernel-data +------------ + +AUTHORS +------- +* ABRT team diff --git a/doc/abrt-applet.txt b/doc/abrt-applet.txt new file mode 100644 index 0000000..3dfc00b --- /dev/null +++ b/doc/abrt-applet.txt @@ -0,0 +1,33 @@ +abrt-applet(1) +============ + +NAME +---- +abrt-applet - Applet which notifies user when new problems are detected by ABRT + +SYNOPSIS +-------- +'abrt-applet' [-v] + +DESCRIPTION +----------- +This tool listens on 'org.freedesktop.problems' D-Bus bus and waits for 'Crash' +signal. When the tool detects the signal, it notifies user about new problem +over a desktop specific notification pop-up. + +At start-up this tool checks for new problems which occurred while the tool was +not running and if it finds any of such problem it notifies user over a desktop +specific notification pop-up. + +OPTIONS +------- +-v, --verbose:: + Be more verbose. Can be given multiple times. + +SEE ALSO +-------- +abrt-dbus(8) + +AUTHORS +------- +* ABRT team diff --git a/doc/abrt-dedup-client.txt b/doc/abrt-dedup-client.txt new file mode 100644 index 0000000..b837fcd --- /dev/null +++ b/doc/abrt-dedup-client.txt @@ -0,0 +1,52 @@ +abrt-dedup-client(1) +================== + +NAME +---- +abrt-dedup-client - The ABRT dedup server client. + +SYNOPSIS +-------- +'abrt-dedup-client' [-vsk] [--url URL] [--port PORT] [-d DIR] [--headers] + +DESCRIPTION +----------- +'abrt-dedup-client' is the command-line tool for searching for duplicates. + +OPTIONS +------- +-v, --verbose:: + be verbose + +-s, --syslog:: + log to syslog + +-k, --insecure:: + allow insecure connection to dedup server + +--url URL:: + dedup server URL [Default: retrace.fedoraproject.org] + +--port NUM:: + dedup server port [Default: 443] + +-d, --dump-dir DIR:: + problem directory [Default: current directory] + +--headers:: + (debug) show received HTTP headers + +ENVIRONMENT +----------- +DEDUP_SERVER_URL:: + dedup server URL + +DEDUP_SERVER_PORT:: + dedup server PORT + +DEDUP_SERVER_INSECURE:: + Allow insecure connection to dedup server (use 'insecure') + +AUTHORS +------- +* ABRT team diff --git a/doc/abrt-dump-oops.txt b/doc/abrt-dump-oops.txt new file mode 100644 index 0000000..f63e53a --- /dev/null +++ b/doc/abrt-dump-oops.txt @@ -0,0 +1,49 @@ +abrt-dump-oops(1) +=============== + +NAME +---- +abrt-dump-oops - Extract oops from FILE (or standard input) + +SYNOPSIS +-------- +'abrt-dump-oops' [-vusoxm] [-d DIR]/[-D] [FILE] + +DESCRIPTION +----------- +This tool creates problem directory from, updates problem directory with or +prints oops extracted from FILE or standard input. + +OPTIONS +------- +-v, --verbose:: + Be more verbose. Can be given multiple times. + +-s:: + Log to syslog + +-o:: + Print found oopses on standard output + +-d DIR:: + Create new problem directory in DIR for every oops found + +-D:: + Same as -d DumpLocation, DumpLocation is specified in abrt.conf + +-u PROBLEM:: + Save the extracted information in PROBLEM directory + +-x:: + Make the problem directory world readable. Usable only with -d/-D + +-m:: + Print search string(s) for 'abrt-watch-log' to stdout and exit + +SEE ALSO +-------- +abrt-watch-log(1), abrt.conf(5) + +AUTHORS +------- +* ABRT team diff --git a/doc/abrt-dump-xorg.txt b/doc/abrt-dump-xorg.txt new file mode 100644 index 0000000..7fe7a79 --- /dev/null +++ b/doc/abrt-dump-xorg.txt @@ -0,0 +1,46 @@ +abrt-dump-xorg(1) +=============== + +NAME +---- +abrt-dump-xorg - Extract Xorg crash from FILE (or standard input) + +SYNOPSIS +-------- +'abrt-dump-xorg' [-vsoxm] [-d DIR]/[-D] [FILE] + +DESCRIPTION +----------- +This tool creates problem directory from or prints Xorg crash extracted from FILE +or standard input. + +OPTIONS +------- +-v, --verbose:: + Be more verbose. Can be given multiple times. + +-s:: + Log to syslog + +-o:: + Print found crash data on standard output + +-d DIR:: + Create new problem directory in DIR for every crash found + +-D:: + Same as -d DumpLocation, DumpLocation is specified in abrt.conf + +-x:: + Make the problem directory world readable. Usable only with -d/-D + +-m:: + Print search string(s) for 'abrt-watch-log' to stdout and exit + +SEE ALSO +-------- +abrt-watch-log(1), abrt.conf(5) + +AUTHORS +------- +* ABRT team diff --git a/doc/abrt-harvest-uefioops.txt b/doc/abrt-harvest-uefioops.txt new file mode 100644 index 0000000..efd6f3f --- /dev/null +++ b/doc/abrt-harvest-uefioops.txt @@ -0,0 +1,25 @@ +abrt-harvest-uefioops(1) +====================== + +NAME +---- +abrt-harvest-uefioops - Reconstruct oops from /sys/fs/pstore/* files, create ABRT problems and remove the files + +SYNOPSIS +-------- +'abrt-harvest-uefioops' + +DESCRIPTION +----------- +This script is meant to be run once at system startup after abrtd is up and +running. It scans /sys/fs/pstore/*, reconstructs oops text(s) from these files, +creates ABRT problem directories from them, then removes the files (UEFI +storage is a limited resource). + +SEE ALSO +-------- +abrt-merge-uefioops(1) + +AUTHORS +------- +* ABRT team diff --git a/doc/abrt-harvest-vmcore.txt b/doc/abrt-harvest-vmcore.txt new file mode 100644 index 0000000..0902afd --- /dev/null +++ b/doc/abrt-harvest-vmcore.txt @@ -0,0 +1,32 @@ +abrt-harvest-vmcore(1) +==================== + +NAME +---- +abrt-harvest-vmcore - Converts VMCores to ABRT problems + +SYNOPSIS +-------- +'abrt-harvest-vmcore' + +DESCRIPTION +----------- +This script is meant to be run once at system startup after abrtd is up and +running. It moves all vmcore directories in /var/crash (which are presumably +created by kdump) to abrtd spool directory. + +The goal is to let abrtd notice and process them as new problem data dirs. + +FILES +----- +/etc/abrt/abrt-harvest-vmcore.conf + Configuration file where user can enable copying or moving VMcore to ABRT + problem directory + +SEE ALSO +-------- +abrt.conf(5) + +AUTHORS +------- +* ABRT team diff --git a/doc/abrt-merge-uefioops.txt b/doc/abrt-merge-uefioops.txt new file mode 100644 index 0000000..8f7de86 --- /dev/null +++ b/doc/abrt-merge-uefioops.txt @@ -0,0 +1,30 @@ +abrt-merge-uefioops(1) +==================== + +NAME +---- +abrt-merge-uefioops - Scans files for split oops message. Can print and/or delete them. + +SYNOPSIS +-------- +'abrt-merge-uefioops' [-v] [-od] FILE... + +DESCRIPTION +----------- +This tool takes list of files, reads all of the files, scans them for split +oops messages and join oops parts to original oops message. + +OPTIONS +------- +-o:: + Print found oopses + +-d:: + Delete files with found oopses + +-v, --verbose:: + Be more verbose. Can be given multiple times. + +AUTHORS +------- +* ABRT team diff --git a/doc/abrt-watch-log.txt b/doc/abrt-watch-log.txt new file mode 100644 index 0000000..c393410 --- /dev/null +++ b/doc/abrt-watch-log.txt @@ -0,0 +1,34 @@ +abrt-watch-log(1) +=============== + +NAME +---- +abrt-watch-log - Watch log file and run command when it grows or is replaced + +SYNOPSIS +-------- +'abrt-watch-log' [-vs] [-F STR] ... FILE PROG [ARGS] + +OPTIONS +------- +-F STR:: + Don't run PROG if STRs aren't found + +-v, --verbose:: + Be more verbose. Can be given multiple times. + +-s:: + Log to syslog + +FILE:: + Watched file + +PROG:: + Path to an executable + +ARGS:: + Arguments for PROG + +AUTHORS +------- +* ABRT team diff --git a/doc/system-config-abrt.txt b/doc/system-config-abrt.txt new file mode 100644 index 0000000..cf431a7 --- /dev/null +++ b/doc/system-config-abrt.txt @@ -0,0 +1,19 @@ +system-config-abrt(1) +=================== + +NAME +---- +system-config-abrt - GUI tool to configure ABRT + +SYNOPSIS +-------- +'system-config-abrt' + +DESCRIPTION +----------- +'system-config-abrt' is a graphical tool that provides to users comfortable way +for changing ABRT's configuration files from one place. + +AUTHORS +------- +* ABRT team

Related to #669

Signed-off-by: Jakub Filak jfilak@redhat.com --- src/hooks/abrt_exception_handler.py.in | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/hooks/abrt_exception_handler.py.in b/src/hooks/abrt_exception_handler.py.in index 774a586..4ed34fd 100644 --- a/src/hooks/abrt_exception_handler.py.in +++ b/src/hooks/abrt_exception_handler.py.in @@ -16,7 +16,7 @@

## You should have received a copy of the GNU General Public License ## along with this program; if not, write to the Free Software -## Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. +## Foundation, Inc., 51 Franklin Street, Suite 500, Boston, MA 02110-1335 USA

""" Module for the ABRT exception handling hook