https://github.com/wjp/idados

Eric Fry's IDA/DOSBox debugger plugin
https://github.com/wjp/idados

Last synced: 8 days ago
JSON representation

Eric Fry's IDA/DOSBox debugger plugin

• Host: GitHub
• URL: https://github.com/wjp/idados
• Owner: wjp
• Created: 2013-01-29T19:33:57.000Z (almost 12 years ago)
• Default Branch: master
• Last Pushed: 2016-03-07T19:32:45.000Z (over 8 years ago)
• Last Synced: 2024-10-31T22:24:20.417Z (15 days ago)
• Language: C++
• Size: 90.8 KB
• Stars: 131
• Watchers: 20
• Forks: 26
• Open Issues: 4
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# IDA DOSBox debugger plugin

## Authors

* Eric Fry 

* Willem Jan Palenstijn 

## Getting started

1. Download the IDA SDK.

1. Download the plugin source from https://github.com/wjp/idados.

1. Download the patched DOSBox source from the 'idados' branch of https://github.com/wjp/dosbox.

1. Build the plugin and DOSBox as described in the [BUILD.md](./BUILD.md) file.

## Usage

1. Load the executable you are debugging into IDA in the usual manner.

1. Configure DOSBox with `core=normal`.

1. Run DOSBox and mount disks, etc. in the usual manner.

1. In DOSBox, run the binary you want to debug, prefixed with `debug`.

   e.g. `debug sierra.exe`. DOSBox will pause here while waiting for a

   connection from IDA.

1. In IDA, start the debugger, selecting the "Remote DOSBox" debugger.

   You should be able to leave the connection options at their defaults.

   The binary and arguments are ignored.

## Notes

This plugin has not been tested on many platforms, but it has been reported to

work with 32-bit IDA 6.9 Starter, on 32-bit Windows (using [MSYS2](http://msys2.github.io/)),

64-bit Linux, and 64-bit Mac OS X.

The debugger plugin will rebase the program to match the memory location

in DOSBox, but there have been many bugs with this in older versions of IDA.

If this is causing problems, try manually rebasing before starting the debugger,

or even recreating the database at the right offset.

There is a known bug with breakpoints on the program entry point. As a

workaround, you can use the "Suspend on debugging start" option in IDA if you

wish to break on starting the process. Breakpoints at other locations should

work fine.

With a 32-bit IDA, you will have to build a 32-bit dosbox, even on 64-bit

platforms.

And finally, patches to improve the plugin are most welcome!