Enum ValidationError 

pub enum ValidationError {
    OutOfRange {
        field: String,
        value: u64,
        max: u64,
    },
    InvalidAlignment {
        address: u64,
        required_alignment: u64,
    },
    InvalidAccessType {
        bits: u8,
    },
    InvalidSecurityState {
        bits: u8,
    },
    InvalidTranslationStage {
        bits: u8,
    },
    InvalidFaultType {
        code: u8,
    },
    InvalidStateTransition {
        from: String,
        to: String,
    },
    PermissionDenied {
        requested: String,
        available: String,
    },
    SecurityViolation {
        from_state: String,
        to_state: String,
    },
    InvalidConfiguration {
        reason: String,
    },
    InvalidPASID {
        value: u32,
    },
    Generic {
        field: String,
        value: String,
        constraint: String,
    },
}

Validation error for newtype wrapper construction and operations

Provides detailed context about validation failures including:

• Field name (e.g., StreamID, PASID)
• Invalid value that was provided
• Constraint that was violated
• Specific error types for different validation scenarios

Examples

use smmu::ValidationError;

let error = ValidationError::OutOfRange {
    field: "PASID".to_string(),
    value: 1_048_576,
    max: 1_048_575,
};

println!("Validation failed: {}", error);

Variants

OutOfRange

Value is out of the valid range

Fields

field: String

Field name

value: u64

Invalid value provided

max: u64

Maximum allowed value

InvalidAlignment

Address is not properly aligned

Fields

address: u64

Address value

required_alignment: u64

Required alignment (e.g., 0x1000 for 4KB pages)

InvalidAccessType

Invalid access type bit pattern

Fields

bits: u8

Invalid bit pattern

InvalidSecurityState

Invalid security state encoding

Fields

bits: u8

Invalid security state bits

InvalidTranslationStage

Invalid translation stage configuration

Fields

bits: u8

Invalid stage bits

InvalidFaultType

Invalid fault type code

Fields

code: u8

Invalid fault code

InvalidStateTransition

Invalid state transition

Fields

from: String

Current state

to: String

Attempted target state

PermissionDenied

Permission denied

Fields

requested: String

Requested permissions

available: String

Available permissions

SecurityViolation

Security violation

Fields

from_state: String

Accessing security state

to_state: String

Target security state

InvalidConfiguration

Invalid configuration

Fields

reason: String

Reason for configuration error

InvalidPASID

Invalid PASID value

Fields

value: u32

Invalid PASID value

Generic

Generic validation error (for backward compatibility)

Fields

field: String

Field name

value: String

Invalid value as string

constraint: String

Constraint description

Implementations

impl ValidationError

pub fn new(field: &str, value: &str, constraint: &str) -> Self

Creates a new generic validation error with context

Arguments

• field - Name of the field that failed validation
• value - The invalid value that was provided
• constraint - Description of the constraint that was violated

Trait Implementations

impl Clone for ValidationError

fn clone(&self) -> ValidationError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ValidationError

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ValidationError

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ValidationError

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

Formats the value using the given formatter.

impl Error for ValidationError

Available on crate feature std only.

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<ValidationError> for ConfigurationError

fn from(error: ValidationError) -> Self

Converts to this type from the input type.

impl PartialEq for ValidationError

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for ValidationError

impl StructuralPartialEq for ValidationError