binexportダウンロードbinexportソースコードのダウンロード

binexport

その他のカテゴリー

BinExport 12 (Updated for Ghidra 11.0.3)

ダウンロード

Binexport

免責事項：これは公式のGoogle製品（実験的またはその他）ではなく、Googleが所有するのは単なるコードです。

導入

BinexportはBindiffの輸出要素です。これは、分解データをBindiffが要求するプロトコルバッファー形式にエクスポートするThe Resassemblers Ida Pro、Binary Ninja、およびGhidraのプラグイン/拡張機能です。

オープンソースソフトウェアリバースエンジニアリングスイートGhidraの実験バージョンはjava/BinExportディレクトリで入手できます。

このリポジトリには、Linux、MacOS、およびWindows用のBinexportプラグインバイナリを構築するために必要な完全なソースコードが含まれています。

インストール

Ida Pro

リリースページからバイナリをダウンロードして、IDA Proプラグインディレクトリにコピーします。これらはデフォルトのパスです。

OS	プラグインパス
Linux	`/opt/idapro-8.2/plugins`
macos	`/Applications/IDA Pro 8.2/idabin/plugins`
Windows	`%ProgramFiles%IDA 8.2plugins`

現在のユーザーのためだけにインストールするには、代わりにこれらのディレクトリのいずれかにファイルをコピーします。

OS	プラグイン
Linux/macos	`~/.idapro/plugins`
Windows	`%AppData%Hex-RaysIDA Proplugins`

インストールバージョンの確認

IDAでは、 Helpを選択します| About programm...
Addons...
正しくインストールすると、次のダイアログボックスが表示されます。

バイナリニンジャ

リリースページからバイナリをダウンロードして、バイナリニンジャプラグインディレクトリにコピーします。これらは、現在のユーザーのデフォルトパスです。

OS	プラグインパス
Linux	`~/.binaryninja/plugins`
macos	`~/Library/Application Support/Binary Ninja/plugins/`
Windows	`%AppData%Binary Ninjaplugins`

インストールバージョンの確認

バイナリニンジャを開始します
Logネイティブドックを選択します。これが見えない場合は、 Viewで有効にしてください| Native Docks | Show Log 。
正しくインストールした場合、ログウィンドウにはこれに似た行が含まれています。

 BinExport 12 (@internal, Jan 3 2023), (c)2004-2011 zynamics GmbH, (c)2011-2024 Google LLC.

ギドラ

リリースページからバイナリをダウンロードします。
Ghidraを起動し、 Fileを選択します| Install Extensions...
[拡張機能をインストール]ダイアログで、右上のプラスアイコンをクリックして「拡張機能を追加」します。
[拡張子の選択]ダイアログで、ステップ1でダウンロードしたghidra_BinExport.zipへのパスを入力し、 OKをクリックします。
OKを2回クリックして、「インストール拡張機能」ダイアログとGhidraを再起動する通知の両方を閉じます。
Ghidraを終了します。

インストールバージョンの確認

Ghidraを始めます
File ] |を選択しますInstall Extensions...
正しくインストールした場合、「拡張機能のインストール」ダイアログには、選択したチェックボックスの横にある「Binexport」拡張機能をリストする必要があります。

使用法

主なユースケースはBindiff経由です。ただし、Binexportを使用して、分解を異なる形式にエクスポートすることもできます。

プロトコルバッファベースの完全なエクスポート
統計テキストファイル
デバッグ用のテキスト形式

Ida Pro

IDA Proデータベースを開きます
Edit |を選択しますPlugins | BinExport 12
次のダイアログボックスが表示されます。
エクスポートするファイルのタイプを選択します

IDCスクリプト

Binexportプラグインは、以下のIDC関数を登録します。

IDC関数名	への輸出	議論
binexportbinary	プロトコルバッファー	ファイル名
binexporttext	テキストファイルダンプ	ファイル名
BinexportStatistics	統計テキストファイル	ファイル名

または、メイン関数を直接呼び出すことにより、プラグインをIDCから呼び出すことができます。

 static main () {
  batch ( 0 );
  auto_wait ();
  load_and_run_plugin ( "binexport12_ida" , 2 /* kBinary */ );
  qexit ( 0 );
}

