Kgdb - Revision history

Adushistova: /* Preparing Kernel to be Debugged */

2012-11-20T17:20:05Z

‎Preparing Kernel to be Debugged

Adushistova: /* Preparing Kernel to be Debugged */

2012-11-20T17:19:45Z

‎Preparing Kernel to be Debugged

Peter Huewe: /* There are several possible problems that you may face */

2011-07-12T20:14:47Z

‎There are several possible problems that you may face

Jsujjava: Add Category Development Tools

2011-05-15T20:52:11Z

Add Category Development Tools

GNUtoo: /* Preparing Kernel to be Debugged */ fix big issue: "Compile the kernel with debug info" was not even mentioned

2010-05-08T21:19:43Z

‎Preparing Kernel to be Debugged: fix big issue: "Compile the kernel with debug info" was not even mentioned

Viralmehta at 09:24, 17 April 2009

2009-04-17T09:24:59Z

New page

It is fascinating to think that you have control over running Linux Kernel. You can stop, can single-step, can resume and even can put break-points on running Kernel. In fact, you can debug the kernel as easily as you debug any application.

== How to setup kgdb ==

The steps mentioned here are with reference to 2.6.26 Kernel. The main reason is KGDB code is merged into Linux tree from 2.6.26-RC5 kernel.
(As a side note, for kernel < 2.6.26-RC5, you have to get kgdb patch from [ http://kgdb.linsyssoft.com/kernel.htm] and apply them to kernel)

== Hardware Requirements ==

Two x86 machines are required for using KGDB. One of the machines runs a kernel to be debugged called "TEST MACHINE". The other machine runs gdb "DEVELOPMENT MACHINE".
A serial line is required between the development and the test machine. And so obviously, machines need one serial port each. Basically, you will be sending "Debugging Commands" from "DEVELOPMENT MACHINE" to "TEST MACHINE".

== Preparing Kernel to be Debugged ==

1. Download the source of kernel (for e.g., 2.6.26.2)from kernel.org

2. Recompile the Kernel on "DEVELOPMENT MACHINE".
Go to Kernel Hacking
Enable two options 1. Enable SysRq Key, and 2. Kernel Debugging KGDB. Give "Y" to both of them.

3. Build kernel and modules
make -j 12 && make modules && make modules_install

4. Transfer the vmlinux and system.map and initrd.img files on "TEST MACHINE".

5. Now, edit the GRUB entry for that kernel on "TEST MACHINE". Add kernel options/kernel parameters like kgddbwait and kgdboc=ttyS0,115200
For e.g., kernel /vmlinux ro root=LABEL=/ rhgb quiet crashkernel=128M@16M kgddbwait kgdboc=ttyS0,115200
kgdbwait -- > This will make Kernel to wait on boot time and will expect someone to connect to it and give further commands
kgdboc --> This is a KGDB I/O driver and we are supplying two arguments. ttyS0 will tell that communication will happen on Serial Port 0 and 115200 is the baudrate.

6. Now boot the Kernel with those kernel parameters.

7. On dev machine, start GDB session.
[dev@einfochips]gdb vmlinux
The argument vmlinux file is the file that is created with Debug symbols.
It will be of much larger size and more than likely to be in the directory where you gave "make" command..

8. Assuming that on "DEVELOPMENT MACHINE" you have set serial interface baudrate as 115200. Connect to the "TEST MACHINE" with target command.
(gdb)target remote /dev/ttyS0

9. This will stop your Kernel booting on "TEST MACHINE" and will give control to your "DEVELOPMENT MACHINE". Now, you can do Single-stepping or put breakpoints and etc.

10. Once your Kernel is running on "TEST MACHINE" and you want control over your running kernel from "DEVELOPMENT MACHINE",
You have to send MANUALLY on TEST machine SysRq command. So, on "TEST MACHINE" press SysRq + g
(i.e., press "ALT" key then Press "PrintScreen" Key and then Press "g" key)

== There are several possible problems that you may face ==
1. Your Kerenel is booted and SysRq+g is not working.
[r00t@einfochips] echo 1 > /proc/sys/kernel/sysrq
This will enable sending SysRq commands.

2. You may find some time that while stopping execution through SysRq key on "TEST MACHINE", it stops but then it is not able to communicate over serial cable with "DEVELOPMENT MACHINE". The reason can be, your KGDB I/O driver is not passed arguments properly and you may need to reconfigure the driver by following way,
[root@einfochips]echo "ttyS0,115200" > /sys/modules/<module name>/parameters

← Older revision		Revision as of 20:52, 15 May 2011
Line 57:		Line 57:
	2. You may find some time that while stopping execution through SysRq key on "TEST MACHINE", it stops but then it is not able to communicate over serial cable with "DEVELOPMENT MACHINE". The reason can be, your KGDB I/O driver is not passed arguments properly and you may need to reconfigure the driver by following way,		2. You may find some time that while stopping execution through SysRq key on "TEST MACHINE", it stops but then it is not able to communicate over serial cable with "DEVELOPMENT MACHINE". The reason can be, your KGDB I/O driver is not passed arguments properly and you may need to reconfigure the driver by following way,
	[root@einfochips]echo "ttyS0,115200" > /sys/modules/<module name>/parameters		[root@einfochips]echo "ttyS0,115200" > /sys/modules/<module name>/parameters
		+
		+	[[Category:Development Tools]]

@@ Line 29: / Line 29: @@
 . Transfer the vmlinux and system.map and initrd.img files on "TEST MACHINE".
-. Now, edit the GRUB entry for that kernel on "TEST MACHINE". Add kernel options/kernel parameters like kgddbwait and kgdboc=ttyS0,115200
+. Now, edit the GRUB entry for that kernel on "TEST MACHINE". Add kernel options/kernel parameters like kgdbwait and kgdboc=ttyS0,115200
      For e.g., kernel /vmlinux ro root=LABEL=/ rhgb quiet crashkernel=128M@16M kgdbwait kgdboc=ttyS0,115200
 kgdbwait -- > This will make Kernel to wait on boot time and will expect someone to connect to it and give further commands

@@ Line 51: / Line 51: @@
 == There are several possible problems that you may face ==
-. Your Kerenel is booted and SysRq+g is not working.
+. Your Kernel is booted and SysRq+g is not working.
      [r00t@einfochips] echo 1 > /proc/sys/kernel/sysrq
 This will enable sending SysRq commands.

@@ Line 16: / Line 16: @@
 . Recompile the Kernel on "DEVELOPMENT MACHINE".
-    Go to Kernel Hacking
+Go to Kernel Hacking and Enable the following options:
-    Enable two options 1. Enable SysRq Key, and 2. Kernel Debugging KGDB. Give "Y" to both of them.
+ -*- Magic SysRq key
+ [*] Compile the kernel with debug info
 . Build kernel and modules
       make -j 12 && make modules && make modules_install