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