97fb7197287b5785920dabd8d169b05f9df9003a
[platform/upstream/krb5.git] / src / man / kpasswd.man
1 .\" Man page generated from reStructuredText.
2 .
3 .TH "KPASSWD" "1" " " "1.15.2" "MIT Kerberos"
4 .SH NAME
5 kpasswd \- change a user's Kerberos password
6 .
7 .nr rst2man-indent-level 0
8 .
9 .de1 rstReportMargin
10 \\$1 \\n[an-margin]
11 level \\n[rst2man-indent-level]
12 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
13 -
14 \\n[rst2man-indent0]
15 \\n[rst2man-indent1]
16 \\n[rst2man-indent2]
17 ..
18 .de1 INDENT
19 .\" .rstReportMargin pre:
20 . RS \\$1
21 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
22 . nr rst2man-indent-level +1
23 .\" .rstReportMargin post:
24 ..
25 .de UNINDENT
26 . RE
27 .\" indent \\n[an-margin]
28 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
29 .nr rst2man-indent-level -1
30 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
31 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
32 ..
33 .SH SYNOPSIS
34 .sp
35 \fBkpasswd\fP [\fIprincipal\fP]
36 .SH DESCRIPTION
37 .sp
38 The kpasswd command is used to change a Kerberos principal\(aqs password.
39 kpasswd first prompts for the current Kerberos password, then prompts
40 the user twice for the new password, and the password is changed.
41 .sp
42 If the principal is governed by a policy that specifies the length
43 and/or number of character classes required in the new password, the
44 new password must conform to the policy.  (The five character classes
45 are lower case, upper case, numbers, punctuation, and all other
46 characters.)
47 .SH OPTIONS
48 .INDENT 0.0
49 .TP
50 .B \fIprincipal\fP
51 Change the password for the Kerberos principal principal.
52 Otherwise, kpasswd uses the principal name from an existing ccache
53 if there is one; if not, the principal is derived from the
54 identity of the user invoking the kpasswd command.
55 .UNINDENT
56 .SH SEE ALSO
57 .sp
58 \fIkadmin(1)\fP, \fIkadmind(8)\fP
59 .SH AUTHOR
60 MIT
61 .SH COPYRIGHT
62 1985-2017, MIT
63 .\" Generated by docutils manpage writer.
64 .