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 ProtectedMemoryRange

executable, readOnly, shared

Modifier and Type	Field	Description
protected boolean	executable
protected boolean	readOnly
protected boolean	shared

Fields declared in class BaseMemoryRange

baseAddress, size

Modifier and Type	Field	Description
protected final long	baseAddress
protected final long	size

Fields declared in interface IDetailedMemoryRange

EXECUTABLE, READABLE, WRITABLE

Modifier and Type	Field	Description
static final String	EXECUTABLE
static final String	READABLE	Common properties for ImageSections.
static final String	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()

Methods declared in class ProtectedMemoryRange

isExecutable, isReadOnly, isShared

Modifier and Type	Method	Description
boolean	isExecutable()
boolean	isReadOnly()
boolean	isShared()

Methods declared in class BaseMemoryRange

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

Modifier and Type	Method	Description
int	compareTo(IMemoryRange o)	Compares this object with the specified object for order.
boolean	contains(long address)	Checks whether an address is present in this memory range
final long	getBaseAddress()
final long	getSize()
final long	getTopAddress()
boolean	isBacked()
boolean	isSubRange(IMemoryRange other)
boolean	overlaps(IMemoryRange other)

Methods declared in class Object

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

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