Skip to content


Repository Info

This project is hosted on GitHub at

Build Status

Windows Linux macOS
Build status Travis-CI Status Travis-CI Status

Debugging Guest Code

  • QEMU can host a gdb stub! Launch with -s -S, and with gdb run target remote localhost:1234
    • Protip: You can also attach to it with IDA if you're so inclined. You can then load in a database if you export it as a IDC script!
  • XQEMU can emulate a XDK serial port (which with a debug bios hosts KD, as in this and this)! Launch with something like -device lpc47m157 -serial unix:/tmp/xserial,server. With some effort you can wrestle the unix socket into a vm for with WinDbg. There's also a very barebones perl KD client in scripts/windpl
  • apitrace is useful for tracking down rendering bugs.

Debugging XQEMU Itself

Depending on the task at hand, it may be necessary to debug XQEMU itself.


The Visual Studio Code IDE can be used to launch and debug XQEMU. A sample launch.vs.json file which can be used to launch XQEMU from code can be found here.


Using Xcode

Create a project, edit the "Scheme" to run the xqemu binary, then click the run button. Xcode has a nice GUI for analyzing the stack frame and looking at local variables to quickly track down bugs. You can also attach to running processes.


GDB works of course. Eclipse can also be used for those wanting a graphical source-level debugging solution.