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()

if let Err(e) = "xc".parse::<u32>() { // Print e itself, no need for description(). eprintln!("Error: {}", e); }

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

Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting