diff --git a/.wordlist.txt b/.wordlist.txt index e4caee5d83..b3161fa928 100644 --- a/.wordlist.txt +++ b/.wordlist.txt @@ -32,6 +32,7 @@ enqueues entrypoint entrypoints enum +enums embeded extern fatbinary diff --git a/docs/doxygen/Doxyfile b/docs/doxygen/Doxyfile index b0e7231aa6..e7a8784eb2 100644 --- a/docs/doxygen/Doxyfile +++ b/docs/doxygen/Doxyfile @@ -829,8 +829,7 @@ WARN_LOGFILE = # spaces. See also FILE_PATTERNS and EXTENSION_MAPPING # Note: If this tag is empty the current directory is searched. -INPUT = mainpage.md \ - ../../include/hip \ +INPUT = ../../include/hip \ ../../../clr/hipamd/include/hip/amd_detail/amd_hip_gl_interop.h \ ../../../clr/hipamd/include/hip/amd_detail/amd_surface_functions.h \ ../../../clr/hipamd/include/hip/amd_detail/amd_hip_cooperative_groups.h \ @@ -2207,6 +2206,7 @@ PREDEFINED = "__HIP_PLATFORM_AMD__" \ "__CG_QUALIFIER__=" \ "__CG_STATIC_QUALIFIER__=static" \ "_CG_STATIC_CONST_DECL_=static constexpr" \ + "HIP_PUBLIC_API" \ "HIP_ENABLE_WARP_SYNC_BUILTINS" # If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then this diff --git a/docs/doxygen/mainpage.md b/docs/doxygen/mainpage.md deleted file mode 100644 index 66fb00250a..0000000000 --- a/docs/doxygen/mainpage.md +++ /dev/null @@ -1,34 +0,0 @@ -# HIP Runtime API Reference {#mainpage} - -This is the full HIP Runtime API reference. The API is organized into -[modules](modules.html) based on functionality. - -## List of Modules - -- @ref GlobalDefs -- @ref Driver -- @ref Device -- @ref Execution -- @ref Error -- @ref Stream -- @ref StreamM -- @ref Event -- @ref Memory - - @ref External - - @ref MemoryM - - @ref StreamO - - @ref MemoryD -- @ref PeerToPeer -- @ref Context -- @ref Module -- @ref Occupancy -- @ref Profiler -- @ref Clang -- @ref Texture - - @ref TextureD -- @ref Runtime -- @ref Callback -- @ref Graph -- @ref Virtual -- @ref GL -- @ref Surface diff --git a/docs/index.md b/docs/index.md index 81ffc9c921..a659b9b83a 100644 --- a/docs/index.md +++ b/docs/index.md @@ -54,15 +54,14 @@ On non-AMD platforms, like NVIDIA, HIP provides header files required to support :::{grid-item-card} Reference -* {doc}`/doxygen/html/index` +* [HIP runtime API](./reference/hip_runtime_api_reference) + * [Modules](./reference/hip_runtime_api/modules) + * [Global defines, enums, structs and files](./reference/hip_runtime_api/global_defines_enums_structs_files) +* [HSA runtime API for ROCm](./reference/virtual_rocr) * [C++ language extensions](./reference/cpp_language_extensions) * [C++ language support](./reference/cpp_language_support) * [HIP math API](./reference/math_api) * [Comparing syntax for different APIs](./reference/terms) -* [HSA runtime API for ROCm](./reference/virtual_rocr) -* [HIP managed memory allocation API](./reference/unified_memory_reference) -* [HIP virtual memory management API](./reference/virtual_memory_reference) -* [HIP Cooperative groups API](./reference/cooperative_groups_reference) * [List of deprecated APIs](./reference/deprecated_api_list) * [FP8 numbers in HIP](./reference/fp8_numbers) diff --git a/docs/reference/hip_runtime_api/global_defines_enums_structs_files.rst b/docs/reference/hip_runtime_api/global_defines_enums_structs_files.rst new file mode 100644 index 0000000000..7123ab5d77 --- /dev/null +++ b/docs/reference/hip_runtime_api/global_defines_enums_structs_files.rst @@ -0,0 +1,14 @@ +.. meta:: + :description: The global defines, enum, structs and files reference page. + +.. _global_defines_enums_structs_files_reference: + +******************************************************************************* +Global defines, enums, structs and files +******************************************************************************* + +The structs, define macros, enums and files in the HIP runtime API. + +* :ref:`global_enum_defines_reference` +* :doc:`hip:doxygen/html/annotated` +* :doc:`hip:doxygen/html/files` diff --git a/docs/reference/hip_runtime_api/global_defines_enums_structs_files/global_enum_and_defines.rst b/docs/reference/hip_runtime_api/global_defines_enums_structs_files/global_enum_and_defines.rst new file mode 100644 index 0000000000..0660b13007 --- /dev/null +++ b/docs/reference/hip_runtime_api/global_defines_enums_structs_files/global_enum_and_defines.rst @@ -0,0 +1,12 @@ +.. meta:: + :description: The global enum and defines reference page. + :keywords: AMD, ROCm, HIP, CUDA, global enum, defines + +.. _global_enum_defines_reference: + +******************************************************************************* +Global enum and defines +******************************************************************************* + +.. doxygengroup:: GlobalDefs + :content-only: diff --git a/docs/reference/hip_runtime_api/modules.rst b/docs/reference/hip_runtime_api/modules.rst new file mode 100644 index 0000000000..83c10ccf2e --- /dev/null +++ b/docs/reference/hip_runtime_api/modules.rst @@ -0,0 +1,41 @@ +.. meta:: + :description: The HIP runtime API modules reference page. + :keywords: AMD, ROCm, HIP, CUDA, HIP runtime API modules, modules + +.. _modules_reference: + +******************************************************************************* +Modules +******************************************************************************* + +The API is organized into modules based on functionality. + +* :ref:`initialization_version_reference` +* :ref:`device_management_reference` +* :ref:`execution_control_reference` +* :ref:`error_handling_reference` +* :ref:`stream_management_reference` +* :ref:`stream_memory_operations_reference` +* :ref:`event_management_reference` +* :ref:`memory_management_reference` + + * :ref:`memory_management_deprecated_reference` + * :ref:`external_resource_interoperability_reference` + * :ref:`stream_ordered_memory_allocator_reference` + * :ref:`unified_memory_reference` + * :ref:`virtual_memory_reference` + * :ref:`texture_management_reference` + * :ref:`texture_management_deprecated_reference` + * :ref:`surface_object_reference` + +* :ref:`peer_to_peer_device_memory_access_reference` +* :ref:`context_management_reference` +* :ref:`module_management_reference` +* :ref:`occupancy_reference` +* :ref:`profiler_control_reference` +* :ref:`launch_api_reference` +* :ref:`runtime_compilation_reference` +* :ref:`callback_activity_apis_reference` +* :ref:`graph_management_reference` +* :ref:`opengl_interoperability_reference` +* :ref:`cooperative_groups_reference` diff --git a/docs/reference/hip_runtime_api/modules/callback_activity_apis.rst b/docs/reference/hip_runtime_api/modules/callback_activity_apis.rst new file mode 100644 index 0000000000..d27c59ebbf --- /dev/null +++ b/docs/reference/hip_runtime_api/modules/callback_activity_apis.rst @@ -0,0 +1,12 @@ +.. meta:: + :description: The callback activity APIs reference page. + :keywords: AMD, ROCm, HIP, CUDA, callback activity APIs, callback activity + +.. _callback_activity_apis_reference: + +******************************************************************************* +Callback activity APIs +******************************************************************************* + +.. doxygengroup:: Callback + :content-only: diff --git a/docs/reference/hip_runtime_api/modules/context_management.rst b/docs/reference/hip_runtime_api/modules/context_management.rst new file mode 100644 index 0000000000..83fce7e593 --- /dev/null +++ b/docs/reference/hip_runtime_api/modules/context_management.rst @@ -0,0 +1,12 @@ +.. meta:: + :description: The context management reference page. + :keywords: AMD, ROCm, HIP, CUDA, context management, context + +.. _context_management_reference: + +******************************************************************************* +Context management [deprecated] +******************************************************************************* + +.. doxygengroup:: Context + :content-only: diff --git a/docs/reference/cooperative_groups_reference.rst b/docs/reference/hip_runtime_api/modules/cooperative_groups_reference.rst similarity index 94% rename from docs/reference/cooperative_groups_reference.rst rename to docs/reference/hip_runtime_api/modules/cooperative_groups_reference.rst index 1191edcbb4..6edc01fc95 100644 --- a/docs/reference/cooperative_groups_reference.rst +++ b/docs/reference/hip_runtime_api/modules/cooperative_groups_reference.rst @@ -1,11 +1,13 @@ .. meta:: - :description: This chapter lists types and device API wrappers related to the Cooperative Group feature. Programmers can directly use these API features in their kernels. + :description: This chapter lists types and device API wrappers related to the + Cooperative Group feature. Programmers can directly use these + API features in their kernels. :keywords: AMD, ROCm, HIP, cooperative groups .. _cooperative_groups_reference: ******************************************************************************* -HIP Cooperative groups API +Cooperative groups ******************************************************************************* Cooperative kernel launches diff --git a/docs/reference/hip_runtime_api/modules/device_management.rst b/docs/reference/hip_runtime_api/modules/device_management.rst new file mode 100644 index 0000000000..17b600f5c5 --- /dev/null +++ b/docs/reference/hip_runtime_api/modules/device_management.rst @@ -0,0 +1,12 @@ +.. meta:: + :description: The device management reference page. + :keywords: AMD, ROCm, HIP, CUDA, device management, device + +.. _device_management_reference: + +******************************************************************************* +Device management +******************************************************************************* + +.. doxygengroup:: Device + :content-only: diff --git a/docs/reference/hip_runtime_api/modules/error_handling.rst b/docs/reference/hip_runtime_api/modules/error_handling.rst new file mode 100644 index 0000000000..1e2ec4a1f7 --- /dev/null +++ b/docs/reference/hip_runtime_api/modules/error_handling.rst @@ -0,0 +1,12 @@ +.. meta:: + :description: The error handling reference page. + :keywords: AMD, ROCm, HIP, CUDA, error handling, error + +.. _error_handling_reference: + +******************************************************************************* +Error handling +******************************************************************************* + +.. doxygengroup:: Error + :content-only: diff --git a/docs/reference/hip_runtime_api/modules/event_management.rst b/docs/reference/hip_runtime_api/modules/event_management.rst new file mode 100644 index 0000000000..b4df0d0164 --- /dev/null +++ b/docs/reference/hip_runtime_api/modules/event_management.rst @@ -0,0 +1,12 @@ +.. meta:: + :description: The event management reference page. + :keywords: AMD, ROCm, HIP, CUDA, event management, event + +.. _event_management_reference: + +******************************************************************************* +Event management +******************************************************************************* + +.. doxygengroup:: Event + :content-only: diff --git a/docs/reference/hip_runtime_api/modules/execution_control.rst b/docs/reference/hip_runtime_api/modules/execution_control.rst new file mode 100644 index 0000000000..dfc5b8d5d6 --- /dev/null +++ b/docs/reference/hip_runtime_api/modules/execution_control.rst @@ -0,0 +1,12 @@ +.. meta:: + :description: The execution control reference page. + :keywords: AMD, ROCm, HIP, CUDA, execution control, execution + +.. _execution_control_reference: + +******************************************************************************* +Execution control +******************************************************************************* + +.. doxygengroup:: Execution + :content-only: diff --git a/docs/reference/hip_runtime_api/modules/graph_management.rst b/docs/reference/hip_runtime_api/modules/graph_management.rst new file mode 100644 index 0000000000..6bfca89c2f --- /dev/null +++ b/docs/reference/hip_runtime_api/modules/graph_management.rst @@ -0,0 +1,12 @@ +.. meta:: + :description: The graph management reference page. + :keywords: AMD, ROCm, HIP, CUDA, graph management, graph + +.. _graph_management_reference: + +******************************************************************************* +Graph management +******************************************************************************* + +.. doxygengroup:: Graph + :content-only: diff --git a/docs/reference/hip_runtime_api/modules/initialization_and_version.rst b/docs/reference/hip_runtime_api/modules/initialization_and_version.rst new file mode 100644 index 0000000000..25809662e5 --- /dev/null +++ b/docs/reference/hip_runtime_api/modules/initialization_and_version.rst @@ -0,0 +1,12 @@ +.. meta:: + :description: The initialization and version reference page. + :keywords: AMD, ROCm, HIP, CUDA, initialization, version + +.. _initialization_version_reference: + +******************************************************************************* +Initialization and version +******************************************************************************* + +.. doxygengroup:: Driver + :content-only: diff --git a/docs/reference/hip_runtime_api/modules/launch_api.rst b/docs/reference/hip_runtime_api/modules/launch_api.rst new file mode 100644 index 0000000000..ddd3c32c94 --- /dev/null +++ b/docs/reference/hip_runtime_api/modules/launch_api.rst @@ -0,0 +1,12 @@ +.. meta:: + :description: The launch API reference page. + :keywords: AMD, ROCm, HIP, CUDA, launch API, triple-chevron + +.. _launch_api_reference: + +******************************************************************************* +Launch API +******************************************************************************* + +.. doxygengroup:: Clang + :content-only: diff --git a/docs/reference/hip_runtime_api/modules/memory_management.rst b/docs/reference/hip_runtime_api/modules/memory_management.rst new file mode 100644 index 0000000000..f78805b8f2 --- /dev/null +++ b/docs/reference/hip_runtime_api/modules/memory_management.rst @@ -0,0 +1,12 @@ +.. meta:: + :description: The memory management reference page. + :keywords: AMD, ROCm, HIP, CUDA, memory management, memory + +.. _memory_management_reference: + +******************************************************************************* +Memory management +******************************************************************************* + +.. doxygengroup:: Memory + :content-only: diff --git a/docs/reference/hip_runtime_api/modules/memory_management/external_resource_interoperability.rst b/docs/reference/hip_runtime_api/modules/memory_management/external_resource_interoperability.rst new file mode 100644 index 0000000000..c002d5136c --- /dev/null +++ b/docs/reference/hip_runtime_api/modules/memory_management/external_resource_interoperability.rst @@ -0,0 +1,12 @@ +.. meta:: + :description: The external resource interoperability reference page. + :keywords: AMD, ROCm, HIP, CUDA, external resource interoperability + +.. _external_resource_interoperability_reference: + +******************************************************************************* +External resource interoperability +******************************************************************************* + +.. doxygengroup:: External + :content-only: diff --git a/docs/reference/hip_runtime_api/modules/memory_management/memory_management_deprecated.rst b/docs/reference/hip_runtime_api/modules/memory_management/memory_management_deprecated.rst new file mode 100644 index 0000000000..96b8de64f3 --- /dev/null +++ b/docs/reference/hip_runtime_api/modules/memory_management/memory_management_deprecated.rst @@ -0,0 +1,11 @@ +.. meta:: + :description: The deprecated memory management reference page. + +.. _memory_management_deprecated_reference: + +******************************************************************************* +Memory management (deprecated) +******************************************************************************* + +.. doxygengroup:: MemoryD + :content-only: diff --git a/docs/reference/hip_runtime_api/modules/memory_management/stream_ordered_memory_allocator.rst b/docs/reference/hip_runtime_api/modules/memory_management/stream_ordered_memory_allocator.rst new file mode 100644 index 0000000000..39caaba5e3 --- /dev/null +++ b/docs/reference/hip_runtime_api/modules/memory_management/stream_ordered_memory_allocator.rst @@ -0,0 +1,12 @@ +.. meta:: + :description: The stream ordered memory allocator reference page. + :keywords: AMD, ROCm, HIP, CUDA, stream ordered memory allocator + +.. _stream_ordered_memory_allocator_reference: + +******************************************************************************* +Stream ordered memory allocator +******************************************************************************* + +.. doxygengroup:: StreamO + :content-only: diff --git a/docs/reference/hip_runtime_api/modules/memory_management/surface_object.rst b/docs/reference/hip_runtime_api/modules/memory_management/surface_object.rst new file mode 100644 index 0000000000..8ccce297c6 --- /dev/null +++ b/docs/reference/hip_runtime_api/modules/memory_management/surface_object.rst @@ -0,0 +1,12 @@ +.. meta:: + :description: The surface object reference page. + :keywords: AMD, ROCm, HIP, CUDA, surface object, surface + +.. _surface_object_reference: + +******************************************************************************* +Surface object +******************************************************************************* + +.. doxygengroup:: Surface + :content-only: diff --git a/docs/reference/hip_runtime_api/modules/memory_management/texture_management.rst b/docs/reference/hip_runtime_api/modules/memory_management/texture_management.rst new file mode 100644 index 0000000000..4688d5df72 --- /dev/null +++ b/docs/reference/hip_runtime_api/modules/memory_management/texture_management.rst @@ -0,0 +1,12 @@ +.. meta:: + :description: The texture management reference page. + :keywords: AMD, ROCm, HIP, CUDA, texture management, texture + +.. _texture_management_reference: + +******************************************************************************* +Texture management +******************************************************************************* + +.. doxygengroup:: Texture + :content-only: diff --git a/docs/reference/hip_runtime_api/modules/memory_management/texture_management_deprecated.rst b/docs/reference/hip_runtime_api/modules/memory_management/texture_management_deprecated.rst new file mode 100644 index 0000000000..886a446dbc --- /dev/null +++ b/docs/reference/hip_runtime_api/modules/memory_management/texture_management_deprecated.rst @@ -0,0 +1,12 @@ +.. meta:: + :description: The deprecated texture management reference page. + :keywords: AMD, ROCm, HIP, CUDA, deprecated texture management + +.. _texture_management_deprecated_reference: + +******************************************************************************* +Texture management (deprecated) +******************************************************************************* + +.. doxygengroup:: TextureD + :content-only: diff --git a/docs/reference/unified_memory_reference.rst b/docs/reference/hip_runtime_api/modules/memory_management/unified_memory_reference.rst similarity index 67% rename from docs/reference/unified_memory_reference.rst rename to docs/reference/hip_runtime_api/modules/memory_management/unified_memory_reference.rst index 12922d7664..828d4fdcd4 100644 --- a/docs/reference/unified_memory_reference.rst +++ b/docs/reference/hip_runtime_api/modules/memory_management/unified_memory_reference.rst @@ -1,12 +1,11 @@ .. meta:: - :description: This chapter describes introduces Unified Memory (UM) and shows - how to use it in AMD HIP. + :description: The managed memory reference page. :keywords: AMD, ROCm, HIP, CUDA, unified memory, unified, memory, UM, APU .. _unified_memory_reference: ******************************************************************************* -HIP managed memory allocation API +Managed memory ******************************************************************************* .. doxygengroup:: MemoryM diff --git a/docs/reference/virtual_memory_reference.rst b/docs/reference/hip_runtime_api/modules/memory_management/virtual_memory_reference.rst similarity index 67% rename from docs/reference/virtual_memory_reference.rst rename to docs/reference/hip_runtime_api/modules/memory_management/virtual_memory_reference.rst index d8ef7ebd5c..e46b6d91e4 100644 --- a/docs/reference/virtual_memory_reference.rst +++ b/docs/reference/hip_runtime_api/modules/memory_management/virtual_memory_reference.rst @@ -1,12 +1,11 @@ .. meta:: - :description: This topic describes introduces Virtual Memory (VM) and shows - how to use it in AMD HIP. + :description: The virtual memory (VM) management reference page. :keywords: AMD, ROCm, HIP, CUDA, virtual memory, virtual, memory, VM .. _virtual_memory_reference: ******************************************************************************* -HIP virtual memory management API +Virtual memory management ******************************************************************************* .. doxygengroup:: Virtual diff --git a/docs/reference/hip_runtime_api/modules/module_management.rst b/docs/reference/hip_runtime_api/modules/module_management.rst new file mode 100644 index 0000000000..6a5b645b9b --- /dev/null +++ b/docs/reference/hip_runtime_api/modules/module_management.rst @@ -0,0 +1,12 @@ +.. meta:: + :description: The module management reference page. + :keywords: AMD, ROCm, HIP, CUDA, module management, module + +.. _module_management_reference: + +******************************************************************************* +Module management +******************************************************************************* + +.. doxygengroup:: Module + :content-only: diff --git a/docs/reference/hip_runtime_api/modules/occupancy.rst b/docs/reference/hip_runtime_api/modules/occupancy.rst new file mode 100644 index 0000000000..492c3f2310 --- /dev/null +++ b/docs/reference/hip_runtime_api/modules/occupancy.rst @@ -0,0 +1,12 @@ +.. meta:: + :description: The occupancy reference page. + :keywords: AMD, ROCm, HIP, CUDA, occupancy + +.. _occupancy_reference: + +******************************************************************************* +Occupancy +******************************************************************************* + +.. doxygengroup:: Occupancy + :content-only: diff --git a/docs/reference/hip_runtime_api/modules/opengl_interoperability.rst b/docs/reference/hip_runtime_api/modules/opengl_interoperability.rst new file mode 100644 index 0000000000..d90a790fbf --- /dev/null +++ b/docs/reference/hip_runtime_api/modules/opengl_interoperability.rst @@ -0,0 +1,12 @@ +.. meta:: + :description: The OpenGL interoperability reference page. + :keywords: AMD, ROCm, HIP, CUDA, OpenGL interoperability, OpenGL interop + +.. _opengl_interoperability_reference: + +******************************************************************************* +OpenGL interoperability +******************************************************************************* + +.. doxygengroup:: GL + :content-only: diff --git a/docs/reference/hip_runtime_api/modules/peer_to_peer_device_memory_access.rst b/docs/reference/hip_runtime_api/modules/peer_to_peer_device_memory_access.rst new file mode 100644 index 0000000000..2797776ae4 --- /dev/null +++ b/docs/reference/hip_runtime_api/modules/peer_to_peer_device_memory_access.rst @@ -0,0 +1,12 @@ +.. meta:: + :description: The peer to peer device memory access reference page. + :keywords: AMD, ROCm, HIP, CUDA, peer to peer device memory access, peer to peer + +.. _peer_to_peer_device_memory_access_reference: + +******************************************************************************* +Peer to peer device memory access +******************************************************************************* + +.. doxygengroup:: PeerToPeer + :content-only: diff --git a/docs/reference/hip_runtime_api/modules/profiler_control.rst b/docs/reference/hip_runtime_api/modules/profiler_control.rst new file mode 100644 index 0000000000..dd56e485ba --- /dev/null +++ b/docs/reference/hip_runtime_api/modules/profiler_control.rst @@ -0,0 +1,12 @@ +.. meta:: + :description: The profiler control reference page. + :keywords: AMD, ROCm, HIP, CUDA, profiler control, profiler + +.. _profiler_control_reference: + +******************************************************************************* +Profiler control +******************************************************************************* + +.. doxygengroup:: Profiler + :content-only: diff --git a/docs/reference/hip_runtime_api/modules/runtime_compilation.rst b/docs/reference/hip_runtime_api/modules/runtime_compilation.rst new file mode 100644 index 0000000000..7c76c2047e --- /dev/null +++ b/docs/reference/hip_runtime_api/modules/runtime_compilation.rst @@ -0,0 +1,12 @@ +.. meta:: + :description: The runtime compilation reference page. + :keywords: AMD, ROCm, HIP, CUDA, runtime compilation + +.. _runtime_compilation_reference: + +******************************************************************************* +Runtime compilation +******************************************************************************* + +.. doxygengroup:: Runtime + :content-only: diff --git a/docs/reference/hip_runtime_api/modules/stream_management.rst b/docs/reference/hip_runtime_api/modules/stream_management.rst new file mode 100644 index 0000000000..6e5de67d7c --- /dev/null +++ b/docs/reference/hip_runtime_api/modules/stream_management.rst @@ -0,0 +1,12 @@ +.. meta:: + :description: The stream management reference page. + :keywords: AMD, ROCm, HIP, CUDA, stream management, stream + +.. _stream_management_reference: + +******************************************************************************* +Stream management +******************************************************************************* + +.. doxygengroup:: Stream + :content-only: diff --git a/docs/reference/hip_runtime_api/modules/stream_memory_operations.rst b/docs/reference/hip_runtime_api/modules/stream_memory_operations.rst new file mode 100644 index 0000000000..beed1cd314 --- /dev/null +++ b/docs/reference/hip_runtime_api/modules/stream_memory_operations.rst @@ -0,0 +1,12 @@ +.. meta:: + :description: The stream memory operations reference page. + :keywords: AMD, ROCm, HIP, CUDA, stream memory operations + +.. _stream_memory_operations_reference: + +******************************************************************************* +Stream memory operations +******************************************************************************* + +.. doxygengroup:: StreamM + :content-only: diff --git a/docs/reference/hip_runtime_api_reference.rst b/docs/reference/hip_runtime_api_reference.rst new file mode 100644 index 0000000000..e77490f79e --- /dev/null +++ b/docs/reference/hip_runtime_api_reference.rst @@ -0,0 +1,14 @@ +.. meta:: + :description: HIP runtime API reference page + :keywords: AMD, ROCm, HIP, CUDA, HIP runtime API, HIP runtime + +.. _runtime_api_reference: + +******************************************************************************** +HIP runtime API +******************************************************************************** + +The HIP Runtime API reference: + +* :ref:`modules_reference` +* :ref:`global_defines_enums_structs_files_reference` diff --git a/docs/sphinx/_toc.yml.in b/docs/sphinx/_toc.yml.in index b68c200a16..9b942953e0 100644 --- a/docs/sphinx/_toc.yml.in +++ b/docs/sphinx/_toc.yml.in @@ -39,7 +39,48 @@ subtrees: - caption: Reference entries: - - file: doxygen/html/index + - file: reference/hip_runtime_api_reference + subtrees: + - entries: + - file: reference/hip_runtime_api/modules + subtrees: + - entries: + - file: reference/hip_runtime_api/modules/initialization_and_version + - file: reference/hip_runtime_api/modules/device_management + - file: reference/hip_runtime_api/modules/execution_control + - file: reference/hip_runtime_api/modules/error_handling + - file: reference/hip_runtime_api/modules/stream_management + - file: reference/hip_runtime_api/modules/stream_memory_operations + - file: reference/hip_runtime_api/modules/event_management + - file: reference/hip_runtime_api/modules/memory_management + subtrees: + - entries: + - file: reference/hip_runtime_api/modules/memory_management/memory_management_deprecated + - file: reference/hip_runtime_api/modules/memory_management/external_resource_interoperability + - file: reference/hip_runtime_api/modules/memory_management/stream_ordered_memory_allocator + - file: reference/hip_runtime_api/modules/memory_management/unified_memory_reference + - file: reference/hip_runtime_api/modules/memory_management/virtual_memory_reference + - file: reference/hip_runtime_api/modules/memory_management/texture_management + - file: reference/hip_runtime_api/modules/memory_management/texture_management_deprecated + - file: reference/hip_runtime_api/modules/memory_management/surface_object + - file: reference/hip_runtime_api/modules/peer_to_peer_device_memory_access + - file: reference/hip_runtime_api/modules/context_management + - file: reference/hip_runtime_api/modules/module_management + - file: reference/hip_runtime_api/modules/occupancy + - file: reference/hip_runtime_api/modules/profiler_control + - file: reference/hip_runtime_api/modules/launch_api + - file: reference/hip_runtime_api/modules/runtime_compilation + - file: reference/hip_runtime_api/modules/callback_activity_apis + - file: reference/hip_runtime_api/modules/graph_management + - file: reference/hip_runtime_api/modules/opengl_interoperability + - file: reference/hip_runtime_api/modules/cooperative_groups_reference + - file: reference/hip_runtime_api/global_defines_enums_structs_files + subtrees: + - entries: + - file: reference/hip_runtime_api/global_defines_enums_structs_files/global_enum_and_defines + - file: doxygen/html/annotated + - file: doxygen/html/files + - file: reference/virtual_rocr - file: reference/cpp_language_extensions title: C++ language extensions - file: reference/cpp_language_support @@ -47,13 +88,6 @@ subtrees: - file: reference/math_api - file: reference/terms title: Comparing syntax for different APIs - - file: reference/cooperative_groups_reference - title: HIP Cooperative groups API - - file: reference/virtual_rocr - - file: reference/unified_memory_reference - title: HIP managed memory allocation API - - file: reference/virtual_memory_reference - title: HIP virtual memory management API - file: reference/deprecated_api_list title: List of deprecated APIs - file: reference/fp8_numbers