Deploy doc preview for PR 2233 (cc462c6)

Author: cuda-python-bot

docs/pr-preview/pr-2233/cuda-bindings/latest/_sources/environment_variables.rst.txt

@@ -24,6 +24,4 @@ Build-Time Environment Variables
      `cuda-pathfinder 1.5.0 release notes <https://nvidia.github.io/cuda-python/cuda-pathfinder/latest/release/1.5.0-notes.html>`_
      for details and migration guidance.
 
-- ``CUDA_PYTHON_PARSER_CACHING`` : bool, toggles the caching of parsed header files during the cuda-bindings build process. If caching is enabled (``CUDA_PYTHON_PARSER_CACHING`` is True), the cache path is set to ./cache_<library_name>, where <library_name> is derived from the cuda toolkit libraries used to build cuda-bindings.
-
 - ``CUDA_PYTHON_PARALLEL_LEVEL`` (previously ``PARALLEL_LEVEL``) : int, sets the number of threads used in the compilation of extension modules. Not setting it or setting it to 0 would disable parallel builds.

docs/pr-preview/pr-2233/cuda-bindings/latest/_sources/install.rst.txt

@@ -120,11 +120,14 @@ Requirements
 
 * CUDA Toolkit headers[^1]
 * CUDA Runtime static library[^2]
+* A git clone of the repository that includes tags[^3]
 
 [^1]: User projects that ``cimport`` CUDA symbols in Cython must also use CUDA Toolkit (CTK) types as provided by the ``cuda.bindings`` major.minor version. This results in CTK headers becoming a transitive dependency of downstream projects through CUDA Python.
 
 [^2]: The CUDA Runtime static library (``libcudart_static.a`` on Linux, ``cudart_static.lib`` on Windows) is part of the CUDA Toolkit. If using conda packages, it is contained in the ``cuda-cudart-static`` package.
 
+[^3]: The version is derived from git tags via ``setuptools-scm``, so the clone must include tags reaching back to at least the latest ``v*`` tag. Clone with ``git clone https://github.com/NVIDIA/cuda-python.git``; do not use ``--depth`` or ``--no-tags``, since a shallow clone builds without error but produces a bogus version such as ``0.1.dev1+g0d22cb444``. See `Cloning the repository <https://github.com/NVIDIA/cuda-python/blob/main/CONTRIBUTING.md>`_ for details and recovery steps.
+
 Source builds require that the provided CUDA headers are of the same major.minor version as the ``cuda.bindings`` you're trying to build. Despite this requirement, note that the minor version compatibility is still maintained. Use the ``CUDA_PATH`` (or ``CUDA_HOME``) environment variable to specify the location of your headers. If both are set, ``CUDA_PATH`` takes precedence. For example, if your headers are located in ``/usr/local/cuda/include``, then you should set ``CUDA_PATH`` with:
 
 .. code-block:: console

docs/pr-preview/pr-2233/cuda-bindings/latest/_sources/module/driver.rst.txt

@@ -1,6 +1,7 @@
 .. SPDX-FileCopyrightText: Copyright (c) 2021-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
 .. SPDX-License-Identifier: Apache-2.0
 
+.. CYTHON-BINDINGS-GENERATED-DO-NOT-MODIFY-THIS-FILE: format=1; content-sha256=15f77ea651a2deffa7f7ae710189546cff9c23ba311b693207743eaf339a0a9c
 ------
 driver
 ------

docs/pr-preview/pr-2233/cuda-bindings/latest/_sources/module/nvjitlink.rst.txt

@@ -25,6 +25,8 @@ NvJitLink defines the following functions for linking code objects and querying
 .. autofunction:: cuda.bindings.nvjitlink.get_linked_cubin
 .. autofunction:: cuda.bindings.nvjitlink.get_linked_ptx_size
 .. autofunction:: cuda.bindings.nvjitlink.get_linked_ptx
+.. autofunction:: cuda.bindings.nvjitlink.get_linked_ltoir_size
+.. autofunction:: cuda.bindings.nvjitlink.get_linked_ltoir
 .. autofunction:: cuda.bindings.nvjitlink.get_error_log_size
 .. autofunction:: cuda.bindings.nvjitlink.get_error_log
 .. autofunction:: cuda.bindings.nvjitlink.get_info_log_size
