xref: /freebsd/crypto/krb5/src/windows/leash/htmlhelp/html/KDESTROY.htm (revision 7f2fe78b9dd5f51c821d771b63d2e096f6fd49e9)
1*7f2fe78bSCy Schubert<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
2*7f2fe78bSCy Schubert<HTML>
3*7f2fe78bSCy Schubert<HEAD>
4*7f2fe78bSCy Schubert<meta name="GENERATOR" content="Microsoft&reg; HTML Help Workshop 4.1">
5*7f2fe78bSCy Schubert<link rel="stylesheet" type="text/css" href="Leash.css" />
6*7f2fe78bSCy Schubert
7*7f2fe78bSCy Schubert<Title>KDESTROY</Title>
8*7f2fe78bSCy Schubert</HEAD>
9*7f2fe78bSCy Schubert<BODY>
10*7f2fe78bSCy Schubert<H1>KDESTROY Command</H1>
11*7f2fe78bSCy Schubert<table>
12*7f2fe78bSCy Schubert<tr><th id="th2"> The following information reproduces the information from UNIX man page for the KDESTROY command.</th>
13*7f2fe78bSCy Schubert</tr>
14*7f2fe78bSCy Schubert</table>
15*7f2fe78bSCy Schubert
16*7f2fe78bSCy Schubert<H2>SYNOPSIS</H2>
17*7f2fe78bSCy Schubert<table>
18*7f2fe78bSCy Schubert<tr>
19*7f2fe78bSCy Schubert<th id="th2">kdestroy</th>
20*7f2fe78bSCy Schubert<td>
21*7f2fe78bSCy Schubert<span class="command">[<B>-A</B>]    </span>
22*7f2fe78bSCy Schubert<span class="command"> [<B>-q</B>]  </span>
23*7f2fe78bSCy Schubert<span class="command">   [<B>-c</B> <I>cache</I><B>_</B><I>name]</I>   </span>
24*7f2fe78bSCy Schubert
25*7f2fe78bSCy Schubert</td>
26*7f2fe78bSCy Schubert</tr>
27*7f2fe78bSCy Schubert</table>
28*7f2fe78bSCy Schubert
29*7f2fe78bSCy Schubert
30*7f2fe78bSCy Schubert<H2>DESCRIPTION</H2>
31*7f2fe78bSCy Schubert<p>
32*7f2fe78bSCy SchubertThe  <I>kdestroy</I> utility destroys the user's active Kerberos
33*7f2fe78bSCy Schubertauthorization tickets by writing zeros to the specified
34*7f2fe78bSCy Schubertcredentials cache  that  contains  them.  If  the  credentials
35*7f2fe78bSCy Schubertcache is not specified, the default credentials cache is
36*7f2fe78bSCy Schubertdestroyed.
37*7f2fe78bSCy Schubert</P>
38*7f2fe78bSCy Schubert
39*7f2fe78bSCy Schubert<H2>OPTIONS</H2>
40*7f2fe78bSCy Schubert<table>
41*7f2fe78bSCy Schubert<tr>
42*7f2fe78bSCy Schubert<th id="th2"><span class="command"> -A </span>  </th>
43*7f2fe78bSCy Schubert<td>Destroys all caches in the collection, if a cache collection  is available. </td>
44*7f2fe78bSCy Schubert<tr>
45*7f2fe78bSCy Schubert<th id="th2"><span class="command"> -q </span></th>
46*7f2fe78bSCy Schubert<td>Run quietly.  Normally <B>kdestroy</B> beeps if it fails to destroy the user's tickets.   The  <B>-q</B>  flag  suppresses  this behavior.
47*7f2fe78bSCy Schubert</td>
48*7f2fe78bSCy Schubert<tr>
49*7f2fe78bSCy Schubert<th id="th2"> <span class="command"> -c</B=th> <I>cache</I><B>_</B><I>name</I></span></th>
50*7f2fe78bSCy Schubert<td>Use  <span class="command"><I>cache</I><B>_</B><I>name</I></span> as the credentials (ticket) cache name and location; if this option is not used, the  default  cache  name  and location are used.<br>
51*7f2fe78bSCy SchubertThe  default credentials cache may vary between systems.  If the KRB5CCNAME environment variable is set, its  value  is  used  to
52*7f2fe78bSCy Schubertname the default ticket cache.
53*7f2fe78bSCy Schubert</td>
54*7f2fe78bSCy Schubert</tr>
55*7f2fe78bSCy Schubert</table>
56*7f2fe78bSCy Schubert<p>
57*7f2fe78bSCy Schubert Most  installations  recommend  that  you place the <I>kdestroy</I> command
58*7f2fe78bSCy Schubertin  your <I>.logout</I> file, so that your  tickets  are  destroyed  automatically
59*7f2fe78bSCy Schubertwhen you log out.
60*7f2fe78bSCy Schubert</p>
61*7f2fe78bSCy Schubert
62*7f2fe78bSCy Schubert<H2>ENVIRONMENT</H2>
63*7f2fe78bSCy Schubert<p>
64*7f2fe78bSCy Schubert<B>Kdestroy</B> uses the following environment variables:</p>
65*7f2fe78bSCy Schubert
66*7f2fe78bSCy Schubert<table>
67*7f2fe78bSCy Schubert<tr>
68*7f2fe78bSCy Schubert<th id="th2"> KRB5CCNAME</th>
69*7f2fe78bSCy Schubert<td>      Location of the default Kerberos 5 credentials (ticket)
70*7f2fe78bSCy Schubert                       cache, in the form <I>type</I>:<I>residual</I>.  If no type prefix is
71*7f2fe78bSCy Schubert                       present,  the  <B>FILE</B>  type  is assumed.  The type of the
72*7f2fe78bSCy Schubert                       default cache may determine the availability of a cache
73*7f2fe78bSCy Schubert                       collection;  for  instance, a default cache of type <B>DIR</B>
74*7f2fe78bSCy Schubert                       causes caches within the directory to be present in the
75*7f2fe78bSCy Schubert                       collection. </td>
76*7f2fe78bSCy Schubert</tr>
77*7f2fe78bSCy Schubert</table>
78*7f2fe78bSCy Schubert
79*7f2fe78bSCy Schubert
80*7f2fe78bSCy Schubert
81*7f2fe78bSCy Schubert<H2>FILES</H2>
82*7f2fe78bSCy Schubert<table>
83*7f2fe78bSCy Schubert<tr>
84*7f2fe78bSCy Schubert  <th id="th2">     <span class="command">   /tmp/krb5cc_[uid]  </span></th>
85*7f2fe78bSCy Schubert<td>       default  location  of  Kerberos  5 credentials cache ([uid] is the decimal UID of the user). </td></tr>
86*7f2fe78bSCy Schubert
87*7f2fe78bSCy Schubert</table>
88*7f2fe78bSCy Schubert
89*7f2fe78bSCy Schubert
90*7f2fe78bSCy Schubert<H2>SEE ALSO</H2>
91*7f2fe78bSCy Schubert<ul id="helpul">
92*7f2fe78bSCy Schubert<li><a href="HTML/KINIT.htm"><B>kinit(1)</B></a> </li>
93*7f2fe78bSCy Schubert<li> <a href="HTML/KLIST.htm"><B>klist(1)</B></a></li>
94*7f2fe78bSCy Schubert<li><B>krb5(3)</B></li>
95*7f2fe78bSCy Schubert</ul>
96*7f2fe78bSCy Schubert
97*7f2fe78bSCy Schubert<H2>BUGS</H2><P>
98*7f2fe78bSCy SchubertOnly the tickets in the  specified  credentials  cache  are  destroyed.
99*7f2fe78bSCy SchubertSeparate  ticket  caches  are  used  to hold root instance and password
100*7f2fe78bSCy Schubertchanging tickets.  These should probably be destroyed too, or all of  a
101*7f2fe78bSCy Schubertuser's tickets kept in a single credentials cache.
102*7f2fe78bSCy Schubert
103*7f2fe78bSCy Schubert</P>
104*7f2fe78bSCy Schubert
105*7f2fe78bSCy Schubert
106*7f2fe78bSCy Schubert
107*7f2fe78bSCy Schubert</BODY>
108*7f2fe78bSCy Schubert</HTML>
109