asiva
8b2b6b2440
This reverts commit74c5aa3a7a. Reason for revert: Fix golem breakage by not changing the script dart_precompiled_runtime2 TEST=ci Original change's description: > Revert ""[SDK/VM] - Rename dart_precompiled_runtime to dartaotruntime, ensures we have a uniform name for the executable between the build directories and the SDK directory"" > > This reverts commitf81a402aa1. > > Reason for revert: golem benchmarks are failing to run > > TEST=ci > > Original change's description: > > "[SDK/VM] - Rename dart_precompiled_runtime to dartaotruntime, ensures we have a uniform name for the executable between the build directories and the SDK directory" > > > > Fixed golem breakage by temporarily copying dartaotruntime to dart_precompiled_runtime > > > > This reverts commit75e6a748f7. > > > > TEST=ci > > Change-Id: I9efe40643c59bc617f6fb484b89b038deaffbb93 Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/393941 Reviewed-by: Alexander Aprelev <aam@google.com> Commit-Queue: Siva Annamalai <asiva@google.com>
84 lines
2.7 KiB
Markdown
84 lines
2.7 KiB
Markdown
# Writing IL tests for AOT compiler
|
|
|
|
Usually optimized IL strongly depends on TFA results and which makes it
|
|
difficult to test certain AOT optimizations through `run_vm_tests`.
|
|
|
|
In such cases you can attempt to write an IL test instead. In these tests
|
|
test runner will run full AOT pipeline (TFA + `gen_snapshot`), will instruct
|
|
`gen_snapshot` to dump flow graphs of specific methods and then run
|
|
`pkg/vm/tool/compare_il` helper script to compare expectations. Here is how you
|
|
create an IL test.
|
|
|
|
IL tests are placed in files ending with `_il_test.dart`.
|
|
|
|
To run an IL test you need to use `tools/test.py` runner with AOT configuration:
|
|
|
|
```
|
|
# Run against ReleaseX64 AOT compiler
|
|
$ tools/test.py -n dartkp-linux-release-x64 $path_to_an_il_test
|
|
$ tools/test.py -c dartkp -m release $path_to_an_il_test
|
|
```
|
|
|
|
Tests require `gen_snapshot`, `dartaotruntime` and
|
|
`vm_platform_strong.dill` to be built for the target configuration.
|
|
|
|
Each IL test should contain one or more of the functions marked with a
|
|
`@pragma('vm:testing:print-flow-graph'[, 'phases filter'])`.
|
|
|
|
These functions will have their IL dumped at points specified by the
|
|
_phases filter_ (if present, `]AllocateRegisters` by default), which follows
|
|
the same syntax as `--compiler-passes=` flag and dumped IL will be compared
|
|
against the expectations, which are specified programmatically using
|
|
`package:vm/testing/il_matchers.dart` helpers. A function named `foo` has
|
|
its IL expectations in the function called `matchIL$foo` in the same file.
|
|
|
|
```dart
|
|
import 'package:vm/testing/il_matchers.dart';
|
|
|
|
@pragma('vm:testing:print-flow-graph')
|
|
void foo() {
|
|
}
|
|
|
|
/// Expectations for [foo].
|
|
void matchIL$foo(FlowGraph graph) {
|
|
graph.match([/* expectations */]);
|
|
}
|
|
```
|
|
|
|
Actual matching is done by the `pkg/vm/tool/compare_il` script.
|
|
|
|
In order to test IL of the inner (local) function, use
|
|
`@pragma('vm:testing:match-inner-flow-graph', 'inner name')`.
|
|
Specifying a particular phase is not supported for inner closures.
|
|
|
|
## Example
|
|
|
|
```dart
|
|
@pragma('vm:never-inline')
|
|
@pragma('vm:testing:print-flow-graph')
|
|
int factorial(int value) => value == 1 ? value : value * factorial(value - 1);
|
|
|
|
void matchIL$factorial(FlowGraph graph) {
|
|
// Expected a graph which starts with GraphEntry block followed by a
|
|
// FunctionEntry block. FunctionEntry block should contain a Branch()
|
|
// instruction, with EqualityCompare as a comparison.
|
|
graph.match([
|
|
match.block('Graph'),
|
|
match.block('Function', [
|
|
match.Branch(match.EqualityCompare(match.any, match.any, kind: '==')),
|
|
]),
|
|
]);
|
|
}
|
|
|
|
@pragma('vm:testing:match-inner-flow-graph', 'bar')
|
|
void foo() {
|
|
@pragma('vm:testing:print-flow-graph')
|
|
bar() {
|
|
}
|
|
}
|
|
|
|
void matchIL$foo_bar(FlowGraph graph) {
|
|
// Test IL of local bar() in foo().
|
|
}
|
|
```
|