[FEA]: Enhance `load_nvidia_dynamic_lib` error message if a library cannot be found

[ZzEeKkAa]

Is this a duplicate?

• I confirmed there appear to be no duplicate issues for this request and that I agree to the Code of Conduct

Area

cuda.pathfinder

Is your feature request related to a problem? Please describe.

load_nvidia_dynamic_lib does great job in looking for packages, runtime error could be confusing for an end user. It would be nice to have user friendly error if library was not found. For example that is how it is done at nvmath-python: https://github.com/NVIDIA/nvmath-python/blob/main/nvmath/_utils.py#L256-L262

Also some helper function (like runtime_nvidia_library_load_error(library_name:str) ) would be nice so user can add custom wrapper around load_nvidia_dynamic_lib.

Describe the solution you'd like

n/a

Describe alternatives you've considered

No response

Additional context

No response

[rwgk]

Discussed offline:

• We want to create a troubleshooting page in the a cuda-pathfinder documentation (that still needs to be added: Add Sphinx docs for cuda.pathfinder #760)
• Then add a URL pointing to the troubleshooting page from the RuntimeError reporting that the requested library could not be found.

Mock-up (non-existing URL):

cuda.pathfinder._dynamic_libs.load_dl_common.DynamicLibNotFoundError: Failure finding "libnotalib.so"

Please see https://nvidia.github.io/cuda-python/cuda-pathfinder/latest/troubleshooting.html for help.

No such file: libnotalib.so*, No such file: /usr/local/cuda-12.9/lib64/libnotalib.so
...