Whale コマンドリファレンス

Whaleビルド

Whaleリポジトリで以下を実行します。

cargo build --release

最上位の実行可能ファイルには4つのコマンドシリーズがあります。

whale asm [--amd64 | --aarch64] <input> -o <output>
whale object <input> -o <output>
whale ir <subcommand> [options]

AMD64 assembler

whale asm --amd64 input.asm -o output.o

AMD64 assembler は .o パスを出力として受け取り、section、symbol、および relocation を含む ELF64 relocatable オブジェクトを作成します。

詳細診断出力は--debug-whaleでオンにします。

whale asm --amd64 input.asm -o output.o \
  --debug-whale --token --ast --bytes --dump-hex --stats

診断フラグには--token、--ast、--bytes、--dump-hex、--dump-bin、--dump-json、--statsがあります。 --traceは処理プロセスを出力します。

Object wrapper

whale object input.bin -o output.o

object コマンドは、生のバイトを ELF64 .text セクションに配置し、グローバル start シンボルをオフセット 0 に追加します。生のマシン コードを ELF オブジェクト ファイルにラップします。

オプション IR socket

irコマンドは、Whaleをsocket-cli機能と共にビルドした場合にのみ含まれます。

cargo run -p whale --features socket-cli -- ir lower program.json
cargo run -p whale --features socket-cli -- ir lower program.json -o program.wir

ir lowerはWhalesocketschemaのJSONを読み、WhaleIRテキストIRはstdoutまたは-oパスに出力されます。 --target <triple>はターゲット文字列を置き換え、--no-verifyは検証を省略します。

IRコマンドを使用するには、Whaleをsocket-cli機能と共にビルドする必要があります。 SocketJSON生産者とWhaleは同じsocketschemaversionを使用する必要があります。