Module openj9.dtfj

Package com.ibm.dtfj.image.j9

Class ImageAddressSpace

java.lang.Object

com.ibm.dtfj.image.j9.ImageAddressSpace

All Implemented Interfaces:

ImageAddressSpace

public class ImageAddressSpace
extends Object
implements ImageAddressSpace

Constructor Summary

Constructors

Constructor	Description
ImageAddressSpace(IAbstractAddressSpace memory, int asid)

Method Summary

Modifier and Type	Method	Description
void	addProcess(ImageProcess proc)
int	bytesPerPointer()	This shouldn't be added to the public API but it is required by the current hashCode algorithm in JavaObject.
ByteOrder	getByteOrder()	Return the byte order of this address space.
ImageProcess	getCurrentProcess()	Get the process within this address space that caused the image to be created.
String	getID()	Gets the system wide identifier for the address space
Iterator	getImageSections()	Get the raw memory in the address space.
ImagePointer	getPointer(long address)	A factory method for creating pointers into this address space.
Iterator	getProcesses()	Get the set of processes within the address space.
Properties	getProperties()	Gets the OS specific properties for this address space.
byte	readByteAtIndex(long address)
int	readIntAtIndex(long address)
long	readLongAtIndex(long address)
ImagePointer	readPointerAtIndex(long address)
short	readShortAtIndex(long address)
String	toString()	If available, show the ASID as toString.

Methods declared in class java.lang.Object

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

Constructor Details

ImageAddressSpace

public ImageAddressSpace(IAbstractAddressSpace memory,
 int asid)

Method Details

getByteOrder

public ByteOrder getByteOrder()

Description copied from interface: ImageAddressSpace

Return the byte order of this address space.

Specified by:

getByteOrder in interface ImageAddressSpace

Returns:

the byte order of this address space

getCurrentProcess

public ImageProcess getCurrentProcess()

Description copied from interface: ImageAddressSpace

Get the process within this address space that caused the image to be created.

Specified by:

getCurrentProcess in interface ImageAddressSpace

Returns:

the process within this address space which caused the image to be created, if any. Return null if no individual process triggered the creation of the image.

getProcesses

public Iterator getProcesses()

Description copied from interface: ImageAddressSpace

Get the set of processes within the address space.

Specified by:

getProcesses in interface ImageAddressSpace

Returns:

an iterator which provides all of the processes within a given address space.

See Also:

• ImageProcess
• CorruptData

getPointer

public ImagePointer getPointer(long address)

Description copied from interface: ImageAddressSpace

A factory method for creating pointers into this address space.

Specified by:

getPointer in interface ImageAddressSpace

Parameters:

address - the address to point to.

Returns:

an ImagePointer for the specified address.

addProcess

public void addProcess(ImageProcess proc)

readByteAtIndex

public byte readByteAtIndex(long address)
                     throws MemoryAccessException

Throws:

MemoryAccessException

readPointerAtIndex

public ImagePointer readPointerAtIndex(long address)
                                throws MemoryAccessException

Throws:

MemoryAccessException

readIntAtIndex

public int readIntAtIndex(long address)
                   throws MemoryAccessException

Throws:

MemoryAccessException

readLongAtIndex

public long readLongAtIndex(long address)
                     throws MemoryAccessException

Throws:

MemoryAccessException

readShortAtIndex

public short readShortAtIndex(long address)
                       throws MemoryAccessException

Throws:

MemoryAccessException

getImageSections

public Iterator getImageSections()

Description copied from interface: ImageAddressSpace

Get the raw memory in the address space.

Specified by:

getImageSections in interface ImageAddressSpace

Returns:

An iterator of all the ImageSections in the address. Their union will be the total process address space.

See Also:

• ImageSection

bytesPerPointer

public int bytesPerPointer()

This shouldn't be added to the public API but it is required by the current hashCode algorithm in JavaObject. It may be possible to remove this method if that callsite is changed to a less hackish solution

Returns:

the number of bytes in a pointer (4 or 8).

toString

public String toString()

If available, show the ASID as toString. Change this once getID() is available.

Overrides:

toString in class Object

Returns:

String a printable representation for the receiver.

getID

public String getID()
             throws DataUnavailable,
CorruptDataException

Description copied from interface: ImageAddressSpace

Gets the system wide identifier for the address space

Specified by:

getID in interface ImageAddressSpace

Returns:

address space ID

Throws:

DataUnavailable

CorruptDataException

getProperties

public Properties getProperties()

Description copied from interface: ImageAddressSpace

Gets the OS specific properties for this address space.

Specified by:

getProperties in interface ImageAddressSpace

Returns:

a set of OS specific properties