Module openj9.dtfj
Package com.ibm.dtfj.image

Interface ImageSection

All Known Subinterfaces:
JavaRuntimeMemorySection
All Known Implementing Classes:
BytecodeImageSection, DTFJGenericJavaRuntimeMemorySection, DTFJJavaRuntimeMemorySectionBase, DTFJMemoryTagRuntimeMemorySection, ImageSection, J9DDRImageSection, JCImageSection, JitImageSection, ModuleImageSection, RawImageSection, StackImageSection
public interface ImageSection
Represents a contiguous range of memory in an address space.

  • Method Summary

    Modifier and Type
    Method
    Description
    ImagePointer
    getBaseAddress()
    Gets the base address (the lowest) of memory in this section.
    String
    getName()
    Gets the name of this section.
    Properties
    getProperties()
    Get the OS-specific properties for this section.
    long
    getSize()
    Gets the size of the memory section.
    boolean
    isExecutable()
    Tests executable permission on memory section.
    boolean
    isReadOnly()
    Tests read permission on memory section.
    boolean
    isShared()
    Tests shared permission on memory section.

  • Method Details

    • getBaseAddress

      ImagePointer getBaseAddress()
      Gets the base address (the lowest) of memory in this section.
      Returns:
      Base address pointer.

    • getSize

      long getSize()
      Gets the size of the memory section.
      Returns:
      Size of section in bytes.

    • getName

      String getName()
      Gets the name of this section. Some memory sections are named. For example, the executable data in a module is typically called ".text". For memory sections without a specific name, a placeholder string will be returned. This method will never return null.
      Returns:
      non-null name String.

    • isExecutable

      boolean isExecutable() throws DataUnavailable
      Tests executable permission on memory section.
      Returns:
      true if the memory pages in this section are marked executable. False otherwise.
      Throws:
      DataUnavailable

    • isReadOnly

      boolean isReadOnly() throws DataUnavailable
      Tests read permission on memory section.
      Returns:
      true if the memory pages in this section are marked read-only. False otherwise.
      Throws:
      DataUnavailable

    • isShared

      boolean isShared() throws DataUnavailable
      Tests shared permission on memory section.
      Returns:
      true if this section is shared between processes. False otherwise.
      Throws:
      DataUnavailable

    • getProperties

      Properties getProperties()
      Get the OS-specific properties for this section.
      Returns:
      a table of OS-specific properties for this section. Values which are commonly available include
      • "readable" -- whether the memory section can be read from
      • "writable" -- whether the memory section can be written to
      • "executable" -- whether data in the memory section can be executed
      Since:
      1.11