EXSWHTEC-224 - Test cases ID clean up and documentation for Memory Management, Vulkan Interop Memory Management and Peer-to-Peer access

catch/DoxyfileTests

@@ -616,7 +616,7 @@ SORT_MEMBER_DOCS       = YES
 # this will also influence the order of the classes in the class list.
 # The default value is: NO.
 
-SORT_BRIEF_DOCS        = NO
+SORT_BRIEF_DOCS        = YES
 
 # If the SORT_MEMBERS_CTORS_1ST tag is set to YES then doxygen will sort the
 # (brief and detailed) documentation of class members so that constructors and
@@ -635,7 +635,7 @@ SORT_MEMBERS_CTORS_1ST = NO
 # appear in their defined order.
 # The default value is: NO.
 
-SORT_GROUP_NAMES       = NO
+SORT_GROUP_NAMES       = YES
 
 # If the SORT_BY_SCOPE_NAME tag is set to YES, the class list will be sorted by
 # fully-qualified names, including namespaces. If set to NO, the class list will

catch/include/hip_test_defgroups.hh

@@ -131,6 +131,214 @@ THE SOFTWARE.
  * @}
  */
 
+/**
+ * @defgroup MemoryTest Memory Management
+ * @{
+ * This section describes tests for the memory management functions of HIP runtime API.
+ */
+
+/**
+ * @addtogroup hipMemset hipMemset
+ * @{
+ * @ingroup MemoryTest
+ */
+/**
+ * Test Description
+ * ------------------------
+ *  - Validates the case when zero value is set.
+ * Test source
+ * ------------------------
+ *  - unit/memory/hipMemsetFunctional.cc
+ * Test requirements
+ * ------------------------
+ *  - HIP_VERSION >= 5.2
+ */
+TEST_CASE("Unit_hipMemsetFunctional_ZeroValue_hipMemset") {}
+
+/**
+ * Test Description
+ * ------------------------
+ *  - Validates the case when small size is set.
+ * Test source
+ * ------------------------
+ *  - unit/memory/hipMemsetFunctional.cc
+ * Test requirements
+ * ------------------------
+ *  - HIP_VERSION >= 5.2
+ */
+TEST_CASE("Unit_hipMemsetFunctional_SmallSize_hipMemset") {}
+
+/**
+ * Test Description
+ * ------------------------
+ *  - Validates the case when zero size is set.
+ * Test source
+ * ------------------------
+ *  - unit/memory/hipMemsetFunctional.cc
+ * Test requirements
+ * ------------------------
+ *  - HIP_VERSION >= 5.2
+ */
+TEST_CASE("Unit_hipMemsetFunctional_ZeroSize_hipMemset") {}
+/**
+ * End doxygen group hipMemset.
+ * @}
+ */
+
+/**
+ * @addtogroup hipMemsetD32 hipMemsetD32
+ * @{
+ * @ingroup MemoryTest
+ */
+/**
+ * Test Description
+ * ------------------------
+ *  - Validates the case when zero value is set.
+ * Test source
+ * ------------------------
+ *  - unit/memory/hipMemsetFunctional.cc
+ * Test requirements
+ * ------------------------
+ *  - HIP_VERSION >= 5.2
+ */
+TEST_CASE("Unit_hipMemsetFunctional_ZeroValue_hipMemsetD32") {}
+
+/**
+ * Test Description
+ * ------------------------
+ *  - Validates the case when small size is set.
+ * Test source
+ * ------------------------
+ *  - unit/memory/hipMemsetFunctional.cc
+ * Test requirements
+ * ------------------------
+ *  - HIP_VERSION >= 5.2
+ */
+TEST_CASE("Unit_hipMemsetFunctional_SmallSize_hipMemsetD32") {}
+
+/**
+ * Test Description
+ * ------------------------
+ *  - Validates the case when zero size is set.
+ * Test source
+ * ------------------------
+ *  - unit/memory/hipMemsetFunctional.cc
+ * Test requirements
+ * ------------------------
+ *  - HIP_VERSION >= 5.2
+ */
+TEST_CASE("Unit_hipMemsetFunctional_ZeroSize_hipMemsetD32") {}
+/**
+ * End doxygen group hipMemsetD32.
+ * @}
+ */
+
+/**
+ * @addtogroup hipMemsetD16 hipMemsetD16
+ * @{
+ * @ingroup MemoryTest
+ */
+/**
+ * Test Description
+ * ------------------------
+ *  - Validates the case when zero value is set.
+ * Test source
+ * ------------------------
+ *  - unit/memory/hipMemsetFunctional.cc
+ * Test requirements
+ * ------------------------
+ *  - HIP_VERSION >= 5.2
+ */
+TEST_CASE("Unit_hipMemsetFunctional_ZeroValue_hipMemsetD16") {}
+
+/**
+ * Test Description
+ * ------------------------
+ *  - Validates the case when small size is set.
+ * Test source
+ * ------------------------
+ *  - unit/memory/hipMemsetFunctional.cc
+ * Test requirements
+ * ------------------------
+ *  - HIP_VERSION >= 5.2
+ */
+TEST_CASE("Unit_hipMemsetFunctional_SmallSize_hipMemsetD16") {}
+
+/**
+ * Test Description
+ * ------------------------
+ *  - Validates the case when zero size is set.
+ * Test source
+ * ------------------------
+ *  - unit/memory/hipMemsetFunctional.cc
+ * Test requirements
+ * ------------------------
+ *  - HIP_VERSION >= 5.2
+ */
+TEST_CASE("Unit_hipMemsetFunctional_ZeroSize_hipMemsetD16") {}
+/**
+ * End doxygen group hipMemsetD16.
+ * @}
+ */
+
+/**
+ * @addtogroup hipMemsetD8 hipMemsetD8
+ * @{
+ * @ingroup MemoryTest
+ */
+/**
+ * Test Description
+ * ------------------------
+ *  - Validates the case when zero value is set.
+ * Test source
+ * ------------------------
+ *  - unit/memory/hipMemsetFunctional.cc
+ * Test requirements
+ * ------------------------
+ *  - HIP_VERSION >= 5.2
+ */
+TEST_CASE("Unit_hipMemsetFunctional_ZeroValue_hipMemsetD8") {}
+
+/**
+ * Test Description
+ * ------------------------
+ *  - Validates the case when small size is set.
+ * Test source
+ * ------------------------
+ *  - unit/memory/hipMemsetFunctional.cc
+ * Test requirements
+ * ------------------------
+ *  - HIP_VERSION >= 5.2
+ */
+TEST_CASE("Unit_hipMemsetFunctional_SmallSize_hipMemsetD8") {}
+
+/**
+ * Test Description
+ * ------------------------
+ *  - Validates the case when zero size is set.
+ * Test source
+ * ------------------------
+ *  - unit/memory/hipMemsetFunctional.cc
+ * Test requirements
+ * ------------------------
+ *  - HIP_VERSION >= 5.2
+ */
+TEST_CASE("Unit_hipMemsetFunctional_ZeroSize_hipMemsetD8") {} /**
+                                                               * End doxygen group hipMemsetD8.
+                                                               * @}
+                                                               */
+
+/**
+ * End doxygen group MemoryTest.
+ * @}
+ */
+
+/**
+ * @defgroup MemoryMTest Managed Memory
+ * @{
+ * This section describes tests for the managed memory management functions of HIP runtime API.
+ */
+
 /**
  * @defgroup ShflTest warp shuffle function Management
  * @{
@@ -154,7 +362,7 @@ THE SOFTWARE.
 /**
  * @defgroup StreamTest Stream Management
  * @{
- * This section describes the stream management types & functions of HIP runtime API.
+ *This section describes the stream management types& functions of HIP runtime API.
  * @}
  */
 