これにより、出力ファイル名に対する制御が提供されることに注意してください。 Binexportは、常に現在ロードされているデータベースのファイル名（拡張機能なし）を使用し、「.binexport」を追加します。

idapython

引数はIDCの場合と同じです（上記のリスト）。

登録されているIDC関数の1つの例の例：

 import idaapi
idaapi . ida_expr . eval_idc_expr ( None , ida_idaapi . BADADDR ,
  'BinExportBinary("exported.BinExport");' )

プラグインオプション

Binexportは、IDAのコマンドラインで指定できる次のプラグインオプションを定義します。

オプション	説明
`-OBinExportAutoAction:<ACTION>`	Binexport IDC関数を呼び出して終了します
`-OBinExportModule:<PARAM>`	`BinExportAutoAction`の議論
`-OBinExportLogFile:<FILE>`	ファイルへのログメッセージ
`-OBinExportAlsoLogToStdErr:TRUE`	指定されている場合は、標準エラーにもログを記録します
`-OBinExportX86NoReturnHeuristic:TRUE`	x86固有のヒューリスティックを有効にして、非復帰関数を識別します

注：これらのオプションは、ファイルの前に来る必要があります。

バイナリニンジャ

現時点では、バイナリニンジャUIへの統合は最小限だけです。

新しい分析データベースを開くか作成します
Toolsを選択| Plugins | BinExport 。これにより、エクスポートプロセスが開始されます。

.BinExportファイルは、同じディレクトリに分析データベースの横に配置されます。

ギドラ

プロジェクトを開くか作成します。新しいプロジェクトの場合、 Fileを使用してファイルを最初にインポートします| Import File...
現在のプロジェクトリストのファイルを右クリックし、[コンテキスト]メニューからExport...を選択します。
「エクスポート」ダイアログの「フォーマット」の下で、「Bindiffのバイナリエクスポート（V2）」を選択します。
「出力ファイル」の下に、目的の出力ファイルパスを入力します。ファイル拡張機能が欠落している場合、 .BinExport自動的に追加されます。
オプション：「オプション...」をクリックして、追加のエクスポートオプションを設定します。
「OK」をクリックしてから、「OK」をもう一度クリックして、「結果の概要」ダイアログを却下します。

スクリプト

BinExport.java Ghidraスクリプトは、ヘッドレスモードとGUIモードの両方で実行できます。 GUIモードでは、Script ManagerのBinExportカテゴリで利用できます。ヘッドレスモードの場合、次のコンテンツを含むBinExport.propertiesファイル（使用するオプションに応じて）を使用できます。

 Choose export file Export = test.BinExport
Choose options IDA Pro Compatibility = "Subtract Imagebase;Remap mnemonics;Prepend Namespace to Function Names"

ヘッドレスモードでの使用例

プロジェクトを作成し、バイナリをインポートして分析します。

 $ ./analyzeHeadless <project_location> <project_name> -import <file>

BinExport.propertiesで指定された.BinExportファイルを生成するBinExport.javaを実行します。

 $ ./analyzeHeadless <project_location> <project_name> -process <file> -propertiesPath <path> -preScript BinExport.java -noanalysis

または、 BinExport.propertiesの代わりにコマンドライン引数を使用します。

 $ ./analyzeHeadless <project_location> <project_name> -process <file> -preScript BinExport.java test.BinExport "Prepend Namespace to Function Names" -noanalysis

構築方法

以下は、IDA Proおよびバイナリニンジャのネイティブコードプラグインのビルド手順です。 Ghidra用のJavaベースの拡張機能を構築するには、Ghidraの指示についてはBinexportを参照してください。

ビルド環境の準備

満たすべき依存関係がかなりあります。

ブースト1.83.0以上（ boost_partsの1.83.0船の部分コピー）
Cmake 3.14以降
提案：スピーディなビルドのニンジャ
GCC 9またはLinux/macosのClangの最近のバージョン。 Windowsでは、Visual Studio 2019コンパイラとWindows SDKをWindows 10に使用します。
GIT 1.8以降
IDA Proのみ：IDA SDK 8.2以降（ third_party/idasdkに編集）
ダウンロードされる依存関係：
- Abseil、GoogleTest、およびプロトコルバッファー（25.2）
- バイナリ忍者SDK

Linux

前提条件

好ましいビルド環境はDebian 11（「Bullseye」）です。

これにより、必要なすべてのパッケージをインストールする必要があります。

