xref: /freebsd/crypto/krb5/doc/user/user_commands/kpasswd.rst (revision 7f2fe78b9dd5f51c821d771b63d2e096f6fd49e9)
1*7f2fe78bSCy Schubert.. _kpasswd(1):
2*7f2fe78bSCy Schubert
3*7f2fe78bSCy Schubertkpasswd
4*7f2fe78bSCy Schubert=======
5*7f2fe78bSCy Schubert
6*7f2fe78bSCy SchubertSYNOPSIS
7*7f2fe78bSCy Schubert--------
8*7f2fe78bSCy Schubert
9*7f2fe78bSCy Schubert**kpasswd** [*principal*]
10*7f2fe78bSCy Schubert
11*7f2fe78bSCy Schubert
12*7f2fe78bSCy SchubertDESCRIPTION
13*7f2fe78bSCy Schubert-----------
14*7f2fe78bSCy Schubert
15*7f2fe78bSCy SchubertThe kpasswd command is used to change a Kerberos principal's password.
16*7f2fe78bSCy Schubertkpasswd first prompts for the current Kerberos password, then prompts
17*7f2fe78bSCy Schubertthe user twice for the new password, and the password is changed.
18*7f2fe78bSCy Schubert
19*7f2fe78bSCy SchubertIf the principal is governed by a policy that specifies the length
20*7f2fe78bSCy Schubertand/or number of character classes required in the new password, the
21*7f2fe78bSCy Schubertnew password must conform to the policy.  (The five character classes
22*7f2fe78bSCy Schubertare lower case, upper case, numbers, punctuation, and all other
23*7f2fe78bSCy Schubertcharacters.)
24*7f2fe78bSCy Schubert
25*7f2fe78bSCy Schubert
26*7f2fe78bSCy SchubertOPTIONS
27*7f2fe78bSCy Schubert-------
28*7f2fe78bSCy Schubert
29*7f2fe78bSCy Schubert*principal*
30*7f2fe78bSCy Schubert    Change the password for the Kerberos principal principal.
31*7f2fe78bSCy Schubert    Otherwise, kpasswd uses the principal name from an existing ccache
32*7f2fe78bSCy Schubert    if there is one; if not, the principal is derived from the
33*7f2fe78bSCy Schubert    identity of the user invoking the kpasswd command.
34*7f2fe78bSCy Schubert
35*7f2fe78bSCy Schubert
36*7f2fe78bSCy SchubertENVIRONMENT
37*7f2fe78bSCy Schubert-----------
38*7f2fe78bSCy Schubert
39*7f2fe78bSCy SchubertSee :ref:`kerberos(7)` for a description of Kerberos environment
40*7f2fe78bSCy Schubertvariables.
41*7f2fe78bSCy Schubert
42*7f2fe78bSCy Schubert
43*7f2fe78bSCy SchubertSEE ALSO
44*7f2fe78bSCy Schubert--------
45*7f2fe78bSCy Schubert
46*7f2fe78bSCy Schubert:ref:`kadmin(1)`, :ref:`kadmind(8)`, :ref:`kerberos(7)`
47