*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->OpenBSD man pages -> kgdb (7)              



NAME    [Toc]    [Back]

     kgdb - remote kernel debugging with gdb

DESCRIPTION    [Toc]    [Back]

     Should a programmer be dissatisfied with  the  OpenBSD  kernel's internal
     debugger  ddb(4), and have appropriate hardware available, a
kernel with
     option KGDB may be built to  effect  remote  debugging  with
gdb(1) instead.

     To prepare for debugging over serial line one would:

        +o    Obtain a second system and a crossover serial cable.
        +o   Connect the systems and test the cable.
        +o   Build a  kernel  with  option  KGDB  and  makeoptions
        +o   Copy the resultant bsd.gdb to the control system, and
boot the
            corresponding bsd on the target system.
        +o   On the control system, run gdb  on  the  kernel  just
        +o    Issue the command "target remote /dev/<serial port>"
within gdb.
            The target system should enter kgdb at this point.
        +o   Debug as normal and  detach  when  done,  the  target
should resume
            normal operation.

SEE ALSO    [Toc]    [Back]

     gdb(1), ddb(4), options(4)

     gdb info documents and online documentation.

CAVEATS    [Toc]    [Back]

     The remote connection will introduce certain latencies a local debugger
     would not see.

     Not available on all architectures.

OpenBSD     3.6                         August      23,      2001
[ Back ]
 Similar pages
Name OS Title
uutry Tru64 Tries to contact remote system with debugging on
uutry IRIX try to contact remote system with debugging on
kallsyms Linux Extract all kernel symbols for debugging
setsym IRIX set up a debug kernel for symbolic debugging
perldebug OpenBSD Perl debugging
perldebug IRIX Perl debugging
perldebtut OpenBSD Perl debugging tutorial
fsdb OpenBSD FFS debugging/editing tool
ptrace NetBSD process tracing and debugging
rip6query FreeBSD RIPng debugging tool
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service