Struct Bundle 

pub struct Bundle<'a> { /* private fields */ }

A validated bundle: a handle onto the buffer it was parsed from.

Holding one is the proof that every check in this module passed, which is why walking it with iter cannot fail.

Implementations

impl<'a> Bundle<'a>

pub fn parse(format: &Format, bytes: &'a [u8]) -> Result<Bundle<'a>, Error>

Checks bytes against format and returns a handle to it.

Allocates nothing: the result borrows the buffer.

Order of checks

The checksum is verified before any entry is walked. A transfer that lost bytes produces lengths that still look plausible, and reporting the first one that happens not to fit describes a symptom rather than what went wrong.

pub fn count(&self) -> usize

How many entries it holds.

pub fn iter(&self) -> Iter<'a>

The entries, in the order they were packed.

Not the order they should be written in — see Role.

pub fn kernel(&self) -> Option<Entry<'a>>

The entry carrying the boot image, if the bundle has one.

A bundle without a kernel is valid and useful: it updates a website or a settings file without rewriting an image that has not changed.

Trait Implementations

impl<'a> Clone for Bundle<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for Bundle<'a>

impl<'a> Debug for Bundle<'a>

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

Formats the value using the given formatter.