1REPORTER-UREPORT(1)            LIBREPORT MANUAL            REPORTER-UREPORT(1)
2
3
4

NAME

6       reporter-ureport - Reports ABRT problems in format of micro report
7

SYNOPSIS

9       reporter-ureport [-v] [-c CONFFILE] [-u URL] [-k] [-A -a bthash -B -b
10       bug-id -E -e email -O -o comment -l DATA -L FIELD -T TYPE -r
11       RESULT_TYPE] [-d DIR]
12

DESCRIPTION

14       The tool reads problem directory DIR, assembles an micro report from
15       the loaded problem data and sends the micro report to uReport server
16       for updating statistics and fast analysis. The results of the analysis
17       are stored in problem data in form of problems elements.
18       reporter-ureport updates reported_to
19
20   Configuration file
21       If not specified, CONFFILE defaults to
22       /etc/libreport/plugins/ureport.conf. Configuration file lines should
23       have PARAM = VALUE format. The parameters are:
24
25       URL
26           Base sever HTTP(S) address.
27
28       SSLVerify
29           Use no/false/off/0 to disable verification of server’s SSL
30           certificate. (default: yes)
31
32       SSLClientAuth
33           If this option is set, client-side SSL certificate is used to
34           authenticate to the server so that it knows which machine it came
35           from. Assigning any value to this option changes the default value
36           of IncludeAuthData to yes.
37
38               Possible values are:
39
40           rhsm
41               Uses the system V3 entitlement certificate that is used for Red
42               Hat subscription management.
43
44           puppet
45               Uses the certificate that is used by the Puppet configuration
46               management tool.
47
48           <cert_path>:<key_path>
49               Manually supply paths to certificate and the corresponding key
50               in PEM format.
51
52       HTTPAuth
53           Use the configured values to as HTTP Basic Authentication
54           credentials. Assigning any value to this option changes the default
55           value of IncludeAuthData to yes.
56
57       Possible values are
58
59           rhts-credentials
60               Uses Login= and Password= values from
61               /etc/libreport/plugins/rhtsupport.conf and user’s local
62               ~/.config/libreport/rhtsupport.conf.
63
64           <user_name>:<password>
65               Manually supply credentials.
66
67       ContactEmail
68           Email address attached to a bthash on the server.
69
70       IncludeAuthData
71           If this option is set to yes, uploaded uReport will contain auth
72           object consisting from key value pairs made from CSV list stored in
73           AuthDataItems option. Keys are file names and values are bites of
74           these files.
75
76               The default value is no, unless you set SSLClientAuth to some value. In that
77               case, the default value is yes.
78
79       AuthDataItems
80           CSV list of files included in the auth uReport object.
81
82       ProcessUnpackaged
83           Report problems coming from unpackaged executables.
84
85       Parameters can be overridden via $uReport_PARAM environment variables.
86

OPTIONS

88       -c FILE
89           Path to configuration file
90
91       -a, --attach BTHASH
92           bthash of uReport to attach (conflicts with -A)
93
94       -A, --attach-rt
95           Attach to a bthash from reported_to (conflicts with -a)
96
97       -b, --bug-id NUM
98           Attach RHBZ bug (requires -a)
99
100       -B, --bug-id-rt
101           Attach last RHBZ bug from reported_to (requires -a|-A, conflicts
102           with -b)
103
104       -e, --email EMAIL
105           Contact e-mail address (requires -a|-A, conflicts with -E)
106
107       -E, --email-env
108           Contact e-mail address from environment (requires -a|-A, conflicts
109           with -e)
110
111       -d, --problem-dir DIR
112           Path to problem directory.
113
114       -k, --insecure
115           Allow insecure connection to ureport server
116
117       -t, --auth SOURCE
118           Enables client authentication. See SSLClientAuth configuration file
119           option for list of possible values.
120
121       -h, --http-auth CREDENTIALS
122           Enables client authentication via HTTP Authentication. See HTTPAuth
123           configuration file option for list of possible values.
124
125       -v
126           Be more verbose. Can be given multiple times.
127
128       -u, --url URL
129           Specify server URL
130
131       -i AUTH_DATA_ITEMS
132           List of dump dir files included in the auth uReport object.
133
134       -o, --comment DESCRIPTION
135           Attach short text (requires -a|-A, conflicts with -D)
136
137       -O, --comment-file
138           Attach short text from comment (requires -a|-A, conflicts with -d)
139
140       -l DATA
141           Attach DATA (requires -T and -a|-A)
142
143       -L REPORT_RESULT_FILED
144           Attach the value of REPORT_RESULT_FILED member of the last report
145           result indentified by REPORT_RESULT_TYPE passed with -r option
146           (requires -r, -T and -a|-A).
147
148       -T ATTACHMENT_TYPE
149           Specifies the attachment type when attaching an arbitrary data to
150           BTHASH (takes effect only with -l or -L)
151
152       -r REPORT_RESULT_TYP
153           Used to single out report results (reported_to file lines) when
154           attaching an arbitrary data to BTHASH (takes effect only with -L)
155

ENVIRONMENT VARIABLES

157       Environment variables take precedence over values provided in the
158       configuration file.
159
160       uReport_URL
161           Base sever HTTP(S) address.
162
163       uReport_SSLVerify
164           Use yes/true/on/1 to verify server’s SSL certificate. (default:
165           yes)
166
167       uReport_ContactEmail
168           Email address attached to a bthash on the server.
169
170       uReport_IncludeAuthData
171           See IncludeAuthData configuration option for details.
172
173       uReport_AuthDataItems
174           See AuthDataItems configuration option for details.
175
176       uReport_ProcessUnpackaged
177           Report problems coming from unpackaged executables.
178

FILES

180       /usr/share/libreport/conf.d/plugins/ureport.conf
181           Readonly default configuration files.
182
183       /etc/libreport/plugins/ureport.conf
184           Configuration file.
185

SEE ALSO

187       ureport.conf(5), report_uploader.conf(5), uploader_event.conf(5)
188

AUTHORS

190       ·   ABRT team
191
192
193
194LIBREPORT 2.9.5                   08/10/2019               REPORTER-UREPORT(1)
Impressum