Module openj9.dtfj

Package com.ibm.j9ddr.corereaders.memory

Interface IProcess

All Superinterfaces:

IMemory

All Known Implementing Classes:

ASNoProcess, BufferedMemory, LinuxProcessAddressSpace, OSXProcessAddressSpace, ProcessAddressSpace, WindowsProcessAddressSpace

public interface IProcess
extends IMemory

Models an OS process. IProcess is-a IMemorySpace because a process knows how big a pointer is (on zOS 32 and 64 bit processes can share the same 64 bit address space). It would be unpleasant to ask an IProcess how big its pointers were, then ask for its address space and then ask that for its memory.

Method Summary

Modifier and Type	Method	Description
int	bytesPerPointer()
IAddressSpace	getAddressSpace()
String	getCommandLine()
Properties	getEnvironmentVariables()
IModule	getExecutable()
Collection<? extends IModule>	getModules()
long	getPointerAt(long address)
String	getProcedureNameForAddress(long address)	Equivalent to getProcedureNameForAddress(address, false).
String	getProcedureNameForAddress(long address, boolean dtfjFormat)
long	getProcessId()
int	getSignalNumber()
Collection<? extends IOSThread>	getThreads()
boolean	isFailingProcess()

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

findPattern, getByteAt, getByteOrder, getBytesAt, getBytesAt, getIntAt, getLongAt, getMemoryRanges, getPlatform, getProperties, getShortAt, isExecutable, isReadOnly, isShared

Method Details

getAddressSpace

IAddressSpace getAddressSpace()

Returns:

Address space this process uses.

getPointerAt

long getPointerAt(long address)
           throws MemoryFault

Throws:

MemoryFault

bytesPerPointer

int bytesPerPointer()

Returns:

Number of bytes in a pointer

getCommandLine

String getCommandLine()
               throws DataUnavailableException,
CorruptDataException

Returns:

Process command line or null if the data is unavailable

Throws:

CorruptDataException

DataUnavailableException

getEnvironmentVariables

Properties getEnvironmentVariables()
                            throws DataUnavailableException,
CorruptDataException

Returns:

Properties containing environment variables name=value pairs

Throws:

CorruptDataException

DataUnavailableException

getModules

Collection<? extends IModule> getModules()
                                  throws CorruptDataException

Throws:

CorruptDataException

getExecutable

IModule getExecutable()
               throws CorruptDataException

Throws:

CorruptDataException

getProcessId

long getProcessId()
           throws CorruptDataException

Throws:

CorruptDataException

getProcedureNameForAddress

String getProcedureNameForAddress(long address)
                           throws DataUnavailableException,
CorruptDataException

Equivalent to getProcedureNameForAddress(address, false). Default behaviour is to return DDR format strings for symbols.

Throws:

DataUnavailableException

CorruptDataException

getProcedureNameForAddress

String getProcedureNameForAddress(long address,
 boolean dtfjFormat)
                           throws DataUnavailableException,
CorruptDataException

Throws:

DataUnavailableException

CorruptDataException

getThreads

Collection<? extends IOSThread> getThreads()
                                    throws CorruptDataException

Throws:

CorruptDataException

getSignalNumber

int getSignalNumber()
             throws DataUnavailableException

Throws:

DataUnavailableException

isFailingProcess

boolean isFailingProcess()
                  throws DataUnavailableException

Throws:

DataUnavailableException