Remote debugging with Anjuta

Owners: Haitao Feng, Kevin Wang

Using the Anjuta IDE with the Moblin Anjuta plug-in for Anjuta provides a good environment for creating and remote debugging of Moblin applications on Ubuntu and Fedora.

Import Your Project into Anjuta

For this tutorial we will be using the sample clutter application. The source for this is included in the SDK under "samples". You can also use your own project.

Start anjuta:

Click "File->New->Project From Existing Sources", choose a project name and enter the source directory.

Configure the Anjuta Debugger and Moblin SDK plug-ins

If you have not already installed Anjuta and the Moblin SDK plug-in, follow the steps on the Moblin Anjuta Plug-in project page.

• Enable the Anjuta Debugger plug-in
  Click "Edit->Preferences. Select the "General" icon in the left panel, then the "Installed plugins" tab. Click "Debugger" (usually already selected) to enable the Anjuta debugger.
• Enable the Moblin SDK plug-in
  While viewing the installed plug-ins, also select the "Moblin SDK" plug-in. A new icon will appear for the Moblin plug-in settings in the left panel of the Preferrences dialog.
• Configure the Moblin plug-in
  Click the Moblin SDK icon in the left panel.
  • Select "Use an external toolchain" and set "SDK root" to: ~/moblin-sdk-${version}/moblin-cross-toolchain
  • Set "Toolchain triplet" to "i586-moblin-linux"
  • Select "Use an external device" and set "IP address" to your netbook's IP address

  

• Restart anjuta

Configure and Build the Project

Now that anjuta is configured to use the Moblin SDK toolchain we are ready to build our application.

• Run "configure": Click "Build->Configure Project->Execute"
• Run "make": Click "Build->Build Project"

Configure the netbook to enable remote deployment and debugging

Build on your workstation, deploy to the netbook, debug remotely.

• gdbserver enables you to walk through code on your workstation while the program is running on the netbook
• openssh-server and rsync enable you to easily send newly built binaries from the workstation to the netbook. This is called "deploy" in anjuta
• xhost + allows remote systems to connect and display content on the display

On your netbook, run the following in a terminal:

Deploy Project

When you "Deploy" your application it is the same as running "make install" on the Netbook. The application icons, data, and binaries are all installed in the appropriate locations. The Netbook root user priveleges are required.

To Deploy your application, click: "Tools->Deploy". You can see the results in the Deploy window.

Test Run Project on Netbook

Click "Tools->Run Remote ...". Enter the full path where your application was installed on the Netbook. For the sample application, enter "/usr/local/bin/clutter-helloworld".

Remote Debugging on Netbook

• Start gdbserver on Netbook. In a terminal, run:
  
  $ gdbserver localhost:<port> <full-path-to-program>
( for clutter-helloworld program and using port #8080 you would enter: )
$ gdbserver localhost:8080  /usr/local/bin/clutter-helloworld
  
  Note: gdbserver must be started each time you debug your application.
• Start anjuta debugging session on Workstation
  • In anjuta, set a breakpoint in your source code (right-click on a line of code and select "Toggle Breakpoint")
  • Click: "Run->Debug Remote Target ...".
  • In the "Connect to remote target" dialog, enter the Netbook IP address and port used with gdbserver above. Click "Connect"