-
- All Known Implementing Classes:
ImageProcess
,J9DDRImageProcess
,JCImageProcess
,PartialProcess
public interface ImageProcess
Represents a native operating system process.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description String
getCommandLine()
Fetch the command line for this process.ImageThread
getCurrentThread()
Find the thread which triggered the creation of the imageProperties
getEnvironment()
Get the environment variables for this process.ImageModule
getExecutable()
Get the module representing the executable within the image.String
getID()
Get the system-wide identifier for the process.Iterator
getLibraries()
Get the set of shared libraries which are loaded in this process.int
getPointerSize()
Determine the pointer size used by this process.Properties
getProperties()
Gets the OS specific properties for this process.Iterator
getRuntimes()
Get the set of the known ManagedRuntime environments in the image.String
getSignalName()
Get the name of the OS signal in this process which triggered the creation of this image.int
getSignalNumber()
Get the OS signal number in this process which triggered the creation of this image.Iterator
getThreads()
Get the set of image threads in the image.
-
-
-
Method Detail
-
getCommandLine
String getCommandLine() throws DataUnavailable, CorruptDataException
Fetch the command line for this process. This may be the exact command line the user issued, or it may be a reconstructed command line based on argv[] and argc.- Returns:
- the command line for the process
- Throws:
DataUnavailable
- if the information cannot be providedCorruptDataException
-
getEnvironment
Properties getEnvironment() throws DataUnavailable, CorruptDataException
Get the environment variables for this process.- Returns:
- the environment variables for this process
- Throws:
DataUnavailable
- if the information cannot be providedCorruptDataException
-
getID
String getID() throws DataUnavailable, CorruptDataException
Get the system-wide identifier for the process.- Returns:
- a system-wide identifier for the process (e.g. a process id (pid) on Unix like systems)
- Throws:
DataUnavailable
- if the information cannot be providedCorruptDataException
-
getLibraries
Iterator getLibraries() throws DataUnavailable, CorruptDataException
Get the set of shared libraries which are loaded in this process.- Returns:
- an iterator to iterate over the shared libraries which are loaded in this process
- Throws:
DataUnavailable
- if the information cannot be providedCorruptDataException
- See Also:
ImageModule
,CorruptData
-
getExecutable
ImageModule getExecutable() throws DataUnavailable, CorruptDataException
Get the module representing the executable within the image.- Returns:
- the module representing the executable within the image (as opposed to modules representing libraries)
- Throws:
DataUnavailable
- if the information cannot be providedCorruptDataException
- See Also:
ImageModule
-
getThreads
Iterator getThreads()
Get the set of image threads in the image.- Returns:
- an iterator to iterate over each ImageThread in the image There is not necessarily any relationship between JavaThreads and ImageThreads. A JVM implementation may use an n:m mapping of JavaThreads to ImageThreads, and not all ImageThreads are necessarily attached.
- See Also:
ImageThread
,CorruptData
-
getCurrentThread
ImageThread getCurrentThread() throws CorruptDataException
Find the thread which triggered the creation of the image- Returns:
- the ImageThread which caused the image to be created, or null if the image was not created due to a specific thread
- Throws:
CorruptDataException
- See Also:
ImageThread
-
getRuntimes
Iterator getRuntimes()
Get the set of the known ManagedRuntime environments in the image.- Returns:
- an iterator to iterate over all of the known ManagedRuntime environments in the image. In a typical image, there will be only one runtime, and it will be an instance of JavaRuntime. However any user of this API should be aware that there is a possibility that other runtimes may exist in the image
- See Also:
ManagedRuntime
,JavaRuntime
,CorruptData
-
getSignalNumber
int getSignalNumber() throws DataUnavailable, CorruptDataException
Get the OS signal number in this process which triggered the creation of this image.- Returns:
- the OS signal number in this process which triggered the creation of this image, or 0 if the image was not created because of a signal in this process
- Throws:
DataUnavailable
- if the information cannot be providedCorruptDataException
-
getSignalName
String getSignalName() throws DataUnavailable, CorruptDataException
Get the name of the OS signal in this process which triggered the creation of this image.- Returns:
- the name of the OS signal in this process which triggered the creation of this image, or null if the image was not created because of a signal in this process
- Throws:
DataUnavailable
- if the information cannot be providedCorruptDataException
-
getPointerSize
int getPointerSize()
Determine the pointer size used by this process. Currently supported values are 31, 32 or 64. In the future, other pointer sizes may also be supported.- Returns:
- the size of a pointer, in bits
-
getProperties
Properties getProperties()
Gets the OS specific properties for this process.- Returns:
- a set of OS specific properties
- Since:
- 1.7
-
-