windbg2ida (New Version 1.1.2 - 31 Aug 2019)
Windbg2ida lets you dump each step in Windbg then shows these steps in IDA Windbg2ida - Windbg and IDA plugin
Shows every steps of Windbg in IDA :)
Introduction to Windbg2ida
Windbg2ida lets you dump each step (instruction) in Windbg then give you a dump file and you can use it later in your IDA to put color on each line of the instructions that you've run to show code coverage.
You can use Windbg2ida to see differences between two or more code coverages in IDA.
How to use?
- Load Script
Download windbg2ida from here or use git to download files.
git clone https://github.com/SinaKarvandi/windbg2ida.git
Open Windbg and load windbg2ida.js script (replace path with your computer path to windbg2ida.js)
.load jsprovider.dll
.scriptload "C:\\Users\\Sina\\Desktop\\windbg2ida\\windbg2ida.js"
Important note : If you can't load the script or the script gives you error about using files then make sure to update you windbg (Windows SDK) to the latest version as the previous versions have problem with using file with JavaScript.
- Examples
- The simplest example is execute until the return of current function. (replace the path to save the dump)
!windbg2ida\_run\_until\_ret "c:\\\\users\\\\sina\\\\desktop\\\\dump1.w2i"
- If you wanna run a specific number of instructions (e.g 100 instruction). (replace the path to save the dump)
!windbg2ida\_run\_with\_limitation 100,"c:\\\\users\\\\sina\\\\desktop\\\\dump1.w2i"
- If you want to execute until a specific address is executed. (replace the path to save the dump and the address(es))
!windbg2ida\_run\_until\_address "fffff80617bc4622,fffff80617bc4628,fffff80617bc462a" ,"c:\\\\users\\\\sina\\\\desktop\\\\dump1.w2i"
- If you want to execute until a specific address is executed or if windbg reaches to the return of current function. (replace the path to save the dump and the address(es))
!windbg2ida\_run\_until\_address\_or\_return "fffff80617bc4622","c:\\\\users\\\\sina\\\\desktop\\\\dump1.w2i"
- Show Dump in IDA
Now in order to use your dump file(s), copy them into "w2i Files" folder next to IDAScript.py, goto IDA > File > Script file... > select IDAScript.py.
Each time you run IDAScript.py all the .w2i files in the "w2i Files" graphs are colorized in IDA. You can see "Output Window" for more details (e.g functions that changed their colors).
- Configuration
- Change the color of code coverage graph. (Change the hex number of color). This option is special useful when you want to compare two or more dumps.
!windbg2ida\_set\_color 0x36AC29
- Disable Step in into function calls.
!windbg2ida\_disable\_stepin
- Disable registers in comment of IDA.
!windbg2ida\_disable\_registers\_in\_comment
For more information about other configs use the !windbg2ida to see the help.
- Unload Script
To unload the windbg2ida.js (replace path with your computer path to windbg2ida.js)
.scriptunload "C:\\Users\\Sina\\Desktop\\windbg2ida\\windbg2ida.js"
Pictures
Demo
Windbg2ida Help
kd> !windbg2ida
------------------------------------------------------------------
- Usage :
These commands show how you can use Windbg2IDA.
- !windbg2ida_run_until_ret [FileToSaveDump]
Description : Run the program until it reaches to the ret instruction of current function.
+ [FileToSaveDump] : The path to save the dump which can be use later by IDA.
e.g : !windbg2ida_run_until_ret "c:\\users\\sina\\desktop\\dump1.w2i"
- !windbg2ida_run_with_limitation [LimitCount],[FileToSaveDump]
Description : Run a specific number of instructions.
+ [FileToSaveDump] : The path to save the dump which can be use later by IDA.
+ [LimitCount] : Count of instructions to be execute.
e.g : !windbg2ida_run_with_limitation 100,"c:\\users\\sina\\desktop\\dump1.w2i"
run 100 instructions and save the results into c:\users\sina\desktop\dump1.w2i
- !windbg2ida_run_until_address [Address(es)],[FileToSaveDump]
Description : Run until the program reaches to the specific address(es).
+ [FileToSaveDump] : The path to save the dump which can be use later by IDA.
+ [Address(es)] : Address(es) to stop execution.
e.g : !windbg2ida_run_until_address "fffff80617bc4622","c:\\users\\sina\\desktop\\dump1.w2i"
run until the program reaches to fffff806`17bc4622 and then save the dump into c:\users\sina\desktop\dump1.w2i
e.g : !windbg2ida_run_until_address "fffff80617bc4622,fffff80617bc4628,fffff80617bc462a","c:\\users\\sina\\desktop\\dump1.w2i"
run until the program reaches to fffff80617bc4622 or fffff80617bc4628 or fffff80617bc462a
then save the dump into c:\users\sina\desktop\dump1.w2i
- !windbg2ida_run_until_address_or_return [Address(es)],[FileToSaveDump]
Description : Run until the program reaches to the specific address(es) or reaches to the return of the current function.
+ [FileToSaveDump] : The path to save the dump which can be use later by IDA.
+ [Address(es)] : Address(es) to stop execution.
e.g : !windbg2ida_run_until_address_or_return "fffff80617bc4622","c:\\users\\sina\\desktop\\dump1.w2i"
run until the program reaches to fffff806`17bc4622 or return of the current function
and then save the dump into c:\users\sina\desktop\dump1.w2i
e.g : !windbg2ida_run_until_address_or_return "fffff80617bc4622,fffff80617bc4628,fffff80617bc462a","c:\\users\\sina\\desktop\\dump1.w2i"
run until the program reaches to fffff80617bc4622 or fffff80617bc4628 or fffff80617bc462a
or return of the current function then save the dump into c:\users\sina\desktop\dump1.w2i
------------------------------------------------------------------
- Load and Unload :
If you need to load or unload the script, use the following commands.
- .scriptload LocationOfWindbg2ida.js
Description : Loads the windbg2ida script (You've already loaded ;) .
e.g : .scriptload c:\windbg2ida.js
- .scriptunload LocationOfWindbg2ida.js
Description : Unloads the windbg2ida script.
e.g : .scriptunload c:\windbg2ida.js
------------------------------------------------------------------
- Configuration :
If you need to enable or disable any of the features you can use
the following commands. (otherwise leave it alone with default configuration).
- !windbg2ida_set_color [ColorHex]
Description : Set the color of current dump in IDA.
+ [ColorHex] : Color in hex.
e.g : !windbg2ida_set_color 0xFF0004
Turns coverage color to red.
e.g : !windbg2ida_set_color 0x36AC29
Turns coverage color to green.
e.g : !windbg2ida_set_color 0x1628AC
Turns coverage color to blue.
e.g : !windbg2ida_set_color 0xFF0FE0
Turns coverage color to pink.
- !windbg2ida_enable_stepin
Description : Enables Step In in execution of each instruction.
If you need the current function and also need the other functions
that the current function calls then use this command (Enabled By Default).
- !windbg2ida_disable_stepin
Description : Disable Step In in execution of each instruction.
If you only need the current function and don't need other functions
that the current function calls then use this command.
- !windbg2ida_enable_registers_in_comment
Description : Enables showing of register(s) in IDA instructions comment.
Note that it might remove your comments (Enabled By Default).
- !windbg2ida_disable_registers_in_comment
Description : Disables showing of register(s) in IDA instructions comment.
- !windbg2ida_enable_branch_status
Description : Enables IDA comments with [Branch is taken] or [Branch is not taken].
If you want to see these statement then use this option (Enabled By Default).
Note : It won't work if you use !windbg2ida_disable_registers_in_comment
- !windbg2ida_disable_branch_status
Description : Disables IDA comments with [Branch is taken] or [Branch is not taken].
If you don't want to see these statement then use this option.
- !windbg2ida_enable_eflags_in_comment
Description : Enables showing of [EFLAGS] in IDA comments.
- !windbg2ida_disable_eflags_in_comment
Description : Disables showing of [EFLAGS] in IDA comments. (Enabled By Default)
- !windbg2ida_enable_memory_in_comment
Description : Enables showing of Memory addresses and Contents.
Works on mov instructions (Enabled By Default).
- !windbg2ida_disable_memory_in_comment
Description : Disables showing of Memory addresses and Contents.
------------------------------------------------------------------
- Help :
- !windbg2ida
Description : Shows this help.
------------------------------------------------------------------
Features
Current features :
- Comparing two or more code coverage files simultaneously
- Works on both x64 and x86 version of Windbg
- Show registers for each instruction
- Show memorry contents for each instruction
- Both User-mode and Kernel-mode Compatible
- Use dump files offline without need to re-run in Windbg
- Show other modules and invalid addresses
- etc.
What's new? (v1.0.0.0)
- Add comparing for two or more files
- Add read from folders
- Add registers + eflag read
- Add branch status show
What's new? (v1.1.2.0)
- Fix MOVxx bug as some moves memory didn't show
- IDA reports functions in order of execution
- Some calls are not executed (fixed)
Todo
- Add Pause when a special value detected for a register
- Add Pause when a special memory address used in program flow
Latest News
First Version Released
Aug 21st, 2019
First Version Released
Aug 31, 2019
Version 1.1.2
Similar Projects
- ret-sync
- Another Windbg2ida for 32bit only
- Ablation
- Integrating WinDbg and IDA for Improved Code Flow Analysis
Contribution
Windbg2ida is maintained by Sina Karvandi, you can find me in Twitter . If you see any problem or if you need a new feature you can use Issues on GitHub.
Any Contribution is appreciated.
Windbg2ida is under GPLv3
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent