com.ibm.dtfj.image
Interface ImageThread


public interface ImageThread

A low-level thread instance


Method Summary
 java.lang.String getID()
          Fetch a unique identifier for the thread.
 java.util.Properties getProperties()
           
 java.util.Iterator getRegisters()
           
 java.util.Iterator getStackFrames()
           
 java.util.Iterator getStackSections()
           
 

Method Detail

getID

java.lang.String getID()
                       throws CorruptDataException
Fetch a unique identifier for the thread. In many operating systems, threads have more than one identifier (e.g. a tid, 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 whould be returned by getProperties()

Returns:
a process-wide identifier for the thread (e.g. a tid number)
Throws:
CorruptDataException

getStackFrames

java.util.Iterator getStackFrames()
                                  throws DataUnavailable
Returns:
an iterator to walk the native stack frames in order from top-of-stack (i.e. 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

java.util.Iterator getStackSections()
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

java.util.Iterator getRegisters()
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

java.util.Properties getProperties()
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