Enum pwbox::Error

pub enum Error {
    NoCipher(String),
    NoKdf(String),
    KdfParams(JsonError),
    NonceLen,
    MacLen,
    SaltLen,
    MacMismatch,
    DeriveKey(Error),
}

Errors occurring during PwBox operations.

Variants

NoCipher(String)

A cipher with the specified name is not registered.

Troubleshooting

Register the cipher with the help of Eraser::add_cipher() or Eraser::add_suite() methods.

NoKdf(String)

A key derivation function with the specified name is not registered.

Troubleshooting

Register the cipher with the help of Eraser::add_kdf() or Eraser::add_suite() methods.

KdfParams(JsonError)

Failed to parse KDF parameters.

NonceLen

Incorrect nonce length encountered.

This error usually means that the box is corrupted.

MacLen

Incorrect MAC length encountered.

This error usually means that the box is corrupted.

SaltLen

Incorrect salt length encountered.

This error usually means that the box is corrupted.

MacMismatch

Failed to verify MAC code.

This error means that either the supplied password is incorrect, or the box is corrupted.

DeriveKey(Error)

Error during KDF invocation.

This error can arise if the KDF was supplied with invalid parameters, which may lead or have led to a KDF-specific error (e.g., out-of-memory).

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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

The lower-level source of this error, if any.

fn backtrace(&self) -> Option<&Backtrace>

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

Returns a stack backtrace, if available, of where this error occurred.

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

impl From<MacMismatch> for Error

fn from(_: MacMismatch) -> Self

Performs the conversion.