Struct CdiRegistry 

pub struct CdiRegistry { /* private fields */ }

Registry of all discovered CDI specs, indexed by fully-qualified device name.

A fully-qualified CDI device name has the format vendor.com/class=device, e.g. nvidia.com/gpu=0.

Implementations

impl CdiRegistry

pub fn discover() -> Self

Discover and load CDI specs from the standard directories.

Scans /etc/cdi/ and /var/run/cdi/ for *.json and *.yaml files, parses them, and indexes them by kind. Honors the CDI_SPEC_DIRS environment variable for an additional override search path.

pub fn discover_from<P: AsRef<Path>>(dirs: &[P]) -> Self

Discover and load CDI specs from an explicit list of directories.

This is primarily useful for tests where the standard system paths are not appropriate. Missing directories are silently skipped.

pub fn get_spec(&self, kind: &str) -> Option<&CdiSpec>

Look up a CDI spec by kind (e.g. “nvidia.com/gpu”).

pub fn resolve_device(&self, qualified_name: &str) -> Option<CdiContainerEdits>

Resolve a fully-qualified CDI device name to its container edits.

Format: vendor.com/class=device (e.g. nvidia.com/gpu=0)

Returns the merged container edits (global + device-specific) or None if the device is not found.

pub fn resolve_for_kind( &self, kind: &str, device_names: &[String], ) -> Result<Vec<CdiContainerEdits>, CdiError>

Resolve one or more device names for a given vendor kind into a flat list of per-device container edits.

The special device name "all" expands to every device declared in the spec for the requested vendor — this mirrors the semantics of NVIDIA_VISIBLE_DEVICES=all and matches the behavior of nvidia-ctk’s CDI implementation.

Errors

Returns CdiError::SpecMissing if no spec is loaded for the requested kind. Returns CdiError::DeviceMissing if any of the requested device names is not declared in the spec. Returns CdiError::NoDevices if the request asks for "all" but the spec contains no devices.

pub fn is_empty(&self) -> bool

Check if any CDI specs are available.

pub fn kinds(&self) -> impl Iterator<Item = &str>

Get all available kinds.

pub async fn generate_nvidia_spec() -> Option<CdiSpec>

Generate a CDI spec for NVIDIA GPUs using nvidia-ctk.

Runs nvidia-ctk cdi generate and returns the resulting spec, or None if nvidia-ctk is not available.

Trait Implementations

impl Debug for CdiRegistry

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for CdiRegistry

fn default() -> CdiRegistry

Returns the “default value” for a type.