Opens a file, locks it exclusively and returns the filehandle.
(package developer related)
Returns resource file handle or PEAR_Error on failure.
Table 29-1. Possible PEAR_Error values
| Error Code | Summary |
|---|---|
| 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 the desired mode |
| FILE_PASSWD_E_FILE_NOT_LOCKED | passwd file couldn't be locked |