Unreleased - 2024-08-18
- Add side-effect analysis.
- The options
--class-path
and--app-class-path
can be repeated multiple times to specify multiple paths. - Pointer analysis
- Add
Plugin.onPhaseFinish()
. - Support specifying multiple method signatures in one
@InvokeHandler
annotation. - Add
getInfo()
to call graph edges and pointer flow edges. - Add pointer analysis assertion mechanism to ease testing.
- Add
pascal.taie.analysis.pta.plugin.util.AnalysisModelPlugin
andIRModelPlugin
to replace originalModel
andIRModel
, provide more convenient interfaces to support@InvokeHandler
.
- Add
- Taint analysis
- Support specifying IndexRef (e.g.,
index: "0[*]"
andindex: "0.f"
) in call sources and parameter sources. - Support specifying IndexRef in sinks.
- Support interactive mode, allowing users to modify the taint configuration file and re-run taint analysis without needing to re-run the whole program analysis.
- Enhance TFG dumping by adding taint configuration and call site info to Source/Sink node and TaintTransfer edge.
- Support programmatical taint config provider.
- Support specifying IndexRef (e.g.,
- Class hierarchy analysis (CHA)
- Support ignoring call sites that call methods declared in
java.lang.Object
. - Support ignoring call sites whose callees exceed given limit.
- Support ignoring call sites that call methods declared in
- Signature pattern and matcher
- Add
pascal.taie.language.classes.SignatureMatcher
which supports retrieving classes, methods, or fields whose signature match given pattern. - Use signature matcher in taint analysis and
@InvokeHandler
to simplify signature configuration.
- Add
- API changes
- Change
Solver.addPFGEdge(Pointer,Pointer,FlowKind,Type)
andSolver.addPFGEdge(Pointer,Pointer,FlowKind,Transfer)
toSolver.addPFGEdge(PointerFlowEdge)
and related APIs. - Deprecate
pascal.taie.analysis.pta.plugin.util.Model
andIRModel
(these two interfaces are currently preserved for compatibility, and will be removed in the future). - Change
PrimitiveType
fromenum
to aninterface
and implement it by classes that represent concrete primitive types. Refine the types of certain expressions fromPrimitiveType
to the concrete primitive types.
- Change
- Fix incorrect classpath argument for the frontend where the
-acp
option is not being used. This issue is only reproducible when--prepend-JVM
(-pp
) is set totrue
. - Fix mismatch between number of parameter names and number of actual parameters in JMethod for inner class.
- Fix option parser, now treat only the first colon as delimiter between a key and a value (before each colon is treated as delimiter).
- Fix empty log file when running via JAR.
0.2.2 - 2023-09-23
- Add option
--app-class-path
. - Add option
--keep-results
. - Add option
--output-dir
. - Add option
-wc, --world-cache-mode
. - Add def-use analysis.
- Add dominator-finding algorithm.
- Add generics signature information for Class, Method, and Field.
- Include documentation source in the repository.
- Taint analysis
- Support taint source for arguments of method calls and method parameters.
- Support taint source for field loads.
- Support taint sanitization for method parameters.
- Dump taint flow graph.
- Support loading multiple taint configuration files.
- Support taint transfer between variables and instance fields/array elements.
- Support call-site mode.
- Pointer analysis
- Support adding entry points of the program to analyze.
- Support analysis time limit.
- Support propagation for values of primitive types.
- Support hybrid inference-based and log-based reflection analysis.
- Add Solar reflection analysis (TOSEM'19).
- Support annotation-based invoke handler registration.
- Support dumping points-to set in YAML format.
- Option and configuration changes
- Change All
dump
related options. Previously, mostdump
options require users to specify a path to dump file; now, Tai-e uses fixed path for dump file (the file name is fully fixed, and users can still change dump directory via option--output-dir
), so that users only need to specifytrue
orfalse
for alldump
options. - Rename analysis
class-dumper
toir-dumper
. - Pointer analysis
- Replace
merge-string-constants
bydistinguish-string-constants
. - Replace
action
bydump
andexpected-file
.
- Replace
- Taint analysis
- Require to add
kind
to source configurations. Previously, the taint analysis only supports one kind of sources, i.e., result of method call. Now, we support more kinds of sources, including argument or result of method call (kind: call
), and method parameter (kind: param
) , so users need to specify kind of each source. Please see an example.
- Require to add
- Change All
- API changes
- Change
pascal.taie.analysis.pta.core.heap.HeapModel.getMockObj(String,...)
toHeapModel.getMockObj(Descriptor,...)
. - Change APIs of
pascal.util.graph.Edge
and its subclasses. - Change return type of
Exp.getUses()
toSet<RValue>
. - Change return type of
Stmt.getUses()
toSet<RValue>
.
- Change
0.0.3 - 2022-08-02
- First release.