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

Extensions to LogHandler for supporting suppression of fatal error logging (e.g., implementing flood control) and redirection of fatal error logging (e.g., redirect fatal error logging to a hs_err_pid<NNNN>_libjvmci.log file).

Method Summary

Modifier and Type	Method and Description
default Log	enterFatalContext(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.
default boolean	fatalContext(org.graalvm.nativeimage.c.function.CodePointer callerIP, String msg, Throwable ex) This method is called by the default implementation of LogHandlerExtension.enterFatalContext(org.graalvm.nativeimage.c.function.CodePointer, java.lang.String, java.lang.Throwable).

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 is called by the default implementation of LogHandlerExtension.enterFatalContext(org.graalvm.nativeimage.c.function.CodePointer, java.lang.String, java.lang.Throwable). The implementor returns true if fatal error information should be sent to LogHandler.log(CCharPointer, UnsignedWord). Returning false specifies that no further information is to be logged and the VM must immediately call LogHandler.fatalError().

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:

false if the VM must not log error information before calling LogHandler.fatalError()

Since:

20.3

See Also:

LogHandlerExtension.enterFatalContext(org.graalvm.nativeimage.c.function.CodePointer, java.lang.String, java.lang.Throwable)

enterFatalContext

default Log enterFatalContext(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 implementor returns a non-null Log object if fatal error information should be sent to the log object. Returning null specifies that no further information is to be logged and the VM must immediately call LogHandler.fatalError().

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:

the Log object to which fatal logging is sent or null if the VM must not do any further logging before calling LogHandler.fatalError()

Since:

21.3