Crate nvml_wrapper_sys
source · [−]Expand description
Rust bindings for the NVIDIA Management Library (NVML), a C-based programmatic interface for monitoring and managing various states within NVIDIA (primarily Tesla) GPUs.
It is intended to be a platform for building 3rd-party applications, and is also the underlying library for NVIDIA’s nvidia-smi tool.
See nvml-wrapper
for a safe wrapper over top of these bindings.
Type of Bindings
These bindings were created using bindgen’s feature to generate wrappers over top
of the functionality that the libloading
crate provides. This means
that they’re designed for loading the NVML library at runtime; they are not suitable
for linking to NVML (statically or dynamically) at buildtime.
This choice was made because NVML is the type of library that you’d realistically always want to load at runtime, for the following reasons:
- NVIDIA doesn’t distribute static versions of NVML, so it isn’t possible to statically link it anyway
- Linking to NVML at buildtime means the resulting binary can only be run on systems that have NVIDIA GPUs and well-formed NVIDIA driver installs
Loading NVML at runtime means it’s possible to drop NVIDIA-related features at runtime on systems that don’t have relevant hardware.
I would be willing to consider maintaining both types of bindings in this crate if there’s a convincing reason to do so; please file an issue.
NVML Support
These bindings were generated for NVML version 11. Each new version of NVML is guaranteed to be backwards-compatible according to NVIDIA, so these bindings should be useful regardless of NVML version bumps.