Package ghidra.pcode.emu.jit

Record Class JitConfiguration

java.lang.Object
java.lang.Record
ghidra.pcode.emu.jit.JitConfiguration
Record Components:
maxPassageInstructions - The (soft) maximum number of instructions to decode per translated passage. A passage can consist of several control-flow connected basic blocks. The decoder will decode contiguous streams of instructions with fall-through (called strides), adding seeds where it encounters branches. It will not stop mid-stride, but checks the instruction count before proceeding to another seed. If it exceeds the max, it stops.
maxPassageOps - The (soft) maximum number of p-code ops. This is similar to maxPassageInstructions, but limits the number of p-code ops generated. NOTE: The JVM limits each method to 65,535 total bytes of bytecode. If this limit is exceeded, the ASM library throws an exception. When this happens, the compiler will retry the whole process, but with this configuration parameter halved.
maxPassageStrides - The maximum number of strides to include.
removeUnusedOperations - See JitConfiguration.Opt.REMOVE_UNUSED_OPERATIONS
emitCounters - See JitConfiguration.Opt.EMIT_COUNTERS
logStackTraces - See JitConfiguration.Opt.LOG_STACK_TRACES
public record JitConfiguration(int maxPassageInstructions, int maxPassageOps, int maxPassageStrides, boolean removeUnusedOperations, boolean emitCounters, boolean logStackTraces) extends Record
The configuration for a JIT-accelerated emulator.

  • Constructor Details

    • JitConfiguration

      public JitConfiguration()
      Construct a default configuration

    • JitConfiguration

      public JitConfiguration(Set<JitConfiguration.Opt> opts)
      Construct a configuration with default maxes and the given boolean options
      Parameters:
      opts - the options

    • JitConfiguration

      public JitConfiguration(JitConfiguration.Opt... opts)
      Construct a configuration with default maxes and the given boolean options
      Parameters:
      opts - the options

    • JitConfiguration

      public JitConfiguration(int maxPassageInstructions, int maxPassageOps, int maxPassageStrides, boolean removeUnusedOperations, boolean emitCounters, boolean logStackTraces)
      Creates an instance of a JitConfiguration record class.
      Parameters:
      maxPassageInstructions - the value for the maxPassageInstructions record component
      maxPassageOps - the value for the maxPassageOps record component
      maxPassageStrides - the value for the maxPassageStrides record component
      removeUnusedOperations - the value for the removeUnusedOperations record component
      emitCounters - the value for the emitCounters record component
      logStackTraces - the value for the logStackTraces record component

  • Method Details

    • toString

      public final String toString()
      Returns a string representation of this record class. The representation contains the name of the class, followed by the name and value of each of the record components.
      Specified by:
      toString in class Record
      Returns:
      a string representation of this object

    • hashCode

      public final int hashCode()
      Returns a hash code value for this object. The value is derived from the hash code of each of the record components.
      Specified by:
      hashCode in class Record
      Returns:
      a hash code value for this object

    • equals

      public final boolean equals(Object o)
      Indicates whether some other object is "equal to" this one. The objects are equal if the other object is of the same class and if all the record components are equal. All components in this record class are compared with '=='.
      Specified by:
      equals in class Record
      Parameters:
      o - the object with which to compare
      Returns:
      true if this object is the same as the o argument; false otherwise.

    • maxPassageInstructions

      public int maxPassageInstructions()
      Returns the value of the maxPassageInstructions record component.
      Returns:
      the value of the maxPassageInstructions record component

    • maxPassageOps

      public int maxPassageOps()
      Returns the value of the maxPassageOps record component.
      Returns:
      the value of the maxPassageOps record component

    • maxPassageStrides

      public int maxPassageStrides()
      Returns the value of the maxPassageStrides record component.
      Returns:
      the value of the maxPassageStrides record component

    • removeUnusedOperations

      public boolean removeUnusedOperations()
      Returns the value of the removeUnusedOperations record component.
      Returns:
      the value of the removeUnusedOperations record component

    • emitCounters

      public boolean emitCounters()
      Returns the value of the emitCounters record component.
      Returns:
      the value of the emitCounters record component

    • logStackTraces

      public boolean logStackTraces()
      Returns the value of the logStackTraces record component.
      Returns:
      the value of the logStackTraces record component