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