REPOSITORY OVERVIEW

Live repository statistics

★ 393Stars

⑂ 49Forks

◯ 13Open issues

◉ 393Watchers

README preview

IDA SDK

A Software Development Kit for extending IDA, the state-of-the-art binary code analysis tool. The C++ SDK allows you to build custom plugins, loaders, processors, and scripts that integrate directly into IDA. This project also includes IDAPython SDK allowing you to write plugins using Python.

Documentation

IDA Documentation
C++ Developer’s Guide
SDK reference
Additional README files in subdirectories provide details for processor modules, loaders, and other components.

Contributing

The SDK is currently closed to external contributions, as it requires tight integration with our proprietary IDA Pro workflows and follows an internal roadmap with specific architectural decisions.

However, feel free to report bugs or suggest features via Issues.

Versioning

Git tags use semver-compatible syntax to track both IDA product releases and independent SDK updates:

Tag pattern	Meaning
`vX.Y.Z-release`	SDK snapshot shipped with an IDA release
`vX.Y.Z-sdk.N`	SDK-only update between IDA releases (build system, docs, examples, etc.)

X.Y.Z matches the IDA version that the SDK targets. The pre-release suffix distinguishes the type of change:

-release marks the exact SDK state shipped with a given IDA version.
-sdk.N marks subsequent SDK improvements that still target the same IDA version. N increments with each update.

Sort order. Semver compares pre-release identifiers lexically, so -release sorts before -sdk.N (r < s), which gives the correct chronological order:

v9.3.0-release        ← IDA 9.3.0 ships, SDK updated to match
v9.2.0-sdk.2          ← second SDK-only update for IDA 9.2.0
v9.2.0-sdk.1          ← first SDK-only update (e.g., CMake support added)
v9.2.0-release        ← IDA 9.2.0 ships (initial commit)

Note: In strict semver, a pre-release version (e.g., v9.3.0-release) has lower precedence than the corresponding normal version (v9.3.0). Since this repository never publishes bare vX.Y.Z tags, the ordering among tagged versions is unambiguous and correct.

Requirements

To build:

CMake 3.25 or later
C++ compiler that fully supports C++17 compatible with your platform:
- GCC or LLVM/Clang (Linux/macOS)
- Microsoft Visual C++ (MSVC) 2022 or later (Windows)

To use the SDK:

IDA 9.2

Repository fundamentals

src/module/ — Processor modules
src/ldr/ — Loader modules
src/include/ — Core IDA SDK headers
src/lib/ — Stub libraries for linking against IDA kernel
src/dbg/ — Debugger server integration
src/bin/ — Build helpers & binaries
src/idalib/ — IDA as a library examples
src/plugins/ — Sample plugin modules (including IDAPython)

Getting Started

CMake is the supported build system for the IDA SDK.

To install the project on your local machine, refer to the instructions in src/readme.txt. Additional README files in subdirectories provide more details about:

Processor module templates
Loaders
Other components

Building

Basic build:

Linux/macOS/Windows:

cd src/
cmake -B build -G Ninja
cmake --build build

Generator choice (use Ninja). Ninja is the recommended generator on every platform, including Windows. It is a single-config generator: the build type is fixed at configure time (this SDK defaults CMAKE_BUILD_TYPE to Release), and build outputs land directly in bin/plugins, bin/procs, etc. On Windows, run the configure/build from a Visual Studio Developer Command Prompt (or any shell where cl.exe is on PATH); the SDK also auto-detects MSVC via cmake/find_msvc.cmake.

Known issue - the default "Visual Studio" generator. If you omit -G on Windows, CMake picks the multi-config Visual Studio generator, which behaves differently and is not recommended for this SDK:

It ignores CMAKE_BUILD_TYPE; you must pass --config Release at build time. Without it the build defaults to Debug, whose debug-CRT objects (/MDd, _ITERATOR_DEBUG_LEVEL=2) fail to link against the Release-only stub libs shipped in src/lib/ (LNK2038 / LNK1120, __imp__CrtDbgReport).

