https://github.com/rust-cuda/cuda-sys
Rust binding to CUDA APIs
https://github.com/rust-cuda/cuda-sys
Last synced: about 1 month ago
JSON representation
Rust binding to CUDA APIs
- Host: GitHub
- URL: https://github.com/rust-cuda/cuda-sys
- Owner: rust-cuda
- License: apache-2.0
- Archived: true
- Created: 2018-11-25T09:03:39.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2025-03-29T06:45:42.000Z (about 2 months ago)
- Last Synced: 2025-03-29T07:27:34.301Z (about 2 months ago)
- Language: Rust
- Size: 375 KB
- Stars: 119
- Watchers: 11
- Forks: 24
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
Awesome Lists containing this project
- awesome-cuda-and-hpc - rust-cuda/cuda-sys - cuda/cuda-sys?style=social"/> : Rust binding to CUDA APIs. (Frameworks)
- awesome-cuda-and-hpc - rust-cuda/cuda-sys - cuda/cuda-sys?style=social"/> : Rust binding to CUDA APIs. (Frameworks)
- awesome-rust-list - rust-cuda/cuda-sys - cuda/cuda-sys?style=social"/> : Rust binding to CUDA APIs. (GPU Programming)
- awesome-rust-list - rust-cuda/cuda-sys - cuda/cuda-sys?style=social"/> : Rust binding to CUDA APIs. (GPU Programming)
README
> [!WARNING]
> This repository has been archived following [the reboot of the Rust-CUDA project](https://rust-gpu.github.io/blog/2025/01/27/rust-cuda-reboot/?s=09).
> Please use [Rust-GPU/Rust-CUDA](https://github.com/Rust-GPU/Rust-CUDA) instead.
cuda-sys
=========
|name |crate.io |docs.rs | CUDA |
|:--------------:|:-----------------------------------------------------------------------------------------------------:|:----------------------------------------------------------------------------------------:|:----:|
|cuda-driver-sys |[](https://crates.io/crates/cuda-driver-sys) |[](https://docs.rs/cuda-driver-sys) | 10.2 |
|cuda-runtime-sys|[](https://crates.io/crates/cuda-runtime-sys)|[](https://docs.rs/cuda-runtime-sys)| 10.2 |
Rust binding to [CUDA Driver (`libcuda.so`)](https://docs.nvidia.com/cuda/cuda-driver-api/index.html)
and [Runtime (`libcudart.so`) APIs](https://docs.nvidia.com/cuda/cuda-runtime-api/index.html)
This crate does **NOT** include CUDA itself. You need to install on your own.
CUDA Installation
------------------
- You should install CUDA from [the official installer](https://developer.nvidia.com/cuda-downloads).
- or use [`nvidia/cuda` container](https://hub.docker.com/r/nvidia/cuda/)
- This container does not add `libcuda.so` to dynamic link path.
You need to add it to your ld path `LD_LIBRARY_PATH=/usr/local/cuda/lib64/stubs` or using `ldconfig`.
CUDA_LIBRARY_PATH environment variable
--------------------------------------
- If you use system installer (e.g. `apt`, `yum`, `pacman`, and so on), the install path may be different.
- `$CUDA_LIBRARY_PATH` (e.g. `/opt/cuda/lib64`) environment value adds paths to the list of library searching.
- `$CUDA_LIBRARY_PATH` is not required on Windows when CUDA is installed via [the official Windows installer](https://developer.nvidia.com/cuda-downloads).
- To verify that cuda-sys can find your CUDA installation, you can check that the `CUDA_PATH` environment variable has been set.
Q & A
------
Q. Program does not *start* (can be compiled) with following error message:
```
error while loading shared libraries: libcuda.so.1: cannot open shared object file: No such file or directory
```
A. Driver API (`libcuda.so`) is sometimes installed in a separate directory. You need to find it, and add to `LD_LIBRARY_PATH`:
```
LD_LIBRARY_PATH=/usr/local/cuda/lib64/stubs
```
License
--------
Dual-licensed to be compatible with the Rust project.
Licensed under the [Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0) or the [MIT license](http://opensource.org/licenses/MIT), at your option.
This file may not be copied, modified, or distributed except according to those terms.
You should check the [End User License Agreement](https://docs.nvidia.com/cuda/eula/index.html),
which describes NVIDIA Software License Agreement and CUDA Supplement to Software License Agreement.