sysmo-bts
/
generic-poky
9
0
Fork 0
Code Pull Requests Releases Activity

dev-manual: Added new GDB debug requirements section for target 

Fixes [YOCTO #9554]

I added a new section titled "Debugging with the GNU Project
Debugger (GDB) on the Target" that provides requirements for
this type of debugging.

(From yocto-docs rev: 5d15c6c5f2030395f9faea8a5ef3ead1b98042d8)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark 2016-09-22 15:16:07 -07:00 committed by Richard Purdie
parent 924966f634
commit 9f2cf76e09
1 changed files with 43 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

43
documentation/dev-manual/dev-manual-common-tasks.xml
View File

@ -9870,6 +9870,49 @@
</section>
</section>
<section id='debugging-with-the-gnu-project-debugger-gdb-on-the-target'>
<title>Debugging with the GNU Project Debugger (GDB) on the Target</title>
<para>
The previous section addressed using GDB remotely for debugging
purposes.
This section describes what you need to do in order to support
using GDB to debug on the target hardware.
</para>
<para>
To support this kind of debugging, you need do the following:
<itemizedlist>
<listitem><para>
Ensure that GDB is on the target.
You can do this by adding "gdb" to
<ulink url='&YOCTO_DOCS_REF_URL;#var-IMAGE_INSTALL'><filename>IMAGE_INSTALL</filename></ulink>:
<literallayout class='monospaced'>
IMAGE_INSTALL_append = " gdb"
</literallayout>
Alternatively, you can add "tools-debug" to
<ulink url='&YOCTO_DOCS_REF_URL;#var-IMAGE_FEATURES'><filename>IMAGE_FEATURES</filename></ulink>:
<literallayout class='monospaced'>
IMAGE_FEATURES = tools-debug
</literallayout>
</para></listitem>
<listitem><para>
Ensure that debug symbols are present.
You can make sure these symbols are present by installing
<filename>-dbg</filename>:
<literallayout class='monospaced'>
IMAGE_INSTALL_append = " <replaceable>packagename</replaceable>-dbg"
</literallayout>
Alternatively, you can do the following to include all the
debug symbols:
<literallayout class='monospaced'>
IMAGE_FEATURES = dbg-pkgs
</literallayout>
</para></listitem>
</itemizedlist>
</para>
</section>
<section id='debugging-parallel-make-races'>
<title>Debugging Parallel Make Races</title>