libgoblin

正しい言葉を言いましょう

Goblinはrustc 1.85.0（Rust 2024エディション）を必要とします。

Cargo.tomlに追加してください。

[dependencies]
goblin = "0.10"

libgoblinは、バイナリの解析、読み込み、分析のためのワンストップショップを目指しています。

Goblinは主に以下の重要なユースケースをサポートしています。

コア、std不要の#[repr(C)]構造体、コンパイル時間が短く、32ビット/64ビット（または両方）を自由に選択可能。
型の弄り（type punning）。ある型に対して一度関数を定義すれば、32ビットでも64ビットでも動作します – ほとんど何も変更する必要はなく、マクロも不要です！基本的な例についてはexamples/automagic.rsを参照してください。
stdモード。PreadやPwriteによる読み取り・書き込み実装、ファイルからの読み込み、便利なアロケーション、追加メソッドなどを追加します。これは、アロケーションが可能で、ディスクからバイナリを読み込みたいクライアント向けです。
Endian_fd。本当にひどい名前ですね 😆 これは、panopticonやfalconのようなバイナリ分析ツールで必要な、異なるエンディアンのバイナリを読み取るため、またはクロスプラットフォームな異種アーキテクチャのbinutils（例：cargo-symやbingrepが簡単な例）を構築するための基盤として使用します。可能性は無限大です。

このクレートを使ってできること（または実装を手伝えばできるようになること）の例：

コンパイラを作成し、それを使ってバイナリを生成する（すべての生のC構造体はPwriteを派生しています）。
panopticonやfalconのようなバイナリ分析ツールを作成し、さまざまなバイナリ形式をロード、解析、分析する。
半機能的な動的リンカを作成する。
カーネルを作成し、no_std cfgを使用してバイナリをロードする。つまり、基本的に構造体と定数の定義（Cヘッダーのようなもの）だけで、fdも出力もstdも不要。
bin2jsonツールを作成する。なぜバイナリ形式をJSONにしないのか？

libgoblinは、高度に設定可能になるように設計されています。現在のフラグは次のとおりです。

メンテナー

メンテナーは、各バックエンドの最初の連絡先レビュアーです。過去のコントリビューション、活動性、基礎知識、そして友好的で社交的な振る舞いに基づいて選ばれます :D

現在、私（@m4b）だけがすべてのPRに対するマージ権限を持っています。将来的には、各バックエンドのメンテナーもマージ権限を持つ可能性があります。

最後に、私はすべてのPRに一応のレビューを行うでしょうが、ほとんど/完全にそのバックエンドのメンテナーに任せることになります。

そして、ビルとテッドの知恵を常に忘れないでください：「お互いに素晴らしくあろう！」

皆さん、ありがとうございます ❤️ !

アルファベット順：

特に明示されていない限り、あなたのコントリビューションは添付のLICENSEファイル（MIT）に記載された条件でライセンスされることに同意したものとみなします。

コミットには影響を受けるバイナリコンポーネントを接頭辞として付けてください。具体的であればあるほど良いです。例えば、elfモジュールのリロケーションのみを変更した場合は、"elf.reloc: added new constants for Z80"のようにしてください。
コミットメッセージは変更内容を説明する必要があります。"changed"や"fix"のような汎用的なものは避けてください。このようなコミットをPRにプッシュした場合、@m4bまたは誰かが squash する可能性が高いです。
モジュールに大きな変更を加える場合は、まず issue を立てて議論してください。技術的に良い方向でなければ、あなたの時間を無駄にしたくありません。
PRが注目されていない場合は、PRに上がったすべての関連コメントに返信し、それでも返事がない場合は、GitHubで@m4bに ping するか、遠慮なく@m4bにメールしてください。
新しい機能を追加する場合は、テストを追加してください。そうでない場合でも、テストを追加することは歓迎します。テストは素晴らしく、Rustでは簡単です。