crypto/kerberosIV/man/kdestroy.1

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