REPORTER-UREPORT(1)

🌸 NAME 🌸

reporter-ureport — ok so this is the tool that reports ABRT problems in format of micro report 💖

---

✨ SYNOPSIS ✨

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

---

🦋 DESCRIPTION 🦋

So here's the vibe: the tool reads problem directory DIR, assembles a micro report from the loaded problem data, and yeets that micro report over to the uReport server so it can update statistics and do fast analysis. The results of the analysis get stored back in the problem data in the form of problems elements. Also, reporter-ureport updates reported_to. Slay. 🫶

🎀 Configuration file 🎀

If you don't specify one, CONFFILE defaults to /etc/libreport/plugins/ureport.conf. Every line in that config file should be in PARAM = VALUE format. The parameters are, like:

URL

Base sever HTTP(S) address.

SSLVerify

Use no/false/off/0 to disable verification of server’s SSL certificate. (default: yes)

SSLClientAuth

If this option is set, client-side SSL certificate is used to authenticate to the server so that it knows which machine it came from. Assigning any value to this option changes the default value of IncludeAuthData to yes.

Possible values are:

• puppet — uses the certificate that is used by the Puppet configuration management tool.
• <cert_path>:<key_path> — manually supply paths to certificate and the corresponding key in PEM format.

HTTPAuth

Use the configured values to as HTTP Basic Authentication credentials. Assigning any value to this option changes the default value of IncludeAuthData to yes.

Possible values are:

• <user_name>:<password> — manually supply credentials.

ContactEmail

Email address attached to a bthash on the server. 📧

IncludeAuthData

If this option is set to yes, uploaded uReport will contain auth object consisting from key value pairs made from CSV list stored in AuthDataItems option. Keys are file names and values are bites of these files.

The default value is no, unless you set SSLClientAuth to some value. In that case, the default value is yes.

AuthDataItems

CSV list of files included in the auth uReport object.

ProcessUnpackaged

Report problems coming from unpackaged executables.

Parameters can be overridden via $uReport_PARAM environment variables. 👑

---

💅 OPTIONS 💅

• -c FILE — path to configuration file
• -a, --attach BTHASH — bthash of uReport to attach (conflicts with -A)
• -A, --attach-rt — attach to a bthash from reported_to (conflicts with -a)
• -b, --bug-id NUM — attach RHBZ bug (requires -a)
• -B, --bug-id-rt — attach last RHBZ bug from reported_to (requires -a|-A, conflicts with -b)
• -e, --email EMAIL — contact e-mail address (requires -a|-A, conflicts with -E)
• -E, --email-env — contact e-mail address from environment (requires -a|-A, conflicts with -e)
• -d, --problem-dir DIR — path to problem directory.
• -k, --insecure — allow insecure connection to ureport server
• -t, --auth SOURCE — enables client authentication. See SSLClientAuth configuration file option for list of possible values.
• -h, --http-auth CREDENTIALS — enables client authentication via HTTP Authentication. See HTTPAuth configuration file option for list of possible values.
• -v — be more verbose. Can be given multiple times.
• -u, --url URL — specify server URL
• -i AUTH_DATA_ITEMS — list of dump dir files included in the auth uReport object.
• -o, --comment DESCRIPTION — attach short text (requires -a|-A, conflicts with -D)
• -O, --comment-file — attach short text from comment (requires -a|-A, conflicts with -d)
• -l DATA — attach DATA (requires -T and -a|-A)
• -L REPORT_RESULT_FILED — attach the value of REPORT_RESULT_FILED member of the last report result indentified by REPORT_RESULT_TYPE passed with -r option (requires -r, -T and -a|-A).
• -T ATTACHMENT_TYPE — specifies the attachment type when attaching an arbitrary data to BTHASH (takes effect only with -l or -L)
• -r REPORT_RESULT_TYP — used to single out report results (reported_to file lines) when attaching an arbitrary data to BTHASH (takes effect only with -L)

---

🌈 ENVIRONMENT VARIABLES 🌈

Environment variables take precedence over values provided in the configuration file. Fr fr, env wins. 🏆

• uReport_URL — base sever HTTP(S) address.
• uReport_SSLVerify — use yes/true/on/1 to verify server’s SSL certificate. (default: yes)
• uReport_ContactEmail — email address attached to a bthash on the server.
• uReport_IncludeAuthData — see IncludeAuthData configuration option for details.
• uReport_AuthDataItems — see AuthDataItems configuration option for details.
• uReport_ProcessUnpackaged — report problems coming from unpackaged executables.

---

🍓 FILES 🍓

• /usr/share/libreport/conf.d/plugins/ureport.conf — readonly default configuration files.
• /etc/libreport/plugins/ureport.conf — configuration file.

---

👑 SEE ALSO 👑

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

---

🧚 AUTHORS 🧚

• ABRT team

---

ok that's literally the whole thing bestie, go forth and report 💜 — this was LIBREPORT 2.17.15, dated 07/15/2024, iykyk ✨🎀