aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorOrestis Floros <orestisflo@gmail.com>2023-07-15 00:08:34 +0200
committerMichael Stapelberg <stapelberg@users.noreply.github.com>2023-07-15 21:27:11 +0200
commitcf2ea348c73a97a7b757b1c95c42487b4a2997cf (patch)
treee17c17378757e6bb1c72f17c5456f85681e4c505
parente6b41172da01225747f4551d95d4eac64befb4fa (diff)
downloadi3-cf2ea348c73a97a7b757b1c95c42487b4a2997cf.tar.gz
i3-cf2ea348c73a97a7b757b1c95c42487b4a2997cf.zip
debugging docs: Add note about ptrace
Also remove outdated section about IRC
-rw-r--r--docs/debugging17
1 files changed, 9 insertions, 8 deletions
diff --git a/docs/debugging b/docs/debugging
index 562a11f2..cfc260cc 100644
--- a/docs/debugging
+++ b/docs/debugging
@@ -147,16 +147,17 @@ After pressing "b" in the crash dialog, you will get a file called
id (PID) and the second one is incremented each time you generate a backtrace,
starting at 0.
-== Sending bug reports/debugging on IRC
+In Linux, if the backtrace just says +No stack.+, that's because gdb does not
+have necessary permissions to attach to a running process. You can fix that by
+running from a terminal (you can open a new tty, e.g. with ctrl-alt-F2):
-When sending bug reports, please attach the *whole* log file. Even if you think
-you found the section which clearly highlights the problem, additional
-information might be necessary to completely diagnose the problem.
+---------------------------------------------------------------------
+echo 0 | sudo tee /proc/sys/kernel/yama/ptrace_scope
+---------------------------------------------------------------------
-When debugging with us in IRC, be prepared to use a so-called nopaste service
-such as https://pastebin.com because pasting large amounts of text in IRC
-sometimes leads to incomplete lines (servers have line length limitations) or
-flood kicks.
+Afterwards, try re-generating the stack trace. Note that this setting re-sets
+after reboot, see more info at
+https://www.kernel.org/doc/Documentation/security/Yama.txt.
== Debugging i3bar