Provide idiomatic abstraction for vGPU type information

nvml-wrapper/src/device.rs

@@ -25,6 +25,8 @@ use crate::ffi::bindings::*;
 use crate::struct_wrappers::device::*;
 use crate::structs::device::*;
 
+use crate::vgpu::VgpuType;
+
 #[cfg(target_os = "linux")]
 use std::convert::TryInto;
 #[cfg(target_os = "linux")]
@@ -5058,6 +5060,48 @@ impl<'nvml> Device<'nvml> {
     pub fn link_wrapper_for(&self, link: u32) -> NvLink {
         NvLink { device: self, link }
     }
+
+    // vGPU
+
+    /// Obtain a list of vGPU type (profiles) supported by the device, if any.
+    pub fn vgpu_supported_types(&self) -> Result<Vec<VgpuType>, NvmlError> {
+        let sym = nvml_sym(self.nvml.lib.nvmlDeviceGetSupportedVgpus.as_ref())?;
+        let mut ids = vec![];
+
+        unsafe {
+            let mut count: c_uint = mem::zeroed();
+
+            match nvml_try(sym(self.device, &mut count, ids.as_mut_ptr())) {
+                Ok(()) | Err(NvmlError::InsufficientSize(_)) => {}
+                Err(err) => return Err(err),
+            }
+
+            ids.resize(count as usize, 0);
+            nvml_try(sym(self.device, &mut count, ids.as_mut_ptr()))?;
+        }
+
+        Ok(ids.into_iter().map(|id| VgpuType::new(self, id)).collect())
+    }
+
+    /// Obtain a list of vGPU type (profiles) creatable on the device, if any.
+    pub fn vgpu_creatable_types(&self) -> Result<Vec<VgpuType>, NvmlError> {
+        let sym = nvml_sym(self.nvml.lib.nvmlDeviceGetCreatableVgpus.as_ref())?;
+        let mut ids = vec![];
+
+        unsafe {
+            let mut count: c_uint = mem::zeroed();
+
+            match nvml_try(sym(self.device, &mut count, ids.as_mut_ptr())) {
+                Ok(()) | Err(NvmlError::InsufficientSize(_)) => {}
+                Err(err) => return Err(err),
+            }
+
+            ids.resize(count as usize, 0);
+            nvml_try(sym(self.device, &mut count, ids.as_mut_ptr()))?;
+        }
+
+        Ok(ids.into_iter().map(|id| VgpuType::new(self, id)).collect())
+    }
 }
 
 #[cfg(test)]

nvml-wrapper/src/lib.rs

@@ -109,6 +109,7 @@ pub mod structs;
 #[cfg(test)]
 mod test_utils;
 pub mod unit;
+pub mod vgpu;
 
 // Re-exports for convenience
 pub use crate::device::Device;
@@ -297,6 +298,11 @@ impl Nvml {
         NvmlBuilder::default()
     }
 
+    /// Get the underlying `NvmlLib` instance.
+    pub fn lib(&self) -> &NvmlLib {
+        &self.lib
+    }
+
     /**
     Use this to shutdown NVML and release allocated resources if you care about handling
     potential errors (*the `Drop` implementation ignores errors!*).