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           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

OPTIONS

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

ENVIRONMENT VARIABLES

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

FILES

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

SEE ALSO

178       ureport.conf(5), report_uploader.conf(5), uploader_event.conf(5)
179

AUTHORS

181       •   ABRT team
182
183
184
185LIBREPORT 2.17.11                 06/30/2023               REPORTER-UREPORT(1)
Impressum