* draft-ietf-cat-kerb-chg-password-02.txt: Describes protocol in

	use by krb5_change_password().

	* README: Describes which admin protocol is used with which server.

There is a newer draft of the password changing protocol out
(version 2 of the protocol) but we do not implement it.

git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@13498 dc483132-0cff-0310-8789-dd5450dbe970

1 files changed, 46 insertions, 0 deletions

diff --git a/doc/kadmin/README b/doc/kadmin/README
new file mode 100644
index 0000000000..b3e53bfc82
--- /dev/null
+++ b/doc/kadmin/README
@@ -0,0 +1,46 @@
+There are several different admin protocols in our source tree.
+
+a) V4 server protocol - not documented
+
+b) Old kadmin protocol - which was in the beta code (kadmin/v5passwdd)
+
+c) Newer kadm5 gssrpc based code (kadmin/server)
+
+d) Simple password changing protocol implemented in our kadmin server
+with client in clients/kpasswd. 
+
+
+
+This file will attempt to link the files in this directory with where
+the code is used in the source tree.
+
+
+- kpasswd.protocol: Describes the password changing protocol in
+			src/kadmin/v5passwdd. 
+			include/krb5/adm.h has some defintions.
+
+		    Client and server provided
+
+- kadmin.protocol: Describes other administrative protocol options that 
+			src/kadmin/v5passwdd supports
+
+		    No client in the source tree uses it.
+
+- draft-ietf-cat-kerb-chg-password-02.txt: Describes the 
+		    password changing service that 
+		    clients/kpasswd uses through krb5_change_password() 
+		    located in lib/krb5/os/changepw.c
+
+		    kadmin/server/schpw.c implements this as part of
+		    the kadmin server.
+
+		    This is version 1 of the protocol. Version 2 is
+		    in the IETF draft stage and is very different. 
+
+		    Currently: Version 1 is supported - but we may not 
+		    be implementing the TCP handling aspects.
+
+- ../doc/kadm5: Describes the current protocol. 
+
+		    kadmin/passwd (which is not installed) uses
+ 		    the kadm5 protocol for password changing.