Struct KvmNestedStateBuffer

#[non_exhaustive]
#[repr(C)]
pub struct KvmNestedStateBuffer {
    pub flags: u16,
    pub format: u16,
    pub size: u32,
    pub hdr: kvm_nested_state__bindgen_ty_1,
    pub data: kvm_nested_state__data,
}

Available on x86-64 only.

A stack-allocated buffer for nested KVM state including the mandatory header with meta-information.

KVM uses a dynamically sized buffer structure (with a header reporting the size of the buffer/state). This helper type makes working with get_nested_state() and set_nested_state() significantly more convenient at the cost of a slightly higher memory footprint in some cases.

Type Size

On Intel VMX, the actual state requires 128 + 8192 == 8320 bytes, on AMD SVM, the actual state requires 128 + 4096 == 4224 bytes. This type doesn’t make a differentiation and unifies the required memory. By sacrificing a few more bytes on VMX, this type is generally convenient to use.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

flags: u16

format: u16

size: u32

hdr: kvm_nested_state__bindgen_ty_1

data: kvm_nested_state__data

Implementations

impl KvmNestedStateBuffer

pub fn empty() -> Self

Creates a new empty buffer, ready for nested state to be stored in by KVM.

The size property will report the size of the buffer to KVM.

Trait Implementations

impl Clone for KvmNestedStateBuffer

fn clone(&self) -> KvmNestedStateBuffer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for KvmNestedStateBuffer

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for KvmNestedStateBuffer

Available on crate feature serde only.

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl FromBytes for KvmNestedStateBuffer

where u16: FromBytes, u32: FromBytes, kvm_nested_state__bindgen_ty_1: FromBytes, kvm_nested_state__data: FromBytes,

fn read_from_bytes(source: &[u8]) -> Result<Self, SizeError<&[u8], Self>>

where Self: Sized,

Reads a copy of Self from the given source.

fn read_from_prefix( source: &[u8], ) -> Result<(Self, &[u8]), SizeError<&[u8], Self>>

where Self: Sized,

Reads a copy of Self from the prefix of the given source.

fn read_from_suffix( source: &[u8], ) -> Result<(&[u8], Self), SizeError<&[u8], Self>>

where Self: Sized,

Reads a copy of Self from the suffix of the given source.

impl FromZeros for KvmNestedStateBuffer

where u16: FromZeros, u32: FromZeros, kvm_nested_state__bindgen_ty_1: FromZeros, kvm_nested_state__data: FromZeros,

fn zero(&mut self)

Overwrites self with zeros.

fn new_zeroed() -> Self

where Self: Sized,

Creates an instance of Self from zeroed bytes.

impl IntoBytes for KvmNestedStateBuffer

where u16: IntoBytes, u32: IntoBytes, kvm_nested_state__bindgen_ty_1: IntoBytes, kvm_nested_state__data: IntoBytes, (): PaddingFree<Self, { _ }>,

fn as_bytes(&self) -> &[u8]

where Self: Immutable,

Gets the bytes of this value.

fn as_mut_bytes(&mut self) -> &mut [u8]

where Self: FromBytes,

Gets the bytes of this value mutably.

fn write_to(&self, dst: &mut [u8]) -> Result<(), SizeError<&Self, &mut [u8]>>

where Self: Immutable,

Writes a copy of self to dst.

fn write_to_prefix( &self, dst: &mut [u8], ) -> Result<(), SizeError<&Self, &mut [u8]>>

where Self: Immutable,

Writes a copy of self to the prefix of dst.

fn write_to_suffix( &self, dst: &mut [u8], ) -> Result<(), SizeError<&Self, &mut [u8]>>

where Self: Immutable,

Writes a copy of self to the suffix of dst.

impl Serialize for KvmNestedStateBuffer

Available on crate feature serde only.

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFromBytes for KvmNestedStateBuffer

where u16: TryFromBytes, u32: TryFromBytes, kvm_nested_state__bindgen_ty_1: TryFromBytes, kvm_nested_state__data: TryFromBytes,

fn try_read_from_bytes( source: &[u8], ) -> Result<Self, ConvertError<Infallible, SizeError<&[u8], Self>, ValidityError<&[u8], Self>>>

where Self: Sized,

Attempts to read the given source as a Self.

fn try_read_from_prefix( source: &[u8], ) -> Result<(Self, &[u8]), ConvertError<Infallible, SizeError<&[u8], Self>, ValidityError<&[u8], Self>>>

where Self: Sized,

Attempts to read a Self from the prefix of the given source.

fn try_read_from_suffix( source: &[u8], ) -> Result<(&[u8], Self), ConvertError<Infallible, SizeError<&[u8], Self>, ValidityError<&[u8], Self>>>

where Self: Sized,

Attempts to read a Self from the suffix of the given source.

impl Copy for KvmNestedStateBuffer

impl Immutable for KvmNestedStateBuffer

where u16: Immutable, u32: Immutable, kvm_nested_state__bindgen_ty_1: Immutable, kvm_nested_state__data: Immutable,