Even with --config Release, it nests outputs under a per-config subfolder (bin/plugins/Release/...) instead of bin/plugins/..., which can confuse tooling and scripts that expect the flat layout.

Both problems disappear with -G Ninja.

Presets (optional): src/CMakePresets.json defines ready-made configurations:

Preset	Description
`native`	Full SDK build (host arch, 64-bit address space)
`dbgserver`	Debug server only (host arch, 64-bit address space)
`dbgserver-ea32`	Debug server only (32-bit address space)
`arm`	Cross-compile to ARM (from x64 Linux/Windows host)
`x64`	Cross-compile to x64 (from ARM macOS host)
`arm-dbgserver`	Debug server only, ARM target (64-bit address space)
`x64-dbgserver`	Debug server only, x64 target (64-bit address space)
`x64-dbgserver-ea32`	Debug server only, x64 target (32-bit address space)

Each preset is only offered when its host condition matches, so unavailable cross-compile presets are hidden on the current host.

cd src/
cmake --preset dbgserver
cmake --build --preset dbgserver

The cross-compile toolchains live under src/cmake/toolchains/. Targeting ARM Linux from an x64 Linux host additionally needs an aarch64 sysroot, for example:

cd src/
cmake --preset arm -DCMAKE_SYSROOT=/usr/aarch64-linux-gnu
cmake --build --preset arm

Qt samples. The Qt-based samples (such as plugins/qwindow) call find_package(Qt6 ...) and are built only when a matching Qt6 is discoverable through the usual CMake mechanisms (CMAKE_PREFIX_PATH, Qt6_DIR, or a system install). If no Qt6 is found the target is skipped silently - the rest of the build is unaffected.

Cross-compiling Qt plugins does not work out of the box: Qt's build tools (moc, rcc, uic) must run on the build host, so a target-only Qt in the sysroot is not enough - you also need a host Qt of the same version, pointed to with QT_HOST_PATH:

cd src/
cmake --preset arm -DCMAKE_SYSROOT=$HOME/arm64-cr-sysroot \
      -DQT_HOST_PATH=/path/to/host/Qt/6.8.0/<host-arch>
cmake --build --preset arm

If you do not need the Qt samples, skip them entirely instead with -DIDACMAKE_SKIP_QT=ON:

cd src/
cmake --preset arm -DCMAKE_SYSROOT=$HOME/arm64-cr-sysroot -DIDACMAKE_SKIP_QT=ON
cmake --build --preset arm

Build options can be passed with -D, for example -DIDA_WARNINGS=all (one of none, default, all), or -DIDA_BUILD_IDA=OFF -DIDA_BUILD_DBGSRV=ON to build only the debugger server tree. The CMake package and its options live under src/cmake/ (entry point src/cmake/idasdkConfig.cmake).

Building your own plugin, loader, or processor module

The build API - ida_add_plugin, ida_add_loader, ida_add_procmod, ida_add_idalib - is the same whether you build inside the SDK tree or from a separate project of your own. Choose whichever fits your workflow.

1. In-tree (alongside the bundled examples).

Put your sources in a folder under the matching example tree and add a CMakeLists.txt next to them. For a plugin in src/plugins/myplugin/:

# src/plugins/myplugin/CMakeLists.txt
ida_add_plugin(myplugin SOURCES myplugin.cpp)

Then register that folder by adding one line to the parent listfile, src/plugins/CMakeLists.txt:

add_subdirectory(myplugin)

Loaders live under src/ldr/ and processor modules under src/module/, each registered the same way from the respective parent CMakeLists.txt. A regular SDK build then picks the new component up automatically.

2. Out-of-tree, using the init helper (recommended).

Keep your component in its own repository/folder and point it at an SDK checkout. Include idasdk_init.cmake before project() - it resolves the SDK location, makes find_package(idasdk) reachable, and preselects MSVC on Windows (so no Developer Command Prompt is required):

cmake_minimum_required(VERSION 3.25)

include("$ENV{IDASDK}/src/cmake/idasdk_init.cmake")  # before project()

project(myplugin CXX)
find_package(idasdk REQUIRED)

ida_add_plugin(myplugin SOURCES myplugin.cpp)

