Enum KernelValueWidth 

#[non_exhaustive]
pub enum KernelValueWidth {
    U32,
    U64,
    Bytes(usize),
}

Width specifier for the Op::ReadKernelHot / Op::ReadKernelCold ops — picks which crate::monitor::guest::GuestKernel read_*_u32 / read_*_u64 / read_*_bytes family the host dispatcher invokes for the read. Mirrors KernelValue’s variant tags but without payload data (reads do not carry an outgoing value — only a width hint that the dispatcher uses to size the resulting crate::vmm::wire::KernelOpValue in the reply).

#[non_exhaustive]

KernelValueWidth is #[non_exhaustive] so new widths can be added without breaking external pattern-matchers. Prefer the per-variant constructors (Self::u32, Self::u64, Self::bytes) over naming variant literals.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

U32

Read a u32 little-endian. Atomic when the resolved host PA is 4-byte aligned (see KernelValue::U32’s alignment note for the misaligned fall-through behaviour).

U64

Read a u64 little-endian. Atomic at 8-byte alignment; otherwise a per-byte loop is used (same fall-through as KernelValue::U64).

Bytes(usize)

Read exactly len raw bytes. Non-atomic; reads through the crate::monitor::guest::GuestKernel read_*_bytes helpers’ chunked-page primitive.

Implementations

impl KernelValueWidth

pub const fn u32() -> Self

u32 read width.

pub const fn u64() -> Self

u64 read width.

pub const fn bytes(len: usize) -> Self

len-byte read width. Produces a crate::vmm::wire::KernelOpValue::Bytes of exactly len bytes in the reply.

Trait Implementations

impl Clone for KernelValueWidth

fn clone(&self) -> KernelValueWidth

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for KernelValueWidth

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

Formats the value using the given formatter.

impl From<&KernelValueWidth> for KernelOpValue

fn from(width: &KernelValueWidth) -> Self

Map a KernelValueWidth to a zero-filled crate::vmm::wire::KernelOpValue of the requested width for the read-entry’s value-hint slot. The wire payload’s value discriminant tells the host dispatcher which read family to invoke; the byte contents are written by the host before replying.

impl PartialEq for KernelValueWidth

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

impl StructuralPartialEq for KernelValueWidth