Struct ConsoleDevice 

pub struct ConsoleDevice { /* private fields */ }

virtio-console device.

Implementations

impl ConsoleDevice

pub fn new(sink: ConsoleSink) -> Self

Build a console with a custom sink.

pub fn discard() -> Self

Build a console that discards output. Useful for tests and headless boots.

Trait Implementations

impl Debug for ConsoleDevice

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

Formats the value using the given formatter.

impl VirtioDevice for ConsoleDevice

fn device_type(&self) -> VirtioDeviceType

Device-type discriminant for the MMIO DeviceID register.

fn avail_features(&self) -> u64

Bitmap of features the device offers. The transport ANDs this with the driver’s acked_features and surfaces the negotiated set.

fn acked_features(&self) -> u64

Bitmap of features the driver has acknowledged.

fn set_acked_features(&mut self, value: u64)

Set the driver-acked feature set. The transport calls this once per MMIO DriverFeatures write; implementors typically just store the value.

fn queue_max_sizes(&self) -> &[u16]

Per-queue maximum descriptor counts. The vector length determines how many vrings the device exposes; the value at each index becomes QueueNumMax for that queue.

fn queues(&self) -> &[Queue]

Borrow the device’s queue state.

fn queues_mut(&mut self) -> &mut [Queue]

Borrow the device’s queue state mutably (transport uses this when the driver writes queue-config registers).

fn read_config(&self, _offset: u64, data: &mut [u8])

Read a slice of the device’s config space at offset.

fn write_config(&mut self, _offset: u64, _data: &[u8])

Write a slice into the device’s config space at offset. Per the virtio spec § 2.4.2, drivers SHOULD not write config-space after DRIVER_OK; the transport gates on this and silently drops post-OK writes via crate::transport::VirtioMmioTransport::accept_config_write.

fn activate( &mut self, mem: Arc<dyn GuestMemory>, irq: IrqLine, ) -> Result<(), ActivateError>

Take ownership of the resources needed to drive the device live. Called exactly once on the driver’s DRIVER_OK transition.

fn is_activated(&self) -> bool

true once activate has succeeded.

fn process_queue(&mut self, queue_index: u16)

Handler invoked on a guest write to the MMIO QueueNotify register.