From e98fcb92a0c5a54e6cd3ebaa09c0e073ae595e0f Mon Sep 17 00:00:00 2001 From: Michael Droettboom Date: Fri, 11 Sep 2026 09:46:09 -0400 Subject: [PATCH] Regenerate bindings: !541 Fix documentation parameter matching Generated from 43c69cf36c10812ae3d20bdb6315a502f77d9c31 + maint-13.4 --- cuda_bindings/cuda/bindings/driver.pyx | 52 ++++++++++++------- cuda_bindings/cuda/bindings/nvfatbin.pyx | 13 ++++- cuda_bindings/cuda/bindings/runtime.pyx | 16 +++--- .../docs/source/release/13.5.0-notes.rst | 5 ++ 4 files changed, 61 insertions(+), 25 deletions(-) diff --git a/cuda_bindings/cuda/bindings/driver.pyx b/cuda_bindings/cuda/bindings/driver.pyx index 781d040c1f7..71df2a8e43b 100644 --- a/cuda_bindings/cuda/bindings/driver.pyx +++ b/cuda_bindings/cuda/bindings/driver.pyx @@ -2,7 +2,7 @@ # SPDX-License-Identifier: Apache-2.0 # This code was automatically generated with version 13.4.1. Do not modify it directly. -# CYTHON-BINDINGS-GENERATED-DO-NOT-MODIFY-THIS-FILE: format=1; content-sha256=79336857bd6bf7884714e40db0ea94f28275fb08b283efa6bae52b1e93529c14 +# CYTHON-BINDINGS-GENERATED-DO-NOT-MODIFY-THIS-FILE: format=1; content-sha256=6bd7ebe1b68edf32a3a0c2768c16c1383f942ddf1f5dc51cc06f8b1792eb9b5d from typing import Any, Optional import cython import ctypes @@ -36431,16 +36431,24 @@ def cuMemPoolGetAttribute(pool, attr not None : CUmemPool_attribute): Parameters ---------- pool : :py:obj:`~.CUmemoryPool` or :py:obj:`~.cudaMemPool_t` - None + The memory pool to get attributes of attr : :py:obj:`~.CUmemPool_attribute` - None + The attribute to get Returns ------- CUresult - + :py:obj:`~.CUDA_SUCCESS`, :py:obj:`~.CUDA_ERROR_NOT_INITIALIZED`, :py:obj:`~.CUDA_ERROR_INVALID_VALUE` value : Any - None + Retrieved value + + See Also + -------- + :py:obj:`~.cuMemAllocAsync`, :py:obj:`~.cuMemFreeAsync`, :py:obj:`~.cuDeviceGetDefaultMemPool`, :py:obj:`~.cuDeviceGetMemPool`, :py:obj:`~.cuMemPoolCreate` + + Notes + ----- + On devices with a single locality domain, mempools created with :py:obj:`~.CU_MEM_LOCATION_TYPE_DEVICE_LOCALITY_DOMAIN` and localityDomainId 0 are equivalent to full-device mempools created with :py:obj:`~.CU_MEM_LOCATION_TYPE_DEVICE`. The value of this attribute will be -1 for such mempools. """ cdef cydriver.CUmemoryPool cypool if pool is None: @@ -47294,7 +47302,7 @@ def cuGraphNodeGetContainingGraph(hNode): ------- CUresult :py:obj:`~.CUDA_SUCCESS` :py:obj:`~.CUDA_ERROR_INVALID_VALUE` - *phGraph : :py:obj:`~.CUgraph` + phGraph : :py:obj:`~.CUgraph` Pointer to return the containing graph See Also @@ -47368,7 +47376,7 @@ def cuGraphNodeGetToolsId(hNode): ------- CUresult :py:obj:`~.CUDA_SUCCESS` :py:obj:`~.CUDA_ERROR_INVALID_VALUE` - *toolsNodeId : unsigned long long + toolsNodeId : unsigned long long Pointer to return the id used by tools See Also @@ -47406,7 +47414,7 @@ def cuGraphGetId(hGraph): ------- CUresult :py:obj:`~.CUDA_SUCCESS` :py:obj:`~.CUDA_ERROR_INVALID_VALUE` - *graphId : unsigned int + graphId : unsigned int Pointer to return the graphId See Also @@ -47444,7 +47452,7 @@ def cuGraphExecGetId(hGraphExec): ------- CUresult :py:obj:`~.CUDA_SUCCESS` :py:obj:`~.CUDA_ERROR_INVALID_VALUE` - *graphId : unsigned int + graphId : unsigned int Pointer to return the graphId See Also @@ -53946,16 +53954,20 @@ def cuGraphicsResourceGetMappedPointer(resource): Parameters ---------- resource : :py:obj:`~.CUgraphicsResource` - None + Mapped resource to access Returns ------- CUresult - + :py:obj:`~.CUDA_SUCCESS`, :py:obj:`~.CUDA_ERROR_DEINITIALIZED`, :py:obj:`~.CUDA_ERROR_NOT_INITIALIZED`, :py:obj:`~.CUDA_ERROR_INVALID_CONTEXT`, :py:obj:`~.CUDA_ERROR_INVALID_VALUE`, :py:obj:`~.CUDA_ERROR_INVALID_HANDLE`, :py:obj:`~.CUDA_ERROR_NOT_MAPPED`, :py:obj:`~.CUDA_ERROR_NOT_MAPPED_AS_POINTER` pDevPtr : :py:obj:`~.CUdeviceptr` - None + Returned pointer through which `resource` may be accessed pSize : int - None + Returned size of the buffer accessible starting at `*pPointer` + + See Also + -------- + :py:obj:`~.cuGraphicsMapResources`, :py:obj:`~.cuGraphicsSubResourceGetMappedArray`, :py:obj:`~.cudaGraphicsResourceGetMappedPointer` """ cdef cydriver.CUgraphicsResource cyresource if resource is None: @@ -57168,18 +57180,22 @@ def cuGraphicsResourceGetMappedEglFrame(resource, unsigned int index, unsigned i Parameters ---------- resource : :py:obj:`~.CUgraphicsResource` - None + Registered resource to access. index : unsigned int - None + Index for cubemap surfaces. mipLevel : unsigned int - None + Mipmap level for the subresource to access. Returns ------- CUresult - + :py:obj:`~.CUDA_SUCCESS`, :py:obj:`~.CUDA_ERROR_DEINITIALIZED`, :py:obj:`~.CUDA_ERROR_NOT_INITIALIZED`, :py:obj:`~.CUDA_ERROR_INVALID_CONTEXT`, :py:obj:`~.CUDA_ERROR_INVALID_VALUE`, :py:obj:`~.CUDA_ERROR_INVALID_HANDLE`, :py:obj:`~.CUDA_ERROR_NOT_MAPPED` eglFrame : :py:obj:`~.CUeglFrame` - None + Returned eglFrame. + + See Also + -------- + :py:obj:`~.cuGraphicsMapResources`, :py:obj:`~.cuGraphicsSubResourceGetMappedArray`, :py:obj:`~.cuGraphicsResourceGetMappedPointer`, :py:obj:`~.cudaGraphicsResourceGetMappedEglFrame` """ cdef cydriver.CUgraphicsResource cyresource if resource is None: diff --git a/cuda_bindings/cuda/bindings/nvfatbin.pyx b/cuda_bindings/cuda/bindings/nvfatbin.pyx index 3c64bdcb4d0..be8b01f3db4 100644 --- a/cuda_bindings/cuda/bindings/nvfatbin.pyx +++ b/cuda_bindings/cuda/bindings/nvfatbin.pyx @@ -3,7 +3,7 @@ # SPDX-License-Identifier: Apache-2.0 # # This code was automatically generated across versions from 12.4.1 to 13.4.1. Do not modify it directly. -# CYTHON-BINDINGS-GENERATED-DO-NOT-MODIFY-THIS-FILE: format=1; content-sha256=b5d55e220498d5f9a4ea3993256cb5e66063e990616da21b03feb12e39fafeac +# CYTHON-BINDINGS-GENERATED-DO-NOT-MODIFY-THIS-FILE: format=1; content-sha256=a7028b3fc77724f1ea7c5c49302cfe8524b85554b73eaf754231ac9bfc26c0f7 # <<<< PREAMBLE CONTENT >>>> @@ -320,6 +320,17 @@ cpdef tuple version(): cpdef add_index(intptr_t handle, code, size_t size, identifier): + """nvFatbinAddIndex adds an index file to the fatbinary. + + Args: + handle (intptr_t): nvFatbin handle. + code (bytes): The index. + size (size_t): The size of the index. + identifier (str): Name of the index, useful when extracting the + fatbin with tools like cuobjdump. + + .. seealso:: `nvFatbinAddIndex` + """ cdef void* _code_ = _cyb_get_buffer_pointer(code, size, readonly=True) if not isinstance(identifier, str): raise TypeError("identifier must be a Python str") diff --git a/cuda_bindings/cuda/bindings/runtime.pyx b/cuda_bindings/cuda/bindings/runtime.pyx index 4546ed78f45..a7210d90f3e 100644 --- a/cuda_bindings/cuda/bindings/runtime.pyx +++ b/cuda_bindings/cuda/bindings/runtime.pyx @@ -2,7 +2,7 @@ # SPDX-License-Identifier: Apache-2.0 # This code was automatically generated with version 13.4.1. Do not modify it directly. -# CYTHON-BINDINGS-GENERATED-DO-NOT-MODIFY-THIS-FILE: format=1; content-sha256=144b063e6665a8eda3633307d63f7bd708b343d3f3be6f61e0f39b5890fcc76e +# CYTHON-BINDINGS-GENERATED-DO-NOT-MODIFY-THIS-FILE: format=1; content-sha256=3ff83968470ed75fcb6f9869b1ea072055493376a761c571df614c041c70a869 from typing import Any, Optional import cython import ctypes @@ -31352,16 +31352,20 @@ def cudaGraphicsResourceGetMappedPointer(resource): Parameters ---------- resource : :py:obj:`~.cudaGraphicsResource_t` - None + Mapped resource to access Returns ------- cudaError_t - + :py:obj:`~.cudaSuccess`, :py:obj:`~.cudaErrorInvalidValue`, :py:obj:`~.cudaErrorInvalidResourceHandle`, :py:obj:`~.cudaErrorUnknown` devPtr : Any - None + Returned pointer through which `resource` may be accessed size : int - None + Returned size of the buffer accessible starting at `*devPtr` + + See Also + -------- + :py:obj:`~.cudaGraphicsMapResources`, :py:obj:`~.cudaGraphicsSubResourceGetMappedArray`, :py:obj:`~.cuGraphicsResourceGetMappedPointer` """ cdef cyruntime.cudaGraphicsResource_t cyresource if resource is None: @@ -34648,7 +34652,7 @@ def cudaGraphNodeGetToolsId(hNode): ------- cudaError_t :py:obj:`~.CUDA_SUCCESS` :py:obj:`~.cudaErrorInvalidValue` - *toolsNodeId : unsigned long long + toolsNodeId : unsigned long long Pointer to return the id used by tools See Also diff --git a/cuda_bindings/docs/source/release/13.5.0-notes.rst b/cuda_bindings/docs/source/release/13.5.0-notes.rst index b6a3956e5ab..c64e702b45b 100644 --- a/cuda_bindings/docs/source/release/13.5.0-notes.rst +++ b/cuda_bindings/docs/source/release/13.5.0-notes.rst @@ -14,6 +14,11 @@ Enhancements - For all ``cuda-bindings`` APIs, functions that accept a ``bytes`` object will also accept ``None``, which is treated as ``NULL``. - For all ``cuda-bindings`` APIs, functions that accept a struct wrapper will accept the struct wrapper directly, rather than requiring getting the ``.ptr`` property. +Bugfixes +-------- + +- A number of incorrect docstrings have been corrected. + Prerelease feature ------------------