Einen Stack Trace bereitstellen

Ein Stack Trace (manchmal auch Backtrace genannt) ist eine Liste von Funktionsaufrufen, die zu einem bestimmten Punkt im Programm führt. Debugging-Werkzeuge wie gdb oder bugbuddy können Stack Traces von abgestürzten Anwendungen erfassen, sodass Entwickler die Fehlerursache ermitteln können.

Ein typischer Stack Trace sieht in etwa wie folgt aus:

Ein besserer Backtrace mit Debuginfo-Symbolen (siehe unten) sieht folgendermaßen aus:

Beachten Sie die Dateinamen und Zeilennummern der Stellen, an denen die Funktionen aufgerufen werden.

Wird ein Programm mit speziellen Optionen zur Erzeugung von Debug-Symbolen (Compiler-Option -g) kompiliert, werden zusätzliche Informationen in der Programmdatei gespeichert. Mithilfe dieser Informationen lässt sich ein Stack Trace generieren, der deutlich mehr Informationen enthält, beispielsweise die genaue Zeilennummer der Quelldatei, in der der Fehler aufgetreten ist. Ohne diese Informationen ist es sehr schwierig, die Fehlerursache allein anhand des Stack Traces zu ermitteln.

Fedora enthält spezielle RPM-Pakete, sogenannte Debuginfo-RPMs. Diese automatisch erstellten RPMs enthalten die Debugging-Informationen der Programmdateien, die in einer externen Datei gespeichert sind. Alle Werkzeuge, die Debugging-Informationen verarbeiten, können diese Dateien automatisch durchsuchen. So lassen sich Debugging-Informationen bei Bedarf einfach installieren. Sie müssen die exakt passende Version und Architektur von Debuginfo für die zu debuggende Anwendung installieren.

Beispiel: Überprüfung der Übereinstimmung von Version und Architektur

Jedes Paket mit Binärdateien in der Distribution verfügt über ein entsprechendes debuginfo-Paket.

Stellen Sie zunächst sicher, dass Sie die Debuginfo-Pakete für die zu debuggende Anwendung sowie alle zugehörigen Bibliotheken installiert haben. Entwickler empfehlen häufig die Installation bestimmter Debuginfo-Pakete, da sie anhand eines Stack Traces erkennen können, welche Bibliotheken am Absturz beteiligt sind. Nachfolgend finden Sie empfohlene Pakete für einige gängige Anwendungstypen.

Es gibt mehrere Möglichkeiten, einen Stack Trace zu erhalten:

Sie müssen zumindest das Debuginfo-Paket für die abstürzende Anwendung installieren. Sie können herausfinden, in welchem Paket sich diese Anwendung befindet, indem Sie rpm -qf Pfad-zum-Programm eingeben.

Für bestimmte Programmtypen ist es außerdem sehr nützlich, einige Standardpakete zu installieren, die für nahezu alle Stack Traces hilfreich sind:

Führen Sie zunächst folgenden Befehl aus, um gdb zu starten:

Hierbei ist der „Programmname“ der Name des Programms, das abgestürzt ist (zum Beispiel: /usr/bin/gnome-panel).

Geben Sie anschließend an der gdb-Eingabeaufforderung Folgendes ein:

Falls Sie dem Programm Argumente übergeben müssen, geben Sie diese nach dem Befehl „run“ an, zum Beispiel:

Sobald das Programm läuft, reproduzieren Sie den Absturz und kehren Sie zum Terminal zurück, in dem Sie gdb ausgeführt haben. Die gdb-Eingabeaufforderung sollte angezeigt werden – falls nicht, drücken Sie Strg+C, um den Debugger zu starten. Geben Sie an der gdb-Debugger-Eingabeaufforderung Folgendes ein:

