pub struct RangeSession<'driver, 'root> { /* private fields */ }Expand description
Synchronous caller-buffered staging. Bytes and sync observations carry no proof, availability, serving permission or durable-publication authority. Hold the canonical runtime StorageStage while doing these operations; the host owns fresh policy/time checks and cancellation/worker drain.
Implementations§
Source§impl RangeSession<'_, '_>
impl RangeSession<'_, '_>
pub const fn limits(&self) -> RangeLimits
pub fn attempt_id(&self) -> [u8; 32]
pub fn staging_path(&self) -> &Path
pub const fn capabilities(&self) -> RangeCapabilities
Sourcepub fn observed_file_length(&self, which: RangeFile) -> Result<u64, RangeError>
pub fn observed_file_length(&self, which: RangeFile) -> Result<u64, RangeError>
Observes length through the retained handle, including sparse holes. This diagnostic is never a verified-presence or durability map.
Sourcepub fn read_exact_at(
&mut self,
which: RangeFile,
offset: u64,
out: &mut [u8],
) -> Result<(), RangeError>
pub fn read_exact_at( &mut self, which: RangeFile, offset: u64, out: &mut [u8], ) -> Result<(), RangeError>
Reads exactly the caller’s slice. Sparse zero bytes are not presence.
Sourcepub fn write_exact_at(
&mut self,
which: RangeFile,
offset: u64,
bytes: &[u8],
) -> Result<(), RangeError>
pub fn write_exact_at( &mut self, which: RangeFile, offset: u64, bytes: &[u8], ) -> Result<(), RangeError>
Does not allocate, preallocate the ceiling, or accept a filename. An I/O error may have written a prefix; no atomicity is promised.
Sourcepub fn sync_file(&self, which: RangeFile) -> Result<FileBarrier, RangeError>
pub fn sync_file(&self, which: RangeFile) -> Result<FileBarrier, RangeError>
Actual file sync completion, not directory durability or verification.
Source§impl<'root> RangeSession<'_, 'root>
impl<'root> RangeSession<'_, 'root>
pub fn close(self) -> Result<CleanupObservation, CleanupPending<'root>>
Trait Implementations§
Source§impl Drop for RangeSession<'_, '_>
impl Drop for RangeSession<'_, '_>
Auto Trait Implementations§
impl<'driver, 'root> Freeze for RangeSession<'driver, 'root>
impl<'driver, 'root> RefUnwindSafe for RangeSession<'driver, 'root>
impl<'driver, 'root> Send for RangeSession<'driver, 'root>
impl<'driver, 'root> Sync for RangeSession<'driver, 'root>
impl<'driver, 'root> Unpin for RangeSession<'driver, 'root>
impl<'driver, 'root> UnsafeUnpin for RangeSession<'driver, 'root>
impl<'driver, 'root> UnwindSafe for RangeSession<'driver, 'root>
Blanket Implementations§
§impl<S, A> Aggregate<Result<S, Error>> for Awhere
A: Aggregate<S>,
impl<S, A> Aggregate<Result<S, Error>> for Awhere
A: Aggregate<S>,
Aggregate shares in an MPC protocol.
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
Converts
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
Converts
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read more