Struct FileWriter 

pub struct FileWriter { /* private fields */ }

A streaming write to a guest file. Chunks feed a bounded channel that backs the client-streaming RPC, so a slow uplink applies backpressure rather than buffering the source. The RPC result surfaces from FileWriter::finish, and only finish commits the write: dropping (or FileWriter::aborting) an unfinished writer cancels the RPC instead of half-closing into what the server would treat as a completed write. The guest file state after an abort is unspecified (the write was never confirmed).

Implementations

impl FileWriter

pub async fn write(&mut self, data: &[u8]) -> Result<(), SailError>

Write bytes to the file, splitting them into transport-sized chunks (FILE_WRITE_CHUNK_BYTES each). This is the normal write path; use FileWriter::write_chunk only to control message framing yourself.

pub async fn write_chunk(&mut self, data: Vec<u8>) -> Result<(), SailError>

Send one chunk of file data as a single transport message. Chunks must not exceed FILE_WRITE_CHUNK_BYTES. If the RPC has already ended, returns its result instead.

pub async fn finish(&mut self) -> Result<(), SailError>

Finish the write and return the RPC’s result, creating an empty file when no chunks were sent.

pub fn abort(&mut self)

Abort the write: cancel the RPC without the clean end-of-stream the server would commit. Idempotent; a no-op after finish. Later write or finish calls report the abort instead of succeeding.

pub fn abort_handle(&self) -> WriteAbortHandle

An out-of-band handle that aborts this write without borrowing the writer, so a concurrent caller (the bindings’ abort path) can cancel a stalled or backpressured write instead of queueing behind it.

Trait Implementations

impl Drop for FileWriter

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.