com.oracle.svm.core.log

Interface LogHandlerExtension

All Superinterfaces:

org.graalvm.nativeimage.LogHandler

All Known Implementing Classes:

FunctionPointerLogHandler

public interface LogHandlerExtension
extends org.graalvm.nativeimage.LogHandler

Method Summary

Modifier and Type	Method and Description
default boolean	fatalContext(org.graalvm.nativeimage.c.function.CodePointer callerIP, String msg, Throwable ex) This method gets called if the VM finds itself in a fatal, non-recoverable error situation.

Methods inherited from interface org.graalvm.nativeimage.LogHandler

fatalError, flush, log

Method Detail

fatalContext

default boolean fatalContext(org.graalvm.nativeimage.c.function.CodePointer callerIP,
                             String msg,
                             Throwable ex)

This method gets called if the VM finds itself in a fatal, non-recoverable error situation. The callee receives arguments that describes the error. Based on these arguments the implementor can decide if it wants to get more specific error related information via subsequent calls to LogHandler.log(CCharPointer, UnsignedWord). This is requested by returning true. Returning false on the other hand will let the VM know that it can skip providing this information and immediately proceed with calling LogHandler.fatalError() from where it is expected to never return to the VM.

Providing this method allows to implement flood control for fatal errors. The implementor can rely on LogHandler.fatalError() getting called soon after this method is called.

Parameters:

callerIP - the address of the call-site where the fatal error occurred

msg - provides optional text that was passed to the fatal error call

ex - provides optional exception object that was passed to the fatal error call

Returns:

if false is returned the VM will skip providing more specific error related information before calling LogHandler.fatalError().

Since:

20.3