MirOS Manual: kgdb(7)

KGDB(7)                      BSD Reference Manual                      KGDB(7)

NAME

     kgdb - remote kernel debugging with gdb

DESCRIPTION

     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:

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

SEE ALSO

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

     gdb info documents and online documentation.

CAVEATS

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

     Not available on all architectures.

MirOS BSD #10-current          August 23, 2001                               1

Generated on 2014-07-04 21:17:45 by $MirOS: src/scripts/roff2htm,v 1.79 2014/02/10 00:36:11 tg Exp $

These manual pages and other documentation are copyrighted by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors. The rest is Copyright © 2002‒2014 The MirOS Project, Germany.
This product includes material provided by Thorsten Glaser.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.