[NFC] Fix stale hyperlinks after GitHub organization and repo movement (llvm#2569)

saiislam · web-flow · commit 2d45b35c0118 · 2025-06-17T11:01:19.000+05:30
diff --git a/amd/comgr/test/source/multiple-note-records-one-kernel.s b/amd/comgr/test/source/multiple-note-records-one-kernel.s
@@ -120,7 +120,7 @@ _ZN17__HIP_CoordinatesI14__HIP_BlockDimE1xE:
 	.zero	1
 	.size	_ZN17__HIP_CoordinatesI14__HIP_BlockDimE1xE, 1
 
-	.ident	"AMD clang version 17.0.0 (https://github.com/RadeonOpenCompute/llvm-project roc-6.0.0 23483 7208e8d15fbf218deb74483ea8c549c67ca4985e)"
+	.ident	"AMD clang version 17.0.0 (https://github.com/ROCm/llvm-project roc-6.0.0 23483 7208e8d15fbf218deb74483ea8c549c67ca4985e)"
 	.section	".note.GNU-stack"
 	.addrsig
 	.amdgpu_metadata
diff --git a/amd/comgr/test/source/multiple-note-records.s b/amd/comgr/test/source/multiple-note-records.s
@@ -216,7 +216,7 @@ _ZN17__HIP_CoordinatesI14__HIP_BlockDimE1xE:
 	.zero	1
 	.size	_ZN17__HIP_CoordinatesI14__HIP_BlockDimE1xE, 1
 
-	.ident	"AMD clang version 17.0.0 (https://github.com/RadeonOpenCompute/llvm-project roc-6.0.0 23483 7208e8d15fbf218deb74483ea8c549c67ca4985e)"
+	.ident	"AMD clang version 17.0.0 (https://github.com/ROCm/llvm-project roc-6.0.0 23483 7208e8d15fbf218deb74483ea8c549c67ca4985e)"
 	.section	".note.GNU-stack"
 	.addrsig
 	.amdgpu_metadata
diff --git a/amd/device-libs/CMakeLists.txt b/amd/device-libs/CMakeLists.txt
@@ -106,7 +106,7 @@ if(CMAKE_SOURCE_DIR STREQUAL CMAKE_CURRENT_SOURCE_DIR)
   set ( CPACK_PACKAGE_DESCRIPTION_SUMMARY "Radeon Open Compute - device libraries" )
   set ( CPACK_PACKAGE_DESCRIPTION "This package includes LLVM bitcode libraries." )
   set ( CPACK_RESOURCE_FILE_LICENSE "${CMAKE_CURRENT_SOURCE_DIR}/LICENSE.TXT" )
-  set ( CPACK_DEBIAN_PACKAGE_HOMEPAGE "https://github.com/RadeonOpenCompute/ROCm-Device-Libs" )
+  set ( CPACK_DEBIAN_PACKAGE_HOMEPAGE "https://github.com/ROCm/llvm-project/tree/amd-staging/amd/device-libs" )
 
   # Install License file
   install ( FILES "${CPACK_RESOURCE_FILE_LICENSE}"
diff --git a/amd/hipcc/CMakeLists.txt b/amd/hipcc/CMakeLists.txt
@@ -70,7 +70,7 @@ set(CPACK_DEB_COMPONENT_INSTALL ON)
 set(CPACK_DEBIAN_FILE_NAME "DEB-DEFAULT")
 set(CPACK_DEBIAN_PACKAGE_DEPENDS "rocm-core")
 set(CPACK_DEBIAN_PACKAGE_RECOMMENDS "perl (>= 5.0)")
-set(CPACK_DEBIAN_PACKAGE_HOMEPAGE "https://github.com/ROCm-Developer-Tools/HIPCC")
+set(CPACK_DEBIAN_PACKAGE_HOMEPAGE "https://github.com/ROCm/llvm-project/tree/amd-staging/amd/hipcc")
 if(DEFINED ENV{CPACK_DEBIAN_PACKAGE_RELEASE})
   set(CPACK_DEBIAN_PACKAGE_RELEASE $ENV{CPACK_DEBIAN_PACKAGE_RELEASE})
 else()
diff --git a/amd/utils/translate-legacy-branch-to-omnibus-monorepo.sh b/amd/utils/translate-legacy-branch-to-omnibus-monorepo.sh
@@ -13,15 +13,15 @@
 #|
 #|   Value        Repository
 #|   -----------  ---------------------------------------------------------
-#|   comgr        https://github.com/RadeonOpenCompute/ROCm-CompilerSupport
-#|   device-libs  https://github.com/RadeonOpenCompute/ROCm-Device-Libs
-#|   hipcc        https://github.com/ROCm-Developer-Tools/HIPCC
+#|   comgr        https://github.com/ROCm/llvm-project/tree/amd-staging/amd/comgr
+#|   device-libs  https://github.com/ROCm/llvm-project/tree/amd-staging/amd/device-libs
+#|   hipcc        https://github.com/ROCm/llvm-project/tree/amd-staging/amd/hipcc
 #|
 #| BASE-BRANCH identifies the branch upon which the to-be-translated branch is
 #| based (e.g. amd-stg-open).
 #|
 #| The TARGET-REPO-DIR must locate a fresh clone of the ROCm llvm-project
-#| repository (https://github.com/RadeonOpenCompute/llvm-project). If the
+#| repository (https://github.com/ROCm/llvm-project). If the
 #| script is to be invoked repeatedly the same clone may be reused. It is
 #| NOT recommended to use any clone which contains local refs that have not
 #| been saved elsewhere, as they may be clobbered!
diff --git a/llvm/lib/Support/CommandLine.cpp b/llvm/lib/Support/CommandLine.cpp
@@ -2529,7 +2529,7 @@ class VersionPrinter {
 #ifdef PACKAGE_VENDOR
     OS << PACKAGE_VENDOR << " ";
 #else
-    OS << "AOMP-18.0-12 (http://github.com/ROCm-Developer-Tools/aomp):\n Source ID:18.0-12-ce1873ac686bb90ddec72bb99889a4e80e2de382\n  ";
+    OS << "AOMP-18.0-12 (http://github.com/ROCm/aomp):\n Source ID:18.0-12-ce1873ac686bb90ddec72bb99889a4e80e2de382\n  ";
 #endif
     OS << PACKAGE_NAME << " version " << PACKAGE_VERSION << "\n  ";
 #if LLVM_IS_DEBUG_BUILD
diff --git a/openmp/docs/SupportAndFAQ.rst b/openmp/docs/SupportAndFAQ.rst
@@ -103,13 +103,60 @@ time and link against it directly.
 
 Q: How to build an OpenMP AMDGPU offload capable compiler?
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+A subset of the `ROCm <https://github.com/ROCm>`_ toolchain is
+required to build the LLVM toolchain and to execute the openmp application.
+Either install ROCm somewhere that cmake's find_package can locate it, or
+build the required subcomponents ROCt and ROCr from source.
 
-The OpenMP AMDGPU offloading support depends on the ROCm math libraries and the
-HSA ROCr / ROCt runtimes. These are normally provided by a standard ROCm
-installation, but can be built and used independently if desired. Building the
-libraries does not depend on these libraries by default by dynamically loading
-the HSA runtime at program execution. As in the CUDA case, this can be change by
-omitting ``amdgpu`` from the ``LIBOMPTARGET_DLOPEN_PLUGINS`` list.
+The two components used are ROCT-Thunk-Interface, roct, and ROCR-Runtime, rocr.
+Roct is the userspace part of the linux driver. It calls into the driver which
+ships with the linux kernel. It is an implementation detail of Rocr from
+OpenMP's perspective. Rocr is an implementation of `HSA
+<http://www.hsafoundation.com>`_.
+
+.. code-block:: text
+
+  SOURCE_DIR=same-as-llvm-source # e.g. the checkout of llvm-project, next to openmp
+  BUILD_DIR=somewhere
+  INSTALL_PREFIX=same-as-llvm-install
+
+  cd $SOURCE_DIR
+  git clone git@github.com:ROCm/ROCT-Thunk-Interface.git -b roc-4.2.x \
+    --single-branch
+  git clone git@github.com:ROCm/ROCR-Runtime.git -b rocm-4.2.x \
+    --single-branch
+
+  cd $BUILD_DIR && mkdir roct && cd roct
+  cmake $SOURCE_DIR/ROCT-Thunk-Interface/ -DCMAKE_INSTALL_PREFIX=$INSTALL_PREFIX \
+    -DCMAKE_BUILD_TYPE=Release -DBUILD_SHARED_LIBS=OFF
+  make && make install
+
+  cd $BUILD_DIR && mkdir rocr && cd rocr
+  cmake $SOURCE_DIR/ROCR-Runtime/src -DIMAGE_SUPPORT=OFF \
+    -DCMAKE_INSTALL_PREFIX=$INSTALL_PREFIX -DCMAKE_BUILD_TYPE=Release \
+    -DBUILD_SHARED_LIBS=ON
+  make && make install
+
+``IMAGE_SUPPORT`` requires building rocr with clang and is not used by openmp.
+
+Provided cmake's find_package can find the ROCR-Runtime package, LLVM will
+build a tool ``bin/amdgpu-arch`` which will print a string like ``gfx906`` when
+run if it recognises a GPU on the local system. LLVM will also build a shared
+library, libomptarget.rtl.amdgpu.so, which is linked against rocr.
+
+With those libraries installed, then LLVM build and installed, try:
+
+.. code-block:: shell
+
+    clang -O2 -fopenmp -fopenmp-targets=amdgcn-amd-amdhsa example.c -o example && ./example
+
+If your build machine is not the target machine or automatic detection of the
+available GPUs failed, you should also set:
+
+- ``LIBOMPTARGET_DEVICE_ARCHITECTURES='gfx<xyz>;...'`` where ``<xyz>`` is the
+  shader core instruction set architecture. For instance, set 
+  ``LIBOMPTARGET_DEVICE_ARCHITECTURES='gfx906;gfx90a'`` to target AMD GCN5
+  and CDNA2 devices. 
 
 Q: What are the known limitations of OpenMP AMDGPU offload?
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
