DESCRIPTION

These functions change the password for a given principal.

Fn krb5_set_password
and
Fn krb5_set_password_using_ccache
are the newer of the three functions, and use a newer version of the
protocol (and also fall back to the older set-password protocol if the
newer protocol doesn't work).

Fn krb5_change_password
sets the password
Fa newpasswd
for the client principal in
Fa creds .
The server principal of creds must be
kadmin/changepw

Fn krb5_set_password
requires that the credential for
kadmin/changepw@REALM
is in
Fa creds .
If the user caller isn't an administrator, this credential
needs to be an initial credential, see
krb5_get_init_creds3
how to get such credentials.

Fn krb5_set_password_using_ccache
will get the credential from
Fa ccache .

If
Fa targprinc
is
NULL
Fn krb5_set_password_using_ccache
uses the the default principal in
Fa ccache
and
Fn krb5_set_password
uses the global the default principal.

All three functions return an error in
Fa result_code
and maybe an error string to print in
Fa result_string .