Package ghidra.app.emulator

Class MemoryAccessFilter

java.lang.Object
ghidra.app.emulator.MemoryAccessFilter
@Deprecated(since="12.1", forRemoval=true) public abstract class MemoryAccessFilter extends Object
Deprecated, for removal: This API element is subject to removal in a future version.
Please use PcodeEmulator instead. For similar callbacks, see PcodeEmulationCallbacks
A means of intercepting and/or modifying the emulator's memory access.

Several of these filters may be chained together, each being invoked in the reverse of the order added. In this way, the first added gets the "final say," but it also is farthest from the original request.

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    protected Emulator
    emu
    Deprecated, for removal: This API element is subject to removal in a future version.
     

  • Constructor Summary

    Constructors
    Constructor
    Description
    MemoryAccessFilter()
    Deprecated, for removal: This API element is subject to removal in a future version.
     

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    dispose()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Dispose this filter which will cause it to be removed from the memory state.
    boolean
    filterOnExecutionOnly()
    Deprecated, for removal: This API element is subject to removal in a future version.
     
    protected abstract void
    processRead(AddressSpace spc, long off, int size, byte[] values)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Invoked after a read
    protected abstract void
    processWrite(AddressSpace spc, long off, int size, byte[] values)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Invoked after a write
    void
    setFilterOnExecutionOnly(boolean filterOnExecutionOnly)
    Deprecated, for removal: This API element is subject to removal in a future version.
     

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Field Details

    • emu

      protected Emulator emu
      Deprecated, for removal: This API element is subject to removal in a future version.

  • Constructor Details

    • MemoryAccessFilter

      public MemoryAccessFilter()
      Deprecated, for removal: This API element is subject to removal in a future version.

  • Method Details

    • processRead

      protected abstract void processRead(AddressSpace spc, long off, int size, byte[] values)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Invoked after a read
      Parameters:
      spc - the space read from
      off - the offset within the space
      size - the number of bytes read
      values - the bytes read

    • processWrite

      protected abstract void processWrite(AddressSpace spc, long off, int size, byte[] values)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Invoked after a write
      Parameters:
      spc - the space written to
      off - the offset within the space
      size - the number of bytes written
      values - the bytes written

    • dispose

      public void dispose()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Dispose this filter which will cause it to be removed from the memory state.

      If overriden, be sure to invoke super.dispose().

    • filterOnExecutionOnly

      public boolean filterOnExecutionOnly()
      Deprecated, for removal: This API element is subject to removal in a future version.

    • setFilterOnExecutionOnly

      public void setFilterOnExecutionOnly(boolean filterOnExecutionOnly)
      Deprecated, for removal: This API element is subject to removal in a future version.