Package ghidra.app.util.bin.format.golang.rtti

Class GoSlice

java.lang.Object
ghidra.app.util.bin.format.golang.rtti.GoSlice
public class GoSlice extends Object

  • Constructor Summary

    Constructors
    Constructor
    Description
    GoSlice()
     
    GoSlice(long array, long len, long cap)
     
    GoSlice(long array, long len, long cap, GoRttiMapper programContext)
     

  • Method Summary

    Modifier and Type
    Method
    Description
    Address
    getArrayAddress()
     
    long
    getArrayOffset()
     
    long
    getCap()
     
    long
    getLen()
     
    GoSlice
    getSubSlice(long startElement, long elementCount, long elementSize)
    Return a artificial view of a portion of this slice's contents.
    boolean
    isFull()
     
    boolean
    isOffsetWithinData(long offset, int sizeofElement)
     
    boolean
    isValid(int elementSize)
     
    void
    markupArray(String sliceName, DataType elementType, boolean ptr)
    Marks up the memory occupied by the array elements with a name and a Ghidra ArrayDataType.
    void
    markupArray(String sliceName, Class<?> elementClazz, boolean ptr)
    Marks up the memory occupied by the array elements with a name and a Ghidra ArrayDataType, which has elements who's type is determined by the specified structure class.
    <T> List<T>
    markupArrayElements(Class<T> clazz)
    Marks up each element of the array, useful when the elements are themselves structures.
    void
    markupElementReferences(int elementSize, List<Address> targetAddrs)
    Marks up each element of the array with an outbound reference to the corresponding address in the targetAddrs list.
    <T> List<T>
    readList(BinaryReader.ReaderFunction<T> readFunc)
    Reads the contents of the slice, treating each element as an instance of an object that can be read using the supplied reading function.
    <T> List<T>
    readList(Class<T> clazz)
    Reads the content of the slice, treating each element as an instance of the specified structure mapped class.
    long[]
    readUIntList(int intSize)
    Treats this slice as a array of unsigned integers, of the specified intSize.

    Methods inherited from class java.lang.Object

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

  • Constructor Details

    • GoSlice

      public GoSlice()

    • GoSlice

      public GoSlice(long array, long len, long cap)

    • GoSlice

      public GoSlice(long array, long len, long cap, GoRttiMapper programContext)

  • Method Details

    • getSubSlice

      public GoSlice getSubSlice(long startElement, long elementCount, long elementSize)
      Return a artificial view of a portion of this slice's contents.
      Parameters:
      startElement -
      elementCount -
      elementSize -
      Returns:

    • isValid

      public boolean isValid(int elementSize)

    • getArrayOffset

      public long getArrayOffset()

    • getArrayAddress

      public Address getArrayAddress()

    • getLen

      public long getLen()

    • getCap

      public long getCap()

    • isFull

      public boolean isFull()

    • isOffsetWithinData

      public boolean isOffsetWithinData(long offset, int sizeofElement)

    • readList

      public <T> List<T> readList(Class<T> clazz) throws IOException
      Reads the content of the slice, treating each element as an instance of the specified structure mapped class.
      Type Parameters:
      T -
      Parameters:
      clazz - element type
      Returns:
      list of instances
      Throws:
      IOException

    • readList

      public <T> List<T> readList(BinaryReader.ReaderFunction<T> readFunc) throws IOException
      Reads the contents of the slice, treating each element as an instance of an object that can be read using the supplied reading function.
      Type Parameters:
      T -
      Parameters:
      readFunc - function that will read an instance from a BinaryReader
      Returns:
      list of instances
      Throws:
      IOException

    • readUIntList

      public long[] readUIntList(int intSize) throws IOException
      Treats this slice as a array of unsigned integers, of the specified intSize.

      Parameters:
      intSize - size of integer
      Returns:
      array of longs, containing the (possibly smaller) integers contained in the slice
      Throws:
      IOException - if error reading

    • markupArray

      public void markupArray(String sliceName, Class<?> elementClazz, boolean ptr) throws IOException
      Marks up the memory occupied by the array elements with a name and a Ghidra ArrayDataType, which has elements who's type is determined by the specified structure class.
      Parameters:
      sliceName - used to label the memory location
      elementClazz - structure mapped class of the element of the array
      ptr - boolean flag, if true the element type is really a pointer to the supplied data type
      Throws:
      IOException - if error

    • markupArray

      public void markupArray(String sliceName, DataType elementType, boolean ptr) throws IOException
      Marks up the memory occupied by the array elements with a name and a Ghidra ArrayDataType.
      Parameters:
      sliceName - used to label the memory location
      elementType - Ghidra datatype of the array elements, null ok if ptr == true
      ptr - boolean flag, if true the element type is really a pointer to the supplied data type
      Throws:
      IOException - if error

    • markupArrayElements

      public <T> List<T> markupArrayElements(Class<T> clazz) throws IOException
      Marks up each element of the array, useful when the elements are themselves structures.
      Type Parameters:
      T - structure type
      Parameters:
      clazz - class of the structure type
      Returns:
      list of element instances
      Throws:
      IOException - if error reading

    • markupElementReferences

      public void markupElementReferences(int elementSize, List<Address> targetAddrs) throws IOException
      Marks up each element of the array with an outbound reference to the corresponding address in the targetAddrs list.

      Useful when marking up an array of offsets.

      The Listing UI doesn't show the outbound reference from each element (for arrays of primitive types), but the target will show the inbound reference.

      Parameters:
      elementSize - size of each element in the array
      targetAddrs - list of addresses, should be same size as this slice
      Throws:
      IOException