table of contents
KRB5_SET_PASSWORD(3) | Library Functions Manual | KRB5_SET_PASSWORD(3) |
NAME¶
krb5_change_password, krb5_set_password, krb5_set_password_using_ccache, krb5_passwd_result_to_string — change password functionsLIBRARY¶
Kerberos 5 Library (libkrb5, -lkrb5)SYNOPSIS¶
#include <krb5.h> krb5_error_codekrb5_change_password(krb5_context context, krb5_creds *creds, char *newpw, int *result_code, krb5_data *result_code_string, krb5_data *result_string); krb5_error_code
krb5_set_password(krb5_context context, krb5_creds *creds, char *newpw, krb5_principal targprinc, int *result_code, krb5_data *result_code_string, krb5_data *result_string); krb5_error_code
krb5_set_password_using_ccache(krb5_context context, krb5_ccache ccache, char *newpw, krb5_principal targprinc, int *result_code, krb5_data *result_code_string, krb5_data *result_string); const char *
krb5_passwd_result_to_string(krb5_context context, int result);
DESCRIPTION¶
These functions change the password for a given principal. krb5_set_password() and 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). krb5_change_password() sets the password newpasswd for the client principal in creds. The server principal of creds must bekadmin/changepw
.
krb5_set_password() and
krb5_set_password_using_ccache() change the password for the
principal targprinc.
krb5_set_password() requires that the credential for
kadmin/changepw@REALM
is in
creds. If the user caller isn't an administrator, this
credential needs to be an initial credential, see
krb5_get_init_creds(3) how to get such credentials.
krb5_set_password_using_ccache() will get the credential from
ccache.
If targprinc is NULL
,
krb5_set_password_using_ccache() uses the the default
principal in ccache and
krb5_set_password() uses the global the default principal.
All three functions return an error in result_code and
maybe an error string to print in result_string.
krb5_passwd_result_to_string() returns an human readable
string describing the error code in result_code from the
krb5_set_password() functions.
SEE ALSO¶
krb5_ccache(3), krb5_init_context(3)July 15, 2004 | HEIMDAL |