From: Michael Stapelberg Date: Sat, 4 Jan 2014 11:04:43 +0000 (+0100) Subject: docs/debugging: merge the debug symbols/backtrace section X-Git-Tag: 4.7.1~4^2~2 X-Git-Url: https://git.sur5r.net/?p=i3%2Fi3;a=commitdiff_plain;h=92a50db29e9a842113502067f0eb7746281952cb docs/debugging: merge the debug symbols/backtrace section We rarely have crashes, almost always we just need logs. --- diff --git a/docs/debugging b/docs/debugging index 4b7bd371..88948c50 100644 --- a/docs/debugging +++ b/docs/debugging @@ -81,7 +81,10 @@ DISPLAY=:0 i3-dump-log | bzip2 -c > /tmp/i3.log.bz2 This command does not depend on i3 (it also works while i3 displays the crash dialog), but it requires a working X11 connection. -== Compiling with debug symbols +== On crashes: Obtaining a backtrace + +When i3 crashes, it will display a dialog stating “i3 just crashed”, offering +you to save a backtrace to a text file. To actually get useful backtraces, you should make sure that your version of i3 is compiled with debug symbols: @@ -97,8 +100,6 @@ which is stripped, please check whether your distribution provides debug symbols (package +i3-wm-dbg+ on Debian for example) or if you can turn off stripping. If nothing helps, please build i3 from source. -== Obtaining a backtrace - Once you have made sure that your i3 is compiled with debug symbols and the C debugger +gdb+ is installed on your machine, you can let i3 generate a backtrace in the crash dialog.