install sphinx-generated manpages
[krb5.git] / src / man / kpasswd.1
1 .TH "KPASSWD" "1" "January 06, 2012" "0.0.1" "MIT Kerberos"
2 .SH NAME
3 kpasswd \- change a user's Kerberos password
4 .
5 .nr rst2man-indent-level 0
6 .
7 .de1 rstReportMargin
8 \\$1 \\n[an-margin]
9 level \\n[rst2man-indent-level]
10 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
11 -
12 \\n[rst2man-indent0]
13 \\n[rst2man-indent1]
14 \\n[rst2man-indent2]
15 ..
16 .de1 INDENT
17 .\" .rstReportMargin pre:
18 . RS \\$1
19 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
20 . nr rst2man-indent-level +1
21 .\" .rstReportMargin post:
22 ..
23 .de UNINDENT
24 . RE
25 .\" indent \\n[an-margin]
26 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
27 .nr rst2man-indent-level -1
28 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
29 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
30 ..
31 .\" Man page generated from reStructeredText.
32 .
33 .SH SYNOPSIS
34 .sp
35 \fIkpasswd\fP [ \fIprincipal\fP ]
36 .SH DESCRIPTION
37 .sp
38 The \fIkpasswd\fP command is used to change a Kerberos principal\(aqs password.
39 \fIkpasswd\fP prompts for the current Kerberos password, which is used to obtain a
40 \fIchangepw\fP ticket from the KDC for the user\(aqs Kerberos realm.
41 If \fIkpasswd\fP successfully obtains the \fIchangepw\fP ticket, the user is prompted twice for
42 the new password, and the password is changed.
43 .sp
44 If the principal is governed by a policy that specifies the length and/or number of
45 character classes required in the new password, the new password must conform to the policy.
46 (The five character classes are lower case, upper case, numbers, punctuation, and all other characters.)
47 .SH OPTIONS
48 .INDENT 0.0
49 .TP
50 .B \fIprincipal\fP
51 .sp
52 Change the password for the Kerberos principal principal.
53 Otherwise, \fIkpasswd\fP uses the principal name from an existing ccache if there is one;
54 if not, the principal is derived from the identity of the user invoking the \fIkpasswd\fP command.
55 .UNINDENT
56 .SH PORTS
57 .sp
58 \fIkpasswd\fP looks first for:
59 .sp
60 .nf
61 .ft C
62 kpasswd_server = host:port
63 .ft P
64 .fi
65 .sp
66 in the [\fIrealms\fP] section of the \fIkrb5.conf\fP file under the current realm.
67 If that is missing, \fIkpasswd\fP looks for the \fIadmin_server\fP entry, but substitutes 464 for the port.
68 .SH SEE ALSO
69 .sp
70 kadmin(8), kadmind(8)
71 .SH BUGS
72 .sp
73 \fIkpasswd\fP may not work with multi\-homed hosts running on the Solaris platform.
74 .SH AUTHOR
75 MIT
76 .SH COPYRIGHT
77 2011, MIT
78 .\" Generated by docutils manpage writer.
79 .