Struct DebuggerRelay 

pub struct DebuggerRelay { /* private fields */ }

A SerialIo adapter for WinDbg / KD-over-serial debugger mode.

The relay keeps the wrapped backend continuously drained from an independent pump task and never applies guest-visible backpressure. If either bounded relay ring fills, the newest bytes that do not fit are dropped.

Because writes are accepted into a lossy relay, poll_write always reports the full write as accepted and poll_flush/poll_close do not guarantee the bytes reached the real backend. poll_connect/poll_disconnect assume a single consumer (the serial emulator, which waits on only one of them at a time).

Implementations

impl DebuggerRelay

pub fn new( driver: impl Spawn + Driver, name: &str, inner: Box<dyn SerialIo>, ) -> Self

Wraps inner, spawning a pump task on driver to relay data in both directions. name labels the spawned task for diagnostics.

Trait Implementations

impl AsyncRead for DebuggerRelay

fn poll_read( self: Pin<&mut Self>, cx: &mut Context<'_>, buf: &mut [u8], ) -> Poll<Result<usize>>

Attempt to read from the AsyncRead into buf.

fn poll_read_vectored( self: Pin<&mut Self>, cx: &mut Context<'_>, bufs: &mut [IoSliceMut<'_>], ) -> Poll<Result<usize, Error>>

Attempt to read from the AsyncRead into bufs using vectored IO operations.

impl AsyncWrite for DebuggerRelay

fn poll_write( self: Pin<&mut Self>, _cx: &mut Context<'_>, buf: &[u8], ) -> Poll<Result<usize>>

Attempt to write bytes from buf into the object.

fn poll_flush(self: Pin<&mut Self>, _cx: &mut Context<'_>) -> Poll<Result<()>>

Attempt to flush the object, ensuring that any buffered data reach their destination.

fn poll_close(self: Pin<&mut Self>, _cx: &mut Context<'_>) -> Poll<Result<()>>

Attempt to close the object.

fn poll_write_vectored( self: Pin<&mut Self>, cx: &mut Context<'_>, bufs: &[IoSlice<'_>], ) -> Poll<Result<usize, Error>>

Attempt to write bytes from bufs into the object using vectored IO operations.

impl InspectMut for DebuggerRelay

fn inspect_mut(&mut self, req: Request<'_>)

Inspects the object.

impl SerialIo for DebuggerRelay

fn is_connected(&self) -> bool

Returns true if the backend is already connected.

fn poll_connect(&mut self, cx: &mut Context<'_>) -> Poll<Result<()>>

Polls for the serial backend to connect.

fn poll_disconnect(&mut self, cx: &mut Context<'_>) -> Poll<Result<()>>

Polls for the serial backend to disconnect.