# MIT Kerberos Documentation

Contents | previous | next | index | Search | feedback

# krb5_read_password - Read a password from keyboard input.

krb5_error_code krb5_read_password(krb5_context context, const char *prompt, const char *prompt2, char *return_pwd, unsigned int *size_return)

param:

  [in] context - Library context

  [in] prompt - First user prompt when reading password

  [in] prompt2 - Second user prompt (NULL to prompt only once)

  [out] return_pwd - Returned password

  [inout] size_return - On input, maximum size of password; on output, size of password read

retval:

  - 0 Success

return:

  - Error in reading or verifying the password

  - Kerberos error codes

This function reads a password from keyboard input and stores it in return_pwd . size_return should be set by the caller to the amount of storage space available in return_pwd ; on successful return, it will be set to the length of the password read.

> prompt is printed to the terminal, followed by”:”, and then a password is read from the keyboard.

If prompt2 is NULL, the password is read only once. Otherwise, prompt2 is printed to the terminal and a second password is read. If the two passwords entered are not identical, KRB5_LIBOS_BADPWDMATCH is returned.

Echoing is turned off when the password is read.