diff options
author | Mark Kettenis <kettenis@gnu.org> | 2004-07-05 15:31:35 +0000 |
---|---|---|
committer | Mark Kettenis <kettenis@gnu.org> | 2004-07-05 15:31:35 +0000 |
commit | 7561d4504fb545c8c7a02bfa5cefb57f1b4f697c (patch) | |
tree | 0070fcb327cad6fc31953e8e0bb7a6986eda2d06 /gdb/doc | |
parent | 871ec8960924f477379d520fd477c1958cad4e33 (diff) | |
download | fsf-binutils-gdb-7561d4504fb545c8c7a02bfa5cefb57f1b4f697c.zip fsf-binutils-gdb-7561d4504fb545c8c7a02bfa5cefb57f1b4f697c.tar.gz fsf-binutils-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/ChangeLog | 5 | ||||
-rw-r--r-- | gdb/doc/gdb.texinfo | 41 |
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 |