diff options
| author |   Scott Rifenbark <srifenbark@gmail.com> | 2016-09-23 09:18:24 -0700 |
|---|---|---|
| committer |   Richard Purdie <richard.purdie@linuxfoundation.org> | 2016-09-28 15:02:33 +0100 |
| commit | 99b9efb9930b37863ceee073a479ea62e4c4ff73 (patch) | |
| tree | de9dee42bfb3db050dc8452d0a03eb66d5fb137f | |
| parent | e7e61507db67acdc0b24d7c554bb2b4b28e243f9 (diff) | |
| download | openembedded-core-contrib-99b9efb9930b37863ceee073a479ea62e4c4ff73.tar.gz | |
dev-manual: Updates to the on-target debugging section.
Fixes [YOCTO #9554]
I applied some review comments for the section on using GDB
on the target for debugging. Included a new note on optimizations
considerations.
(From yocto-docs rev: 23f0dd82f682ea39849de0f589ee1ebfb16be749)
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
| -rw-r--r-- | documentation/dev-manual/dev-manual-common-tasks.xml | 21 |
1 files changed, 20 insertions, 1 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml index b20d9c32f3..4cdd805cec 100644 --- a/documentation/dev-manual/dev-manual-common-tasks.xml +++ b/documentation/dev-manual/dev-manual-common-tasks.xml @@ -9875,7 +9875,10 @@ <para> The previous section addressed using GDB remotely for debugging - purposes. + purposes, which is the most usual case due to the inherent + hardware limitations on many embedded devices. + However, debugging in the target hardware itself is also possible + with the most powerful devices. This section describes what you need to do in order to support using GDB to debug on the target hardware. </para> @@ -9910,6 +9913,22 @@ </literallayout> </para></listitem> </itemizedlist> + <note> + To improve the debug information accuracy, you can reduce the + level of optimization used by the compiler. + For example, when adding the following line to your + <filename>local.conf</filename> file, you will reduce + optimization from + <ulink url='&YOCTO_DOCS_REF_URL;#var-FULL_OPTIMIZATION'><filename>FULL_OPTIMIZATION</filename></ulink> + of "-O2" to + <ulink url='&YOCTO_DOCS_REF_URL;#var-DEBUG_OPTIMIZATION'><filename>DEBUG_OPTIMIZATION</filename></ulink> + of "-O -fno-omit-frame-pointer": + <literallayout class='monospaced'> + DEBUG_BUILD = "1" + </literallayout> + Consider that this will reduce the application's performance + and is recommended only for debugging purposes. + </note> </para> </section> |