[gnome-boxes.wiki] Create debugging



commit 6da6d423cfc4e2ef3c4c51c852c458e0f798e355
Author: Felipe Borges <felipeborges gnome org>
Date:   Wed Jul 3 08:24:05 2019 +0000

    Create debugging

 Debugging-Crashes.md | 62 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 62 insertions(+)
---
diff --git a/Debugging-Crashes.md b/Debugging-Crashes.md
new file mode 100644
index 0000000..654dedf
--- /dev/null
+++ b/Debugging-Crashes.md
@@ -0,0 +1,62 @@
+We support two building methods, classic and Flatpak. To debug against the host/system libraries. The 
Flatpak debugging tips are at the end of this page.
+
+# 1. Debugging a local install
+
+## 1.1 Install debug symbols
+
+In Fedora/RHEL/CentOS, run:
+
+`$ sudo dnf debuginfo-install gnome-boxes`
+
+## 1.2 Install gdb
+
+In Fedora/RHEL/CentOS, run:
+
+`$ sudo dnf install gdb`
+
+## 1.3 Run Boxes with gdb
+
+$ gdb gnome-boxes
+
+On the gdb console, type "run" and press ENTER.
+
+## 1.4 Reproduce the crash
+
+Now Boxes should be opened, and you should proceed to perform the same action that caused your crash.
+
+Once Boxes crashes, get back to the terminal with the gdb console and type:
+
+`bt all`
+
+## 1.5 Sharing your backtrace
+
+Copy everything printed on your terminal since you opened gdb, and paste in a text file. Attach your file to 
the GitLab issue where your crash is being reported.
+
+# 2. Flatpak
+
+## 2.1 Install the debug symbols
+
+```
+flatpak install flathub org.gnome.Boxes.Debug
+flatpak install flathub org.gnome.Platform.Debug
+```
+
+## 2.2 Open a shell inside the Flatpak container
+
+`flatpak --devel --command=bash run org.gnome.Boxes`
+
+## 2.3 Run Boxes with gdb
+
+`gdb /app/bin/gnome-boxes`
+
+## 2.4 Reproduce the crash
+
+Now Boxes should be opened, and you should proceed to perform the same action that caused your crash.
+
+Once Boxes crashes, get back to the terminal with the gdb console and type:
+
+`bt all`
+
+## 2.5 Sharing your backtrace
+
+Copy everything printed on your terminal since you opened gdb, and paste in a text file. Attach your file to 
the GitLab issue where your crash is being reported.


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]