Module openj9.dtfj

Package com.ibm.dtfj.image.j9

Class ImageThread

java.lang.Object

com.ibm.dtfj.image.j9.ImageThread

All Implemented Interfaces:

ImageThread

public class ImageThread
extends Object
implements ImageThread

Constructor Summary

Constructors

Constructor	Description
ImageThread(String threadID, Iterator registers, Iterator stackSections, Iterator stackFrames, Properties properties, int signalNumber)

Method Summary

Modifier and Type	Method	Description
String	getID()	Fetch a unique identifier for the thread.
Properties	getProperties()	Get the OS-specific properties for this thread.
Iterator	getRegisters()	Get the register contents.
int	getSignal()	Called by the process if this is the current thread to see what signal it is stopped on
Iterator	getStackFrames()	Get the set of stack frames on this thread.
Iterator	getStackSections()	Get the set of image sections which make up the stack.

Methods declared in class java.lang.Object

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

Constructor Details

ImageThread

public ImageThread(String threadID,
 Iterator registers,
 Iterator stackSections,
 Iterator stackFrames,
 Properties properties,
 int signalNumber)

Method Details

getID

public String getID()
             throws CorruptDataException

Description copied from interface: ImageThread

Fetch a unique identifier for the thread. In many operating systems, threads have more than one identifier (e.g. a thread id, a handle, a pointer to VM structures associated with the thread). In this case, one of these identifiers will be chosen as the canonical one. The other identifiers would be returned by getProperties()

Specified by:

getID in interface ImageThread

Returns:

a process-wide identifier for the thread (e.g. a tid number)

Throws:

CorruptDataException

getStackFrames

public Iterator getStackFrames()
                        throws DataUnavailable

Description copied from interface: ImageThread

Get the set of stack frames on this thread.

Specified by:

getStackFrames in interface ImageThread

Returns:

an iterator to walk the native stack frames in order from top-of-stack (that is, the most recent frame) to bottom-of-stack. Throws DataUnavailable if native stack frames are not available on this platform.

Throws:

DataUnavailable - If native stack frames are not available on this platform

See Also:

• ImageStackFrame
• CorruptData

getStackSections

public Iterator getStackSections()

Description copied from interface: ImageThread

Get the set of image sections which make up the stack.

Specified by:

getStackSections in interface ImageThread

Returns:

a collection of ImageSections which make up the stack. On most platforms this consists of a single entry, but on some platforms the thread's stack may consist of non-contiguous sections

See Also:

• ImageSection
• CorruptData

getRegisters

public Iterator getRegisters()

Description copied from interface: ImageThread

Get the register contents.

Specified by:

getRegisters in interface ImageThread

Returns:

an iterator to iterate over the state of the CPU registers when the image was created. The collection may be empty if the register state is not available for this thread. If the CPU supports partial registers (e.g. AH, AL, AX, EAX, RAX on AMD64), only the largest version of the register will be included

See Also:

• ImageRegister

getProperties

public Properties getProperties()

Description copied from interface: ImageThread

Get the OS-specific properties for this thread.

Specified by:

getProperties in interface ImageThread

Returns:

a table of OS-specific properties for this thread. Values which are commonly available include

• "priority" -- the priority of the thread
• "policy" -- the scheduling policy of the thread

getSignal

public int getSignal()

Called by the process if this is the current thread to see what signal it is stopped on

Returns:

The signal number that was pending for this thread