summaryrefslogtreecommitdiffstats
path: root/lib
diff options
context:
space:
mode:
Diffstat (limited to 'lib')
-rw-r--r--lib/Plugins/abrt-Bugzilla.716
-rw-r--r--lib/Plugins/abrt-FileTransfer.745
-rw-r--r--lib/Plugins/abrt-KerneloopsReporter.76
-rw-r--r--lib/Plugins/abrt-KerneloopsScanner.710
-rw-r--r--lib/Plugins/abrt-Logger.712
-rw-r--r--lib/Plugins/abrt-Mailx.716
-rw-r--r--lib/Plugins/abrt-RunApp.712
-rw-r--r--lib/Plugins/abrt-SQLite3.712
-rw-r--r--lib/Plugins/abrt-plugins.724
9 files changed, 77 insertions, 76 deletions
diff --git a/lib/Plugins/abrt-Bugzilla.7 b/lib/Plugins/abrt-Bugzilla.7
index ec56256..c3c0e90 100644
--- a/lib/Plugins/abrt-Bugzilla.7
+++ b/lib/Plugins/abrt-Bugzilla.7
@@ -4,22 +4,22 @@ Bugzilla plugin for abrt(8)
.SH DESCRIPTION
.P
.I abrt
-is a daemon which watches for application crashes. When a crash occurs,
-it collects the crash data and performs some actions according to
-the configuration. This manual page describes the \fIBugzilla\fP plugin
+is a daemon that watches for application crashes. When a crash occurs,
+it collects the crash data and takes action according to
+its configuration. This manual page describes the \fIBugzilla\fP plugin
for \fIabrt\fP.
.P
-This plugin is used to report the crash to the Bugzilla. The plugin
-will determine the package name and distribution version. The crash
-data is attached to the bug report.
+This plugin is used to report the crash to a Bugzilla instance. The
+plugin will determine the package name and distribution version. The
+crash data is attached to the bug report.
.SH INVOCATION
The plugin is invoked in the \fIabrt.conf\fP configuration file.
No parameters are necessary.
.SH CONFIGURATION
The \fIBugzilla.conf\fP configuration file contains several
-entries in a format "Option = Value". The options are:
+entries in the format "Option = Value". The options are:
.SS BugzillaURL
-The URL of the Bugzilla instance you want to use, including the
+The URL of the Bugzilla instance that you want to use, including the
path to the xmlrpc. The default is https://bugzilla.redhat.com/xmlrpc.cgi
.SS Login
Your Bugzilla login. If you have no Bugzilla account, you cannot
diff --git a/lib/Plugins/abrt-FileTransfer.7 b/lib/Plugins/abrt-FileTransfer.7
index c2c2ac7..b126c2c 100644
--- a/lib/Plugins/abrt-FileTransfer.7
+++ b/lib/Plugins/abrt-FileTransfer.7
@@ -4,58 +4,59 @@ FileTransfer plugin for abrt(8)
.SH DESCRIPTION
.P
.I abrt
-is a daemon which watches for application crashes. When a crash occurs,
-it collects the crash data and performs some actions according to
-the configuration. This manual page describes the \fIFileTransfer\fP plugin
+is a daemon that watches for application crashes. When a crash occurs,
+it collects the crash data and takes action according to
+its configuration. This manual page describes the \fIFileTransfer\fP plugin
for \fIabrt\fP.
.P
This plugin is used to transfer the crash report to another
-machine via some file transfer protocol. Supported protocols
-are FTP, FTPS, HTTP, HTTPS, SCP, SFTP and TFTP.
+machine using a file transfer protocol. The protocols supported
+are FTP, FTPS, HTTP, HTTPS, SCP, SFTP, and TFTP.
.SH INVOCATION
.P
The plugin is invoked in the \fIabrt.conf\fP file, usually in the
\fIActionsAndReporters\fP option and/or the \fI[cron]\fP section.
-There are two modes of invocation: either you use the parameter
-\fI"store"\fP: in this case, the plugin stores the information,
-that the crash occurs, in its internal list.
+There are two modes of invocation:
.P
-If you use some other parameter, or no parameter at all, the
+* If you use the parameter
+\fI"store"\fP, the plugin stores a record of the occurrence of
+the crash in its internal list.
+.P
+* If you use some other parameter, or no parameter at all, the
plugin will iterate through the internal list and will send
every recorded crash to the server specified in the \fIFileTransfer.conf\fP
configuration file. After that, the internal list is cleared.
.P
-The rationale of this behavior is this: on a production
-machine, you probably don't want the crash data to be
-sent in the time the machine is busy working, you want
-to send everything in some more quiet time (at night, perhaps)
-and schedule this in the \fI[cron]\fP section of \fIabrt.conf\fP.
+On a production machine, you probably do not want the daemon to send crash
+data at times that the machine is busy working. This second mode allows you
+to send crash reports at a quieter time (at night, perhaps) that you
+schedule in the \fI[cron]\fP section of \fIabrt.conf\fP.
.SH CONFIGURATION
The \fIFileTransfer.conf\fP configuration file contains
-several entries in a format "Option = Value". The options are:
+several entries in the format "Option = Value". The options are:
.SS URL
The URL of the server, where the crash should
be transfered, specifying the protocol, the path,
-the user name and the password, for example
+the user name and the password, for example:
.br
URL = ftp://user:passwd@server.com/path
.SS ArchiveType
-The type of the archive, where the crash data will be packed.
-Currently supporting \fI.tar.gz\fP, \fI.tar.bz2\fP and \fI.zip\fP
+The type of the archive in which to pack the crash data.
+Currently, \fI.tar.gz\fP, \fI.tar.bz2\fP and \fI.zip\fP are supported.
The plugin currently relies on external file archiving
commandline utilities, which will create the archive.
The default is
.br
ArchiveType = .tar.gz
.SS RetryCount
-This specifies, how many times will the plugin try to resend
-the file in the case the transfer was not succesful. The plugin
+This specifies how many times the plugin will try to resend
+the file if the transfer was not succesful. The plugin
waits a while before it retries the transfer: see \fIRetryDelay\fP
The default is
.br
RetryCount = 3
.SS RetryDelay
-In the case the transfer was not succesful, the plugin will
+If the transfer was not succesful, the plugin will
wait some time before sending the file again. This configuration
option specifies the time in seconds. The default is
.br
@@ -63,7 +64,7 @@ RetryDelay = 20
.SH EXAMPLES
.P
Typical configuration in \fIabrt.conf\fP. The crash is stored
-each time it happens and on midnight, all the crash data
+each time it happens and at midnight, all the crash data
is transferred to a central server.
.P
[common]
diff --git a/lib/Plugins/abrt-KerneloopsReporter.7 b/lib/Plugins/abrt-KerneloopsReporter.7
index a0c2341..e0d32c3 100644
--- a/lib/Plugins/abrt-KerneloopsReporter.7
+++ b/lib/Plugins/abrt-KerneloopsReporter.7
@@ -4,9 +4,9 @@ KerneloopsReporter plugin for abrt(8)
.SH DESCRIPTION
.P
.I abrt
-is a daemon which watches for application crashes. When a crash occurs,
-it collects the crash data and performs some actions according to
-the configuration. This manual page describes the \fIKerneloopsReporter\fP
+is a daemon that watches for application crashes. When a crash occurs,
+it collects the crash data and takes action according to
+its configuration. This manual page describes the \fIKerneloopsReporter\fP
plugin for \fIabrt\fP.
.P
This plugin is used to report the crash to the Kerneloops tracker.
diff --git a/lib/Plugins/abrt-KerneloopsScanner.7 b/lib/Plugins/abrt-KerneloopsScanner.7
index 0cbc1dc..d9642a9 100644
--- a/lib/Plugins/abrt-KerneloopsScanner.7
+++ b/lib/Plugins/abrt-KerneloopsScanner.7
@@ -4,16 +4,16 @@ KerneloopsScanner plugin for abrt(8)
.SH DESCRIPTION
.P
.I abrt
-is a daemon which watches for application crashes. When a crash occurs,
-it collects the crash data and performs some actions according to
-the configuration. This manual page describes the \fIKerneloopsScanner\fP
+is a daemon that watches for application crashes. When a crash occurs,
+it collects the crash data and takes action according to
+its configuration. This manual page describes the \fIKerneloopsScanner\fP
plugin for \fIabrt\fP.
.P
This plugin reads the system log file (default /var/log/messages)
and stores the kernel oops crashes, which were not already
-reported, to the abrt's debug dump directory.
+reported, to abrt's debug dump directory.
.P
-In order to distinguish between new crashes and the crashes
+To distinguish between new crashes and crashes
that were already reported, the plugin makes its own entry
in the log file, which acts as a separator.
.SH INVOCATION
diff --git a/lib/Plugins/abrt-Logger.7 b/lib/Plugins/abrt-Logger.7
index 6541c10..0f814d2 100644
--- a/lib/Plugins/abrt-Logger.7
+++ b/lib/Plugins/abrt-Logger.7
@@ -4,17 +4,17 @@ Logger plugin for abrt(8)
.SH DESCRIPTION
.P
.I abrt
-is a daemon which watches for application crashes. When a crash occurs,
-it collects the crash data and performs some actions according to
-the configuration. This manual page describes the \fILogger\fP plugin
+is a daemon that watches for application crashes. When a crash occurs,
+it collects the crash data and takes action according to
+its configuration. This manual page describes the \fILogger\fP plugin
for \fIabrt\fP.
.P
This plugin is used to log the crash to a file.
.P
The log will contain all the file names as well as their
content. It also contains "duplicity check": the ID
-of the crash, which is used to tell, if the same
-crash already happened.
+of the crash, which is used to tell whether the same
+crash has happened previously.
.SH INVOCATION
The plugin is invoked in the \fIabrt.conf\fP configuration file.
No parameters are necessary.
@@ -24,7 +24,7 @@ several entries in a format "Option = Value". The options are:
.SS LogPath
The path to the log file.
.SS AppendLogs
-If set to "yes", which is the default, \fILogger\fP will append
+If set to "yes" (the default) \fILogger\fP will append
the report to the file, otherwise it will overwrite the file (so
only the last crash will be stored).
.SH EXAMPLES
diff --git a/lib/Plugins/abrt-Mailx.7 b/lib/Plugins/abrt-Mailx.7
index 43790f2..10d5e4b 100644
--- a/lib/Plugins/abrt-Mailx.7
+++ b/lib/Plugins/abrt-Mailx.7
@@ -4,9 +4,9 @@ Mailx plugin for abrt(8)
.SH DESCRIPTION
.P
.I abrt
-is a daemon which watches for application crashes. When a crash occurs,
-it collects the crash data and performs some actions according to
-the configuration. This manual page describes the \fIMailx\fP plugin
+is a daemon that watches for application crashes. When a crash occurs,
+it collects the crash data and takes action according to
+its configuration. This manual page describes the \fIMailx\fP plugin
for \fIabrt\fP.
.P
This plugin is used to mail the data about the crash
@@ -25,13 +25,13 @@ The \fIMailx\fP plugin executes the external "mailx" command to
send the mail. This option defines some additional command line
parameters, which should be added to the program invocation, if any.
.SS EmailFrom
-The address, from which the e-mail is sent.
+The address from which the email is sent.
.SS EmailTo
-The address, to which the e-mail is sent.
+The address to which the email is sent.
.SS SendBinaryData
-Can be "yes" or "no". If set to "yes", the e-mail will contain
-also the binary files associated with the crash. Warning:
-this can cause the e-mails to be large! (several MB)
+Can be "yes" or "no". If set to "yes", the email will also
+contain the binary files associated with the crash. Warning:
+this can cause the emails to be large! (several MB)
.SH EXAMPLES
.P
These are snippets from the \fIabrt.conf\fP configuration file.
diff --git a/lib/Plugins/abrt-RunApp.7 b/lib/Plugins/abrt-RunApp.7
index 2128cf8..6d75b12 100644
--- a/lib/Plugins/abrt-RunApp.7
+++ b/lib/Plugins/abrt-RunApp.7
@@ -4,15 +4,15 @@ RunApp plugin for abrt(8)
.SH DESCRIPTION
.P
.I abrt
-is a daemon which watches for application crashes. When a crash occurs,
-it collects the crash data and performs some actions according to
-the configuration. This manual page describes the \fIRunApp\fP plugin
+is a daemon that watches for application crashes. When a crash occurs,
+it collects the crash data and takes action according to
+its configuration. This manual page describes the \fIRunApp\fP plugin
for \fIabrt\fP.
.P
-This plugin is used to run an arbitrary application, when the crash occurs.
+This plugin is used to run a specified application when the crash occurs.
.SH INVOCATION
The plugin is invoked in the \fIabrt.conf\fP configuration file.
-The first parameter is the command to run, the second, optional
+The first parameter is the command to run. The second, optional
parameter specifies an output file, to which the standard
output of the program is saved.
.SH CONFIGURATION
@@ -22,7 +22,7 @@ sufficient.
.P
These are snippets from the \fIabrt.conf\fP configuration file.
.P
-1) each time something crashes, print (and save in a text file)
+1) Each time something crashes, print (and save in a text file)
which processes are running on the system.
.PP
[common]
diff --git a/lib/Plugins/abrt-SQLite3.7 b/lib/Plugins/abrt-SQLite3.7
index 86b5097..87df539 100644
--- a/lib/Plugins/abrt-SQLite3.7
+++ b/lib/Plugins/abrt-SQLite3.7
@@ -4,15 +4,15 @@ SQLite3 database plugin for abrt(8)
.SH DESCRIPTION
.P
.I abrt
-is a daemon which watches for application crashes. When a crash occurs,
-it collects the crash data and performs some actions according to
-the configuration. This manual page describes the \fISQLite3\fP database plugin
+is a daemon that watches for application crashes. When a crash occurs,
+it collects the crash data and takes action according to
+its configuration. This manual page describes the \fISQLite3\fP database plugin
for \fIabrt\fP.
.P
-This is a database plugin: \fIabrt\fP needs some database to store
-its metadata. You can choose which one, specifying "Database" in
+This is a database plugin: \fIabrt\fP needs a database in which to store
+its metadata. You can choose one by specifying "Database" in
the \fIabrt.conf\fP configuration file. Currently SQLite3 is
-the only choice.
+the only choice supported.
.SH INVOCATION
The plugin is invoked in the \fIabrt.conf\fP configuration file, like
this:
diff --git a/lib/Plugins/abrt-plugins.7 b/lib/Plugins/abrt-plugins.7
index 22f89d6..a7c185c 100644
--- a/lib/Plugins/abrt-plugins.7
+++ b/lib/Plugins/abrt-plugins.7
@@ -4,28 +4,28 @@ abrt-plugins \- plugins for the abrt crash reporter program
.SH DESCRIPTION
.P
.I abrt
-is a daemon which watches for application crashes. When a crash occurs,
+is a daemon that watches for application crashes. When a crash occurs,
it collects the crash data (core file, application's command line etc.)
-and performs some actions according to the type of application that
-crashed and according to configuration in the
+and takes action according to the type of application that
+crashed and according to the configuration specified in the
.I abrt.conf
configuration file.
.P
-There are plugins for various actions: for example reporting
-the crash to Bugzilla, mailing the report, transfering the
-report via FTP or SCP, or running an arbitrary program.
+Plugins allow abrt to perform various actions: for example,
+to report the crash to Bugzilla, to mail the report, to transfer
+the report via FTP or SCP, or to run a program that you specify.
.P
-This manual page provides a list of all manual pages of
-the plugins.
+This manual page provides a list of all the manual pages for
+these plugins.
.P
-If you want to create your own plugin, there's a PLUGINS-HOWTO
+If you want to create your own plugin, refer to the PLUGINS-HOWTO
file in the documentation directory.
.SH INVOCATION
Each plugin is invoked in the \fIabrt.conf\fP configuration
-file, in the section, which is appropriate to what you
-want to do.
+file, in the section that is appropriate to what you
+want abrt to do.
.SH CONFIGURATION
-Almost each plugin has its configuration file,
+Almost every plugin has its configuration file,
stored in the \fI/etc/abrt/plugins\fP directory.
.SH "SEE ALSO"
.IR abrt (8),