Struct SharedFile 

pub struct SharedFile(/* private fields */);

A file handle this crate can read/write through without the caller having to prove it outlives every operation pushed against it (M8, PR #20 review response).

Backed by Arc<OwnedHandle> rather than Token’s exclusive-ownership shape: unlike a buffer, one handle is legitimately the target of many concurrent pushes, so what must survive until every one of them completes is a reference, not sole ownership. Every safe push method (e.g. Batch::read, as opposed to its _raw sibling) clones this Arc into the same Token that already tracks the operation’s own payload, so the underlying handle survives until that token is claimed or leaked (D-4 in DESIGN-NOTES.md), regardless of what the caller does with its own clone.

Implementations

impl SharedFile

pub fn new(handle: OwnedHandle) -> Self

Wrap an owned handle so it can be read/written through the ring safely.

Trait Implementations

impl Clone for SharedFile

fn clone(&self) -> SharedFile

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SharedFile

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

Formats the value using the given formatter.

impl FileTarget for SharedFile

type Guard = SharedFile

What the operation’s Token must hold until its completion is observed.

fn as_file_ref(&self) -> FileRef

How this target addresses its file.

fn guard(&self) -> Self::Guard

Produce the value the Token will hold for the operation’s duration.

impl From<OwnedHandle> for SharedFile

fn from(handle: OwnedHandle) -> Self

Converts to this type from the input type.