Struct AbootState 

pub(crate) struct AbootState<'a> {
    sysroot: &'a Dir,
    state: Option<Dir>,
    slots: Option<Dir>,
}

An open fd to the persistent Aboot state

Fields

sysroot: &'a Dir

state: Option<Dir>

slots: Option<Dir>

Implementations

impl<'a> AbootState<'a>

pub(crate) fn open(sysroot: &'a Dir) -> Result<Self>

fn ensure_state(&mut self) -> Result<&Dir>

fn ensure_slots(&mut self) -> Result<&Dir>

fn read_json<T: for<'de> Deserialize<'de>>( &self, name: &str, ) -> Result<Option<T>>

fn write_json( &mut self, name: &str, value: &impl CanonJsonSerialize, ) -> Result<()>

fn remove_state_file(&self, name: &str) -> Result<()>

pub(crate) fn read_pending(&self) -> Result<Option<PendingDeployment>>

pub(crate) fn write_pending( &mut self, pending: &PendingDeployment, ) -> Result<()>

Publish or replace a pending deployment unless one was already attempted.

pub(crate) fn read_attempted(&self) -> Result<Option<AttemptedDeployment>>

fn read_rollback(&self) -> Result<Option<QueuedRollback>>

pub(crate) fn queued_rollback(&self) -> Result<Option<String>>

pub(crate) fn queue_rollback(&mut self, deployment: &str) -> Result<()>

pub(crate) fn clear_rollback(&self) -> Result<()>

pub(crate) fn unlock_pending( &mut self, deployment: &str, ) -> Result<PendingDeployment>

Make a download-only pending deployment eligible for finalization.

pub(crate) fn stage_artifacts( &self, deployment: &str, finalization_locked: bool, boot: &[u8], vbmeta: Option<&[u8]>, ) -> Result<PendingDeployment>

Store the exact partition payloads before publishing the pending deployment.

pub(crate) fn verify_artifacts( &self, root_path: &Utf8Path, pending: &PendingDeployment, ) -> Result<ArtifactPaths>

Verify staged payloads and return paths suitable for passing to aboot-deploy.

fn remove_artifacts(&self, deployment: &str) -> Result<()>

pub(crate) fn discard_pending(&self) -> Result<()>

pub(crate) fn discard_failed_attempt(&self, booted: &str) -> Result<bool>

Discard a failed attempt only when an explicit update replaces it after reboot.

pub(crate) fn record_attempt(&mut self, deployment: &str) -> Result<()>

Mark an update attempted before invalidating a slot or writing partitions.

fn reconcile_state( &mut self, booted: &str, current_boot_id: &str, ) -> Result<ReconcileAction>

pub(crate) fn reconcile(&mut self, booted: &str) -> Result<bool>

Restore the transient staged view and return whether finalization should be armed.

pub(crate) fn slot_deployments(&self) -> Result<Vec<Sha512HashValue>>

fn read_slot(&self, slot: Slot) -> Result<Option<Sha512HashValue>>

pub(crate) fn record_booted( &mut self, cmdline: &Cmdline<'_>, digest: &str, ) -> Result<()>

Record a slot mapping only after that deployment has been observed running.

pub(crate) fn invalidate_other(&self, booted_slot: Slot) -> Result<()>

Invalidate only the non-booted slot mapping before deployment.

pub(crate) fn delete_deployment(&self, deployment: &str) -> Result<()>