Configuring a connection to a Linux Kernel

You can connect to running target using a debug hardware agent.


By default for this type of connection, all processor exceptions are handled by Linux on the target. You can use the Manage Signals dialog box in the Breakpoints view menu to modify the default handler settings.


Before connecting you must ensure that you have the target IP address or name for the connection between the debugger and the debug hardware agent.


To connect to the target:

  1. Select Window → Open Perspective → DS-5 Debug from the main menu.

  2. Select Debug Configurations... from the Run menu.

  3. Select DS-5 Debugger from the configuration tree and then click on New to create a new configuration.

  4. In the Name field, enter a suitable name for the new configuration.

  5. Click on the Connection tab to configure a DS-5 Debugger target connection:

    1. Select the required platform.

    2. Select the Linux Kernel and/or Device Driver Debug project type.

    3. Select the required debug operation.

    4. Configure the connection between the debugger and the debug hardware agent.

  6. Click on the Files tab and select compiled debug versions of the:

    1. Operating System kernel image (vmlinux) compiled against exactly the same kernel version as the target.

    2. Module image compiled against exactly the same kernel version as the target, if required.

    Alternatively after connection, you can manually load debug information into the debugger by using the Load... menu option from the Debug Control view.

  7. Click on the Debugger tab to configure the debugger settings.

    1. In the Run control panel, select Connect only and set up initialization scripts as required.


      Operating System (OS) support is automatically enabled when a Linux kernel image is loaded into the debugger from the DS-5 Debugger launch configuration. However, you can manually control this by using the set os command.

      For example, if you want to delay the activation of OS support until after the kernel has booted and the Memory Management Unit (MMU) is initialized then you can configure a connection that uses a target initialization script to disable OS support. To debug the kernel, OS support must be enabled in the debugger.

    2. Configure the host working directory or use the default.

    3. In the Paths panel, specify any source search directories on the host that the debugger uses when it displays source code.

  8. Click on Apply to save the configuration settings.

  9. Click on Debug to connect to the target.

  10. Debugging requires the DS-5 Debug perspective. If the Confirm Perspective Switch dialog box opens, click Yes to switch perspective.

When connected and the DS-5 Debug perspective opens you are presented with all the relevant views and editors.

For more information on these options, use the dynamic help.

Show/hideSee also

Copyright © 2010, 2011 ARM. All rights reserved.ARM DUI 0446G