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/reference/api_syntax.rst

@@ -11,92 +11,10 @@ example and comparison table. For a complete list of mappings, visit :ref:`HIPIF
 
 The following CUDA code example illustrates several CUDA API syntaxes.
 
-.. code-block:: cpp
-
-  #include <iostream>
-  #include <vector>
-  #include <cuda_runtime.h>
-
-  __global__ void block_reduction(const float* input, float* output, int num_elements)
-  {
-      extern __shared__ float s_data[];
-
-      int tid = threadIdx.x;
-      int global_id = blockDim.x * blockIdx.x + tid;
-
-      if (global_id < num_elements)
-      {
-          s_data[tid] = input[global_id];
-      }
-      else
-      {
-          s_data[tid] = 0.0f;
-      }
-      __syncthreads();
-
-      for (int stride = blockDim.x / 2; stride > 0; stride >>= 1)
-      {
-          if (tid < stride)
-          {
-              s_data[tid] += s_data[tid + stride];
-          }
-          __syncthreads();
-      }
-
-      if (tid == 0)
-      {
-          output[blockIdx.x] = s_data[0];
-      }
-  }
-
-  int main()
-  {
-      int threads = 256;
-      const int num_elements = 50000;
-
-      std::vector<float> h_a(num_elements);
-      std::vector<float> h_b((num_elements + threads - 1) / threads);
-
-      for (int i = 0; i < num_elements; ++i)
-      {
-          h_a[i] = rand() / static_cast<float>(RAND_MAX);
-      }
-
-      float *d_a, *d_b;
-      cudaMalloc(&d_a, h_a.size() * sizeof(float));
-      cudaMalloc(&d_b, h_b.size() * sizeof(float));
-
-      cudaStream_t stream;
-      cudaStreamCreateWithFlags(&stream, cudaStreamNonBlocking);
-
-      cudaEvent_t start_event, stop_event;
-      cudaEventCreate(&start_event);
-      cudaEventCreate(&stop_event);
-
-      cudaMemcpyAsync(d_a, h_a.data(), h_a.size() * sizeof(float), cudaMemcpyHostToDevice, stream);
-
-      cudaEventRecord(start_event, stream);
-
-      int blocks = (num_elements + threads - 1) / threads;
-      block_reduction<<<blocks, threads, threads * sizeof(float), stream>>>(d_a, d_b, num_elements);
-
-      cudaMemcpyAsync(h_b.data(), d_b, h_b.size() * sizeof(float), cudaMemcpyDeviceToHost, stream);
-
-      cudaEventRecord(stop_event, stream);
-      cudaEventSynchronize(stop_event);
-
-      cudaEventElapsedTime(&milliseconds, start_event, stop_event);
-      std::cout << "Kernel execution time: " << milliseconds << " ms\n";
-
-      cudaFree(d_a);
-      cudaFree(d_b);
-
-      cudaEventDestroy(start_event);
-      cudaEventDestroy(stop_event);
-      cudaStreamDestroy(stream);
-
-      return 0;
-  }
+.. literalinclude:: ../tools/example_codes/block_reduction.cu
+    :start-after: // [sphinx-start]
+    :end-before: // [sphinx-end]
+    :language: cpp
 
 The following table maps CUDA API functions to corresponding HIP API functions, as demonstrated in the
 preceding code examples.