Factor out `hurd/debugging/gdb' and create `hurd/debugging/rpctrace'.

1 files changed, 23 insertions, 0 deletions

diff --git a/hurd/debugging/gdb/noninvasive_debugging.mdwn b/hurd/debugging/gdb/noninvasive_debugging.mdwn
new file mode 100644
index 00000000..fc6653e7
--- /dev/null
+++ b/hurd/debugging/gdb/noninvasive_debugging.mdwn
@@ -0,0 +1,23 @@
+[[license text="""
+Copyright © 2007 Free Software Foundation, Inc.
+
+Permission is granted to copy, distribute and/or modify this document under the
+terms of the GNU Free Documentation License, Version 1.2 or any later version
+published by the Free Software Foundation; with no Invariant Sections, no
+Front-Cover Texts, and no Back-Cover Texts.  A copy of the license is included
+in the section entitled [[GNU_Free_Documentation_License|/fdl.txt]].
+
+By contributing to this page, you agree to assign copyright for your
+contribution to the Free Software Foundation.  The Free Software Foundation
+promises to always use either a verbatim copying license or a free
+documentation license when publishing your contribution.  We grant you back all
+your rights under copyright, including the rights to copy, modify, and
+redistribute your contributions.
+"""]]
+
+Sometimes using [[GDB]] on a system server can result in a [[deadlock]].  You
+can however still use GDB by using the [`set
+noninvasive`](http://sourceware.org/gdb/current/onlinedocs/gdb_19.html#Hurd%20Native)
+option.  This indicates to GDB to not stop the program but allows you to
+nevertheless examine its state.  Thus, you can get back traces and value of
+variables (and watch them change underneath you).