This is the mail archive of the
gdb-patches@sources.redhat.com
mailing list for the GDB project.
[PATCH] BSD libkvm documentation
- From: Mark Kettenis <kettenis at chello dot nl>
- To: eliz at gnu dot org, gdb-patches at sources dot redhat dot com
- Date: Sat, 3 Jul 2004 15:32:15 +0200 (CEST)
- Subject: [PATCH] BSD libkvm documentation
Eli, are these doc bits OK?
Mark
Index: doc/ChangeLog
from Mark Kettenis <kettenis@gnu.org>
* gdb.texinfo (BSD libkvm Interface): New node (section)
(Native): Add it to the menu.
Index: doc/gdb.texinfo
===================================================================
RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v
retrieving revision 1.207
diff -u -p -r1.207 gdb.texinfo
--- doc/gdb.texinfo 19 Jun 2004 17:33:44 -0000 1.207
+++ doc/gdb.texinfo 3 Jul 2004 13:31:22 -0000
@@ -11412,6 +11412,7 @@ configurations.
@menu
* HP-UX:: HP-UX
+* BSD libkvm Interface:: Debugging BSD kernel memory images
* SVR4 Process Information:: SVR4 process information
* DJGPP Native:: Features specific to the DJGPP port
* Cygwin Native:: Features specific to the Cygwin port
@@ -11424,6 +11425,47 @@ On HP-UX systems, if you refer to a func
begins with a dollar sign, @value{GDBN} searches for a user or system
name first, before it searches for a convenience variable.
+@node BSD libkvm Interface
+@subsection BSD libkvm Interface
+
+@kindex libkvm
+@cindex kernel memory image
+@cindex kernel crash dump
+
+BSD-derived systems (FreeBSD/NetBSD/OpenBSD) have a kernel memory
+interface that provides a uniform interface for accessing kernel virtual
+memory images, including live systems and crash dumps. @value{GDBN}
+uses this interface to allow you to debug live kernels and kernel crash
+dumps on many native BSD configurations. This is implemented as a
+special @code{kvm} debugging target. For debugging a live system, load
+the currently running kernel into @value{GDBN} and connect to the
+@code{kvm} target:
+
+@smallexample
+(@value{GDBP}) @b{target kvm}
+@end smallexample
+
+For debugging crash dumps, provide the file name of the crash dump as an
+argument:
+
+@smallexample
+(@value{GDBP}) @b{target kvm /var/crash/bsd.0}
+@end smallexample
+
+Once connected to the @code{kvm} target, the following commands are
+available:
+
+@table @code
+@kindex kvm pcb
+@item kvm pcb
+Set current context from pcb address.
+
+@kindex kvm proc
+@item kvm proc
+Set current context from proc address. This command isn't available on
+modern FreeBSD systems.
+@end table
+
@node SVR4 Process Information
@subsection SVR4 process information