freebsd man page for krb5_set_password

Query: krb5_set_password

OS: freebsd

Section: 3

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

KRB5_SET_PASSWORD(3)					   BSD 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 cre- dential 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() func- tions.
SEE ALSO
krb5_ccache(3), krb5_init_context(3)
HEIMDAL
July 15, 2004 HEIMDAL
Related Man Pages
krb5_set_error_string(3) - freebsd
krb5_set_password(3) - debian
krb5_change_password(3) - netbsd
krb5_set_password(3) - netbsd
krb5_enctypes_compatible_keys(3) - freebsd
Similar Topics in the Unix Linux Community
FreeBSD Kernel Internals, Dr. Marshall Kirk McKusick
Scripts without shebang
Reason for no directory creation date
Valid separator in time and date format
Controlling user input