Struct Idevice 

pub struct Idevice { /* private fields */ }

Main handle for communicating with an iOS device

Manages the connection socket and provides methods for common device operations and message exchange.

Implementations

impl Idevice

pub fn new(socket: Box<dyn ReadWrite>, label: impl Into<String>) -> Self

Creates a new device connection handle

Arguments

• socket - The established connection socket
• label - Unique identifier for this connection

pub fn get_socket(self) -> Option<Box<dyn ReadWrite>>

pub fn set_udid(&mut self, udid: impl Into<String>)

Sets cached UDID

pub fn udid(&self) -> Option<&str>

Returns cached UDID if available

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

Queries the device type

Sends a QueryType request and parses the response

Returns

The device type string on success

Errors

Returns IdeviceError if communication fails or response is invalid

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

Performs RSD (Remote Service Discovery) check-in procedure

Establishes the basic service connection protocol

Errors

Returns IdeviceError if the protocol sequence isn’t followed correctly

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

Sends raw binary data to the device

Arguments

• message - The bytes to send

Errors

Returns IdeviceError if transmission fails

pub async fn send_raw_with_progress<Fut, S>( &mut self, message: &[u8], callback: impl Fn(((usize, usize), S)) -> Fut, state: S, ) -> Result<(), IdeviceError>

where Fut: Future<Output = ()>, S: Clone,

Sends raw binary data with progress callbacks

Arguments

• message - The bytes to send
• callback - Progress callback invoked after each chunk
• state - Arbitrary state passed to callback

Type Parameters

• Fut - Future type returned by callback
• S - Type of state passed to callback

Errors

Returns IdeviceError if transmission fails

pub async fn read_raw(&mut self, len: usize) -> Result<Vec<u8>, IdeviceError>

Reads exactly len bytes from the device

Arguments

• len - Exact number of bytes to read

Returns

The received bytes

Errors

Returns IdeviceError if reading fails or connection is closed prematurely

pub async fn read_any(&mut self, max_size: u32) -> Result<Vec<u8>, IdeviceError>

Reads up to max_size bytes from the device

Arguments

• max_size - Maximum number of bytes to read

Returns

The received bytes (may be shorter than max_size)

Errors

Returns IdeviceError if reading fails

pub async fn start_session( &mut self, pairing_file: &PairingFile, ) -> Result<(), IdeviceError>

Upgrades the connection to TLS using device pairing credentials

Arguments

• pairing_file - Contains the device’s identity and certificates

Errors

Returns IdeviceError if TLS handshake fails or credentials are invalid

Trait Implementations

impl From<Idevice> for LockdownClient

fn from(value: Idevice) -> Self

Converts an existing device connection into a lockdown client