Module openj9.dtfj

Package com.ibm.dtfj.corereaders

Interface Dump

All Superinterfaces:

ICoreFileReader, ResourceReleaser

public interface Dump
extends ICoreFileReader

Method Summary

Modifier and Type	Method	Description
Iterator	getAdditionalFileNames()
byte	getByteAt(int asid, long address)
long	getCreationTime()	Determines when the image was created
int	getIntAt(int asid, long address)
long	getLongAt(int asid, long address)
Iterator	getMemoryRanges()
String	getProcessorSubtype()
short	getShortAt(int asid, long address)
boolean	isExecutable(int asid, long address)
boolean	isReadOnly(int asid, long address)
boolean	isShared(int asid, long address)

Methods declared in interface com.ibm.dtfj.corereaders.ICoreFileReader

extract, getAddressSpace, isTruncated

Methods declared in interface com.ibm.dtfj.corereaders.ResourceReleaser

releaseResources

Method Details

getProcessorSubtype

String getProcessorSubtype()

Returns:

the precise model of the CPU (note that this can be an empty string but not null).
e.g. "Pentium IV step 4"

getCreationTime

long getCreationTime()

Determines when the image was created

Returns:

the time in milliseconds since 1970

isExecutable

boolean isExecutable(int asid,
 long address)
              throws MemoryAccessException

Parameters:

asid - an address space ID

address - a byte-offset into the asid

Returns:

true if this memory address is within an executable page

Throws:

MemoryAccessException - if the memory cannot be read

isReadOnly

boolean isReadOnly(int asid,
 long address)
            throws MemoryAccessException

Parameters:

asid - an address space ID

address - a byte-offset into the asid

Returns:

true if write access to this memory address was disabled in the image

Throws:

MemoryAccessException - if the memory cannot be read

isShared

boolean isShared(int asid,
 long address)
          throws MemoryAccessException

Parameters:

asid - an address space ID

address - a byte-offset into the asid

Returns:

true if this memory address is shared between processes

Throws:

MemoryAccessException - if the memory cannot be read

getLongAt

long getLongAt(int asid,
 long address)
        throws MemoryAccessException

Parameters:

asid - an address space ID

address - a byte-offset into the asid

Returns:

the 64-bit long stored at address in asid

Throws:

MemoryAccessException - if the memory cannot be read

getIntAt

int getIntAt(int asid,
 long address)
      throws MemoryAccessException

Parameters:

asid - an address space ID

address - a byte-offset into the asid

Returns:

the 32-bit int stored at address in asid

Throws:

MemoryAccessException - if the memory cannot be read

getShortAt

short getShortAt(int asid,
 long address)
          throws MemoryAccessException

Parameters:

asid - an address space ID

address - a byte-offset into the asid

Returns:

the 16-bit short stored at address in asid

Throws:

MemoryAccessException - if the memory cannot be read

getByteAt

byte getByteAt(int asid,
 long address)
        throws MemoryAccessException

Parameters:

asid - an address space ID

address - a byte-offset into the asid

Returns:

the 8-bit byte stored at address in asid

Throws:

MemoryAccessException - if the memory cannot be read

getMemoryRanges

Iterator getMemoryRanges()

Returns:

An iterator of the MemoryRange objects making up the address space

See Also:

• MemoryRange

getAdditionalFileNames

Iterator getAdditionalFileNames()

Specified by:

getAdditionalFileNames in interface ICoreFileReader

Returns:

An iterator of String object specifying names of additional files needed by the Dump

See Also:

• String