Merge branch 'main' into main

Author: mdboom

cuda_bindings/examples/0_Introduction/clock_nvrtc_test.py

@@ -1,6 +1,13 @@
 # Copyright 2021-2025 NVIDIA Corporation.  All rights reserved.
 # SPDX-License-Identifier: LicenseRef-NVIDIA-SOFTWARE-LICENSE
 
+# ################################################################################
+#
+# This example demonstrates using the device clock for kernel timing via
+# NVRTC-compiled CUDA code.
+#
+# ################################################################################
+
 import platform
 
 import numpy as np

cuda_bindings/examples/0_Introduction/simpleCubemapTexture_test.py

@@ -1,6 +1,12 @@
 # Copyright 2021-2025 NVIDIA Corporation.  All rights reserved.
 # SPDX-License-Identifier: LicenseRef-NVIDIA-SOFTWARE-LICENSE
 
+# ################################################################################
+#
+# This example demonstrates cubemap texture sampling and transformation.
+#
+# ################################################################################
+
 import ctypes
 import sys
 import time

cuda_bindings/examples/0_Introduction/simpleP2P_test.py

@@ -1,6 +1,13 @@
 # Copyright 2021-2025 NVIDIA Corporation.  All rights reserved.
 # SPDX-License-Identifier: LicenseRef-NVIDIA-SOFTWARE-LICENSE
 
+# ################################################################################
+#
+# This example demonstrates peer-to-peer memory access and data transfer
+# between multiple GPUs.
+#
+# ################################################################################
+
 import ctypes
 import platform
 import sys

cuda_bindings/examples/0_Introduction/simpleZeroCopy_test.py

@@ -1,6 +1,13 @@
 # Copyright 2021-2025 NVIDIA Corporation.  All rights reserved.
 # SPDX-License-Identifier: LicenseRef-NVIDIA-SOFTWARE-LICENSE
 
+# ################################################################################
+#
+# This example demonstrates vector addition using zero-copy (mapped) host
+# memory, allowing the GPU to access CPU memory directly.
+#
+# ################################################################################
+
 import ctypes
 import math
 import platform

cuda_bindings/examples/0_Introduction/systemWideAtomics_test.py

@@ -1,6 +1,12 @@
 # Copyright 2021-2025 NVIDIA Corporation.  All rights reserved.
 # SPDX-License-Identifier: LicenseRef-NVIDIA-SOFTWARE-LICENSE
 
+# ################################################################################
+#
+# This example demonstrates system-wide atomic operations on managed memory.
+#
+# ################################################################################
+
 import ctypes
 import os
 import sys

cuda_bindings/examples/0_Introduction/vectorAddDrv_test.py

@@ -1,6 +1,13 @@
 # Copyright 2021-2025 NVIDIA Corporation.  All rights reserved.
 # SPDX-License-Identifier: LicenseRef-NVIDIA-SOFTWARE-LICENSE
 
+# ################################################################################
+#
+# This example demonstrates vector addition using the CUDA Driver API with
+# unified virtual addressing.
+#
+# ################################################################################
+
 import ctypes
 import math
 import sys

cuda_bindings/examples/0_Introduction/vectorAddMMAP_test.py

@@ -1,6 +1,13 @@
 # Copyright 2021-2025 NVIDIA Corporation.  All rights reserved.
 # SPDX-License-Identifier: LicenseRef-NVIDIA-SOFTWARE-LICENSE
 
+# ################################################################################
+#
+# This example demonstrates vector addition using multi-device memory
+# mapping (cuMemCreate, cuMemMap) with virtual address management.
+#
+# ################################################################################
+
 import ctypes
 import math
 import platform

cuda_bindings/examples/2_Concepts_and_Techniques/streamOrderedAllocation_test.py

@@ -1,6 +1,13 @@
 # Copyright 2021-2025 NVIDIA Corporation.  All rights reserved.
 # SPDX-License-Identifier: LicenseRef-NVIDIA-SOFTWARE-LICENSE
 
+# ################################################################################
+#
+# This example demonstrates stream-ordered memory allocation (cudaMallocAsync
+# / cudaFreeAsync) and memory pool release thresholds.
+#
+# ################################################################################
+
 import ctypes
 import math
 import platform

cuda_bindings/examples/3_CUDA_Features/globalToShmemAsyncCopy_test.py

@@ -1,6 +1,13 @@
 # Copyright 2021-2025 NVIDIA Corporation.  All rights reserved.
 # SPDX-License-Identifier: LicenseRef-NVIDIA-SOFTWARE-LICENSE
 
+# ################################################################################
+#
+# This example demonstrates asynchronous copy from global to shared memory
+# (memcpy_async) in matrix multiplication kernels.
+#
+# ################################################################################
+
 import ctypes
 import math
 import platform

cuda_bindings/examples/3_CUDA_Features/simpleCudaGraphs_test.py

@@ -1,6 +1,13 @@
 # Copyright 2021-2025 NVIDIA Corporation.  All rights reserved.
 # SPDX-License-Identifier: LicenseRef-NVIDIA-SOFTWARE-LICENSE
 
+# ################################################################################
+#
+# This example demonstrates CUDA Graphs for capture and replay of GPU
+# workloads, including manual graph construction and stream capture.
+#
+# ################################################################################
+
 import ctypes
 import random as rnd