NAME
krb5_change_password,
krb5_set_password,
krb5_set_password_using_ccache,
krb5_passwd_result_to_string —
change
password functions
LIBRARY
Kerberos 5 Library (libkrb5, -lkrb5)
SYNOPSIS
#include <krb5/krb5.h>
krb5_error_code
krb5_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 be
kadmin/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)