llvm-project/llvm/test/tools/obj2yaml/ELF
Rahman Lavaee 3d6841b2b1 [Propeller] Use Fixed MBB ID instead of volatile MachineBasicBlock::Number.
Let Propeller use specialized IDs for basic blocks, instead of MBB number.

This allows optimizations not just prior to asm-printer, but throughout the entire codegen.
This patch only implements the functionality under the new `LLVM_BB_ADDR_MAP` version, but the old version is still being used. A later patch will change the used version.

####Background
Today Propeller uses machine basic block (MBB) numbers, which already exist, to map native assembly to machine IR.  This is done as follows.
    - Basic block addresses are captured and dumped into the `LLVM_BB_ADDR_MAP` section just before the AsmPrinter pass which writes out object files. This ensures that we have a mapping that is close to assembly.
    - Profiling mapping works by taking a virtual address of an instruction and looking up the `LLVM_BB_ADDR_MAP` section to find the MBB number it corresponds to.
    - While this works well today, we need to do better when we scale Propeller to target other Machine IR optimizations like spill code optimization.  Register allocation happens earlier in the Machine IR pipeline and we need an annotation mechanism that is valid at that point.
    - The current scheme will not work in this scenario because the MBB number of a particular basic block is not fixed and changes over the course of codegen (via renumbering, adding, and removing the basic blocks).
    - In other words, the volatile MBB numbers do not provide a one-to-one correspondence throughout the lifetime of Machine IR.  Profile annotation using MBB numbers is restricted to a fixed point; only valid at the exact point where it was dumped.
    - Further, the object file can only be dumped before AsmPrinter and cannot be dumped at an arbitrary point in the Machine IR pass pipeline.  Hence, MBB numbers are not suitable and we need something else.
####Solution
We propose using fixed unique incremental MBB IDs for basic blocks instead of volatile MBB numbers. These IDs are assigned upon the creation of machine basic blocks. We modify `MachineFunction::CreateMachineBasicBlock` to assign the fixed ID to every newly created basic block.  It assigns `MachineFunction::NextMBBID` to the MBB ID and then increments it, which ensures having unique IDs.

 To ensure correct profile attribution, multiple equivalent compilations must generate the same Propeller IDs. This is guaranteed as long as the MachineFunction passes run in the same order. Since the `NextBBID` variable is scoped to `MachineFunction`, interleaving of codegen for different functions won't cause any inconsistencies.

The new encoding is generated under the new version number 2 and we keep backward-compatibility with older versions.

####Impact on Size of the `LLVM_BB_ADDR_MAP` Section
Emitting the Propeller ID results in a 23% increase in the size of the `LLVM_BB_ADDR_MAP` section for the clang binary.

Reviewed By: tmsriram

Differential Revision: https://reviews.llvm.org/D100808
2023-01-17 15:25:29 -08:00
..
DWARF
aarch64-sym-other.yaml
arm-exidx-section.yaml
bb-addr-map.yaml
call-graph-profile-section.yaml
duplicate-symbol-and-section-names.yaml
dynamic-section-arch-tags.yaml
dynamic-section.yaml
emachine.yaml
entsize.yaml
eshnum.yaml
gnu-hash-section.yaml
gnu-unique-symbols.yaml
hash-section.yaml
implicit-sections-order.yaml
invalid-section-name.yaml
linker-options.yaml
llvm-addrsig-section.yaml
llvm-deplibs-section.yaml
loongarch-eflags.yaml
mips-abi-flags.yaml
mips-eflags.yaml
no-symbol-reloc.yaml
no-symtab.yaml
note-section.yaml
null-section.yaml
offset.yaml
ppc64-relocations.yaml
program-headers.yaml
rel-rela-section.yaml
reladyn-section-shinfo.yaml
relocation-addend.yaml
relocation-type.yaml
relr-section.yaml
retain-section.yaml
riscv-sym-other.yaml
section-group.yaml
section-type.yaml
sections-info.yaml
shinfo.yaml
shlink.yaml
shstrtab.yaml
sht-symtab-shndx.yaml
special-symbol-indices.yaml
stack-sizes.yaml
symbol-type.yaml
symbol-visibility.yaml
symbol.yaml
verdef-section.yaml
verneed-section.yaml
versym-section.yaml