diff options
Diffstat (limited to 'crypto/heimdal/lib/krb5/krb5_set_password.3')
-rw-r--r-- | crypto/heimdal/lib/krb5/krb5_set_password.3 | 68 |
1 files changed, 51 insertions, 17 deletions
diff --git a/crypto/heimdal/lib/krb5/krb5_set_password.3 b/crypto/heimdal/lib/krb5/krb5_set_password.3 index e2e3086..45ed41d 100644 --- a/crypto/heimdal/lib/krb5/krb5_set_password.3 +++ b/crypto/heimdal/lib/krb5/krb5_set_password.3 @@ -1,4 +1,4 @@ -.\" Copyright (c) 2003 Kungliga Tekniska Högskolan +.\" Copyright (c) 2003 - 2004 Kungliga Tekniska Högskolan .\" (Royal Institute of Technology, Stockholm, Sweden). .\" All rights reserved. .\" @@ -29,15 +29,16 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $Id: krb5_set_password.3,v 1.3.2.1 2004/06/21 10:51:20 lha Exp $ +.\" $Id: krb5_set_password.3 14052 2004-07-15 14:39:06Z lha $ .\" -.Dd June 2, 2004 +.Dd July 15, 2004 .Dt KRB5_SET_PASSWORD 3 .Os HEIMDAL .Sh NAME .Nm krb5_change_password , .Nm krb5_set_password , -.Nm krb5_set_password_using_ccache +.Nm krb5_set_password_using_ccache , +.Nm krb5_passwd_result_to_string .Nd change password functions .Sh LIBRARY Kerberos 5 Library (libkrb5, -lkrb5) @@ -57,7 +58,7 @@ Kerberos 5 Library (libkrb5, -lkrb5) .Fa "krb5_context context" .Fa "krb5_creds *creds" .Fa "char *newpw" -.Fa "krb5_principal targprinc", +.Fa "krb5_principal targprinc" .Fa "int *result_code" .Fa "krb5_data *result_code_string" .Fa "krb5_data *result_string" @@ -72,17 +73,23 @@ Kerberos 5 Library (libkrb5, -lkrb5) .Fa "krb5_data *result_code_string" .Fa "krb5_data *result_string" .Fc +.Ft "const char *" +.Fo krb5_passwd_result_to_string +.Fa "krb5_context context" +.Fa "int result" +.Fc .Sh DESCRIPTION These functions change the password for a given principal. .Pp .Fn krb5_set_password and -.Fa 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). +.Fn 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). .Pp .Fn krb5_change_password -set the password +sets the password .Fa newpasswd for the client principal in .Fa creds . @@ -90,20 +97,47 @@ The server principal of creds must be .Li kadmin/changepw . .Pp .Fn krb5_set_password -changes the password for the principal -.Fa targprinc , -if +and +.Fn krb5_set_password_using_ccache +change the password for the principal +.Fa targprinc . +.Pp +.Fn krb5_set_password +requires that the credential for +.Li kadmin/changepw@REALM +is in +.Fa creds . +If the user caller isn't an administrator, this credential +needs to be an initial credential, see +.Xr krb5_get_init_creds 3 +how to get such credentials. +.Pp +.Fn krb5_set_password_using_ccache +will get the credential from +.Fa ccache . +.Pp +If .Fa targprinc is -.Dv NULL -the default principal in +.Dv NULL , +.Fn krb5_set_password_using_ccache +uses the the default principal in .Fa ccache -is used. +and +.Fn krb5_set_password +uses the global the default principal. .Pp -Both functions returns and error in +All three functions return an error in .Fa result_code -and maybe an error strings to print in +and maybe an error string to print in .Fa result_string . +.Pp +.Fn krb5_passwd_result_to_string +returns an human readable string describing the error code in +.Fa result_code +from the +.Fn krb5_set_password +functions. .Sh SEE ALSO .Xr krb5_ccache 3 , .Xr krb5_init_context 3 |