summaryrefslogtreecommitdiffstats
path: root/docs/getting-started
diff options
context:
space:
mode:
authorScott Rifenbark <srifenbark@gmail.com>2018-10-29 13:36:18 -0700
committerScott Rifenbark <srifenbark@gmail.com>2018-10-29 13:36:18 -0700
commit68c8923ad5b03f57de3898b81cdc916ac0500e72 (patch)
tree476c663be73187f49f5f65c6a4709b482cfcd98e /docs/getting-started
parentcf52268b9ab813a4c11e30b70aef8e8c1d6172c9 (diff)
Application development workflow debug:
Updated this content with general information on how to debug the application once it is part of the target (has been deployed). Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Diffstat (limited to 'docs/getting-started')
-rw-r--r--docs/getting-started/app-workflow-debug-app.md25
1 files changed, 12 insertions, 13 deletions
diff --git a/docs/getting-started/app-workflow-debug-app.md b/docs/getting-started/app-workflow-debug-app.md
index 6b6687c..91ef905 100644
--- a/docs/getting-started/app-workflow-debug-app.md
+++ b/docs/getting-started/app-workflow-debug-app.md
@@ -2,14 +2,16 @@
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
+whether or not you are doing a post-mortem analysis, and your debugging
+skills and productivity.
+For example, 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?).
+console?
+Or, is it better for you to use a remote user interface that is part of
+an Integrated Development Environment (IDE) such as Eclipse?
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)"
+"[Debug your first AGL application](../../../../../docs/devguides/en/dev/reference/xds/part-1/5_debug-first-app.html)"
section.
Here are three methods:
@@ -23,26 +25,23 @@ Here are three methods:
* 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)"
+ "[Features supported by `aglsetup`](../../../../../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)`.
+ [`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)"
+ "[XDS remote debugging mode](../../../../../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)"
+ "[Debug using `xds-gdb` within an IDE](../../../../../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)"
+ "[Setup Build Environment Info](../../../../../docs/getting_started/en/dev/reference/source-code.html#set-up-build-environment-info)"
section.