File_Passwd

passwd-style files

passwd-style means, the file has a format like this:

user:password

The temporary file

File_Passwd reads the existing password file, copies the content into a temporary file. All changes, you do with the provided functions only influence this copy. First, when you call close() the copy will renamed to the password file.

File_Passwd::File_Passwd

Requires the name of the password file. This functions opens the file and read it. Changes to this file will written first in the lock file, so it is still possible to access the passwd file by another programs. The lock parameter controls the locking of the lockfile, not of the passwd file! (Swapping $lock and $lockfile would breaks bc to v1.3 and smaller).

Parameter

• $file - password file to read

• $lock - if true, the temporary file will be locked

• $lockfile - name of the temporary password file

File_Passwd::addUser

Adds a user to the file

Parameter

• $user - the user name

• $pass - the uncrypted password

• $cvsuser - when editing a cvs passwd file, you can set the cvs user name

• mixed - when the user already exists, you get a PEAR_Error

File_Passwd::modUser

Modify a user in the file

Parameter

• $user - the user name

• $pass - the uncrypted password

• $cvsuser - when editing a cvs passwd file, you can set the cvs user name

• mixed - when user doesn't exists, you get a PEAR_Error

File_Passwd::delUser

Deletes a user in the file

Parameter

• $user - the user name

• mixed - when user doesn't exists, you get a PEAR_Error

File_Passwd::verifyPassword

Verifies a user's password

Parameter

• $user - the user name

• $pass - the uncrypted password

File_Passwd::close

Writes changes to passwd file and unlocks it.