Checking in kpasswd client...

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

1 files changed, 84 insertions, 0 deletions

diff --git a/src/kadmin/kpasswd/kpasswd.M b/src/kadmin/kpasswd/kpasswd.M
new file mode 100644
index 0000000000..7442331a6d
--- /dev/null
+++ b/src/kadmin/kpasswd/kpasswd.M
@@ -0,0 +1,84 @@
+.\" $Source$
+.\" $Author$
+.\" $Id$
+.\" 
+.\" Copyright 1995 by the Massachusetts Institute of Technology.
+.\"
+.\" Export of this software from the United States of America may
+.\"   require a specific license from the United States Government.
+.\"   It is the responsibility of any person or organization contemplating
+.\"   export to obtain such a license before exporting.
+.\" 
+.\" WITHIN THAT CONSTRAINT, permission to use, copy, modify, and
+.\" distribute this software and its documentation for any purpose and
+.\" without fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright notice and
+.\" this permission notice appear in supporting documentation, and that
+.\" the name of M.I.T. not be used in advertising or publicity pertaining
+.\" to distribution of the software without specific, written prior
+.\" permission.  M.I.T. makes no representations about the suitability of
+.\" this software for any purpose.  It is provided "as is" without express
+.\" or implied warranty.
+.\" 
+.\"
+.TH KPASSWD 1 "Kerberos Version 5.0" "MIT Project Athena"
+.SH NAME
+kpasswd \- change a user's Kerberos password
+.SH SYNOPSIS
+.B kpasswd
+[
+.B \-m
+] [
+.B \-l
+language
+] [
+.B \-u
+.IR username[/instance][@realm]
+]
+.SH DESCRIPTION
+The 
+.I kpasswd
+command is used to change a Kerberos principal's password.
+
+If the
+.I \-n
+option is specified, a partially or fully qualified Kerberos principal may
+be supplied.  Otherwise, the principal name is derived from the identity
+of the user invoking the
+.I kpasswd
+command.
+
+The
+.I \-l
+and 
+.I \-m
+flags may be specified to qualify how the administrative server is to issue
+messages.  The
+.I \-l
+flag specifies which
+.I language
+to issue messages in, while the 
+.I \-m
+flag enables MIME-encoded messages.  The support of these flags and the
+interpretation of the
+.I language
+paramter is specific to the administrative server.
+
+.PP
+The
+.I kpasswd
+command prompts for the current Kerberos password,  which is verified by the
+Kerberos server.  If the old password is correct, the user is prompted twice
+for the new password.  Success or failure is indicated by messages printed
+out by
+.I kpasswd.
+
+
+.SH FILES
+.TP 2i
+/tmp/tkt_kpw_[uid]
+the temporary credentials cache ([uid] is the decimal UID of the user) for
+the lifetime of the password changing operation.
+.SH SEE ALSO
+kadmin5(8), kadmind5(8)
+.SH BUGS