diff options
| author | Marc Horowitz <marc@mit.edu> | 1993-11-12 23:01:45 +0000 |
|---|---|---|
| committer | Marc Horowitz <marc@mit.edu> | 1993-11-12 23:01:45 +0000 |
| commit | 19d56a289953118e5f616fbca434d468ea05ab8e (patch) | |
| tree | adffa3468df3e816b154595a3146efb9e41e0109 /doc | |
| parent | 0db1fb14b7f932d614e08d27992d64eb197d929b (diff) | |
| download | krb5-19d56a289953118e5f616fbca434d468ea05ab8e.tar.gz krb5-19d56a289953118e5f616fbca434d468ea05ab8e.tar.xz krb5-19d56a289953118e5f616fbca434d468ea05ab8e.zip | |
add pw_ret argument to ...chpass_principal_util
git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@2905 dc483132-0cff-0310-8789-dd5450dbe970
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/kadm5/api-funcspec.tex | 9 |
1 files changed, 7 insertions, 2 deletions
diff --git a/doc/kadm5/api-funcspec.tex b/doc/kadm5/api-funcspec.tex index c8fbba807..6071a0ce7 100644 --- a/doc/kadm5/api-funcspec.tex +++ b/doc/kadm5/api-funcspec.tex @@ -885,7 +885,7 @@ life. \begin{verbatim} ovsec_kadm_ret_t ovsec_kadm_chpass_principal_util(krb5_principal princ, char *new_pw, - int override_qual, char *msg_ret); + int override_qual, char **pw_ret, char *msg_ret); \end{verbatim} AUTHORIZATION REQUIRED: modify, or the calling principal being the @@ -896,7 +896,8 @@ This function is a wrapper around ovsec_kadm_chpass_principal. It can read a new password from a user, change a principal's password, and return detailed error messages. msg_ret should point to a char buffer in the caller's space of sufficient length for the error messages -described below. 1024 bytes is recommended. +described below. 1024 bytes is recommended. It will also return the +new password to the caller if pw_ret is non-NULL. \begin{enumerate} \item If new_pw is NULL, this routine will prompt the user for @@ -912,6 +913,10 @@ to read new password.'' followed by a blank line and ``Password not changed.'' into msg_ret and return the error code returned by krb5_read_password. +\item If pw_ret is non-NULL, and the password was prompted, set *pw_ret to +point to a static buffer containing the password. If pw_ret is non-NULL +and the password was supplied, set *pw_ret to the supplied password. + \item Call ovsec_kadm_chpass_principal with princ, new_pw, and override_qual. \item If successful copy ``Password Changed.'' into msg_ret and return zero. |