[gnome-boxes.wiki] Update Debugging Crashes page
- From: Felipe Borges <felipeborges src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gnome-boxes.wiki] Update Debugging Crashes page
- Date: Tue, 30 Nov 2021 11:03:37 +0000 (UTC)
commit 3a21604ab947ab375d748024ef8c497f03a24d06
Author: Felipe Borges <felipeborges gnome org>
Date: Tue Nov 30 11:03:35 2021 +0000
Update Debugging Crashes page
Debugging-Crashes.md | 63 ++++++++++++++++++++++------------------------------
1 file changed, 26 insertions(+), 37 deletions(-)
---
diff --git a/Debugging-Crashes.md b/Debugging-Crashes.md
index 481b86e..c64b3d3 100644
--- a/Debugging-Crashes.md
+++ b/Debugging-Crashes.md
@@ -1,26 +1,24 @@
We support two building methods, classic and Flatpak.
-# 1. Debugging a local install
+# Debugging a local install (classic)
-## 1.1 Install debug symbols
+Install the [debug symbol packages for your
distribution](https://wiki.gnome.org/GettingInTouch/Bugzilla/GettingTraces).
-In Fedora/RHEL/CentOS, run:
+ * Run Boxes with gdb with `gdb gnome-boxes`
+ * On the gdb console, enter `run`.
-`$ sudo dnf debuginfo-install gnome-boxes`
+# Flatpak
-## 1.2 Install gdb
+ * Install the debug symbols
-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.
+```
+flatpak install flathub org.gnome.Boxes.Debug
+flatpak install flathub org.gnome.Platform.Debug
+```
+ * Open a shell session inside the Flatpak container with `flatpak --devel --command=bash run
org.gnome.Boxes`
+ * Run Boxes with gdb with `gdb /app/bin/gnome-boxes`
-## 1.4 Reproduce the crash
+# Reproduce the crash
Now Boxes should be opened, and you should proceed to perform the same action that caused your crash.
@@ -28,35 +26,26 @@ Once Boxes crashes, get back to the terminal with the gdb console and type:
`bt all`
-## 1.5 Sharing your backtrace
+## 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
+# Activating debug messages
-## 2.1 Install the debug symbols
+To run Boxes with debug message output on the console, just run:
-```
-flatpak install flathub org.gnome.Boxes.Debug
-flatpak install flathub org.gnome.Platform.Debug
+```bash
+G_MESSAGES_DEBUG=Boxes gnome-boxes
```
-## 2.2 Open a shell inside the Flatpak container
+In Flatpak, run:
-`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`
+```bash
+flatpak run --env=G_MESSAGES_DEBUG=Boxes org.gnome.Boxes
+```
-## 2.5 Sharing your backtrace
+In jhbuild, run:
-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.
+```bash
+G_MESSAGES_DEBUG=Boxes jhbuild run GNOME-boxes
+```
\ No newline at end of file
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]