Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
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  pass-
     word 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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=krb5_passwd_result_to_string&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help