cuda.pathfinder API Reference

The cuda.pathfinder module provides utilities for loading NVIDIA dynamic libraries, locating NVIDIA C/C++ header directories, finding CUDA binary utilities, and locating CUDA bitcode and static libraries.

get_cuda_path_or_home()	Get CUDA Toolkit path from environment variables.
CompatibilityGuardRails(*[, ctk_major, ...])	Resolve CUDA artifacts while enforcing minimal v1 compatibility guard rails.
process_wide_compatibility_guard_rails	Process-wide default compatibility guard rails instance.
CompatibilityCheckError	Raised when compatibility checks reject a resolved item.
CompatibilityInsufficientMetadataError	Raised when v1 compatibility checks cannot reach a definitive answer.
SUPPORTED_NVIDIA_LIBNAMES	Built-in immutable sequence.
load_nvidia_dynamic_lib(libname)	Load a CUDA dynamic library via the process-wide compatibility guard rails.
LoadedDL(abs_path, ...)
DynamicLibNotFoundError
DynamicLibUnknownError
DynamicLibNotAvailableError
SUPPORTED_HEADERS_CTK	Mapping from short CUDA Toolkit (CTK) library names to their canonical header basenames (used to validate a discovered include directory).
find_nvidia_header_directory(libname)	Locate a CUDA header directory and return its path string.
locate_nvidia_header_directory(libname)	Locate a CUDA header directory via the process-wide compatibility guard rails.
LocatedHeaderDir(abs_path, found_via)
SUPPORTED_BINARY_UTILITIES	Tuple of supported CUDA binary utility names that can be located via find_nvidia_binary_utility().
find_nvidia_binary_utility(utility_name)	Locate a CUDA binary utility via the process-wide compatibility guard rails.
SUPPORTED_BITCODE_LIBS	Tuple of supported bitcode library names that can be resolved via locate_bitcode_lib() and find_bitcode_lib().
find_bitcode_lib(name)	Locate a CUDA bitcode library and return its path string.
locate_bitcode_lib(name)	Locate a CUDA bitcode library via the process-wide compatibility guard rails.
LocatedBitcodeLib(name, abs_path, filename, ...)	Information about a located bitcode library.
BitcodeLibNotFoundError	Raised when a bitcode library cannot be found.
SUPPORTED_STATIC_LIBS	Tuple of supported static library names that can be resolved via locate_static_lib() and find_static_lib().
find_static_lib(name)	Locate a CUDA static library and return its path string.
locate_static_lib(name)	Locate a CUDA static library via the process-wide compatibility guard rails.
LocatedStaticLib(name, abs_path, filename, ...)	Information about a located static library.
StaticLibNotFoundError	Raised when a static library cannot be found.