2.9 Debugging a loadable kernel module
You can use DS-5 to develop and debug a loadable kernel module. Loadable modules can be dynamically inserted and removed from a running kernel during development without the need to frequently recompile the kernel.
This tutorial uses a simple character device driver
modex.c which is part of
the ARMv7 Linux application examples available in DS-5.
You can use
modex.c to compile, run, and
debug against your target. The readme.html in
the <install_directory>/examples/docs/kernel_module contains
information about customising this for your target.
If you are working with your own module, before you can debug it,
you must ensure that you:
- Unpack kernel source code and compile the kernel against exactly the same
kernel version as your target.
- Compile the loadable module against exactly the same kernel
version as your target.
- Ensure that you compile both images with debug information. The debugger requires run-time
information from both images when debugging the module.
Create a new Debug Configuration.
From the main DS-5 menu, select .
In the Debug Configurations dialog box, create a New
Launch Configuration and give it a name. For example,
In the Connection tab, select the target and
platform and set up your target connection.
Figure 2-12 Typical connection settings for a Linux
kernel/Device Driver Debug
In the Files
tab, set up the debugger settings to load debug information for the
Linux kernel and the module.
Figure 2-13 Typical Files settings for a Linux
kernel/Device Driver Debug
In the Debugger
tab, select Connect only in the
Run control panel.
Click Debug to
connect the debugger to the target.
Configure and connect a terminal shell to the target. You can use the Remote System Explorer (RSE) provided with DS-5.
Using RSE, copy the compiled module to the target:
On the host workstation, navigate to .../linux_system/kernel_module/stripped/modex.ko
Drag and drop the module to a writeable directory on the target.
Using the terminal shell, insert the
Navigate to the location of the kernel module.
Execute the following command:
The Modules view updates to display details
of the loaded module.
To debug the module, set breakpoints, run, and step as required.
To modify the module source code:
Remove the module using commands as required in the terminal shell. For example:
Recompile the module.
Repeat steps 3 to 5 as required.
NoteWhen you insert and remove a module, the debugger stops the target and automatically resolves memory locations for debug information and existing breakpoints. This means that you do not have to stop the debugger and reconnect when you recompile the source code.
Useful terminal shell commands:
- Displays information about all the loaded modules.
- Inserts a loadable module.
- Removes a module.
Useful DS-5 Debugger commands:
- Displays a list of OS modules loaded after connection.
- Displays the contents of the OS log buffer.
- Displays the version of the OS.
- Displays a list of processes showing ID, current state and related stack frame information.
- Controls the capturing and printing of Operating System (OS) logging messages to the console.
OS modules loaded after connection are displayed in the Modules view.