1@subheading gsasl_simple_getpass
2@anchor{gsasl_simple_getpass}
3@deftypefun {int} {gsasl_simple_getpass} (const char * @var{filename}, const char * @var{username}, char ** @var{key})
4@var{filename}: filename of file containing passwords.
5
6@var{username}: username string.
7
8@var{key}: newly allocated output character array.
9
10Retrieve password for user from specified file.  The buffer  @code{key} contain the password if this function is successful.  The caller is
11responsible for deallocating it.
12
13The file should be on the UoW "MD5 Based Authentication" format,
14which means it is in text format with comments denoted by # first
15on the line, with user entries looking as "usernameTABpassword".
16This function removes CR and LF at the end of lines before
17processing.  TAB, CR, and LF denote ASCII values 9, 13, and 10,
18respectively.
19
20Return value: Return @code{GSASL_OK}  if output buffer contains the
21password, @code{GSASL_AUTHENTICATION_ERROR}  if the user could not be
22found, or other error code.
23@end deftypefun
24
25