модуль RubyVM::YJIT

# File yjit.rb, line 237
def self.code_gc
  Primitive.rb_yjit_code_gc
end

Удалить существующий скомпилированный код для освобождения памяти и последующей возможности повторной компиляции.

# File yjit.rb, line 160
def self.dump_exit_locations(filename)
  unless trace_exit_locations_enabled?
    raise ArgumentError, "--yjit-trace-exits must be enabled to use dump_exit_locations."
  end

  File.binwrite(filename, Marshal.dump(RubyVM::YJIT.exit_locations))
end

Marshal записывает места выхода в указанный файл.

Использование:

Если --yjit-exit-locations передано, автоматически будет сгенерирован файл с именем «yjit_exit_locations.dump».

Если необходимо собирать трассировки вручную, вызовите dump_exit_locations напрямую.

Обратите внимание, что при вызове из скрипта статистические данные будут сгенерированы после создания дампа, поэтому данные статистики могут включать выходы из самого дампа.

В вызове из скрипта:

at_exit do
  RubyVM::YJIT.dump_exit_locations("my_file.dump")
end

Затем запустите файл с указанными параметрами:

ruby --yjit --yjit-trace-exits test.rb

После завершения работы кода используйте Stackprof для чтения файла дампа. См. документацию Stackprof для опций.

# File yjit.rb, line 47
def self.enable(stats: false, log: false)
  return false if enabled?
  at_exit { print_and_dump_stats } if stats
  call_yjit_hooks
  Primitive.rb_yjit_enable(stats, stats != :quiet, log, log != :quiet)
end

Включить компиляцию YJIT. stats параметр определяет, включить ли статистику YJIT. compilation_log определяет, включить ли ведение журнала компиляции YJIT.

• stats:

  • false: Не включать статистику.

  • true: Включить статистику. Вывести статистику при выходе.

  • :quiet: Включить статистику. Не выводить статистику при выходе.

• log:

  • false: Не включать журнал.

  • true: Включить журнал. Вывести журнал при выходе.

  • :quiet: Включить журнал. Не выводить журнал при выходе.

# File yjit.rb, line 12
def self.enabled?
  Primitive.cexpr! 'RBOOL(rb_yjit_enabled_p)'
end

Проверить, включена ли YJIT.

# File yjit.rb, line 190
def self.log
  return nil unless log_enabled?

  Primitive.rb_yjit_get_log.map do |timestamp, path|
    [Time.at(timestamp), path]
  end
end

Возвращает массив записей журнала. Возвращает nil при отсутствии или непередаче параметра.

# File yjit.rb, line 22
def self.log_enabled?
  Primitive.rb_yjit_log_enabled_p
end

Проверить, используется ли --yjit-log.

# File yjit.rb, line 32
def self.reset_stats!
  Primitive.rb_yjit_reset_stats_bang
end

Сбросить статистические данные, собранные для --yjit-stats.

# File yjit.rb, line 172
def self.runtime_stats(key = nil)
  raise TypeError, "non-symbol given" unless key.nil? || Symbol === key

  Primitive.rb_yjit_get_stats(key)
end

Возвращает хеш со статистикой, сгенерированной для параметра командной строки --yjit-stats. Возвращает nil, если параметр не передан или недоступен. Если в качестве аргумента передано символ, возвращает только значение для заданной статистики. Если предоставлен аргумент другого типа, генерирует исключение TypeError.

# File yjit.rb, line 17
def self.stats_enabled?
  Primitive.rb_yjit_stats_enabled_p
end

Проверяет, используется ли --yjit-stats.

# File yjit.rb, line 180
def self.stats_string
  # Lazily require StringIO to avoid breaking miniruby
  require 'stringio'
  strio = StringIO.new
  _print_stats(out: strio)
  strio.string
end

Форматирует и выводит счётчики в виде String. Возвращает непустой результат только при включенном --yjit-stats.