summaryrefslogtreecommitdiffstats
path: root/docs/part-1/debug-overview.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/part-1/debug-overview.md')
-rw-r--r--docs/part-1/debug-overview.md22
1 files changed, 22 insertions, 0 deletions
diff --git a/docs/part-1/debug-overview.md b/docs/part-1/debug-overview.md
new file mode 100644
index 0000000..e1bdffd
--- /dev/null
+++ b/docs/part-1/debug-overview.md
@@ -0,0 +1,22 @@
+# Debug your first AGL application
+
+Debug is based on gdb and you need to use `xds-gdb` as a wrapper on gdb to
+cross-debug your application.
+
+This tool allows you to debug an application built with XDS without the need to install gdb or any cross tools.
+
+Two debugging models are supported:
+
+1. native debugging
+1. XDS remote debugging requiring an XDS agent/server setup and that allows you to cross debug your application.
+
+By default XDS debug model is used and you need to define `XDS_NATIVE_GDB`
+variable to use native gdb debug mode instead.
+
+---
+
+Links to subchapters :
+
+- [Configuration](./5-1_debug-first-app-config.html)
+- [xds-gdb from command line](./5-2_debug-first-app-cmd.html)
+- [xds-gdb within an IDE](./5-3_debug-first-app-ide.html)