summaryrefslogtreecommitdiffstats
path: root/doc/admin/admin_commands/k5srvutil.rst
blob: 0e30a8ea2a63bd4ed143b24d95f15ceb97d4fc13 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
.. _k5srvutil(1):

k5srvutil
=========

SYNOPSIS
--------

**k5srvutil** *operation*
[**-i**]
[**-f** *filename*]
[**-e** *keysalts*]

DESCRIPTION
-----------

k5srvutil allows an administrator to list or change keys currently in
a keytab or to add new keys to the keytab.

*operation* must be one of the following:

**list**
    Lists the keys in a keytab showing version number and principal
    name.

**change**
    Uses the kadmin protocol to update the keys in the Kerberos
    database to new randomly-generated keys, and updates the keys in
    the keytab to match.  If a key's version number doesn't match the
    version number stored in the Kerberos server's database, then the
    operation will fail.  Old keys are retained in the keytab so that
    existing tickets continue to work.  If the **-i** flag is given,
    k5srvutil will prompt for confirmation before changing each key.
    If the **-k** option is given, the old and new keys will be
    displayed.  Ordinarily, keys will be generated with the default
    encryption types and key salts.  This can be overridden with the
    **-e** option.

**delold**
    Deletes keys that are not the most recent version from the keytab.
    This operation should be used some time after a change operation
    to remove old keys, after existing tickets issued for the service
    have expired.  If the **-i** flag is given, then k5srvutil will
    prompt for confirmation for each principal.

**delete**
    Deletes particular keys in the keytab, interactively prompting for
    each key.

In all cases, the default keytab is used unless this is overridden by
the **-f** option.

k5srvutil uses the :ref:`kadmin(1)` program to edit the keytab in
place.


SEE ALSO
--------

:ref:`kadmin(1)`, :ref:`ktutil(1)`