1REPORTER-UREPORT(1) LIBREPORT MANUAL REPORTER-UREPORT(1)
2
3
4
6 reporter-ureport - Reports ABRT problems in format of micro report
7
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
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 puppet
41 Uses the certificate that is used by the Puppet configuration
42 management tool.
43
44 <cert_path>:<key_path>
45 Manually supply paths to certificate and the corresponding key
46 in PEM format.
47
48 HTTPAuth
49 Use the configured values to as HTTP Basic Authentication
50 credentials. Assigning any value to this option changes the default
51 value of IncludeAuthData to yes.
52
53 Possible values are
54
55 <user_name>:<password>
56 Manually supply credentials.
57
58 ContactEmail
59 Email address attached to a bthash on the server.
60
61 IncludeAuthData
62 If this option is set to yes, uploaded uReport will contain auth
63 object consisting from key value pairs made from CSV list stored in
64 AuthDataItems option. Keys are file names and values are bites of
65 these files.
66
67 The default value is no, unless you set SSLClientAuth to some value. In that
68 case, the default value is yes.
69
70 AuthDataItems
71 CSV list of files included in the auth uReport object.
72
73 ProcessUnpackaged
74 Report problems coming from unpackaged executables.
75
76 Parameters can be overridden via $uReport_PARAM environment variables.
77
79 -c FILE
80 Path to configuration file
81
82 -a, --attach BTHASH
83 bthash of uReport to attach (conflicts with -A)
84
85 -A, --attach-rt
86 Attach to a bthash from reported_to (conflicts with -a)
87
88 -b, --bug-id NUM
89 Attach RHBZ bug (requires -a)
90
91 -B, --bug-id-rt
92 Attach last RHBZ bug from reported_to (requires -a|-A, conflicts
93 with -b)
94
95 -e, --email EMAIL
96 Contact e-mail address (requires -a|-A, conflicts with -E)
97
98 -E, --email-env
99 Contact e-mail address from environment (requires -a|-A, conflicts
100 with -e)
101
102 -d, --problem-dir DIR
103 Path to problem directory.
104
105 -k, --insecure
106 Allow insecure connection to ureport server
107
108 -t, --auth SOURCE
109 Enables client authentication. See SSLClientAuth configuration file
110 option for list of possible values.
111
112 -h, --http-auth CREDENTIALS
113 Enables client authentication via HTTP Authentication. See HTTPAuth
114 configuration file option for list of possible values.
115
116 -v
117 Be more verbose. Can be given multiple times.
118
119 -u, --url URL
120 Specify server URL
121
122 -i AUTH_DATA_ITEMS
123 List of dump dir files included in the auth uReport object.
124
125 -o, --comment DESCRIPTION
126 Attach short text (requires -a|-A, conflicts with -D)
127
128 -O, --comment-file
129 Attach short text from comment (requires -a|-A, conflicts with -d)
130
131 -l DATA
132 Attach DATA (requires -T and -a|-A)
133
134 -L REPORT_RESULT_FILED
135 Attach the value of REPORT_RESULT_FILED member of the last report
136 result indentified by REPORT_RESULT_TYPE passed with -r option
137 (requires -r, -T and -a|-A).
138
139 -T ATTACHMENT_TYPE
140 Specifies the attachment type when attaching an arbitrary data to
141 BTHASH (takes effect only with -l or -L)
142
143 -r REPORT_RESULT_TYP
144 Used to single out report results (reported_to file lines) when
145 attaching an arbitrary data to BTHASH (takes effect only with -L)
146
148 Environment variables take precedence over values provided in the
149 configuration file.
150
151 uReport_URL
152 Base sever HTTP(S) address.
153
154 uReport_SSLVerify
155 Use yes/true/on/1 to verify server’s SSL certificate. (default:
156 yes)
157
158 uReport_ContactEmail
159 Email address attached to a bthash on the server.
160
161 uReport_IncludeAuthData
162 See IncludeAuthData configuration option for details.
163
164 uReport_AuthDataItems
165 See AuthDataItems configuration option for details.
166
167 uReport_ProcessUnpackaged
168 Report problems coming from unpackaged executables.
169
171 /usr/share/libreport/conf.d/plugins/ureport.conf
172 Readonly default configuration files.
173
174 /etc/libreport/plugins/ureport.conf
175 Configuration file.
176
178 ureport.conf(5), report_uploader.conf(5), uploader_event.conf(5)
179
181 • ABRT team
182
183
184
185LIBREPORT 2.17.11 07/20/2023 REPORTER-UREPORT(1)