Function getpass

pub fn getpass(prompt: &CStr) -> Result<String, Error>

Reads a passphrase using readpassphrase(3), returning it as a String.

Internally, this function uses a buffer of PASSWORD_LEN bytes, allowing for passwords up to PASSWORD_LEN - 1 characters (accounting for the C null terminator.) If the entered passphrase is longer, it will be truncated.

The passed flags are always RppFlags::default(), i.e. ECHO_OFF.

Security

The returned String is owned by the caller, and therefore it is the caller’s responsibility to clear it when you are done with it:

let mut pass = getpass(c"Pass: ")?;
_ = pass;
pass.zeroize();

Examples found in repository

examples/pass.rs (line 12)

fn main() {
    let mut password = getpass(c"Password: ").expect("failed reading password");
    println!("{password}");
    password.zeroize();
}