xref: /kvmtool/Documentation/kernel-debugging.txt (revision 26a3a071bb9dada378b9b395393e16fc3e69914d)
1a28e0fe5SSasha LevinThis document explains how to debug a guests' kernel using KGDB.
2a28e0fe5SSasha Levin
3a28e0fe5SSasha Levin1. Run the guest:
4*26a3a071SWanlong Gao        'lkvm run -k [vmlinuz] -p "kgdboc=ttyS1 kgdbwait" --tty 1'
5a28e0fe5SSasha Levin
6a28e0fe5SSasha LevinAnd see which PTY got assigned to ttyS1 (you'll see:
7a28e0fe5SSasha Levin'  Info: Assigned terminal 1 to pty /dev/pts/X').
8a28e0fe5SSasha Levin
9a28e0fe5SSasha Levin2. Run GDB on the host:
10a28e0fe5SSasha Levin        'gdb [vmlinuz]'
11a28e0fe5SSasha Levin
12a28e0fe5SSasha Levin3. Connect to the guest (from within GDB):
13a28e0fe5SSasha Levin        'target remote /dev/pty/X'
14a28e0fe5SSasha Levin
15a28e0fe5SSasha Levin4. Start debugging! (enter 'continue' to continue boot).
16