Man page - krb5_passwd_result_to_string(3)

Packages contains this manual

Manual


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 functions

LIBRARY

Kerberos 5 Library (libkrb5, -lkrb5)

SYNOPSIS

#include <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) HEIMDAL July 15, 2004 KRB5_SET_PASSWORD (3)