'\" t
.\"     Title: reporter-rhtsupport
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\"      Date: 04/02/2020
.\"    Manual: LIBREPORT MANUAL
.\"    Source: LIBREPORT 2.1.11.1
.\"  Language: English
.\"
.TH "REPORTER\-RHTSUPPORT" "1" "04/02/2020" "LIBREPORT 2\&.1\&.11\&.1" "LIBREPORT MANUAL"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
reporter-rhtsupport \- Reports problem to RHTSupport\&.
.SH "SYNOPSIS"
.sp
\fIreporter\-rhtsupport\fR [\-v] [\-c CONFFILE] [\-F FMTFILE] [\-u \-C UR_CONFFILE] \-d DIR
.sp
Or:
.sp
\fIreporter\-rhtsupport\fR [\-v] [\-c CONFFILE] [\-d DIR] \-t[ID] FILE\&...
.SH "DESCRIPTION"
.sp
The tool reads problem directory DIR\&. Then it logs in to RHTSupport and creates a new case\&.
.sp
The tool can be configured to submit an uReport to RHTSupport together with creating a new case\&.
.sp
The URL to new case is printed to stdout and recorded in \fIreported_to\fR element in DIR\&.
.sp
If not specified, CONFFILE defaults to /etc/libreport/plugins/rhtsupport\&.conf\&.
.sp
Option \-t uploads FILEs to the already created case on RHTSupport site\&. The case ID is retrieved from directory specified by \-d DIR\&. If problem data in DIR was never reported to RHTSupport, you will be asked to enter case ID to which you want to upload the FILEs\&.
.sp
Option \-tCASE uploads FILEs to the case CASE on RHTSupport site\&. \-d DIR is ignored\&.
.sp
Option \-u uploads uReport along with creating a new case\&. uReport configuration is loaded from UR_CONFFILE which defaults to /etc/libreport/plugins/ureport\&.conf\&.
.SS "Configuration file"
.sp
Configuration file lines should have \fIPARAM = VALUE\fR format\&. The parameters are:
.PP
\fILogin\fR
.RS 4
Login to RHTSupport account\&.
.RE
.PP
\fIPassword\fR
.RS 4
Password to RHTSupport account\&.
.RE
.PP
\fIURL\fR
.RS 4
HTTP(S) address\&. (default:
\m[blue]\fBhttps://api\&.access\&.redhat\&.com/rs\fR\m[])
.RE
.PP
\fISSLVerify\fR
.RS 4
Use yes/true/on/1 to verify server\(cqs SSL certificate\&. (default: yes)
.RE
.PP
\fISubmitUReport\fR
.RS 4
Use yes/true/on/1 to enable submitting uReport together wit creating a new case\&. (default: no)
.RE
.sp
Parameters can be overridden via $RHTSupport_PARAM environment variables\&.
.SS "Integration with ABRT events"
.sp
\fIreporter\-rhtsupport\fR can be used as an ABRT reporter\&. Example fragment for /etc/libreport/report_event\&.conf:
.sp
.if n \{\
.RS 4
.\}
.nf
# Report Python crashes
EVENT=report_RHTSupport analyzer=Python
      reporter\-rhtsupport \-d \&. \-c /etc/libreport/plugins/rhtsupport\&.conf
.fi
.if n \{\
.RE
.\}
.SH "OPTIONS"
.PP
\-d DIR
.RS 4
Path to problem directory\&.
.RE
.PP
\-c CONFFILE
.RS 4
Path to configuration file\&.
.RE
.PP
\-t[ID]
.RS 4
Upload FILEs to the already created case on RHTSupport site\&.
.RE
.PP
\-u
.RS 4
Submit uReport together with creating a new case\&.
.RE
.PP
\-C UR_CONFFILE
.RS 4
Configuration file for submitting uReports\&.
.RE
.PP
\-F CONF_FORMAT_FILE
.RS 4
Formatting file for a new case\&.
.RE
.SH "FILES"
.PP
/usr/share/libreport/conf\&.d/plugins/rhtsupport\&.conf
.RS 4
Readonly default configuration files\&.
.RE
.PP
/etc/libreport/plugins/rhtsupport\&.conf
.RS 4
Configuration file\&.
.RE
.SH "SEE ALSO"
.sp
abrt_event\&.conf(5), rhtsupport\&.conf(5), rhtsupport_event\&.conf(5)
