Getting Started with gdbserver
Introduction
This documentation shows how to get started with gdbserver with a basic application. When using gdb binaries need to be compiled with debug symbols.
Application and target should have networking. For more information about SDK please check
developer.ridgerun.com/wiki/index.php/RidgeRun_Turrialba_SDK_User_Guide
Compilation process
CFLAG -ggdb:
The ggdb flag produces debugging information specifically intended for gdb, it is recommended to use this flag when using gdb for debuggin
- -ggdb (same as ggdb2)
- -ggdb1
- -ggdb2
- -ggdb3
Example:
AUTOTOOLS_PARAMS = LDFLAGS="-Wl,--rpath-link -Wl,$(FSDEVROOT)/usr/lib:$(FSDEVROOT)/lib" --sysconfdir=$(FSDEVROOT)/etc CFLAGS="-ggdb3"
CFLAG -g
The -g flag can also be added In order to add debug symbols, autotools parameters need to specify cflags as CFLAGS="-g -O0". This flag can be also added at libraries and other utilities, for example gstreamer plugins.
AUTOTOOLS_PARAMS = LDFLAGS="-Wl,--rpath-link -Wl,$(FSDEVROOT)/usr/lib:$(FSDEVROOT)/lib" --sysconfdir=$(FSDEVROOT)/etc CFLAGS="-g -O0"
Both flags can be used at the SDK, ggdb flag is recommended for using gdb debugger
Selecting gdb server on target file system
Select gdb server on File System Configuration:
[*] Install GDB server on target file system
Compile SDK and install on target.
Executing gdb
Running application with gdbserver on target
Execute application with gdbserver:
gdbserver <HOST_IP>:<PORT> <APPLICATION_BINARY>
This will leave the application waiting for the host, current output:
/ # gdbserver 10.251.101.11:2345 hello_gdb Process hello_gdb created; pid = 1179 Listening on port 2345
Running gdb on Host
gdb needs to be for arm compiler, codesourcery distributes their toolchain with the binary, usually located at: codesourcery/arm-2009q1/bin/arm-none-linux-gnueabi-gdbtui.
Execute gdbtui binary:
arm-none-linux-gnueabi-gdbtui
At debugger command line some commands needs to be executed in order to start the application remotely:
Specify path to system root:
set solib-absolute-prefix $(DEVDIR)/fs/fs
Specify binary to work with (usually the binary is inside of root file system specified before)
file <PATH_TO_BINARY>
This will load the binary and will display debug information (Current output of gdbtui):
┌──hello_gdb.c─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│38 { │
│39 int i; │
│40 │
│41 /* Mandatory "Hello, world!" */ │
│42 │
│43 deb_puts("Getting ready to say \"Hello, world\"\n"); │
│44 printf("Hello, world!\n"); │
│45 deb_puts("It has been said.\n"); │
│46 │
│47 /* Print arguments */ │
│48 │
│49 printf("argc\t= %d\n", argc); │
│50 printf("argv\t= 0x%p\n", argv); │
│51 │
│52 for (i = 0; i < argc; i++) │
│53 { │
│54 printf("argv[%d]\t= ", i); │
│55 if (argv[i]) │
└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
exec No process In: Line: ?? PC: 0x0
(gdb) cd
Argument required (new working directory).
(gdb) cd /home/USER/devdirs/DEVDIR/fs/fs
Working directory /home/USER/devdirs/DEVDIR/fs/fs.
(gdb) set
Argument required (expression to compute).
(gdb) set solib-absolute-prefix .
(gdb) file usr/bin/hello_gdb
Reading symbols from /home/USER/devdirs/DEVDIR/fs/fs/usr/bin/hello_gdb...done.
(gdb)
Set breakpoints:
Use the following command:
break <LINE_NUMBER>
This will specify an integer number at the breakpoint.Also the C file name may be specified if using various C files:
break <C_FILE.c>:<LINE_NUMBER>
Example of breakpoint being applied at line 45:
┌──hello_gdb.c─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│38 { │
│39 int i; │
│40 │
│41 /* Mandatory "Hello, world!" */ │
│42 │
│43 deb_puts("Getting ready to say \"Hello, world\"\n"); │
│44 printf("Hello, world!\n"); │
b+ │45 deb_puts("It has been said.\n"); │
│46 │
│47 /* Print arguments */ │
│48 │
│49 printf("argc\t= %d\n", argc); │
│50 printf("argv\t= 0x%p\n", argv); │
│51 │
│52 for (i = 0; i < argc; i++) │
│53 { │
│54 printf("argv[%d]\t= ", i); │
│55 if (argv[i]) │
└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
exec No process In: Line: ?? PC: 0x0
Undefined command: "ls". Try "help".
(gdb) pwd
Working directory /home/USER/devdirs/DEVDIR.
(gdb) file myapps/hello-gdb/src/src/hello_gdb
Reading symbols from /home/USER/devdirs/DEVDIR/myapps/hello-gdb/src/src/hello_gdb...done.
(gdb) berak 45
Undefined command: "berak". Try "help".
(gdb) break 45
Breakpoint 1 at 0x8478: file hello_gdb.c, line 45.
(gdb)
Delete break point
Use the delete command and breakpoint number
delete 2
Specify remote application
Specify target remote application:
target remote <BOARD _IP_ADDRESS>:<PORT>
Run binary
To run the binary use the continue, application will stop at breakpoints
continue
Output when gdb encounters a breakpoint
Breakpoint 1, main (argc=1, argv=0xbeae2ea4, envp=0xbeae2eac) at hello_gdb.c:49 (gdb)
Using ddd with gdb
In order to use ddd with arm gdb run ddd and specify the arm gdb:
ddd --debugger /opt/codesourcery/arm-2009q1/bin/arm-none-linux-gnueabi-gdb
ddd has a command line at the GUI, use the same commands as when using gdbtui. In order to run the binary use the exact same command: "continue"
breakpoints can be added and removed manually at the GUI, the break command also works for this.
Debugging symbol hints
1. Enable general symbols on the toolchain configuration
make config
'-> Toolchain configurations
'-> Toolchain architecture independent flags
'-> -Wall -O0 -ggdb3 -g
2. Remove symbol stripping
make config
'-> File System Configuration
'-> [ ] Strip the target file system binaries (may render debug useless)
Make sure the option is NOT selected
3. Manually fix problematic packages
3.1 Util Linux
Add the line AUTOTOOLS_PARAMS+=CFLAGS="-Wall -O2" to the makefile
#$L$
# Copyright (C) 2013 Ridgerun (http://www.ridgerun.com).
##$L$
PKG_URL=http://www.kernel.org/pub/linux/utils/util-linux/v2.22
PKG_TARBALL=util-linux-2.22.tar.bz2
PKG_SHA1SUM=fdabf80d3104a0d61455d31d74f0de629fa926a6
LIBRARIES= usr/lib/{libblkid.so.1.1.0,libmount.so.1.1.0,libuuid.so.1.3.0}
AUTOTOOLS_PARAMS= \
--disable-makeinstall-chown \
--without-ncurses \
--disable-agetty \
--disable-cramfs \
--disable-eject \
--disable-fallocate \
--disable-fsck \
--disable-kill \
--disable-login \
--disable-losetup \
--disable-mount \
--disable-mountpoint \
--disable-partx \
--disable-pivot_root \
--disable-rename \
--disable-schedutils \
--disable-su \
--disable-sulogin \
--disable-switch_root \
--disable-unshare \
--disable-wall
AUTOTOOLS_PARAMS+=CFLAGS="-Wall -O2"
include ../../../bsp/classes/rrsdk.class
include $(CLASSES)/autotools.class
3.2 libsoup
Add the line AUTOTOOLS_PARAMS+=CFLAGS="-Wall -O2" to the makefile
# Copyright (C) 2011 Ridgerun (http://www.ridgerun.com). ##$L$ PKG_URL = http://ftp.gnome.org/pub/GNOME/sources/libsoup/2.32/ PKG_TARBALL = libsoup-2.32.2.tar.gz PKG_SHA1SUM = 664e4b5e78415c93bd10eb87062f24b864d8c80f AUTOTOOLS_PARAMS= --disable-ssl --without-gnome # Fill the spaces with the software components you'll need on the FSROOT LIBRARIES =/usr/lib/libsoup-2.4.so.1.3.0 AUTOTOOLS_PARAMS+=CFLAGS="-Wall -O2" include ../../../bsp/classes/rrsdk.class include $(CLASSES)/autotools.class
3.3 GstOpenmaxPlugin
We have seen that the deiscaler fails when compiled without optimizations. Add symbols but still tell the compiler to optimize a bit. GDB will run jerky, but it does help.
echo AUTOTOOLS_PARAMS+=CFLAGS=\"-Wall -O1 -ggdb3\" >> proprietary/gst-openmax-dm81xx/Makefile
4. Manually add symbols to DVSDK/EZSDK packages
For example, suppose we wanted to add symbols to the omx core package
proprietary/ezsdk-5_05_02_00/ezsdk/component-sources/omx_05_02_00_48/src/ti/omx/domx/ -CFLAGS_LOCAL_COMMON = -D_VIDEO_M3_DYNAMIC_CONFIG +CFLAGS_LOCAL_COMMON = -D_VIDEO_M3_DYNAMIC_CONFIG CFLAGS+=-O0 -ggdb3