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
information about customizing this for your target.
NoteIf 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 Run > Debug Configurations.
- In the Debug Configurations dialog box, create a New Launch Configuration and give it a name. For example, my_board.
In the Connection tab, select the target and
platform and set up your target connection.
Figure 4-25 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 4-26 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 file.
- 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:
insmod modex.koThe 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:
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.