Skip to content

[MNT] cuda.core: refresh the frozen CUresult explanation table for CUDA 13.3 #2370

Description

@leofang

Summary

_utils/driver_cu_result_explanations_frozen.py
is a fallback table of CUresult explanation strings snapshotted at CUDA Toolkit v13.1.1.

CUDA 13.3 added CUDA_ERROR_GRAPH_RECAPTURE_FAILURE (13.2 added no new driver error codes), so
the new code currently has no fallback explanation text. The error will start appearing once
graph re-capture lands (#2359).

Proposed approach

  • Regenerate the snapshot against CUDA 13.3 using the same process that produced the 13.1.1
    table (helpers are exercised by tests/test_utils_enum_explanations_helpers.py /
    tests/test_cuda_utils.py).
  • If not already covered there: add a tripwire test comparing cuda.bindings CUresult
    members against the table keys, so future toolkit bumps flag missing entries automatically.
  • Consider adding the refresh to the release checklist for new CTK support.

References

  • Found during the CUDA 12.8 → 13.3 bindings vs. cuda.core gap sweep (2026-07-14)

-- Leo's bot

Metadata

Metadata

Assignees

No one assigned

    Labels

    cuda.coreEverything related to the cuda.core moduleenhancementAny code-related improvementstriageNeeds the team's attention

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions