Bochs User Manual
<<< Previous | Tips and Techniques | Next >>>

# Using Bochs and the remote GDB stub

This section covers how you can use Bochs with a remote GDB stub to debug your kernel.

## Configuring Bochs

The GDB stub is not active in standard Bochs binary package. So you must recompile Bochs. Download the Bochs source package, unpack it and run the configure script with the --enable-gdb-stub argument.

      $ ./configure --enable-gdb-stub

After that, just run make and you should have a Bochs binary that contain a GDB stub in your directory.

## Running Bochs

Enable the gdbstub option in `bochsrc`, then just start Bochs as normal. Bochs will stop and wait for GDB to connect to the stub.

## Running GDB

Bochs GDB stub waits for a connection on TCP port 1234. Just start GDB like this:

      $ gdb YOUR-KERNEL
      .
      .
      .
      (gdb) target remote localhost:1234
      Remote debugging using localhost:1234
      0x0000fff0 in ?? ()
      (gdb)

You are now connected to the remote GDB stub in Bochs. You are now able to set breakpoints. Use the continue (c) command to continue the simulation. Hitting ^C works. Example:

      Program received signal 0, Signal 0.
      syscall_testsuite_result (aux=0x1f11fe4) at ../rtmk/syscalls.c:33
      33     {
      (gdb)

<<< Previous | Home | Next >>>
Using Bochs internal debugger | Up | Using the serial port