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