SWDEV-322620 - [catch2][dtest] Adding test for VMM APIs

Change-Id: Ia4dea28601b3c2f0163012a7a2ceb14d3a0c369b

catch/unit/memory/hipMemAddressFree.cc

@@ -0,0 +1,76 @@
+/*
+Copyright (c) 2023 Advanced Micro Devices, Inc. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANNTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER INN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR INN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+*/
+
+/**
+ * @addtogroup hipMemAddressFree hipMemAddressFree
+ * @{
+ * @ingroup MemoryTest
+ * `hipError_t hipMemAddressFree (void* devPtr, size_t size)` -
+ * Frees an address range reservation made via hipMemAddressReserve.
+ */
+
+#include <hip_test_common.hh>
+#include "hip_vmm_common.hh"
+
+#define DATA_SIZE (1 << 13)
+
+/**
+ * Test Description
+ * ------------------------
+ *    - Negative Tests
+ * ------------------------
+ *    - catch\unit\memory\hipMemAddressFree.cc
+ * Test requirements
+ * ------------------------
+ *    - HIP_VERSION >= 6.1
+ */
+TEST_CASE("Unit_hipMemAddressFree_negative") {
+  size_t granularity = 0;
+  constexpr int N = DATA_SIZE;
+  size_t buffer_size = N * sizeof(int);
+  int deviceId = 0;
+  hipDevice_t device;
+  HIP_CHECK(hipDeviceGet(&device, deviceId));
+  checkVMMSupported(device)
+  hipMemAllocationProp prop{};
+  prop.type = hipMemAllocationTypePinned;
+  prop.location.type = hipMemLocationTypeDevice;
+  prop.location.id = device;  // Current Devices
+  HIP_CHECK(hipMemGetAllocationGranularity(&granularity, &prop,
+  hipMemAllocationGranularityMinimum));
+  REQUIRE(granularity > 0);
+  size_t size_mem =
+  ((granularity + buffer_size - 1) / granularity) * granularity;
+  // Allocate virtual address range
+  hipDeviceptr_t ptrA;
+  HIP_CHECK(hipMemAddressReserve(&ptrA, size_mem, 0, 0, 0));
+
+  SECTION("nullptr to devptr") {
+    REQUIRE(hipMemAddressFree(nullptr, size_mem) == hipErrorInvalidValue);
+  }
+
+  SECTION("pass zero to size") {
+    REQUIRE(hipMemAddressFree(ptrA, 0) == hipErrorInvalidValue);
+  }
+
+  HIP_CHECK(hipMemAddressFree(ptrA, size_mem));
+}