#user #group #shadow #user-password #information #passwd #function

passwd-rs

Crate/Library providing a functions to get information about groups, users and shadow passwords

2 unstable releases

0.2.0 Oct 26, 2022
0.1.0 Oct 26, 2022

#658 in Authentication

Download history 28/week @ 2024-04-01 1/week @ 2024-04-15 31/week @ 2024-04-29 51/week @ 2024-05-06 27/week @ 2024-05-13 4/week @ 2024-05-20 18/week @ 2024-05-27 67/week @ 2024-06-03 37/week @ 2024-06-10 112/week @ 2024-06-17 59/week @ 2024-06-24

276 downloads per month
Used in yubico_helper

MIT license

13KB
305 lines

passwd-rs

Crate/Library providing a functions to get information about groups, users and shadow passwords.

Example

use passwd_rs::{Group, User, Shadow, AccountStatus};

fn main() -> std::io::Result<()> {
	let user = User::current_user()?;
	let password;
	if user.passwd.as_ref().unwrap().eq("x") {
		// WARN! This works only if program is executed as root
		let shadow = match Shadow::new_from_username(&user.name.clone()) {
			Err(e) => {
				if e.kind() == std::io::ErrorKind::PermissionDenied {
					println!("Must be run as root to access shadow passwords");
				} else { return Err(e) };

				return Ok(());
			},
			Ok(o) => o,
		};
		if let AccountStatus::Active(passwd) = shadow.passwd {
			password = passwd;
		} else {
			password = shadow.passwd.to_string();
		}
	} else {
		password = user.passwd.unwrap();
	}

	let group = Group::new_from_gid(user.gid.clone())?;

	println!("Group details:");
	println!("Name: {}", group.name);
	println!("ID: {}", group.gid);
	println!("Members: {}", group.display_members());
	println!();
	println!("User details:");
	println!("Name: {}", user.name);
	println!("ID: {}", user.uid);
	println!("Password: {}", password);

	Ok(())
}

No runtime deps