From 6ad067a4a55af953416abdf818ee055a494f0073 Mon Sep 17 00:00:00 2001 From: Xusheng Date: Tue, 29 Oct 2024 17:22:18 +0800 Subject: [PATCH] Update docs on WinDbg/TTD installation. Fix https://github.com/Vector35/debugger/issues/642 --- docs/guide/dbgeng-ttd.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/docs/guide/dbgeng-ttd.md b/docs/guide/dbgeng-ttd.md index 781ceb0..c5adfb3 100644 --- a/docs/guide/dbgeng-ttd.md +++ b/docs/guide/dbgeng-ttd.md @@ -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 @@ -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