Skip to main content

VolumeSet

Struct VolumeSet 

Source
pub struct VolumeSet { /* private fields */ }
Expand description

A primary physical container plus explicitly supplied companion volumes. No filenames are guessed, no graphs are flattened, and ambiguous owners fail. This reader does not yet certify a striped image’s composite block-map digest.

Implementations§

Source§

impl VolumeSet

Source

pub fn verify_full( &mut self, image: &str, expected_image_sha256: Option<&str>, progress: impl FnMut(&str, u64, u64) -> ControlFlow<()>, ) -> Result<SetVerification>

Verifies the selected image, every owned stream, and each volume’s recorded integrity structures. Missing/unsupported references prevent all_match. Striped roots use the explicit supplied order; no ordering is guessed. Other images’ linear/root hashes are reported as unsupported. Metadata references are internal; expected_image_sha256 is an external media digest.

Source§

impl VolumeSet

Source

pub fn open(paths: &[PathBuf]) -> Result<Self>

Opens the primary and companions with a shared metadata/directory budget. The primary must contain the selected image’s complete Map. Named foreign volume references must be supplied; duplicate owners/volume IDs are errors.

Source

pub fn open_with_limits(paths: &[PathBuf], limits: Limits) -> Result<Self>

Opens at most 128 volumes. Metadata bytes, triples, ZIP directory bytes, and entry counts are aggregate limits across the entire set. Chunk and member limits apply per object; only one volume retains payload caches.

Source

pub fn images(&self) -> Vec<String>

Identifiers of physical images described by the primary volume.

Source

pub fn sources(&self) -> Vec<VolumeSource>

Data stream ownership; metadata itself remains scoped to each volume.

Source

pub fn reader_statistics(&self) -> ReaderStatistics

Returns cumulative payload-reader counters shared by all volumes.

Source

pub fn reader_cache_info(&self) -> ReaderCacheInfo

Returns shared automatic decoded payload-cache usage.

Source

pub fn size(&mut self, id: &str) -> Result<u64>

Logical size of a selected primary image, after dependency validation.

Source

pub fn read_at( &mut self, id: &str, buffer: &mut [u8], offset: u64, ) -> Result<usize>

Reads assembled image bytes using the primary Map and explicit owners. Unknown/unreadable symbolic data and missing companions fail closed.

Source

pub fn verify_image( &mut self, id: &str, expected_sha256: Option<&str>, progress: impl FnMut(u64, u64) -> ControlFlow<()>, ) -> Result<SetDigest>

Computes whole-image SHA256 across companions. This does not certify the per-volume metadata or striped composite hashes. Optional external digest must cover the assembled image, not information.turtle or a ZIP file.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

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 more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
where F: FnOnce(&Self) -> bool,

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
Source§

impl<T> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
Source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
Source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V