NAME

Passwd::Solaris - Perl module for manipulating the passwd and shadow files

SYNOPSIS

use Passwd::Solaris qw(modpwinfo setpwinfo rmpwnam mgetpwnam);

$err = modpwinfo(@info);
$err = setpwinfo(@info);
$err = rmpwnam($name);
@info = mgetpwnam($name);

DESCRIPTION

Passwd::Solaris provides additional password routines. It augments the getpw* functions with setpwinfo, modpwinfo, rmpwnam, mgetpwnam. You need to run most of the functions as root or as someone who has permission to modify the shadow file.

setpwinfo and modpwinfo are called with arrays containing (in order): name, crypted_password, uid, gid, gecos, home_directory, shell

rmpwnam is called with a scalar containing the login name

mgetpwnam returns the same array that getpwnam returns without the 'unused' age or comment fields it also returns the crypted password if run with root permissions.

setpwinfo does a create/modify of the user. modpwinfo only does a modify, it will return an error if the user doesn't exist.

rmpwnam removes the user with the given login from both the password and shadow files. It returns an error if the user doesn't exist.

This module does call syslog in the C portion, but it doesn't call openlog. If you wish to see the error output of the syslog you must do an openlog in your perl script.

You must be running as root in order to use this module. If it successfully completes an operation and you are not root then you have a huge security problem on your box.

This module as distributed does not allow operations to occur on uid 0 files

Return values: < 0 system error occurred, error value should be in $! 0 no error 1 operation attempt on uid 0 2 user does not exist

Exported functions on the OK basis

modpwinfo
setpwinfo
rmpwnam
mgetpwnam

AUTHOR

Eric Estabrooks, eric@urbanrage.com

SEE ALSO

perl(1).