com.oracle.svm.core

Class SubstrateDiagnostics

java.lang.Object

com.oracle.svm.core.SubstrateDiagnostics

public class SubstrateDiagnostics
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SubstrateDiagnostics.DiagnosticLevel
static class	SubstrateDiagnostics.DiagnosticThunk Can be used to implement printing of custom diagnostic information.
static class	SubstrateDiagnostics.DiagnosticThunkRegistry
static interface	SubstrateDiagnostics.ErrorContext
static class	SubstrateDiagnostics.FatalErrorState
static class	SubstrateDiagnostics.Options

Constructor Summary

Constructors

Constructor and Description
SubstrateDiagnostics()

Method Summary

Modifier and Type	Method and Description
static boolean	isFatalErrorHandlingInProgress()
static boolean	isFatalErrorHandlingThread()
static int	maxInvocations()
static boolean	printFatalError(Log log, org.graalvm.word.Pointer sp, org.graalvm.nativeimage.c.function.CodePointer ip) See SubstrateDiagnostics.printFatalError(Log, Pointer, CodePointer, RegisterDumper.Context, boolean).
static boolean	printFatalError(Log log, org.graalvm.word.Pointer sp, org.graalvm.nativeimage.c.function.CodePointer ip, RegisterDumper.Context registerContext, boolean frameHasCalleeSavedRegisters) Used to print extensive diagnostic information in case of a fatal error.
static void	printInformation(Log log, org.graalvm.word.Pointer sp, org.graalvm.nativeimage.c.function.CodePointer ip) See SubstrateDiagnostics.printInformation(Log, Pointer, CodePointer, RegisterDumper.Context, boolean).
static void	printInformation(Log log, org.graalvm.word.Pointer sp, org.graalvm.nativeimage.c.function.CodePointer ip, RegisterDumper.Context registerContext, boolean frameHasCalleeSavedRegisters) Prints less detailed information than SubstrateDiagnostics.printFatalError(com.oracle.svm.core.log.Log, org.graalvm.word.Pointer, org.graalvm.nativeimage.c.function.CodePointer) but this method guarantees that it won't cause a crash if all parts of Native Image are fully functional.
static void	printLocationInfo(Log log, org.graalvm.word.UnsignedWord value, boolean allowJavaHeapAccess, boolean allowUnsafeOperations)
static void	setOnlyAttachedForCrashHandler(org.graalvm.nativeimage.IsolateThread thread)
static void	updateInitialInvocationCounts(String configuration)

Methods inherited from class java.lang.Object

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

Constructor Detail

SubstrateDiagnostics

public SubstrateDiagnostics()

Method Detail

setOnlyAttachedForCrashHandler

public static void setOnlyAttachedForCrashHandler(org.graalvm.nativeimage.IsolateThread thread)

isFatalErrorHandlingInProgress

public static boolean isFatalErrorHandlingInProgress()

isFatalErrorHandlingThread

public static boolean isFatalErrorHandlingThread()

maxInvocations

public static int maxInvocations()

printLocationInfo

public static void printLocationInfo(Log log,
                                     org.graalvm.word.UnsignedWord value,
                                     boolean allowJavaHeapAccess,
                                     boolean allowUnsafeOperations)

printInformation

public static void printInformation(Log log,
                                    org.graalvm.word.Pointer sp,
                                    org.graalvm.nativeimage.c.function.CodePointer ip)

See SubstrateDiagnostics.printInformation(Log, Pointer, CodePointer, RegisterDumper.Context, boolean).

printInformation

public static void printInformation(Log log,
                                    org.graalvm.word.Pointer sp,
                                    org.graalvm.nativeimage.c.function.CodePointer ip,
                                    RegisterDumper.Context registerContext,
                                    boolean frameHasCalleeSavedRegisters)

Prints less detailed information than SubstrateDiagnostics.printFatalError(com.oracle.svm.core.log.Log, org.graalvm.word.Pointer, org.graalvm.nativeimage.c.function.CodePointer) but this method guarantees that it won't cause a crash if all parts of Native Image are fully functional.

printFatalError

public static boolean printFatalError(Log log,
                                      org.graalvm.word.Pointer sp,
                                      org.graalvm.nativeimage.c.function.CodePointer ip)

See SubstrateDiagnostics.printFatalError(Log, Pointer, CodePointer, RegisterDumper.Context, boolean).

printFatalError

public static boolean printFatalError(Log log,
                                      org.graalvm.word.Pointer sp,
                                      org.graalvm.nativeimage.c.function.CodePointer ip,
                                      RegisterDumper.Context registerContext,
                                      boolean frameHasCalleeSavedRegisters)

Used to print extensive diagnostic information in case of a fatal error. This method may use operations and memory accesses that are not necessarily 100% safe. So, even if all parts of Native Image are fully functional, this method may cause crashes.

If a segfault handler is present, then this method may be called recursively multiple times if further errors happen while printing diagnostics. On each recursive invocation, the level of detail of the diagnostic output will be reduced gradually.

In scenarios without a segfault handler, it can happen that this method reliably causes a subsequent error that crashes Native Image. In such a case, try to reduce the level of detail of the diagnostic output (see SubstrateOptions.DiagnosticDetails) to get a reasonably complete diagnostic output.

updateInitialInvocationCounts

public static void updateInitialInvocationCounts(String configuration)
                                          throws IllegalArgumentException

Throws:

IllegalArgumentException