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.

Header, binary-utility, bitcode-library, and static-library lookups return resolved absolute paths. Symlinks and parent-directory components (..) are resolved using the filesystem, so the returned path identifies the selected component even when a configured root contains a symlink followed by ... Cached results retain the resolved path selected by the first lookup. Public path values remain strings.

get_cuda_path_or_home()	Get CUDA Toolkit path from environment variables.
SUPPORTED_NVIDIA_LIBNAMES	Tuple of CUDA Toolkit dynamic library names supported by load_nvidia_dynamic_lib() for the current operating system and interpreter architecture.
load_nvidia_dynamic_lib(libname)	Load an NVIDIA dynamic library by name.
LoadedDL(abs_path, ...)
DynamicLibNotFoundError
DynamicLibUnknownError
DynamicLibNotAvailableError
UnsupportedArchError(platform_tag)	Raised when Python reports an unsupported Windows architecture.
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 the header directory for a supported NVIDIA library.
locate_nvidia_header_directory(libname)	Locate the header directory for a supported NVIDIA library.
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 executable.
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)	Find the resolved absolute path to a bitcode library.
locate_bitcode_lib(name)	Locate a bitcode library by name, returning its resolved absolute path.
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)	Find the resolved absolute path to a static library.
locate_static_lib(name)	Locate a static library by name, returning its resolved absolute path.
LocatedStaticLib(name, abs_path, filename, ...)	Information about a located static library.
StaticLibNotFoundError	Raised when a static library cannot be found.