The CodeView S_ARMSWITCHTABLE debug symbol is used to describe the layout of a jump table, it contains the following information:
- The address of the branch instruction that uses the jump table.
- The address of the jump table.
- The "base" address that the values in the jump table are relative to.
- The type of each entry (absolute pointer, a relative integer, a relative integer that is shifted).
Together this information can be used by debuggers and binary analysis tools to understand what an jump table indirect branch is doing and where it might jump to.
Documentation for the symbol can be found in the Microsoft PDB library dumper: https://github.com/microsoft/microsoft-pdb/blob/0fe89a942f9a0f8e061213313e438884f4c9b876/cvdump/dumpsym7.cpp#L5518
This change adds support to LLVM to emit the S_ARMSWITCHTABLE debug symbol as well as to dump it out (for testing purposes).