com.ibm.dtfj.image
Interface Image
- public interface Image
Represents an entire operating system image (e.g. a core file).
There are methods for accessing information about the architecture of the machine on which the image was running - hardware and operating system. The major feature, however, is the ability to iterate over the Address Spaces contained within the image.
Method Summary
Modifier and Type | Method and Description |
---|---|
|
close()
Close this image and any associated resources.
|
|
getAddressSpaces()
Get the set of address spaces within the image - typically one but may be more on some
systems such as Z/OS.
|
|
getCreationTime()
Determines when the image was created
|
|
getHostName()
Get the host name of the system where the image was running.
|
|
getInstalledMemory()
Get the amount of physical memory (in bytes) installed in the system on which
the image was running.
|
|
getIPAddresses()
The set of IP addresses (as InetAddresses) which the system running the image possessed.
|
|
getProcessorCount()
Get the number of CPUs running in the system on which the image was running.
|
|
getProcessorSubType()
Get the precise model of the CPU.
|
|
getProcessorType()
Get the family name for the processor on which the image was
running.
|
|
getSystemSubType()
Get the detailed name of the operating system.
|
|
getSystemType()
Get the family name for the operating system.
|
Method Detail
getAddressSpaces
- java.util.Iterator getAddressSpaces( )
getProcessorType
- java.lang.String getProcessorType( )
- throws DataUnavailable
- CorruptDataException
DataUnavailable
- if this data cannot be inferred from this core type CorruptDataException
- if expected data cannot be read from the core getProcessorSubType
- java.lang.String getProcessorSubType( )
- throws DataUnavailable
- CorruptDataException
e.g. getProcessorType() will return "x86" where getProcessorSubType() may return "Pentium IV step 4"
Note that this value is platform and implementation dependent.
getProcessorCount
- int getProcessorCount()
- throws DataUnavailable
DataUnavailable
- if the information cannot be provided getSystemType
- java.lang.String getSystemType( )
- throws DataUnavailable
- CorruptDataException
DataUnavailable
- if this data cannot be inferred from this core type CorruptDataException
- if expected data cannot be read from the core getSystemSubType
- java.lang.String getSystemSubType( )
- throws DataUnavailable
- CorruptDataException
getInstalledMemory
- long getInstalledMemory()
- throws DataUnavailable
DataUnavailable
- if the information cannot be provided getCreationTime
- long getCreationTime()
- throws DataUnavailable
getHostName
- java.lang.String getHostName()
- throws DataUnavailable
- CorruptDataException
DataUnavailable
- If the image did not provide this information (would happen
if the system did not know its host name or if the image predated this feature). getIPAddresses
- java.util.Iterator getIPAddresses( )
- throws DataUnavailable
DataUnavailable
- If the image did not provide this information (would happen
if the system failed to look them up or if the image pre-dated this feature). java.net.InetAddress
,
CorruptData
close
- void close()
Close this image and any associated resources.
Some kinds of Image require the generation of temporary resources, for example temporary files created when reading core files and libraries from .zip archives. Ordinarily, these resources are deleted at JVM shutdown, but DTFJ applications may want to free them earlier. This method should only be called when the Image is no longer needed. After this method has been called, any objects associated with the image will be in an invalid state.