reporter-upload(1)
==================

NAME
----
reporter-upload - Uploads compressed tarball of problem directory.

SYNOPSIS
--------
'reporter-upload' [-c CONFFILE]... [-d DIR] [-u URL] [-b FILE] [-r FILE]

DESCRIPTION
-----------
The tool is used to create a compressed tarball of the problem directory and
upload it to a URL. Supported protocols include FTP, FTPS, HTTP, HTTPS, SCP,
SFTP, TFTP and FILE.

Configuration file
~~~~~~~~~~~~~~~~~~
Configuration file contains entries in a format "Option = Value".

The options are:

'URL'::
        The URL where tarball should be uploaded.

'SSHPublicKey'::
        The SSH public key.

'SSHPrivateKey'::
        The SSH private key.

Integration with ABRT events
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
'reporter-upload' can be used as a reporter, to allow users to upload
compressed tarballs of problem directories to a configured URL. This usage can be
configured in /etc/libreport/report_event.conf:

------------
EVENT=report_Upload reporter-upload
------------

It can be also used on the 'post-create' event to upload it automatically.

------------
EVENT=post-create reporter-upload
------------

OPTIONS
-------

-d DIR::
   Path to problem directory.

-c CONFFILE::
   Path to configuration file. When used in ABRT event system, the file
   contains site-wide configuration. Users can change the values via
   environment variables.
   If not specified, it defaults to "/etc/libreport/plugins/upload.conf".

-u URL::
   The URL where tarball should be uploaded.
   URL should have the form protocol://[user[:pass]@]host/dir/[file.tar.gz]
   where protocol can be http(s), ftp, scp, or file.
   File protocol can't have user and host parts: pass:[file:///dir/[file.tar.gz]].
   If URL ends with a slash, the archive name will be generated and appended
   to URL; otherwise, URL will be used as full file name.

-b::
--pubkey FILE::
   Set SSH public key file.

-r::
--key FILE::
   Set SSH private key file.

ENVIRONMENT VARIABLES
---------------------
Environment variables take precedence over values provided in
the configuration file.

'Upload_URL'::
   The URL where should be the tarball uploaded.

'Upload_Username'::
   User name for the upload URL

'Upload_Password'::
   Password for the upload URL

'Upload_SSHPublicKey'::
   Path to SSH public key file

'Upload_SSHPrivateKey'::
   Path to SSH private key file

FILES
-----
/usr/share/libreport/conf.d/plugins/upload.conf::
    Readonly default configuration files.

/etc/libreport/plugins/upload.conf::
    Configuration file.

SEE ALSO
--------
uploader_event.conf(5), report_uploader.conf(5)

AUTHORS
-------
* ABRT team
