xref: /freebsd/crypto/krb5/doc/user/user_commands/kdestroy.rst (revision 7f2fe78b9dd5f51c821d771b63d2e096f6fd49e9)
1*7f2fe78bSCy Schubert.. _kdestroy(1):
2*7f2fe78bSCy Schubert
3*7f2fe78bSCy Schubertkdestroy
4*7f2fe78bSCy Schubert========
5*7f2fe78bSCy Schubert
6*7f2fe78bSCy SchubertSYNOPSIS
7*7f2fe78bSCy Schubert--------
8*7f2fe78bSCy Schubert
9*7f2fe78bSCy Schubert**kdestroy**
10*7f2fe78bSCy Schubert[**-A**]
11*7f2fe78bSCy Schubert[**-q**]
12*7f2fe78bSCy Schubert[**-c** *cache_name*]
13*7f2fe78bSCy Schubert[**-p** *princ_name*]
14*7f2fe78bSCy Schubert
15*7f2fe78bSCy Schubert
16*7f2fe78bSCy SchubertDESCRIPTION
17*7f2fe78bSCy Schubert-----------
18*7f2fe78bSCy Schubert
19*7f2fe78bSCy SchubertThe kdestroy utility destroys the user's active Kerberos authorization
20*7f2fe78bSCy Schuberttickets by overwriting and deleting the credentials cache that
21*7f2fe78bSCy Schubertcontains them.  If the credentials cache is not specified, the default
22*7f2fe78bSCy Schubertcredentials cache is destroyed.
23*7f2fe78bSCy Schubert
24*7f2fe78bSCy Schubert
25*7f2fe78bSCy SchubertOPTIONS
26*7f2fe78bSCy Schubert-------
27*7f2fe78bSCy Schubert
28*7f2fe78bSCy Schubert**-A**
29*7f2fe78bSCy Schubert    Destroys all caches in the collection, if a cache collection is
30*7f2fe78bSCy Schubert    available.  May be used with the **-c** option to specify the
31*7f2fe78bSCy Schubert    collection to be destroyed.
32*7f2fe78bSCy Schubert
33*7f2fe78bSCy Schubert**-q**
34*7f2fe78bSCy Schubert    Run quietly.  Normally kdestroy beeps if it fails to destroy the
35*7f2fe78bSCy Schubert    user's tickets.  The **-q** flag suppresses this behavior.
36*7f2fe78bSCy Schubert
37*7f2fe78bSCy Schubert**-c** *cache_name*
38*7f2fe78bSCy Schubert    Use *cache_name* as the credentials (ticket) cache name and
39*7f2fe78bSCy Schubert    location; if this option is not used, the default cache name and
40*7f2fe78bSCy Schubert    location are used.
41*7f2fe78bSCy Schubert
42*7f2fe78bSCy Schubert    The default credentials cache may vary between systems.  If the
43*7f2fe78bSCy Schubert    **KRB5CCNAME** environment variable is set, its value is used to
44*7f2fe78bSCy Schubert    name the default ticket cache.
45*7f2fe78bSCy Schubert
46*7f2fe78bSCy Schubert**-p** *princ_name*
47*7f2fe78bSCy Schubert    If a cache collection is available, destroy the cache for
48*7f2fe78bSCy Schubert    *princ_name* instead of the primary cache.  May be used with the
49*7f2fe78bSCy Schubert    **-c** option to specify the collection to be searched.
50*7f2fe78bSCy Schubert
51*7f2fe78bSCy Schubert
52*7f2fe78bSCy SchubertNOTE
53*7f2fe78bSCy Schubert----
54*7f2fe78bSCy Schubert
55*7f2fe78bSCy SchubertMost installations recommend that you place the kdestroy command in
56*7f2fe78bSCy Schubertyour .logout file, so that your tickets are destroyed automatically
57*7f2fe78bSCy Schubertwhen you log out.
58*7f2fe78bSCy Schubert
59*7f2fe78bSCy Schubert
60*7f2fe78bSCy SchubertENVIRONMENT
61*7f2fe78bSCy Schubert-----------
62*7f2fe78bSCy Schubert
63*7f2fe78bSCy SchubertSee :ref:`kerberos(7)` for a description of Kerberos environment
64*7f2fe78bSCy Schubertvariables.
65*7f2fe78bSCy Schubert
66*7f2fe78bSCy Schubert
67*7f2fe78bSCy SchubertFILES
68*7f2fe78bSCy Schubert-----
69*7f2fe78bSCy Schubert
70*7f2fe78bSCy Schubert|ccache|
71*7f2fe78bSCy Schubert    Default location of Kerberos 5 credentials cache
72*7f2fe78bSCy Schubert
73*7f2fe78bSCy Schubert
74*7f2fe78bSCy SchubertSEE ALSO
75*7f2fe78bSCy Schubert--------
76*7f2fe78bSCy Schubert
77*7f2fe78bSCy Schubert:ref:`kinit(1)`, :ref:`klist(1)`, :ref:`kerberos(7)`
78