module RubyVM::YJIT

要約

YJIT (Yet Another Ruby JIT) の制御・情報取得のためのモジュールです。

YJIT は CRuby に組み込まれた JIT (Just-in-time compiler) コンパイラで、 Ruby 3.1 で実験的機能として導入されました([feature#18229])。 Ruby 3.2 で「実験的」の位置づけが外れ、Ruby 3.3 では実行時に有効化する RubyVM::YJIT.enable が追加されるなど、以降のバージョンでも統計収集(--yjit-stats)やコンパイルログ(--yjit-log)まわりの機能追加が続いています。

有効化するには以下のいずれかの方法を使います。

* コマンドラインオプション --yjit * 環境変数 RUBY_YJIT_ENABLE * (Ruby 3.3 以降) RubyVM::YJIT.enable による実行時の有効化

このモジュールは、YJIT が対応していないプラットフォームでは定義されないことがあります。

なお、Ruby 4.0 で導入された新しい JIT コンパイラである ZJIT は RubyVM::ZJIT という別のモジュールで提供されており、 RubyVM::YJIT とは別物です。

目次

特異メソッド

• code_gc
• dump_exit_locations
• enable
• enabled?
• reset_stats!
• runtime_stats
• stats_enabled?
• stats_string

特異メソッド

code_gc -> nilRuby 3.2 から[permalink][rdoc][edit]

コンパイル済みのコードを破棄してメモリを解放します。以降、必要に応じて再度コンパイルが行われます。

dump_exit_locations(filename) -> IntegerRuby 3.2 から[permalink][rdoc][edit]

--yjit-trace-exits を指定して収集した、サイドイグジット(exit)が発生した位置の情報を Marshal 形式で filename にダンプします。ダンプしたファイルは Stackprof で読み込んで解析できます。

[PARAM] filename:

ダンプ先のファイル名。

[RETURN]

ファイルに書き込んだバイト数を返します。

[EXCEPTION] ArgumentError:

--yjit-trace-exits が有効になっていない場合に発生します。

enable(stats: false) -> boolRuby 3.3 から[permalink][rdoc][edit]

実行時に YJIT を有効化します。

[PARAM] stats:

統計収集の設定です。false なら収集しません。true なら収集し、終了時に結果を表示します。:quiet なら収集しますが、終了時には表示しません。

[RETURN]

有効化したときは true を返します。すでに YJIT が有効な場合は false を返します。

RubyVM::YJIT.enable # => true

JIT の有効・無効はビルドオプションや実行環境に依存するため、実行結果は環境によって異なります。

[SEE_ALSO] RubyVM::YJIT.enabled?

enabled? -> boolRuby 3.1 から[permalink][rdoc][edit]

YJIT が有効かどうかを返します。

RubyVM::YJIT.enabled? # => false

JIT の有効・無効はコマンドラインオプションや環境変数など実行環境に依存するため、実行結果は環境によって異なります。

[SEE_ALSO] RubyVM::YJIT.enable

reset_stats! -> nilRuby 3.1 から[permalink][rdoc][edit]

--yjit-stats で収集した統計情報を破棄します。

[SEE_ALSO] RubyVM::YJIT.runtime_stats, RubyVM::YJIT.stats_enabled?

runtime_stats(context: false) -> Hash | nilRuby 3.1 から[permalink][rdoc][edit]

--yjit-stats コマンドラインオプションを指定して収集した統計情報を返します。

[PARAM] context:

true を指定すると、コンパイルコンテキストに関する統計も含めます。

[RETURN]

統計情報のハッシュを返します。統計収集が無効な場合は nil を返します。

統計情報の内容(キー)はバージョンによって増減します。詳細はビルド時の設定やコマンドラインオプションに依存するため、本ページでは個々のキーの説明は省略します。

[SEE_ALSO] RubyVM::YJIT.stats_enabled?, RubyVM::YJIT.reset_stats!

stats_enabled? -> boolRuby 3.1 から[permalink][rdoc][edit]

--yjit-stats が指定されているなど、統計情報の収集が有効かどうかを返します。

[SEE_ALSO] RubyVM::YJIT.runtime_stats, RubyVM::YJIT.reset_stats!, RubyVM::YJIT.enable

stats_string -> StringRuby 3.3 から[permalink][rdoc][edit]

RubyVM::YJIT.runtime_stats の内容を人が読める形式に整形した文字列を返します。 --yjit-stats が有効なとき以外は空文字列を返します。

[SEE_ALSO] RubyVM::YJIT.runtime_stats