Enum GpuMode 

pub enum GpuMode {
    Auto,
    Required,
    Off,
}

Fail-closed GPU residency mode (issue #1017).

Distinct from GpuPolicy, which governs opportunistic per-kernel dispatch. GpuMode is the process-wide residency contract the resident solver consults through crate::device_runtime::GpuRuntime::global_or_fail:

• GpuMode::Auto — use the device when the probe admits it, fall back to CPU otherwise (the current, working behavior; preserved bit-for-bit).
• GpuMode::Required — the device MUST be available; if the runtime is absent the resident path returns a structured error instead of silently running on the CPU. This is the fail-closed guard the reviewers asked for.
• GpuMode::Off — never use the device.

Variants

Auto

Use the device when available; fall back to CPU otherwise.

Required

Require the device; error (do not fall back) when it is unavailable.

Off

Never use the device.

Implementations

impl GpuMode

pub const fn as_str(self) -> &'static str

Stable lowercase identifier.

Trait Implementations

impl Clone for GpuMode

fn clone(&self) -> GpuMode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for GpuMode

impl Debug for GpuMode

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

Formats the value using the given formatter.

impl Default for GpuMode

fn default() -> GpuMode

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for GpuMode

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for GpuMode

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

Formats the value using the given formatter.

impl Eq for GpuMode

impl PartialEq for GpuMode

fn eq(&self, other: &GpuMode) -> 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 Serialize for GpuMode

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for GpuMode