summaryrefslogtreecommitdiffstats
path: root/doc/users/user_commands/kdestroy.rst
blob: b8c67aba4cc62d4b69d421788241de7e8876b1e9 (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
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
.. _kdestroy(1):

kdestroy
========

SYNOPSIS
--------

**kdestroy**
[**-A**]
[**-q**]
[**-c** *cache_name*]


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

The kdestroy utility destroys the user's active Kerberos authorization
tickets by overwriting and deleting the credentials cache that
contains them.  If the credentials cache is not specified, the default
credentials cache is destroyed.


OPTIONS
-------

**-A**
    Destroys all caches in the collection, if a cache collection is
    available.

**-q**
    Run quietly.  Normally kdestroy beeps if it fails to destroy the
    user's tickets.  The **-q** flag suppresses this behavior.

**-c** *cache_name*
    Use *cache_name* as the credentials (ticket) cache name and
    location; if this option is not used, the default cache name and
    location are used.

    The default credentials cache may vary between systems.  If the
    **KRB5CCNAME** environment variable is set, its value is used to
    name the default ticket cache.


NOTE
----

Most installations recommend that you place the kdestroy command in
your .logout file, so that your tickets are destroyed automatically
when you log out.


ENVIRONMENT
-----------

kdestroy uses the following environment variable:

**KRB5CCNAME**
    Location of the default Kerberos 5 credentials (ticket) cache, in
    the form *type*:*residual*.  If no *type* prefix is present, the
    **FILE** type is assumed.  The type of the default cache may
    determine the availability of a cache collection; for instance, a
    default cache of type **DIR** causes caches within the directory
    to be present in the collection.


FILES
-----

|ccache|
    Default location of Kerberos 5 credentials cache


SEE ALSO
--------

:ref:`kinit(1)`, :ref:`klist(1)`