Merge remote-tracking branch 'savannah/master'
[hurd-web.git] / faq / dev / debugging_translators.mdwn
diff --git a/faq/dev/debugging_translators.mdwn b/faq/dev/debugging_translators.mdwn
new file mode 100644 (file)
index 0000000..a054f2e
--- /dev/null
@@ -0,0 +1,20 @@
+[[!meta copyright="Copyright © 2007, 2008, 2013 Free Software Foundation,
+Inc."]]
+
+[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable
+id="license" text="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]]."]]"""]]
+
+In order to [[debug|debugging]] translators and being able to step into glibc
+during it, on Debian you need the `hurd-dbg` and `libc0.3-dbg` packages installed.
+If you need to debug the initialization of the translator, start the translator
+like
+
+    $ settrans -P /foo /usr/bin/env LD_LIBRARY_PATH=/usr/lib/debug /hurd/foofs
+
+The `-P` option will make it
+pause and you will be able to attach [[debugging/GDB]] to the process.