Enum RekeyError 

#[non_exhaustive]
pub enum RekeyError {
    WrongSourceKey,
    WrongDestinationKey,
    SourceReplaced(String),
    SourceNotFound(String),
    CorruptSource(String),
    VerificationMismatch(String),
    DestinationExists(String),
    DestinationNotFound(String),
    CorruptDestination(String),
    DestinationReplaced(String),
    UnsafeDestination(String),
    InvalidKey(String),
    Io(Error),
    Database(String),
    Panicked(String),
}

Typed error for DbKeyStore::rekey and rekey_at.

Every malformed-database and wrong-key case returns one of these variants; the operation never unwinds or aborts (a panic escaping the underlying database layer is caught and reported as RekeyError::Panicked). Messages never contain secret material.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

WrongSourceKey

The source database could not be decrypted with the supplied key/cipher.

WrongDestinationKey

The destination database could not be decrypted with the supplied key/cipher. Produced by DbKeyStore::verify (and verify_at), which re-open an existing destination candidate; rekey itself always creates a fresh destination and cannot produce this.

SourceReplaced(String)

The source directory entry stopped referring to the file that was validated at the start of the operation (it was replaced mid-rekey).

SourceNotFound(String)

The source database file does not exist or is not a regular file.

CorruptSource(String)

The source is not a readable db-keystore database (corrupt, not a database, or missing the credentials table). An encrypted source opened without any key also lands here, since it is indistinguishable from a non-database file.

VerificationMismatch(String)

Source and destination records did not compare exactly equal.

DestinationExists(String)

The destination path already exists (including as a symlink).

DestinationNotFound(String)

The destination database does not exist or is not a regular file. Produced only by verification, which requires an existing destination (rekey requires the opposite; see RekeyError::DestinationExists).

CorruptDestination(String)

The destination is not a readable db-keystore database (corrupt, not a database, or missing the credentials table). Produced only by verification; rekey always creates its destination.

DestinationReplaced(String)

The destination directory entry stopped referring to the file that was validated at the start of a verification (it was replaced mid-verify). The rekey entry points report the same condition as RekeyError::UnsafeDestination.

UnsafeDestination(String)

The destination could not be created safely, or the directory entry no longer refers to the file that was created.

InvalidKey(String)

A key or cipher parameter was malformed.

Io(Error)

Filesystem error.

Database(String)

Other database-layer error.

Panicked(String)

A panic escaped the database layer and was converted into an error.

The payload is best-effort diagnostic text with no stable format: it is captured from whatever code panicked, length-bounded, and stripped of control characters at capture time. Do not parse it.

Trait Implementations

impl Debug for RekeyError

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

Formats the value using the given formatter.

impl Display for RekeyError

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

Formats the value using the given formatter.

impl Error for RekeyError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for RekeyError

fn from(err: Error) -> Self

Converts to this type from the input type.