Module openj9.dtfj

Package com.ibm.dtfj.image.javacore

Class JCImage

java.lang.Object

com.ibm.dtfj.image.javacore.JCImage

All Implemented Interfaces:

Image, JCReleasingImage, ManagedImage

public class JCImage
extends Object
implements JCReleasingImage, ManagedImage

Constructor Summary

Constructors

Constructor	Description
JCImage()

Method Summary

Modifier and Type	Method	Description
void	addAddressSpace(ImageAddressSpace imageAddressSpace)
void	addIPAddresses(InetAddress address)
void	addReleasable(JavaCoreResourceReleaser o)
void	close()	Close this image and any associated resources.
Iterator	getAddressSpaces()	Get the set of address spaces within the image - typically one but may be more on some systems such as Z/OS.
long	getCreationTime()	Get the time when the image was created
long	getCreationTimeNanos()	Get the value of the JVM's high-resolution timer when the image was created.
String	getHostName()	Get the host name of the system where the image was running.
ManagedImageSource	getImageSource()
long	getInstalledMemory()	Get the amount of physical memory (in bytes) installed in the system on which the image was running.
Iterator	getIPAddresses()	The set of IP addresses (as InetAddresses) which the system running the image possessed.
int	getProcessorCount()	Get the number of CPUs running in the system on which the image was running.
String	getProcessorSubType()	Get the precise model of the CPU.
String	getProcessorType()	Get the family name for the processor on which the image was running.
Properties	getProperties()	Gets the OS specific properties for this image.
URI	getSource()	A unique identifier for the source of this image
String	getSystemSubType()	Get the detailed name of the operating system.
String	getSystemType()	Get the family name for the operating system.
void	setAddressSpaces(Vector addressSpaces)
void	setBytesMem(long bytesMem)
void	setcpuCount(int cpuCount)
void	setcpuSubType(String cpuSubType)
void	setcpuType(String cpuType)
void	setCreationTime(long creationTime)
void	setCreationTimeNanos(long nanoTime)
void	setHostName(String hostName)
void	setImageSource(ManagedImageSource source)
void	setOSSubType(String osSubType)
void	setOSType(String osType)
void	setSource(URI source)

Methods declared in class java.lang.Object

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

Methods declared in interface com.ibm.dtfj.image.Image

isTruncated

Constructor Details

JCImage

public JCImage()

Method Details

setSource

public void setSource(URI source)

getSource

public URI getSource()

Description copied from interface: Image

A unique identifier for the source of this image

Specified by:

getSource in interface Image

Returns:

URI for this image or null if this was not used when the image was created.

addAddressSpace

public void addAddressSpace(ImageAddressSpace imageAddressSpace)

Parameters:

imageAddressSpace -

getAddressSpaces

public Iterator getAddressSpaces()

Description copied from interface: Image

Get the set of address spaces within the image - typically one but may be more on some systems such as Z/OS.

Specified by:

getAddressSpaces in interface Image

Returns:

an Iterator which iterates over all of the address spaces described by this Image

See Also:

• ImageAddressSpace
• CorruptData

getCreationTime

public long getCreationTime()
                     throws DataUnavailable

Description copied from interface: Image

Get the time when the image was created

Specified by:

getCreationTime in interface Image

Returns:

the image creation time in milliseconds since 1970

Throws:

DataUnavailable

getHostName

public String getHostName()
                   throws DataUnavailable,
CorruptDataException

Description copied from interface: Image

Get the host name of the system where the image was running.

Specified by:

getHostName in interface Image

Returns:

The host name of the system where the image was running. This string will be non-null and non-empty

Throws:

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).

CorruptDataException

getIPAddresses

public Iterator getIPAddresses()
                        throws DataUnavailable

Description copied from interface: Image

The set of IP addresses (as InetAddresses) which the system running the image possessed.

Specified by:

getIPAddresses in interface Image

Returns:

An Iterator over the IP addresses (as InetAddresses) which the system running the image possessed. The iterator will be non-null (but can be empty if the host is known to have no IP addresses).

Throws:

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).

See Also:

• InetAddress
• CorruptData

getInstalledMemory

public long getInstalledMemory()
                        throws DataUnavailable

Description copied from interface: Image

Get the amount of physical memory (in bytes) installed in the system on which the image was running.

