public interface HotSpotDiagnosticMXBean extends PlatformManagedObject
The ObjectName for uniquely identifying the diagnostic MXBean within an MBeanServer is:
com.sun.management:type=HotSpotDiagnostic.* It can be obtained by calling the
PlatformManagedObject.getObjectName()
method.ManagementFactory#getPlatformMXBeans(Class)
Modifier and Type | Method and Description |
---|---|
void |
dumpHeap(String outputFile,
boolean live)
Dumps the heap to the outputFile file in the same
format as the hprof heap dump.
|
List<VMOption> |
getDiagnosticOptions()
Returns a list of VMOption objects for all diagnostic options.
|
VMOption |
getVMOption(String name)
Returns a VMOption object for a VM option of the given
name.
|
void |
setVMOption(String name,
String value)
Sets a VM option of the given name to the specified value.
|
getObjectName
void dumpHeap(String outputFile, boolean live) throws IOException
If this method is called remotely from another process, the heap dump output is written to a file named outputFile on the machine where the target VM is running. If outputFile is a relative path, it is relative to the working directory where the target VM was started.
outputFile
- the system-dependent filenamelive
- if true dump only live objects
i.e. objects that are reachable from othersIOException
- if the outputFile
cannot be created, opened, or written to.UnsupportedOperationException
- if this operation is not supported.NullPointerException
- if outputFile is null.List<VMOption> getDiagnosticOptions()
writeable
VM option that can be set dynamically mainly for troubleshooting
and diagnosis.VMOption getVMOption(String name)
NullPointerException
- if name is null.IllegalArgumentException
- if a VM option of the given name
does not exist.void setVMOption(String name, String value)
getVMOption(java.lang.String)
method or
the getDiagnosticOptions()
method. This method does
not change the value of this VMOption object.name
- Name of a VM optionvalue
- New value of the VM option to be setIllegalArgumentException
- if the VM option of the given name
does not exist.IllegalArgumentException
- if the new value is invalid.IllegalArgumentException
- if the VM option is not writeable.NullPointerException
- if name or value is null.java.security.SecurityException
- if a security manager exists and the caller does not have
ManagementPermission("control").
Copyright © 2003, 2011, Oracle and/or its affiliates. All rights reserved.