Struct UpdateFileDiff 

pub struct UpdateFileDiff {
    pub role: String,
    pub esp_path: String,
    pub current_sha256: Option<String>,
    pub current_error: Option<String>,
    pub fresh_sha256: Option<String>,
    pub fresh_error: Option<String>,
    pub would_change: bool,
}

Per-file diff row between what’s currently on the stick’s ESP and what a fresh mkusb / direct-install flash would write. One row per canonical ESP destination (see direct_install::ESP_DEST_*).

Semantics of the hash/error pairs:

• current_sha256 is None when the ESP file couldn’t be read (file absent, mtype missing, permission denied); in that case current_error carries the operator-facing reason.
• fresh_sha256 is None when the host-side source couldn’t be hashed (package not installed, kernel glob missed, etc); fresh_error carries the reason.
• would_change is the Phase-1 verdict the operator cares about: true only when both hashes are present AND they differ. When either hash is absent the comparison is inconclusive and would_change is false — the operator sees the error field and knows the answer isn’t “yes it would change”, it’s “we couldn’t tell”.

Added in UPDATE_SCHEMA_VERSION = 2 (Phase 1 of #181).

Fields

role: String

Role in the signed chain: shim, grub, grub_cfg_boot, grub_cfg_ubuntu, kernel, initrd. One entry per canonical destination (the two grub.cfg targets get separate rows because mkusb.sh writes both).

esp_path: String

Destination path on the ESP, e.g. /EFI/BOOT/BOOTX64.EFI (no :: mtools prefix — stripped for consumers that want an operator-readable path).

current_sha256: Option<String>

Lowercase hex sha256 of the file currently on the stick’s ESP. None when unreadable.

current_error: Option<String>

Operator-readable error explaining why current_sha256 is absent. None when the read succeeded.

fresh_sha256: Option<String>

Lowercase hex sha256 of what a fresh flash would install. None when the host-side source couldn’t be hashed.

fresh_error: Option<String>

Operator-readable error explaining why fresh_sha256 is absent. None when the hash succeeded.

would_change: bool

true when both hashes are present and differ. false when they match, OR when either hash is absent (see struct docs for the rationale).

Trait Implementations

impl Clone for UpdateFileDiff

fn clone(&self) -> UpdateFileDiff

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UpdateFileDiff

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for UpdateFileDiff

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for UpdateFileDiff

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl PartialEq for UpdateFileDiff

fn eq(&self, other: &UpdateFileDiff) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for UpdateFileDiff

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for UpdateFileDiff

impl StructuralPartialEq for UpdateFileDiff