From 61ce0c2da83173054100ea71a94babe694ec9a05 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Wed, 22 May 2019 11:03:04 -0700 Subject: XDS Debug Overview re-write for "guppy" Signed-off-by: Scott Rifenbark Change-Id: I0d9136a7da269cf05f4c25bec9bf7058485df118 --- docs/part-1/debug-overview.md | 40 +++++++++++++++++++++++++++------------- 1 file changed, 27 insertions(+), 13 deletions(-) mode change 100644 => 100755 docs/part-1/debug-overview.md diff --git a/docs/part-1/debug-overview.md b/docs/part-1/debug-overview.md old mode 100644 new mode 100755 index e1bdffd..25cb30d --- a/docs/part-1/debug-overview.md +++ b/docs/part-1/debug-overview.md @@ -1,22 +1,36 @@ -# Debug your first AGL application +# Overview -Debug is based on gdb and you need to use `xds-gdb` as a wrapper on gdb to +Debugging your AGL application is based on the GNU Project Debugger +([GDB](https://www.gnu.org/software/gdb/)). +In order to use GDB, you must use `xds-gdb` as a wrapper on GDB to cross-debug your application. +For information on `xds-gdb`, see the +"[Client Part](./client-part.html)" topic. -This tool allows you to debug an application built with XDS without the need to install gdb or any cross tools. +Using `xds-gdb` allows you to debug an application built with +XDS without the need to install GDB or any cross-tools. -Two debugging models are supported: +XDS supports two debugging models: -1. native debugging -1. XDS remote debugging requiring an XDS agent/server setup and that allows you to cross debug your application. +* Native debugging -By default XDS debug model is used and you need to define `XDS_NATIVE_GDB` -variable to use native gdb debug mode instead. +* XDS remote debugging ---- +The default debugging model is XDS remote. +To use this model, you must have previously set up the XDS +agent and server so that you can cross-debug your application. +See the +"[Server Part](./server-part.html)" and +"[Client Part](./client-part.html)" topics for more +information on getting set up. -Links to subchapters : +If you want to use the native debugging model, you must define the +`XDS_NATIVE_GDB` environment variable. +See the +"[Configuration](./debug-configuration.html)" topic for information +on XDS configuration variables. -- [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) +The remainder of this topic describes +[configurations](./debug-configuration), using the XDS +[command line](./debug-cmd-line) to debug, and using an +[IDE](./debug-ide) to debug. -- cgit 1.2.3-korg