@@ -65,6 +67,33 @@ Types
     .. autoattribute:: cuda.bindings.nvjitlink.Result.ERROR_FINALIZE
 
 
+    .. autoattribute:: cuda.bindings.nvjitlink.Result.ERROR_NULL_INPUT
+
+
+    .. autoattribute:: cuda.bindings.nvjitlink.Result.ERROR_INCOMPATIBLE_OPTIONS
+
+
+    .. autoattribute:: cuda.bindings.nvjitlink.Result.ERROR_INCORRECT_INPUT_TYPE
+
+
+    .. autoattribute:: cuda.bindings.nvjitlink.Result.ERROR_ARCH_MISMATCH
+
+
+    .. autoattribute:: cuda.bindings.nvjitlink.Result.ERROR_OUTDATED_LIBRARY
+
+
+    .. autoattribute:: cuda.bindings.nvjitlink.Result.ERROR_MISSING_FATBIN
+
+
+    .. autoattribute:: cuda.bindings.nvjitlink.Result.ERROR_UNRECOGNIZED_ARCH
+
+
+    .. autoattribute:: cuda.bindings.nvjitlink.Result.ERROR_UNSUPPORTED_ARCH
+
+
+    .. autoattribute:: cuda.bindings.nvjitlink.Result.ERROR_LTO_NOT_ENABLED
+
+
 .. autoclass:: cuda.bindings.nvjitlink.InputType
 
     .. autoattribute:: cuda.bindings.nvjitlink.InputType.NONE

docs/pr-preview/pr-2233/cuda-bindings/latest/_sources/module/nvrtc.rst.txt

@@ -1,6 +1,7 @@
 .. SPDX-FileCopyrightText: Copyright (c) 2021-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
 .. SPDX-License-Identifier: Apache-2.0
 
+.. CYTHON-BINDINGS-GENERATED-DO-NOT-MODIFY-THIS-FILE: format=1; content-sha256=9f44170e12fd85fa04fcd599a18d0b6474ec7920be8f28a5c097000eb3ccb0e0
 -----
 nvrtc
 -----

docs/pr-preview/pr-2233/cuda-bindings/latest/_sources/module/runtime.rst.txt

@@ -1,6 +1,7 @@
 .. SPDX-FileCopyrightText: Copyright (c) 2021-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
 .. SPDX-License-Identifier: Apache-2.0
 
+.. CYTHON-BINDINGS-GENERATED-DO-NOT-MODIFY-THIS-FILE: format=1; content-sha256=86b1e47dc2cb6ed343cc979b646bdfb99db65d352605464573a8e1d5b248fce2
 -------
 runtime
 -------
@@ -4184,7 +4185,7 @@ Data types used by CUDA Runtime
 
         Valid for graph nodes, launches. This attribute is graphs-only, and passing it to a launch in a non-capturing stream will result in an error. 
 
-         :cudaLaunchAttributeValue::deviceUpdatableKernelNode::deviceUpdatable can only be set to 0 or 1. Setting the field to 1 indicates that the corresponding kernel node should be device-updatable. On success, a handle will be returned via :py:obj:`~.cudaLaunchAttributeValue.deviceUpdatableKernelNode.devNode` which can be passed to the various device-side update functions to update the node's kernel parameters from within another kernel. For more information on the types of device updates that can be made, as well as the relevant limitations thereof, see :py:obj:`~.cudaGraphKernelNodeUpdatesApply`. 
+         :py:obj:`~.cudaLaunchAttributeValue.deviceUpdatableKernelNode.deviceUpdatable` can only be set to 0 or 1. Setting the field to 1 indicates that the corresponding kernel node should be device-updatable. On success, a handle will be returned via :py:obj:`~.cudaLaunchAttributeValue.deviceUpdatableKernelNode.devNode` which can be passed to the various device-side update functions to update the node's kernel parameters from within another kernel. For more information on the types of device updates that can be made, as well as the relevant limitations thereof, see :py:obj:`~.cudaGraphKernelNodeUpdatesApply`. 
 
          Nodes which are device-updatable have additional restrictions compared to regular kernel nodes. Firstly, device-updatable nodes cannot be removed from their graph via :py:obj:`~.cudaGraphDestroyNode`. Additionally, once opted-in to this functionality, a node cannot opt out, and any attempt to set the deviceUpdatable attribute to 0 will result in an error. Device-updatable kernel nodes also cannot have their attributes copied to/from another kernel node via :py:obj:`~.cudaGraphKernelNodeCopyAttributes`. Graphs containing one or more device-updatable nodes also do not allow multiple instantiation, and neither the graph nor its instantiated version can be passed to :py:obj:`~.cudaGraphExecUpdate`. 
 

