diff options
Diffstat (limited to 'documentation/dev-manual/dev-manual-common-tasks.xml')
-rw-r--r-- | documentation/dev-manual/dev-manual-common-tasks.xml | 43 |
1 files changed, 43 insertions, 0 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml index 3d63f80553..b20d9c32f3 100644 --- a/documentation/dev-manual/dev-manual-common-tasks.xml +++ b/documentation/dev-manual/dev-manual-common-tasks.xml | |||
@@ -9870,6 +9870,49 @@ | |||
9870 | </section> | 9870 | </section> |
9871 | </section> | 9871 | </section> |
9872 | 9872 | ||
9873 | <section id='debugging-with-the-gnu-project-debugger-gdb-on-the-target'> | ||
9874 | <title>Debugging with the GNU Project Debugger (GDB) on the Target</title> | ||
9875 | |||
9876 | <para> | ||
9877 | The previous section addressed using GDB remotely for debugging | ||
9878 | purposes. | ||
9879 | This section describes what you need to do in order to support | ||
9880 | using GDB to debug on the target hardware. | ||
9881 | </para> | ||
9882 | |||
9883 | <para> | ||
9884 | To support this kind of debugging, you need do the following: | ||
9885 | <itemizedlist> | ||
9886 | <listitem><para> | ||
9887 | Ensure that GDB is on the target. | ||
9888 | You can do this by adding "gdb" to | ||
9889 | <ulink url='&YOCTO_DOCS_REF_URL;#var-IMAGE_INSTALL'><filename>IMAGE_INSTALL</filename></ulink>: | ||
9890 | <literallayout class='monospaced'> | ||
9891 | IMAGE_INSTALL_append = " gdb" | ||
9892 | </literallayout> | ||
9893 | Alternatively, you can add "tools-debug" to | ||
9894 | <ulink url='&YOCTO_DOCS_REF_URL;#var-IMAGE_FEATURES'><filename>IMAGE_FEATURES</filename></ulink>: | ||
9895 | <literallayout class='monospaced'> | ||
9896 | IMAGE_FEATURES = tools-debug | ||
9897 | </literallayout> | ||
9898 | </para></listitem> | ||
9899 | <listitem><para> | ||
9900 | Ensure that debug symbols are present. | ||
9901 | You can make sure these symbols are present by installing | ||
9902 | <filename>-dbg</filename>: | ||
9903 | <literallayout class='monospaced'> | ||
9904 | IMAGE_INSTALL_append = " <replaceable>packagename</replaceable>-dbg" | ||
9905 | </literallayout> | ||
9906 | Alternatively, you can do the following to include all the | ||
9907 | debug symbols: | ||
9908 | <literallayout class='monospaced'> | ||
9909 | IMAGE_FEATURES = dbg-pkgs | ||
9910 | </literallayout> | ||
9911 | </para></listitem> | ||
9912 | </itemizedlist> | ||
9913 | </para> | ||
9914 | </section> | ||
9915 | |||
9873 | <section id='debugging-parallel-make-races'> | 9916 | <section id='debugging-parallel-make-races'> |
9874 | <title>Debugging Parallel Make Races</title> | 9917 | <title>Debugging Parallel Make Races</title> |
9875 | 9918 | ||