unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (NetBSD-6.1.5)
Page:
Section:
Apropos / Subsearch:
optional field

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 <&lt;krb5/krb5.h>&gt;

     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)

NetBSD 6.1.5                     July 15, 2004                    NetBSD 6.1.5