Trait VirtioDeviceBuilder

pub trait VirtioDeviceBuilder: Sized {
    const NAME: &'static str;

    // Required method
    fn create_vhost_user_device(
        self,
        _keep_rds: &mut Vec<RawDescriptor>,
    ) -> Result<Box<dyn VhostUserDeviceBuilder>>;

    // Provided method
    fn create_jail(
        &self,
        jail_config: Option<&JailConfig>,
        virtio_transport: VirtioDeviceType,
    ) -> Result<Option<Minijail>> { ... }
}

A trait for spawning vhost-user device instances and jails from their configuration structure.

Required Associated Constants

const NAME: &'static str

Base name of the device, as it will appear in logs.

Required Methods

fn create_vhost_user_device( self, _keep_rds: &mut Vec<RawDescriptor>, ) -> Result<Box<dyn VhostUserDeviceBuilder>>

Create a device suitable for being run as a vhost-user instance.

Provided Methods

fn create_jail( &self, jail_config: Option<&JailConfig>, virtio_transport: VirtioDeviceType, ) -> Result<Option<Minijail>>

Create a jail that is suitable to run a device.

The default implementation creates a simple jail with a seccomp policy derived from the base name of the device.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementations on Foreign Types

impl VirtioDeviceBuilder for &NetParameters

const NAME: &'static str = "net"

fn create_jail( &self, jail_config: Option<&JailConfig>, virtio_transport: VirtioDeviceType, ) -> Result<Option<Minijail>>

fn create_vhost_user_device( self, keep_rds: &mut Vec<RawDescriptor>, ) -> Result<Box<dyn VhostUserDeviceBuilder>>

impl VirtioDeviceBuilder for &VsockConfig

const NAME: &'static str = "vhost_vsock"

fn create_vhost_user_device( self, keep_rds: &mut Vec<RawDescriptor>, ) -> Result<Box<dyn VhostUserDeviceBuilder>>

impl VirtioDeviceBuilder for &SerialParameters

For creating console virtio devices.

const NAME: &'static str = "serial"

fn create_vhost_user_device( self, keep_rds: &mut Vec<RawDescriptor>, ) -> Result<Box<dyn VhostUserDeviceBuilder>>

fn create_jail( &self, jail_config: Option<&JailConfig>, virtio_transport: VirtioDeviceType, ) -> Result<Option<Minijail>>

Implementors

impl VirtioDeviceBuilder for DiskConfig<'_>

const NAME: &'static str = "block"