PlatformManagedObject
public interface HotSpotDiagnosticMXBean extends PlatformManagedObject
The diagnostic MBean is registered to the platform MBeanServer as are other platform MBeans.
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.
All methods throw a NullPointerException
if any input argument is
null
unless it's stated otherwise.Modifier and Type | Method | 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
outputFile
file in the same
format as the hprof heap dump.
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
.SecurityException
- If a security manager exists and its SecurityManager.checkWrite(java.lang.String)
method denies write access to the named file
or the caller does not have ManagmentPermission("control").List<VMOption> getDiagnosticOptions()
VMOption
objects for all diagnostic options.
A diagnostic option is a writeable
VM option that can be set dynamically mainly for troubleshooting
and diagnosis.VMOption
objects for all diagnostic options.VMOption getVMOption(String name)
VMOption
object for a VM option of the given
name.VMOption
object for a VM option of the given name.NullPointerException
- if name is null
.IllegalArgumentException
- if a VM option of the given name
does not exist.void setVMOption(String name, String value)
VMOption
object returned by the 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 writable.NullPointerException
- if name or value is null
.SecurityException
- if a security manager exists and the caller does not have
ManagementPermission("control"). Submit a bug or feature
Java is a trademark or registered trademark of Oracle and/or its affiliates in the US and other countries.
Copyright © 2003, 2017, Oracle and/or its affiliates. 500 Oracle Parkway
Redwood Shores, CA 94065 USA. All rights reserved.
DRAFT 9-Ubuntu+0-9b151-2