Emulation/Cxbx-Reloaded
1
0
Fork 0
mirror of https://github.com/Cxbx-Reloaded/Cxbx-Reloaded.git synced 2025-04-02 11:11:52 -04:00
Code Issues Projects Releases Packages Wiki Activity
Cxbx-Reloaded/src/CxbxDebugger/README.md
x1nixmzeng 875e4fcd2f Updated debugger goals
2018-04-19 00:45:49 +01:00

1.7 KiB
Raw Permalink Blame History

CxbxDebugger

CxbxDebugger is an experimental tool to aid debugging Xbox executables from within Cxbx.

Cxbx-Debugger screenshot at breakpoint

Cxbx-Debugger screenshot at memory editor

The goal is to resolve XBE symbols using the function signatures identified by Cxbx-Reloaded.

This is a workaround for patching or creating PDB files at runtime for Cxbx-Reloaded (where the memory region is pre-allocated - see virtual_memory_placeholder). However, in future it may be viable to supporting loading symbols from matching PDB files.

Methods

The debugger is a standalone C# application which wraps the child instance of Cxbx-Reloaded used to launch the XBE file.

It uses the debugger API provided by Windows, primarily WaitForDebugEvent and ContinueDebugEvent. The C# implementation is taken from the VsChromium project.

Roadmap

Primary

  • Create wrapper for the Cxbx-Reloaded child process
  • Support new threads
  • Support displaying of interrupts and exceptions
  • Support resolving relevant XBE symbols from a callstack

Secondary

  • Suspending threads and checking memory
  • Breakpoints - inserting and handling interrupts

Thanks