File::LckPwdF - Lock and unlock the passwd and shadow files with lckpwdf and ulckpwdf
(lock_passwd(15)) || (die "Can't lock password file:\n$! stopped");
# ... do stuff with the passwd file ...
(unlock_passwd()) || (die "Can't unlock password file:\n$! stopped");
This is a perl module to use lckpwdf(3) and ulckpwdf(3) to lock the /etc/passwd and (if present) /etc/shadow files.
$timeout works as follows:
The random timeout is controlled by $File::LckPwdF::Rand_Wait, which is exported on request. It is used via
sleep int(rand($Rand_Wait) + 1);
inside an until loop. This sleep is only done if $File::LckPwdF::Rand_Wait is above 0.
$timeout defaults to $File::LckPwdF::Default_Timeout, which is also exported on request; the initial setting of $File::LckPwdF::Default_Timeout (the default default) is 15 seconds. The default setting for $File::LckPwdF::Rand_Wait is 10 seconds.
This function uses ulckpwdf(). If lock_passwd() has previously been used to lock the passwd file, and unlock_passwd() has not been used to lock it, then it will be used to unlock the passwd file in an END: statement. (Admittedly, with many implementations of lckpwdf() this is not necessary, since when a process exits it loses the passwd file lock; it is present as a safety measure for those systems for which this is not true.)
These are the xs-loaded versions of lckpwdf(3) and ulckpwdf(3), respectively.
The lock_passwd() and unlock_passwd() functions return 1 on success and 0 on failure. The return values for lckpwdf() and ulckpwdf() are the same as for the system versions (lckpwdf(3) and ulckpwdf(3)).
If the effective UID is not 0, then lock_passwd() and unlock_passwd() set $! to EACCES if they fail (they do try once, just in case you've got a really weird setup).
If the effective UID is 0, in the event of failure, lock_passwd() sets $! to:
unlock_passwd(), in the event of failure, sets $! to:
If you try to use a negative number for $timeout with lock_passwd($timeout), it carps, returns 0, and sets $! to EINVAL.
This program only works if your system has lckpwdf(3) and ulckpwdf(3). This should be true of SVR4 systems; others will vary. If you use lock_passwd() and unlock_passwd(), lckpwdf(3) and ulckpwdf(3) need to have return values of 0+ for success and below 0 (usually -1) for failure.
The timeout period for lock_passwd() is approximate, since many versions of lckpwdf() will keep trying for a total of 15 seconds to lock the passwd (and possibly shadow) files before they return an appropriate value.
This module only keeps track on its own of whether the passwd file is locked if you always use lock_passwd() and unlock_passwd(). If you use lckpwdf() or ulckpwdf() by themselves for locking and unlocking, you will need to set $File::LckPwdF::Passwd_Locked to 1 for locked and 0 for unlocked yourself.
I haven't written any good automated tests for this program yet. If anyone's interested, be my guest (or for any other improvements, of course).
E. Allen Smith, <email@example.com>. Copyright 1998. This software may be used, distributed, modified, etcetera under the same conditions as perl.
perl(1), lckpwdf(3), ulckpwdf(3)
To install File::LckPwdF, copy and paste the appropriate command in to your terminal.
perl -MCPAN -e shell
For more information on module installation, please visit the detailed CPAN module installation guide.