Build it with IDASDK pointing at your SDK checkout (the directory that contains src/):

IDASDK=/path/to/ida-sdk cmake -B build -G Ninja
cmake --build build

By default the result is written to $IDASDK/bin/{plugins,loaders,procs}. To direct it elsewhere, set IDABIN (environment variable or -DIDABIN=/your/out).

3. Out-of-tree, using find_package directly.

If you would rather not use the init helper, add the package directory to CMAKE_PREFIX_PATH yourself. In this form MSVC must already be configured in the shell (e.g. a Visual Studio Developer Command Prompt) on Windows:

cmake_minimum_required(VERSION 3.25)
project(myplugin CXX)

list(PREPEND CMAKE_PREFIX_PATH "$ENV{IDASDK}/src/cmake")
find_package(idasdk REQUIRED)

ida_add_plugin(myplugin SOURCES myplugin.cpp)

Run

Depending on your build process, some binaries in src/bin may run out of the box. Others may need to be moved to your IDA installation directory.

To use custom-built plugins, you must place them in a location recognized by IDA. You can do this in one of the following ways:

Copy plugins manually

Copy the contents of src/bin/plugins/ to:
- ~/.idapro/plugins/ on Linux/macOS
- %APPDATA%\Hex-Rays\IDA Pro\plugins\ on Windows
Be careful not to overwrite existing plugins.
Use the IDAUSR environment variable

Set or extend the IDAUSR environment variable to include the src/bin path.
Install directly to the IDA directory

Copy the contents of src/bin/plugins/ to <your IDA installation>/plugins/. Be cautious about overwriting existing files.

For more details, see the Getting Started Documentation.

Build Documentation

To build the documentation locally:

Install Tools

macOS

brew install doxygen graphviz

Linux (Debian/Ubuntu)

sudo apt install doxygen graphviz

Windows

Download Doxygen installer from doxygen.nl.
Install Graphviz separately and add it to PATH.

Building Documentation

From docs folder:

doxygen Doxyfile

Output will appear in:

docs/build/

Online Documentation

The latest documentation is available at: https://cpp.docs.hex-rays.com/

Related Projects

Python SDK

The following previous IDAPython repositories have now been archived and moved into this project IDAPython:

For more information, refer to the IDAPython documentation

Support

For commercial support or licensing inquiries, contact: support@hex-rays.com

For community help, visit: IDA Users Forum

License

This project is licensed un

ALGORITHMICALLY RELATED

Similar Open-Source Projects

Selected from shared topics, language and repository description—not editorial ratings.

X-TOOL-S /

crispy-winner

★ 25

