Account for immutably borrowed locals in MIR copy-prop and GVN
For the most part, we consider that immutably borrowed `Freeze` locals still fulfill SSA conditions. As the borrow is immutable, any use of the local will have the value given by the single assignment, and there can be no surprise.
This allows copy-prop to merge a non-borrowed local with a borrowed local. We chose to keep copy-classes heads unborrowed, as those may be easier to optimize in later passes.
This also allows to GVN the value behind an immutable borrow. If a SSA local is borrowed, dereferencing that borrow is equivalent to copying the local's value: re-executing the assignment between the borrow and the dereference would be UB.
r? `@ghost` for perf
The mir-opt test format emits MIR to extra files that you can automatically update by specifying
--bless on the command line (just like ui tests updating .stderr files).
--blessable test format
By default 32 bit and 64 bit targets use the same dump files, which can be problematic in the
presence of pointers in constants or other bit width dependent things. In that case you can add
// EMIT_MIR_FOR_EACH_BIT_WIDTH
to your test, causing separate files to be generated for 32bit and 64bit systems.
Testing a particular MIR pass
If you are only testing the behavior of a particular mir-opt pass on some specific input (as is
usually the case), you should add
//@ test-mir-pass: PassName
to the top of the file. This makes sure that other passes don't run which means you'll get the input
you expected and your test won't break when other code changes. This also lets you test passes
that are disabled by default.
Emit a diff of the mir for a specific optimization
This is what you want most often when you want to see how an optimization changes the MIR.
// EMIT_MIR $file_name_of_some_mir_dump.diff
Emit mir after a specific optimization
Use this if you are just interested in the final state after an optimization.
// EMIT_MIR $file_name_of_some_mir_dump.after.mir
Emit mir before a specific optimization
This exists mainly for completeness and is rarely useful.
The LLVM FileCheck tool is used to verify the contents of output MIR against CHECK directives
present in the test file. This works on the runtime MIR, generated by --emit=mir, and not
on the output of a individual passes.
Use // skip-filecheck to prevent FileCheck from running.
To check MIR for function foo, start with a // CHECK-LABEL fn foo( directive.
{{regex}} syntax allows to match regex.
[[name:regex]] syntax allows to bind name to a string matching regex, and refer to it
as [[name]] in later directives, regex should be written not to match a leading space.
Use [[my_local:_.*]] to name a local, and [[my_bb:bb.*]] to name a block.
d2d24e395a