[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 `amdgpu-hip-tpl` running on `AMD-bb-w-03` while building `llvm` at step 3 "annotate".

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

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

```
Step 3 (annotate) failure: 'python ../llvm.src/offload/ci/hip-tpl.py ...' (failure)
...
-- Performing Test OPENMP_HAVE_FUNCTION_SECTIONS
-- Performing Test OPENMP_HAVE_FUNCTION_SECTIONS - Failed
-- Performing Test OPENMP_HAVE_DATA_SECTIONS
-- Performing Test OPENMP_HAVE_DATA_SECTIONS - Success
-- check-openmp does nothing.
-- check-runtimes does nothing.
-- Configuring done (9.5s)
-- Generating done (0.0s)
-- Build files have been written to: /home/botworker/bbot/amdgpu-hip-tpl/build/llvm.build/runtimes/runtimes-amdgpu-amd-amdhsa-bins
[ 99%/39.871s :: 20->5->8705 (of 8729)] Building CXX object tools/llvm-calc-occupancy/CMakeFiles/llvm-calc-occupancy.dir/llvm-calc-occupancy.cpp.o
FAILED: tools/llvm-calc-occupancy/CMakeFiles/llvm-calc-occupancy.dir/llvm-calc-occupancy.cpp.o 
ccache /opt/rh/gcc-toolset-13/root/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/botworker/bbot/amdgpu-hip-tpl/build/llvm.build/tools/llvm-calc-occupancy -I/home/botworker/bbot/amdgpu-hip-tpl/llvm.src/llvm/tools/llvm-calc-occupancy -I/home/botworker/bbot/amdgpu-hip-tpl/build/llvm.build/include -I/home/botworker/bbot/amdgpu-hip-tpl/llvm.src/llvm/include -I/home/botworker/bbot/amdgpu-hip-tpl/llvm.src/llvm/lib/Target/AMDGPU -I/home/botworker/bbot/amdgpu-hip-tpl/build/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-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/botworker/bbot/amdgpu-hip-tpl/llvm.src/llvm/tools/llvm-calc-occupancy/llvm-calc-occupancy.cpp
/home/botworker/bbot/amdgpu-hip-tpl/llvm.src/llvm/tools/llvm-calc-occupancy/llvm-calc-occupancy.cpp: In function ‘int main(int, char**)’:
/home/botworker/bbot/amdgpu-hip-tpl/llvm.src/llvm/tools/llvm-calc-occupancy/llvm-calc-occupancy.cpp:229: error: ‘getAddressableNumSGPRs’ is not a member of ‘llvm::AMDGPU::IsaInfo’; did you mean ‘getAddressableNumVGPRs’?
  229 |   unsigned AddrSGPRs = AMDGPU::IsaInfo::getAddressableNumSGPRs(STI);
      | 
[ 99%/41.128s :: 20->2->8708 (of 8729)] Linking CXX executable bin/fir-opt
ninja: build stopped: subcommand failed.
ninja -C llvm.build -j32 exited with return code 1.
@@@STEP_FAILURE@@@
Traceback (most recent call last):
  File "/home/botworker/bbot/amdgpu-hip-tpl/build/../llvm.src/offload/ci/hip-tpl.py", line 93, in <module>
    w.run_ninja(builddir=llvmbuilddir)
  File "/home/botworker/bbot/amdgpu-hip-tpl/llvm.src/.ci/buildbot/worker.py", line 274, in run_ninja
    run_command(cmd, **kwargs)
  File "/home/botworker/bbot/amdgpu-hip-tpl/llvm.src/.ci/buildbot/worker.py", line 132, in run_command
    subprocess.check_call(cmd, shell=shell, env=env, **kwargs)
  File "/opt/python/cp312-cp312/lib/python3.12/subprocess.py", line 413, in check_call
    raise CalledProcessError(retcode, cmd)
subprocess.CalledProcessError: Command '['ninja', '-C', 'llvm.build', '-j32']' returned non-zero exit status 1.
Step 7 (compile llvm) failure: compile llvm (failure)
...
-- Performing Test OPENMP_HAVE_FUNCTION_SECTIONS
-- Performing Test OPENMP_HAVE_FUNCTION_SECTIONS - Failed
-- Performing Test OPENMP_HAVE_DATA_SECTIONS
-- Performing Test OPENMP_HAVE_DATA_SECTIONS - Success
-- check-openmp does nothing.
-- check-runtimes does nothing.
-- Configuring done (9.5s)
-- Generating done (0.0s)
-- Build files have been written to: /home/botworker/bbot/amdgpu-hip-tpl/build/llvm.build/runtimes/runtimes-amdgpu-amd-amdhsa-bins
[ 99%/39.871s :: 20->5->8705 (of 8729)] Building CXX object tools/llvm-calc-occupancy/CMakeFiles/llvm-calc-occupancy.dir/llvm-calc-occupancy.cpp.o
FAILED: tools/llvm-calc-occupancy/CMakeFiles/llvm-calc-occupancy.dir/llvm-calc-occupancy.cpp.o 
ccache /opt/rh/gcc-toolset-13/root/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/botworker/bbot/amdgpu-hip-tpl/build/llvm.build/tools/llvm-calc-occupancy -I/home/botworker/bbot/amdgpu-hip-tpl/llvm.src/llvm/tools/llvm-calc-occupancy -I/home/botworker/bbot/amdgpu-hip-tpl/build/llvm.build/include -I/home/botworker/bbot/amdgpu-hip-tpl/llvm.src/llvm/include -I/home/botworker/bbot/amdgpu-hip-tpl/llvm.src/llvm/lib/Target/AMDGPU -I/home/botworker/bbot/amdgpu-hip-tpl/build/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-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/botworker/bbot/amdgpu-hip-tpl/llvm.src/llvm/tools/llvm-calc-occupancy/llvm-calc-occupancy.cpp
/home/botworker/bbot/amdgpu-hip-tpl/llvm.src/llvm/tools/llvm-calc-occupancy/llvm-calc-occupancy.cpp: In function ‘int main(int, char**)’:
/home/botworker/bbot/amdgpu-hip-tpl/llvm.src/llvm/tools/llvm-calc-occupancy/llvm-calc-occupancy.cpp:229: error: ‘getAddressableNumSGPRs’ is not a member of ‘llvm::AMDGPU::IsaInfo’; did you mean ‘getAddressableNumVGPRs’?
  229 |   unsigned AddrSGPRs = AMDGPU::IsaInfo::getAddressableNumSGPRs(STI);
      | 
[ 99%/41.128s :: 20->2->8708 (of 8729)] Linking CXX executable bin/fir-opt
ninja: build stopped: subcommand failed.
ninja -C llvm.build -j32 exited with return code 1.
Traceback (most recent call last):
  File "/home/botworker/bbot/amdgpu-hip-tpl/build/../llvm.src/offload/ci/hip-tpl.py", line 93, in <module>
    w.run_ninja(builddir=llvmbuilddir)
  File "/home/botworker/bbot/amdgpu-hip-tpl/llvm.src/.ci/buildbot/worker.py", line 274, in run_ninja
    run_command(cmd, **kwargs)
  File "/home/botworker/bbot/amdgpu-hip-tpl/llvm.src/.ci/buildbot/worker.py", line 132, in run_command
    subprocess.check_call(cmd, shell=shell, env=env, **kwargs)
  File "/opt/python/cp312-cp312/lib/python3.12/subprocess.py", line 413, in check_call
    raise CalledProcessError(retcode, cmd)
subprocess.CalledProcessError: Command '['ninja', '-C', 'llvm.build', '-j32']' returned non-zero exit status 1.
program finished with exit code 1
elapsedTime=81.280948

```

</details>

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