KGDB(7) BSD Reference Manual KGDB(7)NAMEkgdb - 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 ALSOgdb(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