diff options
author | Scott Rifenbark <srifenbark@gmail.com> | 2018-10-25 15:17:23 -0700 |
---|---|---|
committer | Scott Rifenbark <srifenbark@gmail.com> | 2018-10-25 15:17:23 -0700 |
commit | 83bd353da3cebb7cd8d31f9a6f79ee9b7f90b82f (patch) | |
tree | 08efc7178cb67f2309489461d30dd551aba46f31 /docs/getting-started/app-workflow-debug-app.md | |
parent | 0eba225fb27ec0b87bfa80361314fec5ab901caa (diff) |
Application Development Workflow Content files
I have added new files for content for the "Application Development
Workflow" section that is temporarily in the "Getting Started"
section of the doc website.
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Diffstat (limited to 'docs/getting-started/app-workflow-debug-app.md')
-rw-r--r-- | docs/getting-started/app-workflow-debug-app.md | 48 |
1 files changed, 48 insertions, 0 deletions
diff --git a/docs/getting-started/app-workflow-debug-app.md b/docs/getting-started/app-workflow-debug-app.md new file mode 100644 index 0000000..6b6687c --- /dev/null +++ b/docs/getting-started/app-workflow-debug-app.md @@ -0,0 +1,48 @@ +# Debug the Application # + +You can debug your application many ways. +The method depends on factors such as the component you are debugging, +whether or not you are doing a post-mortem analysis, your debugging +skills and productivity (i.e. do you know how to use the +[GNU Project Debugger](https://www.gnu.org/software/gdb/) (`gdb`) from a +console or is it better for you to use a remote UI that is integrated +with an IDE?). + +For general information on debugging an application, see the +"[Debug your first AGL application](http://docs.automotivelinux.org/docs/devguides/en/dev/reference/xds/part-1/5_debug-first-app.html)" +section. + +Here are three methods: + + * Use `gdb` on the target. + + **NOTE:** How to use `gdb` and other debugging tools such as `valgrind`, `strace`, + and so forth is beyond the scope of the AGL Documentation. + See the appropriate documentation for third-party debugging tools. + + * Use Core Dumps if you have set the `agl-devel` feature. + Core Dumps are obviously more suited for post-mortem analysis. + For features, see the + "[Features supported by `aglsetup`](http://docs.automotivelinux.org/docs/getting_started/en/dev/reference/source-code.html#features-supported-by-aglsetup)" + section. + + **NOTE:** Core Dumps are available only with the "Flunky Flounder" release (i.e. 6.x). + + * Use XDS remotely, which is based on `gdb` and + `[gdbserver](https://en.wikipedia.org/wiki/Gdbserver)`. + See the + "[XDS remote debugging mode](http://docs.automotivelinux.org/docs/devguides/en/dev/reference/xds/part-1/5-2_debug-first-app-cmd.html#xds-remote-debugging-mode)" + section for more information. + + For information on how to remotely debug the application using XDS from within an IDE, see the + "[Debug using `xds-gdb` within an IDE](http://docs.automotivelinux.org/docs/devguides/en/dev/reference/xds/part-1/5-3_debug-first-app-ide.html)" + section. + + **NOTE:** How to use `gdb` and other debugging tools such as `valgrind`, `strace`, and so forth is beyond the scope of the AGL Documentation. + See the appropriate documentation for third-party debugging tools. + + In order to use third-party debugging tools, you need to include the tools in the target image. + You gain access to the tools by enabling the `agl-devel` feature when you run the + `aglsetup.sh` script as described in the + "[Setup Build Environment Info](http://docs.automotivelinux.org/docs/getting_started/en/dev/reference/source-code.html#set-up-build-environment-info)" + section. |