From b9521498fbd3643cb3fab202353b021a85c2ab8b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Love=20H=C3=B6rnquist=20=C3=85strand?= <lha@kth.se>
Date: Wed, 14 Jul 2004 11:10:37 +0000
Subject: [PATCH] Remove superfluous comma; grammar fixes; split sentence in
 two for better understanding. From wiz@NetBSD.org

Describe krb5_set_password_using_ccache


git-svn-id: svn://svn.h5l.se/heimdal/trunk/heimdal@14048 ec53bebd-3082-4978-b11e-865c3cabbd6b
---
 lib/krb5/krb5_set_password.3 | 38 +++++++++++++++++++++++++++---------
 1 file changed, 29 insertions(+), 9 deletions(-)

diff --git a/lib/krb5/krb5_set_password.3 b/lib/krb5/krb5_set_password.3
index 9ff2bf697..40a19b300 100644
--- a/lib/krb5/krb5_set_password.3
+++ b/lib/krb5/krb5_set_password.3
@@ -57,7 +57,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"
@@ -83,7 +83,7 @@ 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 .
@@ -91,19 +91,39 @@ The server principal of creds must be
 .Li kadmin/changepw .
 .Pp
 .Fn krb5_set_password
+and
+.Fn krb5_set_password_using_ccache
 changes the password for the principal
-.Fa targprinc ,
-if
+.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 returns and error in
 .Fa result_code
-and maybe an error strings to print in
+and maybe an error string to print in
 .Fa result_string .
 .Sh SEE ALSO
 .Xr krb5_ccache 3 ,