Falls das nicht funktioniert (d.h., Sie erhalten keine Ausgabe – dies kann bei Programmen der Fall sein, die nicht multithreadfähig sind), geben Sie stattdessen <code>bt</code> ein. Sollten Sie weiterhin keine Ausgabe erhalten, lesen Sie bitte [[#special| diesen Hinweis]] zum Abrufen eines Stack Traces unter speziellen Umständen. Die Ausgabe ist der Stack Trace. Kopieren Sie diesen vollständig in eine Textdatei.

Sie können gdb beenden, indem Sie quit eingeben.

Manchmal kann der Stack Trace recht umfangreich sein und sich nur schwer kopieren und einfügen lassen. In solchen Fällen ist es praktisch, den Stack Trace in einer Datei zu speichern:

Wenn das abstürzende Programm einen Core Dump erzeugt, können Sie mit GDB einen Stack Trace erstellen. Core Dumps werden in einer Datei auf Ihrer Festplatte gespeichert und tragen üblicherweise Namen wie „core“ oder „core.3124“. Um einen Stack Trace aus einer dieser Dateien zu erhalten, führen Sie folgenden Befehl aus:

Dabei ist Programmname der Name des abgestürzten Programms (zum Beispiel /usr/bin/gnome-panel) und Name-des-Core-Dumps der Name der Core-Datei, die den Core-Dump enthält (zum Beispiel core.7812).

Geben Sie anschließend an der gdb-Eingabeaufforderung Folgendes ein:

If that does not work (meaning that you don’t get any output—​this may be the case in programs which are not multi-threaded), type bt instead. If you still do not have any output, read this note about obtaining a stack trace under special circumstances. The output is the stack trace. Cut and paste all of it into a text file.

Sie können gdb beenden, indem Sie quit eingeben.

Beachten Sie, dass die Erstellung von Core-Dateien in Fedora standardmäßig deaktiviert ist (in /etc/profile). Um sie für eine Shell-Sitzung zu aktivieren, geben Sie an der Shell-Eingabeaufforderung Folgendes ein:

Wenn Sie Fedora über ein Live-CD-Abbild installiert haben, sollte ABRT bereits installiert sein. Sie können es unter „Anwendungen → System → Automatisches Fehlerberichtswerkzeug“ starten. Falls ABRT aus irgendeinem Grund nicht installiert ist, können Sie es manuell über die Befehlszeile installieren:

or go to System → Administration → Add/Remove Software in Gnome, and type`abrt` in the search box and select Find. Select the abrt package and apply the changes.

Go to Application → System Tools → Automated Bug Reporting Tool and select it to start it manually. Once the GUI window appears, choose Edit → Plugins and from the Settings window, scroll down, highlight Bugzilla and choose Configure Plugin. The Bugzilla URL should be https://bugzilla.redhat.com and enter your own Bugzilla login and password in the proper boxes.

Wenn Ihr Programm das nächste Mal abstürzt und ABRT ausgelöst wird, kann ABRT sich nach dem Klicken auf „Bericht“ automatisch bei Bugzilla anmelden und einen Fehlerbericht für Sie einreichen.

(Im Folgenden wird Gnome als Desktop-Umgebung vorausgesetzt …​ für KDE/andere Desktop-Umgebungen muss es jemand anderes ergänzen.)

Wenn ABRT einen Programmabsturz erkennt, erhalten Sie eine ABRT-Warnung. Diese wird durch ein blinkendes rotes Licht in der Taskleiste angezeigt. Klicken Sie mit der linken Maustaste auf das Warnlicht. Daraufhin startet das automatische Fehlerberichtswerkzeug und zeigt alle registrierten Abstürze an. Um einen Fehler zu melden, klicken Sie mit der rechten Maustaste darauf und wählen Sie „Melden“. ABRT sammelt die benötigten Protokolle für die Fehlermeldung und benachrichtigt Sie anschließend, dass ein Fehlerbericht erstellt wird. Wenn Sie ABRT wie im vorherigen Abschnitt konfiguriert haben, werden Sie gefragt, ob die verschiedenen Protokolle beigefügt werden sollen. Anschließend wird automatisch ein Fehlerbericht in Bugzilla erstellt und die Protokolle werden an den Bericht angehängt. Die Bug-Nummer wird Ihnen angezeigt, sodass Sie den Bearbeitungsstatus des Fehlers verfolgen können.

Wenn Sie in ABRT mit der rechten Maustaste auf einen Fehler klicken und „Bericht“ auswählen, versucht ABRT, die benötigten Protokolle für den Fehlerbericht abzurufen. Die Entwickler haben Code hinzugefügt, der erkennt, ob symbolische Traces im Backtrace enthalten sind. Falls keine vorhanden sind, erhalten Sie von ABRT eine entsprechende Benachrichtigung und den auszuführenden Befehl. Dies entspricht den Informationen im Abschnitt debuginfo.

Wenn Sie nach Eingabe von thread apply all bt oder bt keine Ausgabe von gdb erhalten, liegt das möglicherweise daran, dass das Programm als Root oder ein anderer Benutzer ausgeführt wird. Unter GNOME ist dies beispielsweise beim Ausführen von gnome-games der Fall. In solchen Fällen benötigen Sie Root-Rechte, um einen Stacktrace zu erfassen. Beenden Sie daher gdb, melden Sie sich als Root an und wiederholen Sie die Schritte, um einen Stacktrace zu erhalten.