org.graalvm.nativeimage

Class ProcessProperties

java.lang.Object

org.graalvm.nativeimage.ProcessProperties

public final class ProcessProperties
extends Object

Utility class to get and set properties of the OS process at run time.

Since:

19.0

Method Summary

Modifier and Type	Method and Description
static boolean	destroy(long processID) Kills the process.
static boolean	destroyForcibly(long processID) Kills the process forcibly.
static void	exec(Path executable, String... args) Replaces the current process image with the process image specified by the given path invoked with the given args.
static String	getExecutableName() Return the canonicalized absolute pathname of the executable.
static String	getObjectFile(CEntryPointLiteral<?> symbol) Return the path of the object file defining the symbol specified as a CEntryPointLiteral containing a function pointer to symbol.
static String	getObjectFile(String symbol) Return the path of the object file defining the symbol specified as a String containing the symbol name.
static long	getProcessID() Get the Process ID of the process executing the image.
static long	getProcessID(Process process) Get the Process ID of the given process object.
static boolean	isAlive(long processID) Tests whether the process represented by the given Process ID is alive.
static String	setLocale(String category, String locale) Set the program locale.
static int	waitForProcessExit(long processID) Wait for process termination and return its exit status.

Methods inherited from class java.lang.Object

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

Method Detail

getExecutableName

public static String getExecutableName()

Return the canonicalized absolute pathname of the executable.

Since:

19.0

getProcessID

public static long getProcessID()

Get the Process ID of the process executing the image.

Since:

19.0

getProcessID

public static long getProcessID(Process process)

Get the Process ID of the given process object.

Since:

19.0

waitForProcessExit

public static int waitForProcessExit(long processID)

Wait for process termination and return its exit status.

Since:

19.0

destroy

public static boolean destroy(long processID)

Kills the process. Whether the process represented by the given Process ID is normally terminated or not is implementation dependent.

Since:

19.0

destroyForcibly

public static boolean destroyForcibly(long processID)

Kills the process forcibly. The process represented by the given Process ID is forcibly terminated. Forcible process destruction is defined as the immediate termination of a process, whereas normal termination allows the process to shut down cleanly.

Since:

19.0

isAlive

public static boolean isAlive(long processID)

Tests whether the process represented by the given Process ID is alive.

Returns:

true if the process represented by the given Process ID object has not yet terminated.

Since:

19.0

getObjectFile

public static String getObjectFile(String symbol)

Return the path of the object file defining the symbol specified as a String containing the symbol name.

Since:

19.0

getObjectFile

public static String getObjectFile(CEntryPointLiteral<?> symbol)

Return the path of the object file defining the symbol specified as a CEntryPointLiteral containing a function pointer to symbol.

Since:

19.0

setLocale

public static String setLocale(String category,
                               String locale)

Set the program locale.

Since:

19.0

exec

public static void exec(Path executable,
                        String... args)

Replaces the current process image with the process image specified by the given path invoked with the given args. This method does not return if the call is successful.

Since:

19.0