krb5_change_password(3)

KRB5_SET_PASSWORD(3)       UNIX Programmer's Manual       KRB5_SET_PASSWORD(3)

NAME

     krb5_change_password, krb5_set_password, krb5_set_password_using_ccache -
     change password functions

LIBRARY

     Kerberos 5 Library (libkrb5, -lkrb5)

SYNOPSIS

     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)

DESCRIPTION

     These functions change the password for a given principal.

     krb5_set_password() and krb5_set_password_using_ccache is the newer two
     of the three functions and uses a newer version of the protocol (and
     falls back to the older when the newer doesn't work).

     krb5_change_password() set the password newpasswd for the client princi-
     pal in creds. The server principal of creds must be kadmin/changepw.

     krb5_set_password() changes the password for the principal targprinc, if
     targprinc is NULL the default principal in ccache is used.

     Both functions returns and error in result_code and maybe an error
     strings to print in result_string.

SEE ALSO

     krb5_ccache(3),  krb5_init_context(3)

 HEIMDAL                         June 2, 2004                                1