# Git Credential Manager [![Build Status](https://github.com/GitCredentialManager/git-credential-manager/actions/workflows/continuous-integration.yml/badge.svg)](https://github.com/GitCredentialManager/git-credential-manager/actions/workflows/continuous-integration.yml) --- [Git Credential Manager](https://github.com/GitCredentialManager/git-credential-manager) (GCM) is a secure Git credential helper built on [.NET](https://dotnet.microsoft.com) that runs on Windows, macOS, and Linux. Compared to Git's [built-in credential helpers]((https://git-scm.com/book/en/v2/Git-Tools-Credential-Storage)) (Windows: wincred, macOS: osxkeychain, Linux: gnome-keyring/libsecret) which provides single-factor authentication support working on any HTTP-enabled Git repository, GCM provides multi-factor authentication support for [Azure DevOps](https://dev.azure.com/), Azure DevOps Server (formerly Team Foundation Server), GitHub, Bitbucket, and GitLab. Git Credential Manager (GCM) replaces the .NET Framework-based [Git Credential Manager for Windows](https://github.com/microsoft/Git-Credential-Manager-for-Windows) (GCM), and the Java-based [Git Credential Manager for Mac and Linux](https://github.com/microsoft/Git-Credential-Manager-for-Mac-and-Linux) (Java GCM), providing a consistent authentication experience across all platforms. ## Current status Git Credential Manager is currently available for Windows, macOS, and Linux\*. GCM only works with HTTP(S) remotes; you can still use Git with SSH: - [Azure DevOps SSH](https://docs.microsoft.com/en-us/azure/devops/repos/git/use-ssh-keys-to-authenticate?view=azure-devops) - [GitHub SSH](https://help.github.com/en/articles/connecting-to-github-with-ssh) - [Bitbucket SSH](https://confluence.atlassian.com/bitbucket/ssh-keys-935365775.html) Feature|Windows|macOS|Linux -|:-:|:-:|:-: Installer/uninstaller|✓|✓|✓\* Secure platform credential storage|✓ [(see more)](docs/credstores.md)|✓ [(see more)](docs/credstores.md)|✓ [(see more)](docs/credstores.md) Multi-factor authentication support for Azure DevOps|✓|✓|✓ Two-factor authentication support for GitHub|✓|✓|✓ Two-factor authentication support for Bitbucket|✓|✓|✓ Two-factor authentication support for GitLab|✓|✓|✓ Windows Integrated Authentication (NTLM/Kerberos) support|✓|_N/A_|_N/A_ Basic HTTP authentication support|✓|✓|✓ Proxy support|✓|✓|✓ `amd64` support|✓|✓|✓ `x86` support|✓|_N/A_|✗ `arm64` support|best effort|via Rosetta 2|best effort, no packages `armhf` support|_N/A_|_N/A_|best effort, no packages (\*) GCM guarantees support for the below Linux distributions. GCM maintainers also monitor and evaluate issues opened against other distributions to determine community interest/engagement and whether an emerging platform should become fully-supported. - Debian/Ubuntu/Linux Mint - Fedora/CentOS/RHEL - Alpine ## Download and Install ### macOS Homebrew The preferred installation mechanism is using Homebrew; we offer a Cask in our custom Tap. To install, run the following: ```shell brew tap microsoft/git brew install --cask git-credential-manager-core ``` After installing you can stay up-to-date with new releases by running: ```shell brew upgrade git-credential-manager-core ``` #### Git Credential Manager for Mac and Linux (Java-based GCM) If you have an existing installation of the 'Java GCM' on macOS and you have installed this using Homebrew, this installation will be unlinked (`brew unlink git-credential-manager`) when GCM is installed. #### Uninstall To uninstall, run the following: ```shell brew uninstall --cask git-credential-manager-core ``` --- ### macOS Package We also provide a [.pkg installer](https://github.com/GitCredentialManager/git-credential-manager/releases/latest) with each release. To install, double-click the installation package and follow the instructions presented. #### Uninstall To uninstall, run the following: ```shell sudo /usr/local/share/gcm-core/uninstall.sh ``` ---   <a name="linux-install-instructions"></a> ### Linux #### Experimental: install from source helper script If you would like to help dogfood our new install from source helper script, run the following: 1. To ensure `curl` is installed: ```shell curl --version ``` If `curl` is not installed, please use your distribution's package manager to install it. 1. To download and run the script: ```shell curl -LO https://raw.githubusercontent.com/GitCredentialManager/git-credential-manager/main/src/linux/Packaging.Linux/install-from-source.sh && sh ./install-from-source.sh && git-credential-manager-core configure ``` **Note:** You will be prompted to enter your credentials so that the script can download GCM's dependencies using your distribution's package manager. #### Ubuntu/Debian distributions Download the latest [.deb package](https://github.com/GitCredentialManager/git-credential-manager/releases/latest), and run the following: ```shell sudo dpkg -i <path-to-package> git-credential-manager-core configure ``` **Note:** Although packages were previously offered on certain [Microsoft Ubuntu package feeds](https://packages.microsoft.com/repos/), GCM no longer publishes to these repositories. Please install the Debian package using the above instructions instead. To uninstall: ```shell git-credential-manager-core unconfigure sudo dpkg -r gcmcore ``` #### Other distributions Download the latest [tarball](https://github.com/GitCredentialManager/git-credential-manager/releases/latest), and run the following: ```shell tar -xvf <path-to-tarball> -C /usr/local/bin git-credential-manager-core configure ``` To uninstall: ```shell git-credential-manager-core unconfigure rm $(command -v git-credential-manager-core) ``` **Note:** all Linux distributions [require additional configuration](https://aka.ms/gcm/credstores) to use GCM. --- ### Windows GCM is included with [Git for Windows](https://gitforwindows.org/), and the latest version is included in each new Git for Windows release. This is the preferred way to install GCM on Windows. During installation you will be asked to select a credential helper, with GCM being set as the default. ![image](https://user-images.githubusercontent.com/5658207/140082529-1ac133c1-0922-4a24-af03-067e27b3988b.png) #### Standalone installation You can also download the [latest installer](https://github.com/GitCredentialManager/git-credential-manager/releases/latest) for Windows to install GCM standalone. **:warning: Important :warning:** Installing GCM as a standalone package on Windows will forcibly override the version of GCM that is bundled with Git for Windows, **even if the version bundled with Git for Windows is a later version**. There are two flavors of standalone installation on Windows: - User (preferred) (`gcmcoreuser-win*`): Does not require administrator rights. Will install only for the current user and updates only the current user's Git configuration. - System (`gcmcore-win*`): Requires administrator rights. Will install for all users on the system and update the system-wide Git configuration. To install, double-click the desired installation package and follow the instructions presented. #### Uninstall (Windows 10) To uninstall, open the Settings app and navigate to the Apps section. Select "Git Credential Manager" and click "Uninstall". #### Uninstall (Windows 7-8.1) To uninstall, open Control Panel and navigate to the Programs and Features screen. Select "Git Credential Manager" and click "Remove". #### Windows Subsystem for Linux (WSL) Git Credential Manager can be used with the [Windows Subsystem for Linux (WSL)](https://aka.ms/wsl) to enable secure authentication of your remote Git repositories from inside of WSL. [Please see the GCM on WSL docs](docs/wsl.md) for more information. ## Supported Git versions Git Credential Manager tries to be compatible with the broadest set of Git versions (within reason). However there are some know problematic releases of Git that are not compatible. - Git 1.x The initial major version of Git is not supported or tested with GCM. - Git 2.26.2 This version of Git introduced a breaking change with parsing credential configuration that GCM relies on. This issue was fixed in commit [`12294990`](https://github.com/git/git/commit/12294990c90e043862be9eb7eb22c3784b526340) of the Git project, and released in Git 2.27.0. ## How to use Once it's installed and configured, Git Credential Manager is called implicitly by Git. You don't have to do anything special, and GCM isn't intended to be called directly by the user. For example, when pushing (`git push`) to [Azure DevOps](https://dev.azure.com), [Bitbucket](https://bitbucket.org), or [GitHub](https://github.com), a window will automatically open and walk you through the sign-in process. (This process will look slightly different for each Git host, and even in some cases, whether you've connected to an on-premises or cloud-hosted Git host.) Later Git commands in the same repository will re-use existing credentials or tokens that GCM has stored for as long as they're valid. Read full command line usage [here](docs/usage.md). ### Configuring a proxy See detailed information [here](https://aka.ms/gcm/httpproxy). ## Additional Resources - [Frequently asked questions](docs/faq.md) - [Development and debugging](docs/development.md) - [Command-line usage](docs/usage.md) - [Configuration options](docs/configuration.md) - [Environment variables](docs/environment.md) - [Enterprise configuration](docs/enterprise-config.md) - [Network and HTTP configuration](docs/netconfig.md) - [Credential stores](docs/credstores.md) - [Architectural overview](docs/architecture.md) - [Host provider specification](docs/hostprovider.md) - [Azure Repos OAuth tokens](docs/azrepos-users-and-tokens.md) - [GitLab support](docs/gitlab.md) ## Experimental Features - [Windows broker (experimental)](docs/windows-broker.md) ## Contributing This project welcomes contributions and suggestions. See the [contributing guide](CONTRIBUTING.md) to get started. This project follows [GitHub's Open Source Code of Conduct](CODE_OF_CONDUCT.md). ## License We're [MIT](LICENSE) licensed. When using GitHub logos, please be sure to follow the [GitHub logo guidelines](https://github.com/logos).

ida-sdk