InterruptableAI
Related Doc:
package ai
Performs an abstract interpretation of the given method using the given domain.
Performs an abstract interpretation of the given method using the given domain.
A non-native, non-abstract method of the given class file that will be analyzed. All parameters are automatically initialized with sensible default values.
The domain that will be used to perform computations related to values.
Continues the interpretation of/performs an abstract interpretation of the given method (code) using the given domain.
Continues the interpretation of/performs an abstract interpretation of the given method (code) using the given domain.
The bytecode that will be interpreted using the given domain.
The set of instructions where two or more control flow paths join. The abstract interpretation framework will only perform a join operation for those instructions.
The domain that will be used to perform the domain dependent computations.
The list of program counters with which the interpretation
will continue. If the method was never analyzed before, the list should just
contain the value "0"; i.e., we start with the interpretation of the
first instruction (see initialWorkList).
Note that the worklist may contain negative values. These values are not
related to a specific instruction per-se but encode the necessary information
to handle subroutines. In case of calls to a subroutine we add the special
values SUBROUTINE and SUBROUTINE_START to the list to encode when the
evaluation started. This is needed to completely process the subroutine
(to explore all paths) before we finally return to the main method.
The list of the program counters (PC) of the instructions
that were already evaluated. Initially (i.e., if the given code is analyzed
the first time) this list is empty.
This list is primarily needed to correctly resolve jumps to sub routines
(JSR(_W) and RET instructions.) For each instruction that was evaluated,
the operands array and the locals array must be non-empty (not null).
The array that contains the operand stacks. Each value
in the array contains the operand stack before the instruction with the
corresponding index is executed. This array can be empty except of the
indexes that are referred to by the initialWorklist.
The operandsArray data structure is mutated by OPAL-AI and it is
recommended that a Domain does not directly mutate the state of
this array.
The array that contains the local variable assignments.
Each value in the array contains the local variable assignments before
the instruction with the corresponding program counter is executed.
The localsArray data structure is mutated by OPAL-AI and it is
recommended that a Domain does not directly mutate the state of
this array.
The array that contains the intermediate information
about the subroutines' operands.
This value should be null unless we are continuing an aborted computation and
a subroutine was already analyzed.
The array that contains the intermediate information
about the subroutines' locals.
This value should be null unless we are continuing an aborted computation and
a subroutine was already analyzed.
Returns the initial register assignment (the initialized locals) that is used when analyzing a new method.
Returns the initial register assignment (the initialized locals) that is used when analyzing a new method.
Initially, only the registers that contain the method's parameters (including
the self reference (this)) are used. If no initial assignment is provided
(someLocals == None) a valid assignment is automatically created using
the domain. See perform(...) for further details regarding the initial
register assignment.
This method is called by the perform method with the same signature. It
may be overridden by subclasses to perform some additional processing. In
that case, however, it is highly recommended to call this method to finalize the
initial assignment.
A non-native, non-abstract method. I.e., a method that has an
implementation in Java bytecode (e.g., method.body.isDefined === true).
The domain that will be used to perform computations related to values.
Returns the initial set of operands that will be used for the abstract interpretation of the given method.
Returns the initial set of operands that will be used for the abstract interpretation of the given method.
In general, an empty list is returned as the JVM specification mandates that the operand stack is empty at the very beginning of a method.
This method is called by the perform method with the same signature. It
may be overridden by subclasses to perform some additional processing.
After a call of this method the abstract interpretation of the current method will be terminated before the evaluation of the next instruction starts.
After a call of this method the abstract interpretation of the current method will be terminated before the evaluation of the next instruction starts.
This functionality is appropriately synchronized to ensure a timely interruption.
Determines whether a running (or to be started) abstract interpretation
should be interrupted (default: false).
Determines whether a running (or to be started) abstract interpretation
should be interrupted (default: false).
In general, interrupting the abstract interpreter may be meaningful if the abstract interpretation takes too long or if the currently used domain is not sufficiently precise enough/if additional information is needed to continue with the analysis.
Called during the abstract interpretation of a method to determine whether the computation should be aborted. This method is always called directly before the evaluation of the first/next instruction. I.e., before the very first instruction or after the ai has completely evaluated an instruction, updated the memory and stated all constraints.
When the abstract interpreter is currently waiting on the result of the interpretation of a called method it may take some time before the interpretation of the current method (this abstract interpreter) is actually aborted. This method needs to be overridden in subclasses to identify situations in which a running abstract interpretation should be interrupted.
Analyzes the given method using the given domain and the pre-initialized parameter values (if any).
Analyzes the given method using the given domain and the pre-initialized parameter
values (if any). Basically, first the set of initial operands and locals is
calculated before the respective perform(...,initialOperands,initialLocals)
method is called.
The abstract interpretation of a method is aborted if the AI's isInterrupted
method returns true.
A non-abstract, non-native method of the given class file. I.e., a method with a body.
The abstract domain that will be used for the abstract interpretation of the given method.
The initial register assignment (the parameters passed to the
method). If the values passed to a method are already known, the
abstract interpretation will be performed under that assumption. The specified
number of locals has to be equal or larger than the number of parameters
(including this in case of a non-static method.). If the number is lower
than method.body.maxLocals it will be adjusted as required.
The result of the abstract interpretation. Basically, the calculated memory layouts; i.e., the list of operands and local variables before each instruction. Each calculated memory layout represents the layout before the instruction with the corresponding program counter was interpreted. If the interpretation was aborted, the returned result object contains all necessary information to continue the interpretation if needed/desired.
Performs an abstract interpretation of the given (byte)code using the given domain and the initial operand stack and initial register assignment.
Performs an abstract interpretation of the given (byte)code using the given domain and the initial operand stack and initial register assignment.
Performs additional initializations of the Domain, if the Domain implements
the trait TheAI, TheCodeStructure, TheMemoryLayout or
CustomInitialization.
Performs additional initializations of the Domain, if the Domain implements
the trait TheAI, TheCodeStructure, TheMemoryLayout or
CustomInitialization.
This method is called before the abstract interpretation is started/continued.
The tracer (default: None) that is called by OPAL while performing the abstract
interpretation of a method.
The tracer (default: None) that is called by OPAL while performing the abstract
interpretation of a method.
This method is called at different points to report on the analysis progress (see org.opalj.ai.AITracer for further details)
It is possible to attach/detach a tracer at any time.
To attach a tracer to the abstract interpreter override this method in subclasses and return some tracer object.
An abstract interpreter that can be interrupted by calling the AI's
interruptmethod or by calling the executing thread's interrupt method.