sudo apt update -qq
sudo apt install -qq --no-install-recommends build-essential

cmakeの最新の安定バージョンをインストールしてください：

wget https://github.com/Kitware/CMake/releases/download/v3.25.1/cmake-3.25.1-linux-x86_64.sh
mkdir ${HOME} /cmake
sh cmake-3.25.1-Linux-x86_64.sh --prefix= ${HOME} /cmake --exclude-subdir
export PATH= ${HOME} /cmake/bin: ${PATH}

次のセクションでは、現在の作業ディレクトリがクローンリポジトリのルートにあると想定しています。

Ida SDK

IDA SDKのコンテンツをthird_party/idasdkに解凍します。表示されているコマンドはIDA Pro 8.2用です。

unzip PATH/TO/idasdk_pro82.zip -d third_party/idasdk
mv third_party/idasdk/idasdk_pro82/ * third_party/idasdk
rmdir third_party/idasdk/idasdk_pro82

Binexportを構築します

すべての前提条件を設定して、Binexportを構成および構築し、テストを実行します。

mkdir -p build_linux && cd build_linux
cmake .. 
    -G Ninja 
    -DCMAKE_BUILD_TYPE=Release 
    " -DCMAKE_INSTALL_PREFIX= ${PWD} " 
    -DBINEXPORT_ENABLE_IDAPRO=ON 
    " -DIdaSdk_ROOT_DIR= ${PWD} /../third_party/idasdk " 
    -DBINEXPORT_ENABLE_BINARYNINJA=ON 
cmake --build . --config Release
ctest --build-config Release --output-on-failure
cmake --install . --config Release --strip

注：忍者を使用して実際のビルドを実行したくない場合は、 -G Ninjaパーツを省略します。

IDA Pro Buildを無効にするには、 -DBINEXPORT_ENABLE_IDAPRO=OFF setを設定します。同様に、バイナリNinja Buildを無効にするには、 -DBINEXPORT_ENABLE_BINARYNINJA=OFF set set -dbinexport_enable_binaryninja = set。

これにより、Abseil、Googletest、プロトコルバッファ、およびバイナリNinja APIをダウンロードして構築します。すべてがうまくいった場合、 build_linux/binexport-prefixディレクトリには、2つのファイルbinexport12_ida.soとbinexport12_ida64.so （それぞれidaとida64で使用します）とbinexport12_binaryninja.so （binary ninja）を含む必要があります。

macos

前提条件

好ましいビルド環境は、Xcode 15.1を使用したMacOS 13 "Ventura"です。 MacOS 12 "Monterey"を使用することも機能するはずです。

開発者ツールをインストールした後、コマンドラインツールもインストールしてください。

sudo xcode-select --install

次のセクションでは、現在の作業ディレクトリがクローンリポジトリのルートにあると想定しています。

cmake

公式サイトからcmakeの最新の安定したバージョンをダウンロードし、そのディスク画像をマウントします。

curl -fsSL https://github.com/Kitware/CMake/releases/download/v3.25.1/cmake-3.25.1-Darwin-x86_64.dmg 
    -o $HOME /Downloads/cmake-osx.dmg
hdiutil attach $HOME /Downloads/cmake-osx.dmg

この時点で、Cmakeのライセンス契約を確認して受け入れる必要があります。 cmakeをインストールします：

sudo cp -Rf /Volumes/cmake-3.25.1-Darwin-x86_64/CMake.app /Applications/
hdiutil detach /Volumes/cmake-3.25.1-Darwin-x86_64
sudo /Applications/CMake.app/Contents/bin/cmake-gui --install

最後のコマンドでは、システムパスでcmakeを利用可能にします。

Ida SDK

IDA SDKのコンテンツをthird_party/idasdkに解凍します。表示されているコマンドはIDA Pro 8.2用です。

unzip PATH/TO/idasdk_pro82.zip -d third_party/idasdk
mv third_party/idasdk/idasdk_pro82/ * third_party/idasdk
rmdir third_party/idasdk/idasdk_pro82

Binexportを構築します

すべての前提条件を設定して、Binexportを構成および構築し、テストを実行します。

