summaryrefslogtreecommitdiffstats
path: root/doc/rst_source/krb_users/user_commands/kdestroy.rst
blob: 78a3014a97e138f1880c79ea037298a1ffdc5692 (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
kdestroy - destroy Kerberos tickets
=======================================

SYNOPSIS
~~~~~~~~~~~~~

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


DESCRIPTION
~~~~~~~~~~~~~

The *kdestroy* utility destroys the user's active Kerberos
authorization tickets by writing zeros to the specified
credentials cache that contains them. If the credentials
cache is not specified, the default credentials cache is destroyed.


OPTIONS
~~~~~~~~~~~~~

     **-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 variables:

     **KRB5CCNAME**  - Location of the Kerberos 5 credentials (ticket) cache.


FILES
~~~~~~~~~~~~~

/tmp/krb5cc_[uid]  - Default location of Kerberos 5 credentials cache ([*uid*] is the decimal UID of the user).


SEE ALSO
~~~~~~~~~

kinit(1), klist(1), krb5(3)


BUGS
~~~~~

Only the tickets in the specified credentials cache are destroyed. 
Separate ticket caches are used to hold root instance and password changing tickets.
These should probably be destroyed too, or all of a user's tickets kept in a single credentials cache.