libreport

Generic library for reporting various problems to destinations like mailing lists, regular files, remote servers and bug tracking tools.

The library operates on problem data stored in the form of regular files in a directory (so called dump directory).

The library provides a low level API (dump_dir.h) for creating and modifying dump directories, a high level API allowing to avoid the need to work with dump directories (problem_data.h), and a set of tools that file reports.

The library also provides an infrastructure (run_event.h, report_event.conf) for automatic execution of shell scripts working with dump directories.

The library is used in ABRT (Automatic Bug Reporting Tool).

flowchart BT
    abrt-java-connector --> abrt
    abrt-java-connector -. build .-> satyr
    abrt --> libreport & satyr
    abrt-java-connector --> libreport
    gnome-abrt --> abrt & libreport
    reportd --> libreport
    libreport:::focus --> satyr
    retrace-server[Retrace Server] -. "optional, for<br>packages only" .-> faf
    faf["ABRT Analytics (FAF)"] --> satyr

click abrt "https://github.com/abrt/abrt" "abrt GitHub repository" _blank
click abrt-java-connector "https://github.com/abrt/abrt-java-connector" "abrt-java-connector GitHub repository" _blank
click faf "https://github.com/abrt/faf" "ABRT Analytics GitHub repository" _blank
click gnome-abrt "https://github.com/abrt/gnome-abrt" "gnome-abrt GitHub repository" _blank
click libreport "https://github.com/abrt/libreport" "libreport GitHub repository" _blank
click reportd "https://github.com/abrt/reportd" "reportd GitHub repository" _blank
click satyr "https://github.com/abrt/satyr" "satyr GitHub repository" _blank
click retrace-server "https://github.com/abrt/retrace-server" "Retrace Server GitHub repository" _blank

classDef focus stroke-width: 4

Loading

Supported report destinations

• regular files : reporter-print

• e-mail : reporter-mailx

• ftp/scp : reporter-upload

• Bugzilla : reporter-bugzilla

• MantisBT : reporter-mantisbt

• FAF : reporter-ureport

• Linux Kernel Oops : reporter-kerneloops

Installing

Please see INSTALL for build and install steps.

Technologies

• satyr - backtrace processing, micro-reports
• ABRT - main libreport consumer
• Python3
• GLib2
• Gtk3
• XML RPC for C and C++
• json-c