apport-cli, apport-gtk, apport-kde - Apport user interfaces for reporting problems
apport-cli [ --save file ] symptom | pid | package | program path | .apport/.crash file
apport-cli -f -p package -P pid
apport-cli -u report-number
Same options/arguments for apport-gtk and apport-kde.
apport automatically collects data from crashed processes and compiles a problem report in
/var/crash/. This is a command line frontend for reporting those crashes to the develop-
ers. It can also be used to report bugs about packages or running processes.
If symptom scripts are available, it can also be given the name of a symptom, or be called
with just -f to display a list of known symptoms.
When being called without any options, it processes the pending crash reports and offers
to report them one by one. You can also display the entire report to see what is sent to
the software developers.
When being called with exactly one argument and no option, apport-cli uses some heuristics
to find out "what you mean" and reports a bug against the given symptom name, package
name, program path, or PID. If the argument is a .crash or .apport file, it uploads the
stored problem report to the bug tracking system.
For desktop systems with a graphical user interface, you should consider installing the
GTK or KDE user interface (apport-gtk or apport-kde). They accept the very same options
and arguments. apport-cli is mainly intended to be used on servers.
Report a (non-crash) problem. If neither --package, --symptom, or --pid are speci-
fied, then it displays a list of available symptoms. If none are available, it
aborts with an error.
This will automatically attach information about your operating system and the
package version etc. to the bug report, so that the developers have some important
-s symptom, --symptom=symptom
When being used in --file-bug mode, specify the symptom to report the problem
-p package, --package=package
When being used in --file-bug mode, specify the package to report the problem
-P pid, --pid=pid
When being used in --file-bug mode, specify the PID (process ID) of a running pro-
gram to report the problem against. This can be determined with e. g. ps -ux.
-c report, --crash-file=report
Upload a previously processed stored report in an arbitrary file location. This is
useful for copying a crash report to a machine with internet connection and report-
ing it from there. Files must end in .crash or .apport.
-u report-number, --update-report report-number
Run apport information collection on an already existing problem report. The
affected package is taken from the report by default, but you can explicitly spec-
ify one with --package to collect information for a different package (this is use-
ful if the report is assigned to the wrong package).
In --file-bug mode, save the collected information into a file instead of reporting
it. This file can then be reported with --crash-file later on.
Point and click at the application window against which you wish to report the bug.
Apport will automatically find the package name and generate a report for you. This
option can be specially useful in situations when you do not know the name of the
package, or if the application window has stopped responding and you cannot report
the problem from the "Help" menu of the application.
Apport refuses to create bug reports if the package or any dependency is not cur-
rent. If this environment variable is set, this check is waived. Experts who will
thoroughly check the situation before filing a bug report can define this in their
~/.bashrc or temporarily when calling the apport frontend (-cli, -gtk, or -kde).
Symptom scripts. These ask a set of interactive questions to determine the package
which is responsible for a particular problem. (For some problems like sound or
storage device related bugs there are many places where things can go wrong, and
it's not immediately obvious for a bug reporter where the problem is.)
apport and the accompanying tools are developed by Martin Pitt <firstname.lastname@example.org>.
Martin Pitt August 01, 2007 apport-cli(1)