Trait ConnectionExt

pub trait ConnectionExt: Connection {
    // Required methods
    fn read(&mut self) -> Result<u8, Self::Error>;
    fn peek(&mut self) -> Result<Option<u8>, Self::Error>;
}

Extends Connection with read and peek methods.

This trait is used as part of gdbstub’s quickstart GdbStub::run_blocking API.

When the std feature is enabled, this trait is automatically implemented for TcpStream and UnixStream (on unix systems).

Required Methods

fn read(&mut self) -> Result<u8, Self::Error>

Read a single byte.

fn peek(&mut self) -> Result<Option<u8>, Self::Error>

Peek a single byte. This MUST be a non-blocking operation, returning None if no byte is available.

Returns a byte (if one is available) without removing that byte from the queue. Subsequent calls to peek MUST return the same byte.

Trait Implementations

impl<E> Connection for &mut dyn ConnectionExt<Error = E>

type Error = E

Transport-specific error type.

fn write(&mut self, byte: u8) -> Result<(), Self::Error>

Write a single byte.

fn write_all(&mut self, buf: &[u8]) -> Result<(), Self::Error>

Write the entire buffer, blocking until complete.

fn flush(&mut self) -> Result<(), Self::Error>

Flush this Connection, ensuring that all intermediately buffered contents reach their destination.

fn on_session_start(&mut self) -> Result<(), Self::Error>

Called at the start of a debugging session before any GDB packets have been sent/received.

impl<E> Connection for Box<dyn ConnectionExt<Error = E>>

type Error = E

Transport-specific error type.

fn write(&mut self, byte: u8) -> Result<(), Self::Error>

Write a single byte.

fn write_all(&mut self, buf: &[u8]) -> Result<(), Self::Error>

Write the entire buffer, blocking until complete.

fn flush(&mut self) -> Result<(), Self::Error>

Flush this Connection, ensuring that all intermediately buffered contents reach their destination.

fn on_session_start(&mut self) -> Result<(), Self::Error>

Called at the start of a debugging session before any GDB packets have been sent/received.

impl<E> ConnectionExt for &mut dyn ConnectionExt<Error = E>

fn read(&mut self) -> Result<u8, Self::Error>

Read a single byte.

fn peek(&mut self) -> Result<Option<u8>, Self::Error>

Peek a single byte. This MUST be a non-blocking operation, returning None if no byte is available.

impl<E> ConnectionExt for Box<dyn ConnectionExt<Error = E>>

fn read(&mut self) -> Result<u8, Self::Error>

Read a single byte.

fn peek(&mut self) -> Result<Option<u8>, Self::Error>

Peek a single byte. This MUST be a non-blocking operation, returning None if no byte is available.

Implementations on Foreign Types

impl ConnectionExt for TcpStream

fn read(&mut self) -> Result<u8, Self::Error>

fn peek(&mut self) -> Result<Option<u8>, Self::Error>

impl ConnectionExt for UnixStream

fn read(&mut self) -> Result<u8, Self::Error>

fn peek(&mut self) -> Result<Option<u8>, Self::Error>

impl<E> ConnectionExt for Box<dyn ConnectionExt<Error = E>>

fn read(&mut self) -> Result<u8, Self::Error>

fn peek(&mut self) -> Result<Option<u8>, Self::Error>

Implementors

impl<E> ConnectionExt for &mut dyn ConnectionExt<Error = E>