[llvm] [llvm-calc-occupancy] Add an AMDGPU occupancy calculator tool (PR #208727)

[LLVM Continuous Integration via llvm-commits]

llvm-ci wrote:

LLVM Buildbot has detected a new failure on builder `openmp-s390x-linux` running on `systemz-1` while building `llvm` at step 5 "compile-openmp".

Full details are available at: https://lab.llvm.org/buildbot/#/builders/88/builds/24999

<details>
<summary>Here is the relevant piece of the build log for the reference</summary>

```
Step 5 (compile-openmp) failure: build (failure)
...
209.983 [313/4/5518] Linking CXX static library lib/libLLVMX86CodeGen.a
210.008 [312/4/5519] Linking CXX static library lib/libLLVMDWARFLinkerParallel.a
210.032 [311/4/5520] Linking CXX static library lib/libLLVMOptDriver.a
211.282 [310/4/5521] Linking CXX executable bin/lli
/usr/bin/s390x-linux-gnu-ld.bfd: warning: -z pack-relative-relocs ignored
213.392 [309/4/5522] Linking CXX executable bin/llvm-lto
/usr/bin/s390x-linux-gnu-ld.bfd: warning: -z pack-relative-relocs ignored
215.204 [308/4/5523] Linking CXX executable bin/clang-nvlink-wrapper
/usr/bin/s390x-linux-gnu-ld.bfd: warning: -z pack-relative-relocs ignored
215.591 [307/4/5524] Building CXX object tools/llvm-calc-occupancy/CMakeFiles/llvm-calc-occupancy.dir/llvm-calc-occupancy.cpp.o
FAILED: [code=1] tools/llvm-calc-occupancy/CMakeFiles/llvm-calc-occupancy.dir/llvm-calc-occupancy.cpp.o 
CCACHE_CPP2=yes CCACHE_HASHDIR=yes CCACHE_SLOPPINESS=pch_defines,time_macros /usr/bin/ccache /usr/bin/c++ -DLLVM_BUILD_STATIC -D_DEBUG -D_GLIBCXX_ASSERTIONS -D_GLIBCXX_USE_CXX11_ABI=1 -D_GNU_SOURCE -D_LIBCPP_HARDENING_MODE=_LIBCPP_HARDENING_MODE_EXTENSIVE -D__STDC_CONSTANT_MACROS -D__STDC_FORMAT_MACROS -D__STDC_LIMIT_MACROS -I/home/buildbot/sandbox/buildbot/openmp-s390x-linux/llvm.build/tools/llvm-calc-occupancy -I/home/buildbot/sandbox/buildbot/openmp-s390x-linux/llvm.src/llvm/tools/llvm-calc-occupancy -I/home/buildbot/sandbox/buildbot/openmp-s390x-linux/llvm.build/include -I/home/buildbot/sandbox/buildbot/openmp-s390x-linux/llvm.src/llvm/include -I/home/buildbot/sandbox/buildbot/openmp-s390x-linux/llvm.src/llvm/lib/Target/AMDGPU -I/home/buildbot/sandbox/buildbot/openmp-s390x-linux/llvm.build/lib/Target/AMDGPU -fPIC -fno-semantic-interposition -fvisibility-inlines-hidden -Werror=date-time -Wall -Wextra -Wno-unused-parameter -Wwrite-strings -Wcast-qual -Wno-missing-field-initializers -pedantic -Wno-long-long -Wimplicit-fallthrough -Wno-maybe-uninitialized -Wno-nonnull -Wno-class-memaccess -Wno-dangling-reference -Wno-redundant-move -Wno-pessimizing-move -Wno-array-bounds -Wno-stringop-overread -Wno-dangling-pointer -Wno-noexcept-type -Wdelete-non-virtual-dtor -Wsuggest-override -Wno-comment -Wno-misleading-indentation -Wctad-maybe-unsupported -fdiagnostics-color -ffunction-sections -fdata-sections -O3 -DNDEBUG -std=c++17 -UNDEBUG -fno-exceptions -funwind-tables -fno-rtti -MD -MT tools/llvm-calc-occupancy/CMakeFiles/llvm-calc-occupancy.dir/llvm-calc-occupancy.cpp.o -MF tools/llvm-calc-occupancy/CMakeFiles/llvm-calc-occupancy.dir/llvm-calc-occupancy.cpp.o.d -o tools/llvm-calc-occupancy/CMakeFiles/llvm-calc-occupancy.dir/llvm-calc-occupancy.cpp.o -c /home/buildbot/sandbox/buildbot/openmp-s390x-linux/llvm.src/llvm/tools/llvm-calc-occupancy/llvm-calc-occupancy.cpp
/home/buildbot/sandbox/buildbot/openmp-s390x-linux/llvm.src/llvm/tools/llvm-calc-occupancy/llvm-calc-occupancy.cpp: In function ‘int main(int, char**)’:
/home/buildbot/sandbox/buildbot/openmp-s390x-linux/llvm.src/llvm/tools/llvm-calc-occupancy/llvm-calc-occupancy.cpp:229:41: error: ‘getAddressableNumSGPRs’ is not a member of ‘llvm::AMDGPU::IsaInfo’; did you mean ‘getAddressableNumVGPRs’?
  229 |   unsigned AddrSGPRs = AMDGPU::IsaInfo::getAddressableNumSGPRs(STI);
      |                                         ^~~~~~~~~~~~~~~~~~~~~~
      |                                         getAddressableNumVGPRs
215.777 [307/3/5525] Linking CXX executable bin/clang-24
/usr/bin/s390x-linux-gnu-ld.bfd: warning: -z pack-relative-relocs ignored
216.550 [307/2/5526] Linking CXX executable bin/opt
/usr/bin/s390x-linux-gnu-ld.bfd: warning: -z pack-relative-relocs ignored
220.094 [307/1/5527] Linking CXX shared library lib/libclang.so.24.0.0git
/usr/bin/s390x-linux-gnu-ld.bfd: warning: -z pack-relative-relocs ignored
ninja: build stopped: subcommand failed.

```

</details>

https://github.com/llvm/llvm-project/pull/208727