diff --git a/Child-Process-Debugging.md b/Child-Process-Debugging.md index c1ec7cb..b869a25 100644 --- a/Child-Process-Debugging.md +++ b/Child-Process-Debugging.md @@ -1,6 +1,5 @@ # Child Process Debugging - -Cxbx is currently engineering a way to run a new instance of itself as a child process. +Cxbx-Reloaded is currently engineering a way to run a new instance of itself as a child process. For development, it is strongly recommended you install [Microsoft Child Process Debugging Power Tool](https://marketplace.visualstudio.com/items?itemName=GreggMiskelly.MicrosoftChildProcessDebuggingPowerTool) to support child process debugging from within Visual Studio. @@ -9,9 +8,7 @@ Once setup, the extension attaches automatically. It supports all the standard IDE features **but will not detect symbols inside XBE memory regions,** instead mapping to the `virtual_memory_placeholder` placeholder stub. You will still see callstacks, though. ## Setup - Install the extensions. You will need to close down any open Visual Studio instances first. - 1. Open the Cxbx-Reloaded project file 2. Open the new configuration window from `Debug -> Other Debug Targets -> Child Process Debugging Settings` 3. From here, check `Enable child process debugging` @@ -22,7 +19,6 @@ Install the extensions. You will need to close down any open Visual Studio insta You only need to do this once. ## Usage - Once emulation has started, Visual Studio will list two `Cxbx.exe` processes on the toolbar You can reshow this toolbar by checking `View -> Toolbars -> Debug Location`) @@ -31,13 +27,11 @@ The emulated process will have two threads named **Cxbx NV2A VBLANK**, and **Cxb ## Cxbx Debugger Workflow - The Cxbx-Reloaded project includes a basic debugger written in C# to support extra Xbox-specific emulation features in addition to debugging the child process. **Only one user-mode debugger can be attached to a process at one time.** With the Child Process extension, you will need to: - 1. Open the Cxbx-Reloaded project file 2. Open the new configuration window from `Debug -> Other Debug Targets -> Child Process Debugging Settings` 3. From here, disable Child Process Debugging on `Cxbx.exe` @@ -46,4 +40,4 @@ With the Child Process extension, you will need to: 6. Set `Debugger Type` as `Managed (v4.6, v4.5, v4.0)` 7. Make sure `Persist settings to` is set to `Hidden solution user options file (SUO file)` and hit Save (top right) -You only need to do this once. \ No newline at end of file +You only need to do this once.