Package org.lwjgl.llvm

Interface LLVMSymbolLookupCallbackI

All Superinterfaces:
CallbackI, Pointer
All Known Implementing Classes:
LLVMSymbolLookupCallback
Functional Interface:
This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.
@FunctionalInterface public interface LLVMSymbolLookupCallbackI extends CallbackI
Instances of this interface may be passed to the CreateDisasm, CreateDisasmCPU and CreateDisasmCPUFeatures methods.

Type


 char const * (*invoke(long, long, long, long, long)) (
     void *DisInfo,
     uint64_t ReferenceValue,
     uint64_t *ReferenceType,
     uint64_t ReferencePC,
     char const **ReferenceName
 )

  • Nested Class Summary

    Nested classes/interfaces inherited from interface org.lwjgl.system.Pointer

    Pointer.Default

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final FFICIF
    CIF
     

    Fields inherited from interface org.lwjgl.system.Pointer

    BITS32, BITS64, CLONG_SHIFT, CLONG_SIZE, POINTER_SHIFT, POINTER_SIZE

  • Method Summary

    Modifier and Type
    Method
    Description
    default void
    callback(long ret, long args)
    The Java method that will be called from native code when the native callback function is invoked.
    default FFICIF
    getCallInterface()
    Returns the libffi Call Interface for this callback function.
    long
    invoke(long DisInfo, long ReferenceValue, long ReferenceType, long ReferencePC, long ReferenceName)
    The type for the symbol lookup function.

    Methods inherited from interface org.lwjgl.system.CallbackI

    address

  • Field Details

    • CIF

      static final FFICIF CIF

  • Method Details

    • getCallInterface

      default FFICIF getCallInterface()
      Description copied from interface: CallbackI
      Returns the libffi Call Interface for this callback function. [INTERNAL API]
      Specified by:
      getCallInterface in interface CallbackI
      Returns:
      the CIF structure for this callback function

    • callback

      default void callback(long ret, long args)
      Description copied from interface: CallbackI
      The Java method that will be called from native code when the native callback function is invoked.
      Specified by:
      callback in interface CallbackI
      Parameters:
      ret - a pointer to the memory used for the function's return value.

      If the function is declared as returning void, then this value is garbage and should not be used.

      Otherwise, the callback must fill the object to which this points, following the same special promotion behavior as LibFFI.ffi_call(org.lwjgl.system.libffi.FFICIF, long, java.nio.ByteBuffer, org.lwjgl.PointerBuffer). That is, in most cases, ret points to an object of exactly the size of the type specified when CIF was constructed. However, integral types narrower than the system register size are widened. In these cases your program may assume that ret points to an ffi_arg object.

      args - a vector of pointers to memory holding the arguments to the function

    • invoke

      long invoke(long DisInfo, long ReferenceValue, long ReferenceType, long ReferencePC, long ReferenceName)
      The type for the symbol lookup function.

      This may be called by the disassembler for things like adding a comment for a PC plus a constant offset load instruction to use a symbol name instead of a load address value. It is passed the block information is saved when the disassembler context is created and the ReferenceValue to look up as a symbol. If no symbol is found for the ReferenceValue NULL is returned. The ReferenceType of the instruction is passed indirectly as is the PC of the instruction in ReferencePC. If the output reference can be determined its type is returned indirectly in ReferenceType along with ReferenceName if any, or that is set to NULL.