NAME

System::Passwd - easily search for system users on Unix based systems

DESCRIPTION

System::Passwd is a Raku distribution for searching the /etc/passwd file. It provides subroutines to search for a System::Passwd::User user by uid, username or full name. System::Passwd should work on Linux, Unix, FreeBSD, NetBSD, OpenBSD and MacOS (although not all MacOS users are stored in /etc/passwd).

SYNOPSIS

use System::Passwd;

my $root-user = get-user-by-uid(0);

say $root-user.username;
say $root-user.uid;
say $root-user.gid;
say $root-user.fullname;
say $root-user.login-shell;
say $root-user.home-directory;
say $root-user.password;         # This won't be a useful value on most systems

# can search for users other methods
my $user = get-user-by-username('sillymoose');

# or:
my $user = get-user-by-fullname('David Farrell');

AUTHOR

David Farrell

COPYRIGHT AND LICENSE

This library is free software; you can redistribute it and/or modify it under the FreeBSD license.