Enum UpdateRecovery 

pub enum UpdateRecovery {
    Nothing,
    Swept {
        removed: usize,
        kept: Vec<(PathBuf, String)>,
    },
    Restored {
        kept: Vec<(PathBuf, String)>,
    },
    Ambiguous {
        displaced: Vec<PathBuf>,
        kept: Vec<(PathBuf, String)>,
    },
    Occupied {
        displaced: PathBuf,
        occupant: PathBuf,
        kept: Vec<(PathBuf, String)>,
    },
    Displaced {
        displaced: Vec<PathBuf>,
        kept: Vec<(PathBuf, String)>,
    },
}

What PluginHost::recover_interrupted_update found for one package.

Every outcome but Nothing carries kept: the generations marked for deletion that recovery found and could not delete, each with where it was left and why. UpdateRecovery::kept returns them whatever else recovery did.

Variants

Nothing

There was nothing to put back or delete. Abandoned stages and empty transactions may have been cleared.

Swept

Out-of-date generations earlier updates claimed, or marked for deletion, were found. removed were deleted. kept could not be, each with where it was left and why: a generation marked for deletion is never loaded or put back, while one whose marking failed is still a claim.

Fields

removed: usize

kept: Vec<(PathBuf, String)>

Restored

The package was missing, and the one generation an interrupted update claimed was put back and discovery ran again. The configured policy decides whether it is admitted; PluginHost::get_plugin says whether it was.

Fields

kept: Vec<(PathBuf, String)>

Ambiguous

The package is missing and more than one interrupted update claimed a generation of it, so which was installed last is not known. Nothing was moved.

Fields

displaced: Vec<PathBuf>

kept: Vec<(PathBuf, String)>

Occupied

The package is not loaded, but something already occupies its name, so the claimed generation was not moved onto it.

Fields

displaced: PathBuf

occupant: PathBuf

kept: Vec<(PathBuf, String)>

Displaced

PluginHost::sweep_interrupted_update found the package missing and a generation of it that an interrupted update claimed, and left the claim where it is: only recovering the package by name puts it back.

Fields

displaced: Vec<PathBuf>

kept: Vec<(PathBuf, String)>

Implementations

impl UpdateRecovery

pub fn kept(&self) -> &[(PathBuf, String)]

The generations marked for deletion that recovery found and could not delete, whatever else it did: each with where it was left and why.

Trait Implementations

impl Debug for UpdateRecovery

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

Formats the value using the given formatter.

impl Eq for UpdateRecovery

impl PartialEq for UpdateRecovery

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for UpdateRecovery