You shouldn't modify the password of the user with this method, use File_Passwd_Unix::changePasswd() instead.
You should use this method only if the 'name map' is used, too.
the user to modify
an associative array of properties to modify
Returns TRUE on success, PEAR_Error on failure.
Table 43-1. Possible PEAR_Error values
|FILE_PASSWD_E_EXISTS_NOT||user doesn't exists|
|FILE_PASSWD_E_INVALID_CHARS||any of the extra properties contains a colon|