Module openj9.dtfj

Package com.ibm.j9ddr.corereaders.memory

Class UnbackedMemorySource

java.lang.Object

com.ibm.j9ddr.corereaders.memory.BaseMemoryRange

com.ibm.j9ddr.corereaders.memory.ProtectedMemoryRange

com.ibm.j9ddr.corereaders.memory.UnbackedMemorySource

All Implemented Interfaces:

IDetailedMemoryRange, IMemoryRange, IMemorySource, Comparable<IMemoryRange>

public class UnbackedMemorySource
extends ProtectedMemoryRange
implements IMemorySource, IDetailedMemoryRange

Memory source for storage range that is declared, but not backed. Any attempt to read storage results in a MemoryFault

Field Summary

Fields declared in class com.ibm.j9ddr.corereaders.memory.ProtectedMemoryRange

executable, readOnly, shared

Fields declared in class com.ibm.j9ddr.corereaders.memory.BaseMemoryRange

baseAddress, size

Fields declared in interface com.ibm.j9ddr.corereaders.memory.IDetailedMemoryRange

EXECUTABLE, READABLE, WRITABLE

Constructor Summary

Constructors

Constructor	Description
UnbackedMemorySource(long base, long size, String explanation)
UnbackedMemorySource(long base, long size, String explanation, int asid, String name)

Method Summary

Modifier and Type	Method	Description
int	getAddressSpaceId()
int	getBytes(long address, byte[] buffer, int offset, int length)	Reads data from the memory range
String	getName()
Properties	getProperties()
boolean	isBacked()
boolean	isExecutable()
boolean	isReadOnly()

Methods declared in class com.ibm.j9ddr.corereaders.memory.ProtectedMemoryRange

isExecutable, isReadOnly, isShared

Methods declared in class com.ibm.j9ddr.corereaders.memory.BaseMemoryRange

compareTo, contains, getBaseAddress, getSize, getTopAddress, isBacked, isSubRange, overlaps

Methods declared in class java.lang.Object

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

Methods declared in interface java.lang.Comparable

compareTo

Methods declared in interface com.ibm.j9ddr.corereaders.memory.IMemoryRange

contains, getBaseAddress, getSize, getTopAddress, isShared, isSubRange, overlaps

Constructor Details

UnbackedMemorySource

public UnbackedMemorySource(long base,
 long size,
 String explanation,
 int asid,
 String name)

Parameters:

base - Base address for this range

size - Size of this range

explanation - String message explaining why this section isn't backed with storage

asid - Address space id

UnbackedMemorySource

public UnbackedMemorySource(long base,
 long size,
 String explanation)

Parameters:

base - Base address for this range

size - Size of this range

explanation - String message explaining why this section isn't backed with storage

Method Details

getAddressSpaceId

public int getAddressSpaceId()

Specified by:

getAddressSpaceId in interface IMemoryRange

Returns:

Address space ID that this range belongs to.

getBytes

public int getBytes(long address,
 byte[] buffer,
 int offset,
 int length)
             throws MemoryFault

Description copied from interface: IMemorySource

Reads data from the memory range

Specified by:

getBytes in interface IMemorySource

Parameters:

address - Starting address

buffer - Buffer to read into

offset - Offset in buffer to write to

length - Number of bytes to read

Returns:

Bytes read

Throws:

MemoryFault

getName

public String getName()

Specified by:

getName in interface IMemoryRange

Returns:

Name of this range (e.g. .text or stack), or null if range is unnamed.

isBacked

public boolean isBacked()

Specified by:

isBacked in interface IMemoryRange

Specified by:

isBacked in interface IMemorySource

Returns:

True if this memory range is backed with data (such that getBytes() won't always throw MemoryFault).

getProperties

public Properties getProperties()

Specified by:

getProperties in interface IDetailedMemoryRange

isExecutable

public boolean isExecutable()

Specified by:

isExecutable in interface IMemoryRange

isReadOnly

public boolean isReadOnly()

Specified by:

isReadOnly in interface IMemoryRange