Struct SmcccTrng

pub struct SmcccTrng {}

An backend implementation of the SMCCC TRNG (DEN0098).

Might not be fully spec-compliant regarding the conditioned entropy.

Implementations

impl SmcccTrng

pub const HVC32_FID_RANGE: Range<u32>

Standard function ID ranges for TRNG 32-bit calls, defined in SMCCC (DEN0028).

pub const HVC64_FID_RANGE: Range<u32>

Standard function ID ranges for TRNG 64-bit calls, defined in SMCCC (DEN0028).

const FID_TRNG_VERSION: u32 = 2_214_592_592u32

const FID_TRNG_FEATURES: u32 = 2_214_592_593u32

const FID_TRNG_GET_UUID: u32 = 2_214_592_594u32

const FID_TRNG_RND32: u32 = 2_214_592_595u32

const FID_TRNG_RND64: u32 = 3_288_334_419u32

const VERSION: (u16, u16)

const UUID: Uuid

CrosVM SMCCC TRNG back-end UUID.

Equivalent to Uuid::new_v8(*b"SMCCCTRNG-CrosVM").

pub fn new() -> Self

Creates a new instance of SmcccTrng.

fn version(&self) -> Result<U31, SmcccTrngError>

fn features(&self, func_id: u32) -> Result<U31, SmcccTrngError>

fn get_uuid(&self) -> Result<[u32; 4], SmcccTrngError>

fn rnd32(&self, n_bits: u32) -> Result<[u32; 3], SmcccTrngError>

fn rnd64(&self, n_bits: u64) -> Result<[u64; 3], SmcccTrngError>

Trait Implementations

impl BusDevice for SmcccTrng

fn device_id(&self) -> DeviceId

Returns a unique id per device type suitable for metrics gathering.

fn debug_label(&self) -> String

Returns a label suitable for debug output.

fn handle_hypercall(&self, abi: &mut HypercallAbi) -> Result<()>

Handles a hypercall. Only used by hypercall-based devices.

fn read(&mut self, _info: BusAccessInfo, _data: &mut [u8])

Performs a read access to this device, based on info.

fn write(&mut self, _info: BusAccessInfo, _data: &[u8])

Performs a write access to this device, based on info.

fn config_register_write( &mut self, reg_idx: usize, offset: u64, data: &[u8], ) -> ConfigWriteResult

Sets a register in the configuration space. Only used by PCI.

fn config_register_read(&self, reg_idx: usize) -> u32

Gets a register from the configuration space. Only used by PCI.

fn init_pci_config_mapping( &mut self, shmem: &SharedMemory, base: usize, len: usize, ) -> bool

Provides a memory region to back MMIO access to the configuration space. If the device can keep the memory region up to date, then it should return true, after which no more calls to config_register_read will be made. Otherwise the device should return false.

fn virtual_config_register_write(&mut self, reg_idx: usize, value: u32)

Sets a register in the virtual config space. Only used by PCI.

fn virtual_config_register_read(&self, reg_idx: usize) -> u32

Gets a register from the virtual config space. Only used by PCI.

fn on_sandboxed(&mut self)

Invoked when the device is sandboxed.

fn get_ranges(&self) -> Vec<(BusRange, BusType)>

Gets a list of all ranges registered by this BusDevice.

fn destroy_device(&mut self)

Invoked when the device is destroyed

fn is_bridge(&self) -> Option<u8>

Returns the secondary bus number if this bus device is pci bridge

impl BusDeviceSync for SmcccTrng

fn read(&self, _info: BusAccessInfo, _data: &mut [u8])

fn write(&self, _info: BusAccessInfo, _data: &[u8])

fn snapshot_sync(&self) -> Result<AnySnapshot>

fn restore_sync(&self, _data: AnySnapshot) -> Result<()>

Load a saved snapshot of an image.

fn sleep_sync(&self) -> Result<()>

Stop all threads related to the device. Sleep should be idempotent.

fn wake_sync(&self) -> Result<()>

Create/Resume all threads related to the device. Wake should be idempotent.

impl Default for SmcccTrng

fn default() -> Self

Returns the “default value” for a type.

impl Suspendable for SmcccTrng

fn snapshot(&mut self) -> Result<AnySnapshot>

Save the device state in an image that can be restored.

fn restore(&mut self, _data: AnySnapshot) -> Result<()>

Load a saved snapshot of an image.

fn sleep(&mut self) -> Result<()>

Stop all threads related to the device. Sleep should be idempotent.

fn wake(&mut self) -> Result<()>

Create/Resume all threads related to the device. Wake should be idempotent.