module ZJIT

This module allows for introspection of ZJIT, CRuby’s just-in-time compiler. Everything in the module is highly implementation specific and the API might be less stable compared to the standard library.

This module may not exist if ZJIT does not support the particular platform for which CRuby is built.

Public Class Methods

enabled? ()

Source

# File zjit.rb, line 18
def enabled?
  Primitive.cexpr! 'RBOOL(rb_zjit_enabled_p)'
end

Check if ZJIT is enabled

stats (key = nil)

Source

# File zjit.rb, line 28
def stats(key = nil)
  stats = Primitive.rb_zjit_stats(key)
  return stats if stats.nil? || !key.nil?

  if stats.key?(:vm_insns_count) && stats.key?(:zjit_insns_count)
    stats[:total_insns_count] = stats[:vm_insns_count] + stats[:zjit_insns_count]
    stats[:ratio_in_zjit] = 100.0 * stats[:zjit_insns_count] / stats[:total_insns_count]
  end

  stats
end

Return ZJIT statistics as a Hash

stats_enabled? ()

Source

# File zjit.rb, line 23
def stats_enabled?
  Primitive.rb_zjit_stats_enabled_p
end

Check if ‘–zjit-stats` is used

stats_string ()

Source

# File zjit.rb, line 41
def stats_string
  buf = +''
  stats = self.stats

  [
    :compile_time_ns,
    :profile_time_ns,
    :gc_time_ns,
    :invalidation_time_ns,
    :total_insns_count,
    :vm_insns_count,
    :zjit_insns_count,
    :ratio_in_zjit,
  ].each do |key|
    # Some stats like vm_insns_count and ratio_in_zjit are not supported on the release build
    next unless stats.key?(key)
    value = stats[key]

    case key
    when :ratio_in_zjit
      value = '%0.1f%%' % value
    when /_time_ns\z/
      key = key.to_s.sub(/_time_ns\z/, '_time')
      value = "#{number_with_delimiter(value / 10**6)}ms"
    else
      value = number_with_delimiter(value)
    end

    buf << "#{'%-18s' % "#{key}:"} #{value}\n"
  end
  buf
end

Get the summary of ZJIT statistics as a String