Returns TRUE on success, PEAR_Error on failure.
Table 43-1. Possible PEAR_Error values
|FILE_PASSWD_E_DIR_NOT_CREATED||the directory in which the passwd file should reside couldn't be created|
|FILE_PASSWD_E_FILE_NOT_OPENED||passwd file couldn't be opened in read mode|
|FILE_PASSWD_E_FILE_NOT_LOCKED||passwd file couldn't be locked shared|
|FILE_PASSWD_E_FILE_NOT_UNLOCKED||passwd file couldn't be unlocked|
|FILE_PASSWD_E_FILE_NOT_CLOSED||passwd file couldn't be closed|
|FILE_PASSWD_E_INVALID_FORMAT||passwd file has invalid format|