Analysis Trace view
When you select an issue, the Analysis Trace view displays the relevant analysis trace. This is a set of program points that show how the analyzer found the issue. For dataflow and control flow issues, the set is presented in the order executed. For dataflow issues, this trace view presents the path that the tainted data follows from the source function to the sink function.
For example, when you select an issue that is related to potentially tainted dataflow, the Analysis Trace view shows the direction the dataflow moves in this section of the source code.
The Analysis Trace view uses the symbols described in the following table to show how the dataflow moves in this section of the source code or execution order.
| Symbol | Description |
|---|---|
|
Data is assigned to a field or variable |
|
Information is read from a source external to the code such as an HTML form or a web address |
|
Data is assigned to a globally scoped field or variable |
|
A comparison is made |
|
The function call receives tainted data |
|
The function call returns tainted data |
|
Passthrough, tainted data passes from one place to another This is typically shown as
|
|
An alias is created for a memory location |
|
Data is read from a variable |
|
Data is read from a global variable |
|
Tainted data is returned from a function |
|
A pointer is created |
|
A pointer is dereferenced |
|
The scope of a variable ends |
|
The execution jumps |
|
A branch is taken in the code execution |
|
A branch is not taken in the code execution |
|
Generic |
|
A runtime source, sink, or validation step |
|
Taint change |
The Analysis Trace view can include inductions. Inductions provide supporting evidence for their parent nodes. Inductions consist of:
-
A text node, displayed in italics as a child of the trace node. This text node is expanded by default.
-
An induction trace, displayed as a child of the text node (a box surrounds the induction trace).
The italics and the box distinguish the induction from a standard subtrace. To display the induction reference information for that induction, click it.