This commit was generated by cvs2svn to track changes on a CVS vendor
[unix-history] / kerberosIV / man / kdestroy.1
CommitLineData
fdf53e02
GW
1.\" $Source: /mit/kerberos/src/man/RCS/kdestroy.1,v $
2.\" $Author: jtkohl $
3.\" $Header: kdestroy.1,v 4.9 89/01/23 11:39:50 jtkohl Exp $
4.\" Copyright 1989 by the Massachusetts Institute of Technology.
5.\"
6.\" For copying and distribution information,
7.\" please see the file <mit-copyright.h>.
8.\"
9.TH KDESTROY 1 "Kerberos Version 4.0" "MIT Project Athena"
10.SH NAME
11kdestroy \- destroy Kerberos tickets
12.SH SYNOPSIS
13.B kdestroy
14[
15.B \-f
16]
17[
18.B \-q
19]
20.SH DESCRIPTION
21The
22.I kdestroy
23utility destroys the user's active
24Kerberos
25authorization tickets by writing zeros to the file that contains them.
26If the ticket file does not exist,
27.I kdestroy
28displays a message to that effect.
29.PP
30After overwriting the file,
31.I kdestroy
32removes the file from the system.
33The utility
34displays a message indicating the success or failure of the
35operation.
36If
37.I kdestroy
38is unable to destroy the ticket file,
39the utility will warn you by making your terminal beep.
40.PP
41In the Athena workstation environment,
42the
43.I toehold
44service automatically destroys your tickets when you
45end a workstation session.
46If your site does not provide a similar ticket-destroying mechanism,
47you can place the
48.I kdestroy
49command in your
50.I .logout
51file so that your tickets are destroyed automatically
52when you logout.
53.PP
54The options to
55.I kdestroy
56are as follows:
57.TP 7
58.B \-f
59.I kdestroy
60runs without displaying the status message.
61.TP
62.B \-q
63.I kdestroy
64will not make your terminal beep if it fails to destroy the tickets.
65.SH FILES
66KRBTKFILE environment variable if set, otherwise
67.br
68/tmp/tkt[uid]
69.SH SEE ALSO
70kerberos(1), kinit(1), klist(1)
71.SH BUGS
72.PP
73Only the tickets in the user's current ticket file are destroyed.
74Separate ticket files are used to hold root instance and password
75changing tickets. These files should probably be destroyed too, or
76all of a user's tickets kept in a single ticket file.
77.SH AUTHORS
78Steve Miller, MIT Project Athena/Digital Equipment Corporation
79.br
80Clifford Neuman, MIT Project Athena
81.br
82Bill Sommerfeld, MIT Project Athena