aboutsummaryrefslogtreecommitdiff
path: root/gdb/doc
diff options
context:
space:
mode:
authorMark Kettenis <kettenis@gnu.org>2004-07-05 15:31:35 +0000
committerMark Kettenis <kettenis@gnu.org>2004-07-05 15:31:35 +0000
commit7561d4504fb545c8c7a02bfa5cefb57f1b4f697c (patch)
tree0070fcb327cad6fc31953e8e0bb7a6986eda2d06 /gdb/doc
parent871ec8960924f477379d520fd477c1958cad4e33 (diff)
downloadgdb-7561d4504fb545c8c7a02bfa5cefb57f1b4f697c.zip
gdb-7561d4504fb545c8c7a02bfa5cefb57f1b4f697c.tar.gz
gdb-7561d4504fb545c8c7a02bfa5cefb57f1b4f697c.tar.bz2
* gdb.texinfo (BSD libkvm Interface): New node (section)
(Native): Add it to the menu.
Diffstat (limited to 'gdb/doc')
-rw-r--r--gdb/doc/ChangeLog5
-rw-r--r--gdb/doc/gdb.texinfo41
2 files changed, 46 insertions, 0 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 2eaec72..6ed591c 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,8 @@
+2004-07-03 Mark Kettenis <kettenis@gnu.org>
+
+ * gdb.texinfo (BSD libkvm Interface): New node (section)
+ (Native): Add it to the menu.
+
2004-07-01 Mark Kettenis <kettenis@gnu.org>
* gdbint.texinfo (Target Architecture Definition): Remove
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 2ae7472..da67e88 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -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,46 @@ On HP-UX systems, if you refer to a function or variable name that
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
+
+@cindex 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
+@item kvm pcb
+Set current context from pcb address.
+
+@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