Struct AfcClient 

pub struct AfcClient<S> { /* private fields */ }

AFC file-system client.

S must be a full-duplex async stream (e.g. the raw usbmux stream from lockdown).

Implementations

impl<S: AsyncRead + AsyncWrite + Unpin> AfcClient<S>

pub const FILE_MODE_READ_ONLY: u64 = 0x00000001

pub const FILE_MODE_READ_WRITE: u64 = 0x00000002

pub const FILE_MODE_WRITE_ONLY_CREATE_TRUNC: u64 = 0x00000003

pub const LOCK_EXCLUSIVE: u64

pub const LOCK_UNLOCK: u64

pub fn new(stream: S) -> Self

pub async fn list_dir(&mut self, path: &str) -> Result<Vec<String>, AfcError>

List directory entries (excludes “.” and “..”).

The AFC device returns null-separated filenames in the payload section of the response frame (entire_len > this_len).

pub async fn stat( &mut self, path: &str, ) -> Result<HashMap<String, String>, AfcError>

Get key-value file info for a path.

pub async fn stat_info(&mut self, path: &str) -> Result<AfcFileInfo, AfcError>

Get parsed file info for a path.

AFC reports st_mode as an octal string. This helper parses it into a u32, matching go-ios behavior.

pub async fn make_dir(&mut self, path: &str) -> Result<(), AfcError>

Create a directory.

pub async fn remove(&mut self, path: &str) -> Result<(), AfcError>

Remove a path (file or empty directory).

pub async fn remove_all(&mut self, path: &str) -> Result<(), AfcError>

Remove a path and all contents recursively.

pub async fn rename(&mut self, from: &str, to: &str) -> Result<(), AfcError>

Rename / move a path.

pub async fn read_file(&mut self, path: &str) -> Result<Bytes, AfcError>

Read an entire file into memory.

pub async fn read_file_follow_links( &mut self, path: &str, ) -> Result<Bytes, AfcError>

Read an entire file into memory, following a single AFC symlink.

This matches go-ios PullSingleFile behavior: if the source path is a symlink, AFC reports the target in st_linktarget and the file is read from that target path instead.

pub async fn write_file( &mut self, path: &str, data: &[u8], ) -> Result<(), AfcError>

Write data to a file (creates or truncates).

pub async fn write_file_from_reader<R>( &mut self, path: &str, reader: &mut R, ) -> Result<(), AfcError>

where R: AsyncRead + Unpin,

Write data from an async reader to a file (creates or truncates).

pub async fn open_file( &mut self, path: &str, mode: u64, ) -> Result<u64, AfcError>

pub async fn lock_file( &mut self, fd: u64, operation: u64, ) -> Result<(), AfcError>

pub async fn close_file(&mut self, fd: u64) -> Result<(), AfcError>

pub async fn device_info(&mut self) -> Result<HashMap<String, String>, AfcError>

Get device filesystem info.