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
NullPointerExceptionif any input argument is
nullunless it's stated otherwise.
|Modifier and Type||Method and Description|
Dumps the heap to the outputFile file in the same format as the hprof heap dump.
Returns a list of VMOption objects for all diagnostic options.
Returns a VMOption object for a VM option of the given name.
Sets a VM option of the given name to the specified value.
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 filename
live- if true dump only live objects i.e. objects that are reachable from others
IOException- if the outputFile already exists, cannot be created, opened, or written to.
UnsupportedOperationException- if this operation is not supported.
IllegalArgumentException- if outputFile does not end with ".hprof" suffix.
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").
writeableVM option that can be set dynamically mainly for troubleshooting and diagnosis.
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 option
value- New value of the VM option to be set
IllegalArgumentException- 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.
SecurityException- if a security manager exists and the caller does not have ManagementPermission("control").
Copyright © 2003, 2020, Oracle and/or its affiliates. All rights reserved.