Sync HIP documentation 2025-10-20 (#1258)

* Add examples to tools folder
* Correct P2P memory access section
* Sync poriting guide
* Add HIP Graph tutorial
* Add hint about using amdgpu-dkms for IPC API
* Add a few more env variables

projects/hip/docs/tools/example_codes/device_enumeration.cpp

@@ -0,0 +1,74 @@
+// MIT License
+//
+// Copyright (c) 2025 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 WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS 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 IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+// SOFTWARE.
+
+// [sphinx-start]
+#include <hip/hip_runtime.h>
+
+#include <cstdlib>
+#include <iostream>
+
+#define HIP_CHECK(expression)                        \
+{                                                    \
+    const hipError_t status = expression;            \
+    if (status != hipSuccess)                        \
+    {                                                \
+        std::cerr << "HIP error " << status          \
+                << ": " << hipGetErrorString(status) \
+                << " at " << __FILE__ << ":"         \
+                << __LINE__ << std::endl;            \
+        std::exit(EXIT_FAILURE);                     \
+    }                                                \
+}
+
+int main()
+{
+    int deviceCount;
+    HIP_CHECK(hipGetDeviceCount(&deviceCount));
+    std::cout << "Number of devices: " << deviceCount << std::endl;
+
+    for (int deviceId = 0; deviceId < deviceCount; ++deviceId)
+    {
+        hipDeviceProp_t deviceProp;
+        HIP_CHECK(hipGetDeviceProperties(&deviceProp, deviceId));
+        std::cout << "Device " << deviceId << std::endl << " Properties:" << std::endl;
+        std::cout << "  Name: " << deviceProp.name << std::endl;
+        std::cout << "  Total Global Memory: " << deviceProp.totalGlobalMem / (1024 * 1024) << " MiB" << std::endl;
+        std::cout << "  Shared Memory per Block: " << deviceProp.sharedMemPerBlock / 1024 << " KiB" << std::endl;
+        std::cout << "  Registers per Block: " << deviceProp.regsPerBlock << std::endl;
+        std::cout << "  Warp Size: " << deviceProp.warpSize << std::endl;
+        std::cout << "  Max Threads per Block: " << deviceProp.maxThreadsPerBlock << std::endl;
+        std::cout << "  Max Threads per Multiprocessor: " << deviceProp.maxThreadsPerMultiProcessor << std::endl;
+        std::cout << "  Number of Multiprocessors: " << deviceProp.multiProcessorCount << std::endl;
+        std::cout << "  Max Threads Dimensions: ["
+                << deviceProp.maxThreadsDim[0] << ", "
+                << deviceProp.maxThreadsDim[1] << ", "
+                << deviceProp.maxThreadsDim[2] << "]" << std::endl;
+        std::cout << "  Max Grid Size: ["
+                << deviceProp.maxGridSize[0] << ", "
+                << deviceProp.maxGridSize[1] << ", "
+                << deviceProp.maxGridSize[2] << "]" << std::endl;
+        std::cout << std::endl;
+    }
+
+    return EXIT_SUCCESS;
+}
+// [sphinx-end]