com.oracle.svm.core

Class SubstrateDiagnostics.DiagnosticThunk

java.lang.Object

com.oracle.svm.core.SubstrateDiagnostics.DiagnosticThunk

Direct Known Subclasses:

VMLockSupport.DumpVMMutexes

Enclosing class:

SubstrateDiagnostics

public abstract static class SubstrateDiagnostics.DiagnosticThunk
extends Object

Can be used to implement printing of custom diagnostic information. Instances are singletons that live in the image heap. The same instance can be used by multiple threads concurrently.

Constructor Summary

Constructors

Constructor and Description
DiagnosticThunk()

Method Summary

Modifier and Type	Method and Description
abstract int	maxInvocationCount()
abstract void	printDiagnostics(Log log, SubstrateDiagnostics.ErrorContext context, int maxDiagnosticLevel, int invocationCount) Prints diagnostic information.

Methods inherited from class java.lang.Object

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

Constructor Detail

DiagnosticThunk

public DiagnosticThunk()

Method Detail

printDiagnostics

public abstract void printDiagnostics(Log log,
                                      SubstrateDiagnostics.ErrorContext context,
                                      int maxDiagnosticLevel,
                                      int invocationCount)

Prints diagnostic information. This method may be invoked by multiple threads concurrently. If an error (e.g., exception or segfault) occurs while executing this method, then the same thread may execute this method multiple times sequentially. The parameter invocationCount is incremented for each sequential invocation. A typical implementation of SubstrateDiagnostics.DiagnosticThunk.printDiagnostics(com.oracle.svm.core.log.Log, com.oracle.svm.core.SubstrateDiagnostics.ErrorContext, int, int) will reduce the amount of diagnostic output when the invocationCount increases. This also reduces the risk of errors and makes it more likely that the method finishes executing successfully.

Parameters:

log - the output to which the diagnostics should be printed.

context - contextual data for the error, e.g., register information.

maxDiagnosticLevel - specifies which kind of operations the diagnostic thunk may perform, see SubstrateDiagnostics.DiagnosticLevel.

invocationCount - this value is >= 1 and <= SubstrateDiagnostics.DiagnosticThunk.maxInvocationCount()).

maxInvocationCount

public abstract int maxInvocationCount()