catch/include/memcpy1d_tests_common.hh

@@ -142,7 +142,7 @@ void MemcpyDeviceToDeviceShell(F memcpy_func, const hipStream_t kernel_stream =
     HIP_CHECK(hipDeviceCanAccessPeer(&can_access_peer, src_device, dst_device));
     if (!can_access_peer) {
       INFO("Peer access cannot be enabled between devices " << src_device << " " << dst_device);
-      return;
+      REQUIRE(can_access_peer);
     }
     HIP_CHECK(hipDeviceEnablePeerAccess(dst_device, 0));
   }

catch/unit/device/hipDeviceEnableDisablePeerAccess.cc

@@ -125,9 +125,9 @@ TEST_CASE("Unit_hipDeviceEnablePeerAccess_negative") {
  * @addtogroup hipDeviceDisablePeerAccess hipDeviceDisablePeerAccess
  * @{
  * @ingroup PeerToPeerTest
- * hipDeviceDisablePeerAccess(int peerDeviceId)` -
- * Disable direct access from current device's virtual address space
- * to memory allocations physically located on a peer device.
+ * `hipDeviceDisablePeerAccess(int peerDeviceId)` -
+ * Disable direct access from current device's virtual address space to memory allocations
+ * physically located on a peer device.
  * ________________________
  * Test cases from other modules:
  *  - @ref Unit_hipDeviceEnableDisablePeerAccess_positive

catch/unit/memory/CMakeLists.txt

@@ -120,8 +120,8 @@ set(TEST_SRC
     hipMemcpyPeer.cc
     hipMemcpyPeer_old.cc
     hipMemcpyPeerAsync.cc
-    hipMemcpyPeerAsync_old.cc
     hipMemcpyWithStream_old.cc
+    hipMemcpyPeerAsync_old.cc
     hipMemcpyWithStream.cc
     hipMemcpyWithStreamMultiThread.cc
     hipMemsetAsyncAndKernel.cc
@@ -132,11 +132,12 @@ set(TEST_SRC
     hipHostMalloc.cc
     hipMemcpy_old.cc
     hipMemcpy_derivatives.cc
-    hipMemcpyAsync.cc
     hipMemcpyAsync_old.cc
+    hipMemcpyAsync.cc
     hipMemcpyAsync_derivatives.cc
     hipMemsetFunctional.cc
     hipMalloc.cc
+    hipExtMallocWithFlags.cc
     hipMallocPitch.cc
     hipMalloc3D.cc
     hipMalloc3DArray.cc