Struct virtio_drivers::device::socket::VirtIOSocket

pub struct VirtIOSocket<H: Hal, T: Transport> { /* private fields */ }

Low-level driver for a VirtIO socket device.

You probably want to use VsockConnectionManager rather than using this directly.

Implementations

impl<H: Hal, T: Transport> VirtIOSocket<H, T>

pub fn new(transport: T) -> Result<Self>

Create a new VirtIO Vsock driver.

pub fn guest_cid(&self) -> u64

Returns the CID which has been assigned to this guest.

pub fn connect(&mut self, connection_info: &ConnectionInfo) -> Result

Sends a request to connect to the given destination.

This returns as soon as the request is sent; you should wait until poll returns a VsockEventType::Connected event indicating that the peer has accepted the connection before sending data.

pub fn accept(&mut self, connection_info: &ConnectionInfo) -> Result

Accepts the given connection from a peer.

pub fn send( &mut self, buffer: &[u8], connection_info: &mut ConnectionInfo ) -> Result

Sends the buffer to the destination.

pub fn credit_update(&mut self, connection_info: &ConnectionInfo) -> Result

Tells the peer how much buffer space we have to receive data.

pub fn poll( &mut self, handler: impl FnOnce(VsockEvent, &[u8]) -> Result<Option<VsockEvent>> ) -> Result<Option<VsockEvent>>

Polls the RX virtqueue for the next event, and calls the given handler function to handle it.

pub fn shutdown(&mut self, connection_info: &ConnectionInfo) -> Result

Requests to shut down the connection cleanly.

This returns as soon as the request is sent; you should wait until poll returns a VsockEventType::Disconnected event if you want to know that the peer has acknowledged the shutdown.

pub fn force_close(&mut self, connection_info: &ConnectionInfo) -> Result

Forcibly closes the connection without waiting for the peer.

Trait Implementations

impl<H: Hal, T: Transport> Drop for VirtIOSocket<H, T>

fn drop(&mut self)

Executes the destructor for this type.