Enum GpuDirectCapability 

pub enum GpuDirectCapability {
    Available {
        stats: String,
    },
    Unavailable {
        reason: &'static str,
    },
    FeatureDisabled,
}

Result of probing the host for GPUDirect Storage support.

Variants

Available

The host exposes nvidia-fs and the kernel reports the driver as enabled.

Fields

stats: String

Raw contents of /proc/driver/nvidia-fs/stats at probe time. Useful for diagnostics; the caller is free to parse it further.

Unavailable

Probe ran but nvidia-fs isn’t installed or the driver is disabled. Callers fall back to IORING_OP_READ_FIXED into host-visible GPU memory - still zero-copy past the PCIe root complex, but not bypassed.

Fields

reason: &'static str

Why the capability isn’t present.

FeatureDisabled

The uring-cmd-nvme feature is compiled out; no GPUDirect probe ran. Loudly surface this so a caller that explicitly expected the fast path sees the config mismatch.

Implementations

impl GpuDirectCapability

pub fn probe() -> Self

Probe the host.

Reads /proc/driver/nvidia-fs/stats. Presence of the file + non-empty contents = Available. A file-not-found or permission error = Unavailable with a structured reason. Non-Linux / feature-disabled hosts return FeatureDisabled.

pub fn is_available(&self) -> bool

True when the fast path is available and callers should construct a GpuMappedBuffer::from_bar1_peer-backed region.

Trait Implementations

impl Clone for GpuDirectCapability

fn clone(&self) -> GpuDirectCapability

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for GpuDirectCapability

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

Formats the value using the given formatter.

impl Eq for GpuDirectCapability

impl PartialEq for GpuDirectCapability

fn eq(&self, other: &GpuDirectCapability) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for GpuDirectCapability