Struct DebugProxyClient 

pub struct DebugProxyClient<R: ReadWrite> {
    pub socket: R,
    pub noack_mode: bool,
}

Client for interacting with the iOS debug proxy service

Implements the GDB Remote Serial Protocol for communicating with debugserver on iOS devices. Handles packet formatting, checksums, and acknowledgments.

Fields

socket: R

The underlying socket connection to debugproxy

noack_mode: bool

Flag indicating whether ACK mode is disabled

Implementations

impl<R: ReadWrite> DebugProxyClient<R>

pub fn new(socket: R) -> Self

Creates a new debug proxy client with default settings

Arguments

• socket - Established connection to debugproxy service

pub fn into_inner(self) -> R

Consumes the client and returns the underlying socket

pub async fn send_command( &mut self, command: DebugserverCommand, ) -> Result<Option<String>, IdeviceError>

Sends a command to debugserver and waits for response

Formats the command according to GDB Remote Serial Protocol: $[]#

Arguments

• command - The command and arguments to send

Returns

The response string if successful, None if no response received

Errors

Returns IdeviceError if communication fails

pub async fn read_response(&mut self) -> Result<Option<String>, IdeviceError>

Reads a response packet from debugserver

Handles the GDB Remote Serial Protocol response format: $#

Returns

The response data without protocol framing if successful

Errors

Returns IdeviceError if communication fails or protocol is violated

pub async fn send_raw(&mut self, bytes: &[u8]) -> Result<(), IdeviceError>

Sends raw bytes directly to the debugproxy connection

Arguments

• bytes - The raw bytes to send

Errors

Returns IdeviceError if writing fails

pub async fn read(&mut self, len: usize) -> Result<String, IdeviceError>

Reads raw bytes from the debugproxy connection

Arguments

• len - Maximum number of bytes to read

Returns

The received data as a string

Errors

Returns IdeviceError if reading fails or data isn’t valid UTF-8

pub async fn set_argv( &mut self, argv: Vec<String>, ) -> Result<String, IdeviceError>

Sets program arguments using the ‘A’ command

Formats arguments according to GDB protocol: A,,

Arguments

• argv - Program arguments to set

Returns

The debugserver response

Errors

Returns IdeviceError if arguments are empty or communication fails

pub async fn send_ack(&mut self) -> Result<(), IdeviceError>

Sends an acknowledgment (+)

Errors

Returns IdeviceError if writing fails

pub async fn send_noack(&mut self) -> Result<(), IdeviceError>

Sends a negative acknowledgment (-)

Errors

Returns IdeviceError if writing fails

pub fn set_ack_mode(&mut self, enabled: bool)

Enables or disables ACK mode

When disabled, the client won’t expect or send acknowledgments

Arguments

• enabled - Whether to enable ACK mode

Trait Implementations

impl<R: Debug + ReadWrite> Debug for DebugProxyClient<R>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl RsdService for DebugProxyClient<Box<dyn ReadWrite>>

fn rsd_service_name() -> Cow<'static, str>

async fn from_stream(stream: Box<dyn ReadWrite>) -> Result<Self, IdeviceError>

fn connect_rsd( provider: &mut impl RsdProvider, handshake: &mut RsdHandshake, ) -> impl Future<Output = Result<Self, IdeviceError>>

where Self: RsdService,