IDAPython project for Hex-Ray's IDA Pro
Go to file
elias.bachaalany 8e78513e91 - minor code cleanup
- updated CHANGES.txt
- nalt.i: forgot to release reference for callback result (in py_import_enum_cb())
2010-03-05 11:35:28 +00:00
docs Initial SVN commit of version 0.9.54 sources. 2007-10-20 07:03:51 +00:00
examples Added import enumeration support. Check exmples\ex_imports.py 2010-03-05 11:18:25 +00:00
python - minor code cleanup 2010-03-05 11:35:28 +00:00
swig - minor code cleanup 2010-03-05 11:35:28 +00:00
tools Added small script to generate function cross reference with epydoc 2008-06-25 21:03:38 +00:00
basetsd.h Initial SVN commit of version 0.9.54 sources. 2007-10-20 07:03:51 +00:00
build.py Added import enumeration support. Check exmples\ex_imports.py 2010-03-05 11:18:25 +00:00
BUILDING.txt Added import enumeration support. Check exmples\ex_imports.py 2010-03-05 11:18:25 +00:00
CHANGES.txt - minor code cleanup 2010-03-05 11:35:28 +00:00
COPYING.txt Updated year in copyright strings 2009-04-26 18:28:59 +00:00
python.cpp bugfix: IDAPython_extlang_create_object may cause exceptions to be reported to the running Python script if called with an invalid object name 2010-02-12 13:16:37 +00:00
pywraps.hpp - some code cleanup 2010-03-05 11:16:27 +00:00
README.txt IDAPython 1.3.0 / IDA Pro 5.6 2010-01-05 18:24:04 +00:00
STATUS.txt graph.i: added graph support (works only with the GUI version) 2009-10-02 17:40:26 +00:00

----------------------------------------------------------
IDAPython - Python plugin for Interactive Disassembler Pro
----------------------------------------------------------

WHAT IS IDAPTYHON?
------------------

IDAPython is an IDA plugin which makes it possible to write scripts
for IDA in the Python programming language. IDAPython provides full
access to both the IDA API and any installed Python module.

Check the scripts in the examples directory to get an quick glimpse.


AVAILABILITY
------------

Latest stable versions of IDAPython are available from
  http://www.d-dome.net/idapython/

Development builds are available from
  http://code.google.com/p/idapython/


RESOURCES
---------

The full function cross-reference is readable online at
  http://www.d-dome.net/idapython/reference/

Bugs and enhancement requests should be submitted to
  http://code.google.com/p/idapython/issues/list

Mailing list for the project is hosted by Google Groups at
  http://groups.google.com/group/idapython


INSTALLATION FROM BINARIES
--------------------------

1, Install Python 2.5 or 2.6 from http://www.python.org/
2, Copy the python and python64 directories to the IDA install directory
3. Copy the plugins to the %IDADIR%\plugins\


USAGE
-----

The plugin has three hotkeys: 

 - Run script (Alt-9)
 - Execute Python statement(s) (Alt-8)
 - Run previously executed script again (Alt-7)

Batch mode execution:

Start IDA with the following command line options:

 -A -OIDAPython:yourscript.py file_to_work_on

If you want fully unattended execution mode, make sure your script
exits with a qexit() call.

By default scripts run after the database is opened. Extended option
format is:

  -OIDAPython:[N;]script.py

Where N can be:
  0: run script after opening database (default)
  1: run script when UI is ready
  2: run script immediately on plugin load (shortly after IDA starts and before processor modules and loaders)

User init file:

You can place your custom settings to a file called 'idapythonrc.py'
that should be placed to 

${HOME}/.idapro/

or 

%AppData%\Hex-Rays\IDA Pro

The user init file is read and executed at the end of the init process.