Struct vhost_user_backend::VhostUserDaemon

pub struct VhostUserDaemon<S, V, B: Bitmap + 'static = ()> { /* private fields */ }

Implement a simple framework to run a vhost-user service daemon.

This structure is the public API the backend is allowed to interact with in order to run a fully functional vhost-user daemon.

Implementations

impl<S, V, B> VhostUserDaemon<S, V, B> where
    S: VhostUserBackend<V, B> + Clone + 'static,
    V: VringT<GuestMemoryAtomic<GuestMemoryMmap<B>>> + Clone + Send + Sync + 'static,
    B: NewBitmap + Clone + Send + Sync, 

pub fn new(
    name: String,
    backend: S,
    atomic_mem: GuestMemoryAtomic<GuestMemoryMmap<B>>
) -> Result<Self>

Create the daemon instance, providing the backend implementation of VhostUserBackend.

Under the hood, this will start a dedicated thread responsible for listening onto registered event. Those events can be vring events or custom events from the backend, but they get to be registered later during the sequence.

pub fn start_client(&mut self, socket_path: &str) -> Result<()>

Connect to the vhost-user socket and run a dedicated thread handling all requests coming through this socket. This runs in an infinite loop that should be terminating once the other end of the socket (the VMM) hangs up.

pub fn start(&mut self, listener: Listener) -> Result<()>

Listen to the vhost-user socket and run a dedicated thread handling all requests coming through this socket.

This runs in an infinite loop that should be terminating once the other end of the socket (the VMM) disconnects.

pub fn wait(&mut self) -> Result<()>

Wait for the thread handling the vhost-user socket connection to terminate.

pub fn get_epoll_handlers(&self) -> Vec<Arc<VringEpollHandler<S, V, B>>>

Retrieve the vring epoll handler.

This is necessary to perform further actions like registering and unregistering some extra event file descriptors.