aboutsummaryrefslogtreecommitdiffstats
path: root/docs/part-1/debug-overview.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/part-1/debug-overview.md')
-rwxr-xr-xdocs/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 100755
index 0000000..22dc82d
--- /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](./debug-configuration.html)
+- [xds-gdb from command line](./debug-cmd-line.html)
+- [xds-gdb within an IDE](./debug-ide.html)