Debugging Linux Applications¶
This article describes how to debug user-space applications on the Linux on ARC.
In most cases it should be enough to use binary distribution of GNU Toolchain
for ARC, which can be downloaded from our Releases page.
If toolchain in binary distribution doesn’t fit some particular requirements,
then instruction to build toolchain from source can be found in README.md file
The simple guide to build kernel can be found in this manual page How to build Linux with GNU tools and run on simulator. More instructions can be found in ARC Linux wiki and in the Internet in general.
Configuring target system¶
Information in this section is not specific to ARC, it is given here just for convenience - there are other ways to achieve same result.
Ethernet model is not available in standalone nSIM simulation.
By default target system will not bring up networking device. To do this:
[arclinux] $ ifconfig eth0 up
If network to which board or virtual platform is attached has a DHCP server, then run DHCP client:
[arclinux] $ udhcpc
If there is no DHCP server, then configure networking manually:
[arclinux] $ ifconfig eth0 <IP_ADDRESS> netmask <IP_NETMASK> [arclinux] $ route add default gw <NETWORK_GATEWAY> eth0
<IP_ADDRESS> is an IP address to assign to ARC Linux,
a mask of this network,
<NETWORK_GATEWAY> is default gateway of network.
To gain access to the Internet DNS must servers must be configured. This is
usually not required when using DHCP, because in this case information about
DNS servers is provided via DHCP. To configure DNS manually, create
/etc/resolv.conf which lists DNS servers by IP. For example:
nameserver 126.96.36.199 nameserver 188.8.131.52
That will connect ARC Linux to the network.
To ease process of delivering target application into the ARC Linux it is recommended to configure NFS share and mount it on the ARC Linux.
Install NFS server on the development host (in this example it is Ubuntu):
$ sudo apt-get install nfs-kernel-server
/etc/exports: describe you public folder there. For example:
Restart NFS server:
$ sudo service nfs-kernel-server restart
Open required ports in firewall. To make things easier this example will open
all ports for the hosts in the
$ sudo ufw allow from 192.168.218.0/24 to 192.168.218.1
Now you can mount your share on the target:
[arclinux] # mount -t nfs -o nolock,rw 192.168.218.1:/home/arc/snps/pub /mnt
Public share will be mounted to the
Another thing that might be useful is to have network services like telnet,
ftp, etc, that will run on ARC Linux. First make sure that desired service is
available in the Busybox configuration. Run
make menuconfig from Busybox
make busybox-menuconfig if you are using Buildroot. Make sure
that “inetd” server is enabled. Select required packages (telnet, ftpd, etc)
and save configuration. Rebuild busybox (run
make busybox-rebuild if you
are using Buildroot).
Then configure inetd daemon. Refer to inetd documentation to learn how to do
this. In the simple case it is required to create
/etc/inetd.conf file on
the target system with following contents:
ftp stream tcp nowait root /usr/sbin/ftpd ftpd -w / telnet stream tcp nowait root /usr/sbin/telnetd telnetd -i -l /bin/sh
Thus inetd will allow connections to ftpd and telnetd servers on the target system. Other services can be added if required.
Rebuild and update rootfs and vmlinux. Start rebuilt system and run inetd to start inetd daemon on target:
[arclinux] $ inetd
Debugging applications with gdbserver¶
It is assumed that one or another way application to debug is on to the target system. Run application on target with gdbserver:
[arclinux] $ gdbserver :49101 <application-to-debug> [application arguments]
TCP port number could any port not occupied by another application. Then run GDB on the host:
$ arc-linux-gdb <application-to-debug>
Then set sysroot directory path. Sysroot is a “mirror” of the target system
file system: it contains copies of the applications and shared libraries
installed on the target system. Path to the sysroot directory should be set to
allow GDB to step into shared libraries functions. Note that shared libraries
and applications on the target system can be stripped from the debug symbols to
preserve disk space, while files in the sysroot shouldn’t be stripped. In case
of Buildroot-generated rootfs sysroot directory can be found under
(gdb) set sysroot <SYSROOT_PATH>
Then connect to the remote gdbserver:
(gdb) target remote <TARGET_IP>:49101
You can find
<TARGET_IP> via running
ifconfig on the target system. TCP
port must much the one used when starting up gdbserver. It is important that
sysroot should be set before connecting to remote target, otherwise GDB might
have issues with stepping into shared libraries functions.
Then you can your debug session as usual. In the simplest case:
Debugging applications with native GDB¶
Starting from GNU Toolchain for ARC release 2014.08 it is possible to build
full GDB to run natively on ARC Linux. Starting from GNU Tooolchain for ARC
release 2015.06 native GDB is automatically built for uClibc toolchain (can be
--no-native-gdb option). In GNU Toolchain prebuilt tarballs
native GDB binary can be found in sysroot directory:
With native GDB it is possible to debug applications the same way as it is done on the host system without gdbserver.