Struct PreparedUpdate 

pub struct PreparedUpdate { /* private fields */ }

An update validated against the installed firmware, ready to write.

Implementations

impl PreparedUpdate

pub fn flash<R, W, H>( &self, io: FlashTransport<'_, R, W>, runtime: &mut H, ) -> Result<Verified, FlashError<W::Error>>

where W: Transport, R: Transport<Error = W::Error>, H: FlashRuntime<W::Error>,

Write the update and prove it: PROBE, TEST UNIT READY, PREPARE, the transfer in STREAM chunks, COMMIT, TEST UNIT READY and REQUEST SENSE; then poll TEST UNIT READY until the drive has programmed, REQUEST SENSE again, and read back every chunk, comparing the integrity-protected ranges with the image.

First capture a backup, enforce tray and consent policy and exclude other users of the drive. A failure stops at once; nothing is retried.

impl PreparedUpdate

pub fn check(image: &[u8], drive: &Identity) -> Result<Family, PrepareError>

Every check that needs no installed firmware, in order: size, integrity, raw drive read, chip against the drive and the image’s own hardware family. Returns that family.

Run it before capturing a backup; PreparedUpdate::prepare repeats it.

pub fn prepare( image: &[u8], installed: &InstalledFirmware, ) -> Result<Self, PrepareError>

Prepare image for the drive installed describes: Self::check against its identity, then the family gate. Both families must be known and equal.

pub fn encrypted(self) -> Self

Stream the AES-128-ECB transport envelope instead of the plaintext. Read-back still compares the plaintext the drive stores.

pub fn class(&self) -> DriveClass

The update dialect.

pub fn family(&self) -> Family

The hardware family the image and the installed firmware share.

pub fn image(&self) -> &[u8]

The image the drive will store.

pub fn transfer(&self) -> &[u8]

The bytes streamed: the image, or its transport envelope.

pub fn steps(&self) -> Vec<Step>

The commands of the update session; see DriveClass::steps.

pub fn verification_ranges(&self) -> Vec<RangeInclusive<usize>>

The ranges read-back verification compares; see DriveClass::verification_ranges.

Trait Implementations

impl Clone for PreparedUpdate

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PreparedUpdate

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

Formats the value using the given formatter.