Skip to content

Commit

Permalink
Update docs on WinDbg/TTD installation. Fix Vector35#642
Browse files Browse the repository at this point in the history
  • Loading branch information
xusheng6 committed Oct 29, 2024
1 parent 514dd1c commit 6ad067a
Showing 1 changed file with 7 additions and 2 deletions.
9 changes: 7 additions & 2 deletions docs/guide/dbgeng-ttd.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,9 @@ Below is a guide to set it up.
There are two ways to install and configure WinDbg to be used by Binary Ninja debugger.
We recommend you to try the first method first.
If it does not work, for example if your machine cannot connect to the Internet, you can follow the second method to set it up manually.

The free version currently does not support installing WinDbg automatically. It needs to be installed manually.

The WinDbg installation only needs to be done once.

### Install WinDbg Automatically
Expand All @@ -30,14 +33,16 @@ The WinDbg installation only needs to be done once.
- Download https://aka.ms/windbg/download
- Open the downloaded AppInstaller file in a text editor. It is an XML file, and look for the download URL of the WinDbg MSIX bundle in it
- The download URL should look like https://windbg.download.prss.microsoft.com/dbazure/prod/1-2402-24001-0/windbg.msixbundle
- Download the MSIX bundle using the URL found in the above step (this can take longer)
- Download the MSIX bundle using the URL found in the above step (this can take a while to finish)
- The downloaded MSIX bundle is a Zip archive. Extract it with a tool like 7Zip
- Find the `windbg_win7-x64.msix` in it. Again it is a Zip archive, extract it
- Find the path of the DbgEng DLLs you have extracted
- It should be inside the `amd64` folder of where you extracted the `windbg_win7-x64.msix`
- For example, it can be `C:\Users\XXXXX\Downloads\windbg\windbg_win7-x64\amd64`
- There should be an x64 version of `dbgeng.dll` in it
- In Binary Ninja, set `debugger.x64dbgEngPath` to the DbgEng DLL path in the last step
- In Binary Ninja, open the Settings view via the menu `Edit`->`Settings`, or use the shortcut (Ctrl+,)
- Search for `debugger.x64dbgEngPath`, and set it to the folder that the DbgEng DLL is in in the last step
(do NOT include the DLL itself in the path!)
- Restart Binary Ninja


Expand Down

0 comments on commit 6ad067a

Please sign in to comment.