docs/pr-preview/pr-2233/cuda-bindings/latest/_sources/release/13.4.0-notes.rst.txt

@@ -0,0 +1,28 @@
+.. SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+.. SPDX-License-Identifier: Apache-2.0
+
+.. module:: cuda.bindings
+
+``cuda-bindings`` 13.4.0 Release notes
+======================================
+
+Deprecation Notices
+-------------------
+
+* Support for using ``cuda-bindings`` with Python 3.10 is deprecated and will be
+  removed in a future version.  Python 3.10 reaches end of life in October 2026
+  per the `CPython support cycle <https://devguide.python.org/versions/>`_.
+
+Prerelease feature
+------------------
+
+A new version of the ``nvrtc`` API is available as ``cuda.bindings._v2.nvrtc``.  The
+primary improvements are: (1) raising exceptions rather than returning error
+codes, (2) uses PEP8-compliant naming, and (3) more performance.  This API is
+still experimental and subject to change.
+
+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``.
+* ``nvml.system_get_process_name`` on WSL can return incorrect values.  To work around this, set the locale to "C" before calling ``nvml.device_get_compute_running_processes_v3`` (which sets the process names) and before calling ``nvml.system_get_process_name``. ``cuda_core`` does this automatically, but users of the raw NVML API will need to do this manually.

docs/pr-preview/pr-2233/cuda-bindings/latest/api.html

@@ -533,6 +533,7 @@
   <div class="bd-toc-item navbar-nav"><p aria-level="2" class="caption" role="heading"><span class="caption-text">Contents:</span></p>
 <ul class="current nav bd-sidenav">
 <li class="toctree-l1 has-children"><a class="reference internal" href="release.html">Release Notes</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
+<li class="toctree-l2"><a class="reference internal" href="release/13.4.0-notes.html">13.4.0</a></li>
 <li class="toctree-l2"><a class="reference internal" href="release/13.3.1-notes.html">13.3.1</a></li>
 <li class="toctree-l2"><a class="reference internal" href="release/13.3.0-notes.html">13.3.0</a></li>
 <li class="toctree-l2"><a class="reference internal" href="release/13.2.0-notes.html">13.2.0</a></li>
@@ -2267,7 +2268,7 @@ <h1>CUDA Python API Reference<a class="headerlink" href="#cuda-python-api-refere
 <li class="toctree-l3"><a class="reference internal" href="module/driver.html#id69"><code class="docutils literal notranslate"><span class="pre">CUdevSmResource</span></code></a></li>
 <li class="toctree-l3"><a class="reference internal" href="module/driver.html#id72"><code class="docutils literal notranslate"><span class="pre">CUdevWorkqueueConfigResource</span></code></a></li>
 <li class="toctree-l3"><a class="reference internal" href="module/driver.html#id75"><code class="docutils literal notranslate"><span class="pre">CUdevWorkqueueResource</span></code></a></li>
-<li class="toctree-l3"><a class="reference internal" href="module/driver.html#id78"><code class="docutils literal notranslate"><span class="pre">CU_DEV_SM_RESOURCE_GROUP_PARAMS</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="module/driver.html#id77"><code class="docutils literal notranslate"><span class="pre">CU_DEV_SM_RESOURCE_GROUP_PARAMS</span></code></a></li>
 <li class="toctree-l3"><a class="reference internal" href="module/driver.html#cuda.bindings.driver.cuGreenCtxCreate"><code class="docutils literal notranslate"><span class="pre">cuGreenCtxCreate()</span></code></a></li>
 <li class="toctree-l3"><a class="reference internal" href="module/driver.html#cuda.bindings.driver.cuGreenCtxDestroy"><code class="docutils literal notranslate"><span class="pre">cuGreenCtxDestroy()</span></code></a></li>
 <li class="toctree-l3"><a class="reference internal" href="module/driver.html#cuda.bindings.driver.cuCtxFromGreenCtx"><code class="docutils literal notranslate"><span class="pre">cuCtxFromGreenCtx()</span></code></a></li>
