REPORTER-UREPORT(1)

NAME
reporter-ureport - 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

The tool reads problem directory DIR, assembles an micro report from the loaded problem data and sends the micro report to uReport server for updating statistics and fast analysis. The results of the analysis are stored in problem data in form of problems elements. reporter-ureport updates reported_to

  Configuration file

If not specified, CONFFILE defaults to /etc/libreport/plugins/ureport.conf. Configuration file lines should have PARAM = VALUE format. The parameters are:

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.

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