Editing Documentation/devtools/maemo5/maemo-debug-scripts

Warning: You are not logged in. Your IP address will be recorded in this page's edit history.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Learn more about Contributing to the wiki.

== Description ==

''maemo-debug-scripts'' is a convenience package for maemo developers needing to debug their programs. The package will:

* Post-install a symlink required by Gdb/Valgrind/Oprofile to find the debug symbol files in Scratchbox.  The files are installed in ''/usr/lib/debug/&lt;library path&gt;'', but in Scratchbox the library realpaths are ''/targets/&lt;target name&gt;/&lt;library path&gt;''.

* Depend from libc6-dbg.  Without libc6-dbg threads cannot be debugged with Gdb and Valgrind reports redundant errors for the dynamic loader (its error suppressions for /lib/ld functions can match them only with the debug symbol file as stripped binary doesn't contain static function names)

* Depend from target native Gdb.  The Scratchbox host version of Gdb (cross-gdb) doesn't know how to load the correct thread library (even on x86) and it cannot debug ARM core-dumps. Native one can.

* Install a few helper scripts:
** ''native-gdb''
::runs the target native Gdb (by default Scratchbox runs the host binary if it exists, this script overrides that)
** ''debug-dep-install''
::installs debug symbols for given binaries and their dependencies listed by "ldd"
** ''debug-pkg-check''
::checks the correctness of a debug package for a given package
** ''list-mmapped-libs''
::lists all packages containing libs and binaries that given process uses. It can be used to find out the libraries mmap()ed through dlopen that "ldd" (used by debug-deb-install script) doesn't find
** ''run-with-valgrind''
::helper script for running a binary with Valgrind memcheck plugin (memory access errors, leaks etc) so that all suitable options are set for it
** ''run-with-callgrind''
::helper script for running a binary with Valgrind callgrind plugin (performance profiling) so that all suitable options are set for it
** ''run-with-massif''
::helper script for running a binary with Valgrind massif plugin (memory usage visualization) so that all suitable options are set for it
** ''run-with-helgrind''
::helper script for running a binary with Valgrind helgrind plugin (race condition detector for threaded programs) so that all suitable options are set
** ''run-with-strace''
::helper script for running a binary with strace. Like above helper scripts, handles maemo-launched binaries automatically

== Packages ==

'''source''': maemo-debug-scripts

'''binary''': maemo-debug-scripts

== Usage Examples ==

== Links ==

[debug-dep-install man page](/development/documentation/man_pages/debug-dep-install.html)

[debug-pkg-check man page](/development/documentation/man_pages/debug-pkg-check.html)

[list-mmapped-libs man page](/development/documentation/man_pages/list-mmapped-libs.html)

[native-gdb man page](/development/documentation/man_pages/native-gdb.html)

[run-with-callgrind man page](/development/documentation/man_pages/run-with-callgrind.html)

[run-with-massif man page](/development/documentation/man_pages/run-with-massif.html)

[run-with-memcheck man page](/development/documentation/man_pages/run-with-memcheck.html)

[run-with-helgrind man page](/development/documentation/man_pages/run-with-helgrind.html)

[run-with-strace man page](/development/documentation/man_pages/run-with-strace.html)

== See Also ==

[[Documentation/devtools/maemo5/gdb|gdb]], [[Documentation/devtools/maemo5/valgrind|valgrind]], [[Documentation/devtools/maemo5/strace|strace]]

[[Category:Fremantle]]

Please note that all contributions to maemo.org wiki may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see maemo.org wiki:Copyrights for details). Do not submit copyrighted work without permission!

Summary:

Cancel | Editing help (opens in new window)

Templates used on this page:

Template:Ambox (view source) (semi-protected)
Template:Devtools (edit)

Retrieved from "http://wiki.maemo.org/Documentation/devtools/maemo5/maemo-debug-scripts"

Personal tools

Navigation

Views

Editing Documentation/devtools/maemo5/maemo-debug-scripts

@@ Line 13: / Line 13: @@
 * Install a few helper scripts:
-::''native-gdb''
+** ''native-gdb''
 ::runs the target native Gdb (by default Scratchbox runs the host binary if it exists, this script overrides that)
-::''debug-dep-install''
+** ''debug-dep-install''
 ::installs debug symbols for given binaries and their dependencies listed by "ldd"
-::''debug-pkg-check''
+** ''debug-pkg-check''
 ::checks the correctness of a debug package for a given package
-::''list-mmapped-libs''
+** ''list-mmapped-libs''
 ::lists all packages containing libs and binaries that given process uses. It can be used to find out the libraries mmap()ed through dlopen that "ldd" (used by debug-deb-install script) doesn't find
-::''run-with-valgrind''
+** ''run-with-valgrind''
 ::helper script for running a binary with Valgrind memcheck plugin (memory access errors, leaks etc) so that all suitable options are set for it
-::''run-with-callgrind''
+** ''run-with-callgrind''
 ::helper script for running a binary with Valgrind callgrind plugin (performance profiling) so that all suitable options are set for it
-::''run-with-massif''
+** ''run-with-massif''
 ::helper script for running a binary with Valgrind massif plugin (memory usage visualization) so that all suitable options are set for it
-::''run-with-helgrind''
+** ''run-with-helgrind''
 ::helper script for running a binary with Valgrind helgrind plugin (race condition detector for threaded programs) so that all suitable options are set
-::''run-with-strace''
+** ''run-with-strace''
 ::helper script for running a binary with strace. Like above helper scripts, handles maemo-launched binaries automatically