@@ -3122,6 +3123,8 @@ <h1>CUDA Python API Reference<a class="headerlink" href="#cuda-python-api-refere
 <li class="toctree-l3"><a class="reference internal" href="module/nvjitlink.html#cuda.bindings.nvjitlink.get_linked_cubin"><code class="docutils literal notranslate"><span class="pre">get_linked_cubin()</span></code></a></li>
 <li class="toctree-l3"><a class="reference internal" href="module/nvjitlink.html#cuda.bindings.nvjitlink.get_linked_ptx_size"><code class="docutils literal notranslate"><span class="pre">get_linked_ptx_size()</span></code></a></li>
 <li class="toctree-l3"><a class="reference internal" href="module/nvjitlink.html#cuda.bindings.nvjitlink.get_linked_ptx"><code class="docutils literal notranslate"><span class="pre">get_linked_ptx()</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="module/nvjitlink.html#cuda.bindings.nvjitlink.get_linked_ltoir_size"><code class="docutils literal notranslate"><span class="pre">get_linked_ltoir_size()</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="module/nvjitlink.html#cuda.bindings.nvjitlink.get_linked_ltoir"><code class="docutils literal notranslate"><span class="pre">get_linked_ltoir()</span></code></a></li>
 <li class="toctree-l3"><a class="reference internal" href="module/nvjitlink.html#cuda.bindings.nvjitlink.get_error_log_size"><code class="docutils literal notranslate"><span class="pre">get_error_log_size()</span></code></a></li>
 <li class="toctree-l3"><a class="reference internal" href="module/nvjitlink.html#cuda.bindings.nvjitlink.get_error_log"><code class="docutils literal notranslate"><span class="pre">get_error_log()</span></code></a></li>
 <li class="toctree-l3"><a class="reference internal" href="module/nvjitlink.html#cuda.bindings.nvjitlink.get_info_log_size"><code class="docutils literal notranslate"><span class="pre">get_info_log_size()</span></code></a></li>

docs/pr-preview/pr-2233/cuda-bindings/latest/conduct.html

@@ -537,6 +537,7 @@
   <div class="bd-toc-item navbar-nav"><p aria-level="2" class="caption" role="heading"><span class="caption-text">Contents:</span></p>
 <ul class="current nav bd-sidenav">
 <li class="toctree-l1 has-children"><a class="reference internal" href="release.html">Release Notes</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
+<li class="toctree-l2"><a class="reference internal" href="release/13.4.0-notes.html">13.4.0</a></li>
 <li class="toctree-l2"><a class="reference internal" href="release/13.3.1-notes.html">13.3.1</a></li>
 <li class="toctree-l2"><a class="reference internal" href="release/13.3.0-notes.html">13.3.0</a></li>
 <li class="toctree-l2"><a class="reference internal" href="release/13.2.0-notes.html">13.2.0</a></li>

docs/pr-preview/pr-2233/cuda-bindings/latest/contribute.html

@@ -533,6 +533,7 @@
   <div class="bd-toc-item navbar-nav"><p aria-level="2" class="caption" role="heading"><span class="caption-text">Contents:</span></p>
 <ul class="current nav bd-sidenav">
 <li class="toctree-l1 has-children"><a class="reference internal" href="release.html">Release Notes</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
+<li class="toctree-l2"><a class="reference internal" href="release/13.4.0-notes.html">13.4.0</a></li>
 <li class="toctree-l2"><a class="reference internal" href="release/13.3.1-notes.html">13.3.1</a></li>
 <li class="toctree-l2"><a class="reference internal" href="release/13.3.0-notes.html">13.3.0</a></li>
 <li class="toctree-l2"><a class="reference internal" href="release/13.2.0-notes.html">13.2.0</a></li>