Debugging Central

This page is part of the debugging series — pages with debugging details for a variety of Ubuntu packages.


This debugging article applies to all GNOME applications.

General debugging procedure

Capturing a manual stacktrace of a crash for upstream

If a GNOME application crash is reproducible in the latest version of the application available in a Ubuntu repository, then one is welcome to file a report upstream. However, it is required to generate a stacktrace manually when filing an upstream report, irrespective of if you have filed a crash report on Launchpad, or on This is due to how upstream may not have permissions to access a private crash report (or a Launchpad account to add them to it), test to the issue in the release you are using, or test the version of the application the crash is reproducible in. Hence, please ensure you have attached a stacktrace with full debug symbols.

Enabling making an application crash on critical warnings

In Ubuntu we have disabled the feature that makes applications crash on critical warnings. To debug problems it's sometimes good to have this happen.

This will make it crash:

G_DEBUG=fatal_criticals <program>

If you run the program under gdb or valgrind, it will help you figure out what led to the critical warning.

This will make a program stop on warnings:

<program> --g-fatal-warnings

Debugging Menus

If you should ever have to debug GNOME menus, you might want to use this:

MENU_VERBOSE=1 <program>

Debugging specific GNOME applications

See also

CategoryBugSquad CategoryDesktopTeam CategoryDebugging