org.graalvm.nativeimage

Class VMRuntime

java.lang.Object

org.graalvm.nativeimage.VMRuntime

public final class VMRuntime
extends Object

Used for doing VM runtime operations.

Since:

19.0

Method Summary

Modifier and Type	Method and Description
static void	dumpHeap(String outputFile, boolean live) Dumps the heap to the outputFile file in the same format as the hprof heap dump.
static void	initialize() Initializes the VM: Runs all startup hooks that were registered during image building.
static void	shutdown() Shuts down the VM: Runs all shutdown hooks and waits for all finalization to complete.

Methods inherited from class java.lang.Object

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

Method Detail

initialize

public static void initialize()

Initializes the VM: Runs all startup hooks that were registered during image building. Startup hooks usually depend on option values, so it is recommended (but not required) that all option values are set before calling this method.

Invoking this method more than once has no effect, i.e., startup hooks are only executed at the first invocation.

Since:

19.0

shutdown

public static void shutdown()

Shuts down the VM: Runs all shutdown hooks and waits for all finalization to complete.

This method should only be called once. Invoking this method multiple times can have continued effects. Also, although recommended, it is not strictly required for VMRuntime.initialize() to be called before this method.

Since:

19.0

dumpHeap

public static void dumpHeap(String outputFile,
                            boolean live)
                     throws IOException

Dumps the heap to the outputFile file in the same format as the hprof heap dump.

Throws:

UnsupportedOperationException - if this operation is not supported.

IOException

Since:

20.1