Add HSA functions from ROCR Runtime for HIP 6.2.0

.readthedocs.yaml

@@ -23,3 +23,4 @@ build:
      post_checkout:
        - git clone --depth=1 --single-branch --branch rocdoc-195 https://github.com/StreamHPC/llvm-project.git ../llvm-project
        - git clone --depth=1 --single-branch --branch develop    https://github.com/ROCm/clr.git ../clr
+       - git clone --depth=1 --single-branch --branch master     https://github.com/ROCm/ROCR-Runtime.git ../ROCR-Runtime

docs/doxygen/Doxyfile

@@ -832,7 +832,8 @@ WARN_LOGFILE           =
 INPUT                  = mainpage.md \
                          ../../include/hip \
                          ../../../clr/hipamd/include/hip/amd_detail/amd_hip_gl_interop.h \
-                         ../../../llvm-project/clang/lib/Headers/__clang_hip_math.h
+                         ../../../llvm-project/clang/lib/Headers/__clang_hip_math.h \
+                         ../../../ROCR-Runtime/src/inc/hsa_ext_amd.h
 
 # This tag can be used to specify the character encoding of the source files
 # that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses

docs/index.md

@@ -19,6 +19,7 @@ portable applications for AMD and NVIDIA GPUs from single source code.
 
 * {doc}`/reference/programming_model`
 * {doc}`/doxygen/html/index`
+* [HSA Runtime API for ROCm](./reference/virtual_rocr)
 * [Deprecated APIs](./reference/deprecated_api_list)
 
 :::

docs/reference/virtual_rocr.rst

@@ -0,0 +1,35 @@
+.. meta::
+  :description: This chapter lists user-mode API interfaces and libraries 
+                necessary for host applications to launch compute kernels to 
+                available HSA ROCm kernel agents.
+  :keywords: AMD, ROCm, HIP, HSA, ROCR runtime, virtual memory management
+
+*******************************************************************************
+HSA Runtime API for ROCm
+*******************************************************************************
+
+The following functions are located in the https://github.com/ROCm/ROCR-Runtime repository.
+
+.. doxygenfunction:: hsa_amd_vmem_address_reserve
+
+.. doxygenfunction:: hsa_amd_vmem_address_free
+
+.. doxygenfunction:: hsa_amd_vmem_handle_create
+
+.. doxygenfunction:: hsa_amd_vmem_handle_release
+
+.. doxygenfunction:: hsa_amd_vmem_map
+
+.. doxygenfunction:: hsa_amd_vmem_unmap
+
+.. doxygenfunction:: hsa_amd_vmem_set_access
+
+.. doxygenfunction:: hsa_amd_vmem_get_access
+
+.. doxygenfunction:: hsa_amd_vmem_export_shareable_handle
+
+.. doxygenfunction:: hsa_amd_vmem_import_shareable_handle
+
+.. doxygenfunction:: hsa_amd_vmem_retain_alloc_handle
+
+.. doxygenfunction:: hsa_amd_vmem_get_alloc_properties_from_handle

docs/sphinx/_toc.yml.in

@@ -19,6 +19,8 @@ subtrees:
     - file: old/reference/kernel_language
     - file: doxygen/mainpage.md
       title: API library
+    - file: reference/virtual_rocr
+      title: HSA Runtime API for ROCm
     - file: reference/deprecated_api_list
       title: Deprecated API list