Struct IntoError

Source

pub struct IntoError(/* private fields */);

Expand description

An Error from readpassphrase_into containing the passed buffer.

The buffer is accessible via IntoError::into_bytes, and the Error via IntoError::error.

If into_bytes is not called, the buffer is automatically zeroed on drop.

Implementations§

Source §

impl IntoError

Source

pub fn error(&self) -> &Error

Return the Error corresponding to this.

Examples found in repository ?

examples/owned.rs (line 18)

4fn main() -> Result<(), Error> {
5    let mut buf = Zeroizing::new(Some(vec![0u8; PASSWORD_LEN]));
6    let pass = Zeroizing::new(
7        readpassphrase(c"Password: ", buf.as_deref_mut().unwrap(), Flags::ECHO_ON)?.to_string(),
8    );
9    let mut buf = buf.take();
10    loop {
11        buf = Some(
12            match readpassphrase_into(c"Confirmation: ", buf.take().unwrap(), Flags::REQUIRE_TTY) {
13                Ok(mut s) if *pass == s => {
14                    s.zeroize();
15                    break;
16                }
17                Ok(s) => s.into_bytes(),
18                Err(e) => match e.error() {
19                    Error::Io(_) => return Err(e.into()),
20                    Error::Utf8(_) => {
21                        eprintln!("decode error: {e}");
22                        e.into_bytes()
23                    }
24                },
25            },
26        );
27    }
28    Ok(())
29}

Source

pub fn into_bytes(self) -> Vec<u8> ⓘ

Returns the buffer that was passed to readpassphrase_into.

§Security

The returned buffer may contain sensitive data in its spare capacity, even if the buffer’s length is zero. It is the caller’s responsibility to zero it as soon as possible if needed, e.g. using Zeroize:

let mut buf = err.into_bytes();
// ...
buf.zeroize();

Examples found in repository ?

examples/owned.rs (line 22)

4fn main() -> Result<(), Error> {
5    let mut buf = Zeroizing::new(Some(vec![0u8; PASSWORD_LEN]));
6    let pass = Zeroizing::new(
7        readpassphrase(c"Password: ", buf.as_deref_mut().unwrap(), Flags::ECHO_ON)?.to_string(),
8    );
9    let mut buf = buf.take();
10    loop {
11        buf = Some(
12            match readpassphrase_into(c"Confirmation: ", buf.take().unwrap(), Flags::REQUIRE_TTY) {
13                Ok(mut s) if *pass == s => {
14                    s.zeroize();
15                    break;
16                }
17                Ok(s) => s.into_bytes(),
18                Err(e) => match e.error() {
19                    Error::Io(_) => return Err(e.into()),
20                    Error::Utf8(_) => {
21                        eprintln!("decode error: {e}");
22                        e.into_bytes()
23                    }
24                },
25            },
26        );
27    }
28    Ok(())
29}