Opens a file, locks it exclusively and returns the filehandle.
(package developer related)
Returns resource file handle or 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 the desired mode|
|FILE_PASSWD_E_FILE_NOT_LOCKED||passwd file couldn't be locked|