mkdir -p build_mac && cd build_mac
cmake .. 
    -DCMAKE_BUILD_TYPE=Release 
    " -DCMAKE_INSTALL_PREFIX= ${PWD} " 
    -DBINEXPORT_ENABLE_IDAPRO=ON 
    " -DIdaSdk_ROOT_DIR= ${PWD} /../third_party/idasdk " 
    -DBINEXPORT_ENABLE_BINARYNINJA=ON 
cmake --build . --config Release -- " -j $( sysctl -n hw.logicalcpu ) "
ctest --build-config Release --output-on-failure
cmake --install . --config Release --strip

注：これは、標準のcmake「makefileジェネレーター」を使用します。 XcodeまたはNinjaを発電機としても使用できます。

IDA Pro Buildを無効にするには、 -DBINEXPORT_ENABLE_IDAPRO=OFF setを設定します。同様に、バイナリNinja Buildを無効にするには、 -DBINEXPORT_ENABLE_BINARYNINJA=OFF set set -dbinexport_enable_binaryninja = set。

これにより、Abseil、Googletest、プロトコルバッファ、およびバイナリNinja APIをダウンロードして構築します。すべてがうまくいった場合、 build_mac/binexport-prefixディレクトリには、2つのファイルを含む必要がありますbinexport12_ida.dylibとbinexport12_ida64.dylib （それぞれidaおよびida64で使用するため）とbinexport12_binaryninja.dylib （binary ninjaの場合）。

Windows

好ましいビルド環境は、Visual Studio 2022コンパイラとWindows 10用のWindows SDKを使用したWindows 10（64ビットIntel）です。

cmake

ダウンロードページから最新のstable cmake（執筆時点で3.25.1）をダウンロードしてインストールします。「すべてのユーザーのシステムパスにcmakeを追加する」を選択してください。

git

ダウンロードページからgitをダウンロードしてインストールします。次のオプションを選択してください。 *インストールディレクトリは、デフォルトの%ProgramFiles%Gitbingit.exe * "Windowsコマンドプロンプトからgitを使用します" - セットアップユーティリティをシステムパスに追加する必要があります。 *「Windowsのデフォルトコンソールウィンドウを使用」 - 通常のコマンドプロンプトからGitを使用できるように。

準備する

次のセクションでは、クローン化されたBinexportリポジトリのルートにある現在の作業ディレクトリを備えたオープンコマンドプロンプトを想定しています。

git clone https://github.com/google/binexport.git
cd binexport

Ida SDK

IDA SDKのコンテンツをthird_party/idasdkに解凍します。表示されているコマンドは、Gitが最初にデフォルトディレクトリにインストールされたと仮定して、IDA Pro 8.2のものです。

 " %ProgramFiles% Gitusrbinunzip " PATHTOidasdk_pro82.zip -d third_party
rename third_partyidasdk_pro82 idasdk

Binexportを構築します

すべての前提条件が整っていると、Binexportを構成して構築します。

 if not exist build_msvc mkdir build_msvc
cd build_msvc
cmake .. ^
    -G " Visual Studio 17 2022 " ^
    -DCMAKE_BUILD_TYPE=Release ^
    " -DCMAKE_INSTALL_PREFIX= %cd% " ^
    -DBINEXPORT_ENABLE_IDAPRO=ON ^
    -DIdaSdk_ROOT_DIR= %cd% ..third_partyidasdk ^
    -DBINEXPORT_ENABLE_BINARYNINJA=ON
cmake --build . --config Release -- /m /clp:NoSummary;ForceNoAlign /v:minimal
ctest --build-config Release --output-on-failure
cmake --install . --config Release --strip

注：これは、Cmakeの「Visual Studio」ジェネレーターを使用します。忍者ジェネレーターも使用できます。

IDA Pro Buildを無効にするには、 -DBINEXPORT_ENABLE_IDAPRO=OFF setを設定します。同様に、バイナリNinja Buildを無効にするには、 -DBINEXPORT_ENABLE_BINARYNINJA=OFF set set -dbinexport_enable_binaryninja = set。

これにより、Abseil、Googletest、プロトコルバッファ、およびバイナリNinja APIをダウンロードして構築します。すべてがうまくいった場合、 build_msvc/binexport-prefixディレクトリには、2つのファイルbinexport12_ida.dllとbinexport12_ida64.dll （それぞれida.exeおよびida64.exeで使用して） binexport12_binaryninja.dll含む必要があります。

拡大する

追加情報