[][src]Crate nvml_wrapper_sys

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.