From: Sasha Levin <levinsasha928@gmail.com>
Date: Mon, 19 Sep 2011 11:05:56 +0000 (+0300)
Subject: kvm tools: Document steps to debug kernel using KGDB
X-Git-Tag: next-20110920~2^2~1
X-Git-Url: https://git.karo-electronics.de/?a=commitdiff_plain;h=eb54989c0723863646edf85dbeadbf5a3347b593;p=karo-tx-linux.git

kvm tools: Document steps to debug kernel using KGDB

Signed-off-by: Sasha Levin <levinsasha928@gmail.com>
---

diff --git a/tools/kvm/Documentation/kernel-debugging.txt b/tools/kvm/Documentation/kernel-debugging.txt
new file mode 100644
index 000000000000..7feeb3065da0
--- /dev/null
+++ b/tools/kvm/Documentation/kernel-debugging.txt
@@ -0,0 +1,15 @@
+This document explains how to debug a guests' kernel using KGDB.
+
+1. Run the guest:
+        'kvm run -k [vmlinuz] -p "kgdboc=ttyS1 kgdbwait" --tty 1'
+
+And see which PTY got assigned to ttyS1 (you'll see:
+'  Info: Assigned terminal 1 to pty /dev/pts/X').
+
+2. Run GDB on the host:
+        'gdb [vmlinuz]'
+
+3. Connect to the guest (from within GDB):
+        'target remote /dev/pty/X'
+
+4. Start debugging! (enter 'continue' to continue boot).