Specified by:

getInstalledMemory in interface Image

Returns:

the amount of physical memory installed in the system on which the image was running. The return value is specified in bytes.

Throws:

DataUnavailable - if the information cannot be provided

getProcessorCount

public int getProcessorCount()
                      throws DataUnavailable

Description copied from interface: Image

Get the number of CPUs running in the system on which the image was running.

Specified by:

getProcessorCount in interface Image

Returns:

the number of CPUs running in the system on which the image was running

Throws:

DataUnavailable - if the information cannot be provided

getProcessorSubType

public String getProcessorSubType()
                           throws DataUnavailable,
CorruptDataException

Description copied from interface: Image

Get the precise model of the CPU.

Specified by:

getProcessorSubType in interface Image

Returns:

the precise model of the CPU (note that this can be an empty string but not null).
e.g. getProcessorType() will return x86 where getProcessorSubType() may return Pentium IV step 4

Note that this value is platform and implementation dependent.

Throws:

DataUnavailable

CorruptDataException

getProcessorType

public String getProcessorType()
                        throws DataUnavailable,
CorruptDataException

Description copied from interface: Image

Get the family name for the processor on which the image was running.

Specified by:

getProcessorType in interface Image

Returns:

the family name for the processor on which the image was running. This corresponds to the value you would find in the "os.arch" System property.

Throws:

DataUnavailable - if this data cannot be inferred from this core type

CorruptDataException - if expected data cannot be read from the core

getSystemSubType

public String getSystemSubType()
                        throws DataUnavailable,
CorruptDataException

Description copied from interface: Image

Get the detailed name of the operating system.

Specified by:

getSystemSubType in interface Image

Returns:

the detailed name of the operating system, or an empty string if this information is not available (null will never be returned). This should be the same value that would be returned for the "os.version" system property

Throws:

DataUnavailable

CorruptDataException

getSystemType

public String getSystemType()
                     throws DataUnavailable,
CorruptDataException

Description copied from interface: Image

Get the family name for the operating system.

Specified by:

getSystemType in interface Image

Returns:

the family name for the operating system. This should be the same value that would be returned for the "os.name" system property

Throws:

DataUnavailable - if this data cannot be inferred from this core type

CorruptDataException - if expected data cannot be read from the core

setAddressSpaces

public void setAddressSpaces(Vector addressSpaces)

setBytesMem

public void setBytesMem(long bytesMem)

Parameters:

bytesMem -

setcpuCount

public void setcpuCount(int cpuCount)

Parameters:

cpuCount -

setcpuSubType

public void setcpuSubType(String cpuSubType)

Parameters:

cpuSubType -

setcpuType

public void setcpuType(String cpuType)

Parameters:

cpuType -

setCreationTime

public void setCreationTime(long creationTime)

Parameters:

creationTime -

setCreationTimeNanos

public void setCreationTimeNanos(long nanoTime)

Parameters:

creationTimeNanos -

setHostName

public void setHostName(String hostName)

Parameters:

hostName -

addIPAddresses

public void addIPAddresses(InetAddress address)

Parameters:

addresses -

setOSSubType

public void setOSSubType(String osSubType)

Parameters:

osSubType -

setOSType

public void setOSType(String osType)

Parameters:

osType -

close

public void close()

Description copied from interface: Image

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.

Specified by:

close in interface Image

addReleasable

public void addReleasable(JavaCoreResourceReleaser o)

Specified by:

addReleasable in interface JCReleasingImage

getProperties

public Properties getProperties()

Description copied from interface: Image

Gets the OS specific properties for this image.

Specified by:

getProperties in interface Image

Returns:

a set of OS specific properties

getImageSource

public ManagedImageSource getImageSource()

Specified by:

getImageSource in interface ManagedImage

setImageSource

public void setImageSource(ManagedImageSource source)

Specified by:

setImageSource in interface ManagedImage

getCreationTimeNanos

public long getCreationTimeNanos()
                          throws DataUnavailable,
CorruptDataException

Description copied from interface: Image

Get the value of the JVM's high-resolution timer when the image was created.

Specified by:

getCreationTimeNanos in interface Image

Returns:

the value of the high-resolution timer, in nanoseconds

Throws:

DataUnavailable - if the image creation time is not available

CorruptDataException - if the image creation time is corrupted