.. SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
.. SPDX-License-Identifier: LicenseRef-NVIDIA-SOFTWARE-LICENSE

.. module:: cuda.bindings

``cuda-bindings`` 12.9.7 Release notes
======================================

Bugfixes
--------

* Fixed ``CUDA_PYTHON_CUDA_PER_THREAD_DEFAULT_STREAM=0`` incorrectly enabling
  per-thread default stream mode.
  (`PR #2110 <https://github.com/NVIDIA/cuda-python/pull/2110>`_)

* Fixed a use-after-free in ``cudaGraphGetEdges``, ``cudaGraphNodeGetDependencies``,
  ``cudaGraphNodeGetDependentNodes``, ``cudaStreamGetCaptureInfo``, and their
  driver-API counterparts (``cuGraphGetEdges``, ``cuGraphNodeGetDependencies``,
  ``cuGraphNodeGetDependentNodes``, ``cuStreamGetCaptureInfo``). The returned
  ``cudaGraphEdgeData``/``CUgraphEdgeData`` wrappers were backed by a scratch
  buffer that was freed before the call returned, leaving every wrapper holding
  a dangling pointer. The returned wrappers now own deep copies of the edge
  data.
  (`Issue #1804 <https://github.com/NVIDIA/cuda-python/issues/1804>`_,
  `PR #2110 <https://github.com/NVIDIA/cuda-python/pull/2110>`_)

* Fixed a double-free in the generated setters for list-valued struct members
  (e.g. ``CUlaunchConfig.attrs``, ``CUDA_MEM_ALLOC_NODE_PARAMS.accessDescs``,
  external-semaphore and batch-mem-op node parameter arrays, and their runtime
  counterparts). Assigning an empty list freed the internal buffer but left
  the cached pointer non-NULL, so a subsequent assignment or ``__dealloc__``
  would call ``free()`` again on the dangling pointer.
  (`PR #2115 <https://github.com/NVIDIA/cuda-python/pull/2115>`_)

Miscellaneous
-------------

* NVRTC bindings now use pre-generated Cython files and no longer require
  pyclibrary header parsing at build time.
  (`PR #1957 <https://github.com/NVIDIA/cuda-python/pull/1957>`_)

* Improved generated documentation and argument names, including the ``ind_ex``
  argument naming bug.
  (`PR #1928 <https://github.com/NVIDIA/cuda-python/pull/1928>`_,
  `PR #2110 <https://github.com/NVIDIA/cuda-python/pull/2110>`_)

* Source archives now include git archival metadata for setuptools-scm.
  (`PR #1756 <https://github.com/NVIDIA/cuda-python/pull/1756>`_)

Known issues
------------

* Updating from older versions (v12.6.2.post1 and below) via ``pip install -U cuda-python`` might not work. Please do a clean re-installation by uninstalling ``pip uninstall -y cuda-python`` followed by installing ``pip install cuda-python``.