crypto/kerberosIV/man/klist.1

   1 .\" $Id: klist.1,v 1.2 1996/06/12 21:29:19 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 KLIST 1 "Kerberos Version 4.0" "MIT Project Athena"
   8 .SH NAME
   9 klist \- list currently held Kerberos tickets
  10 .SH SYNOPSIS
  11 .B klist
  12 [
  13 \fB\-s \fR|\fB \-t\fR
  14 ] [
  15 .B \-file
  16 name ] [
  17 .B \-srvtab
  18 ]
  19 .br
  20 .SH DESCRIPTION
  21 .I klist
  22 prints the name of the tickets file and the
  23 identity of the principal the tickets are for (as listed in the
  24 tickets file), and
  25 lists the principal names of all Kerberos tickets currently held by
  26 the user, along with the issue and expire time for each authenticator.
  27 Principal names are listed in the form
  28 .I name.instance@realm,
  29 with the '.' omitted if the instance is null,
  30 and the '@' omitted if the realm is null.
  31
  32 If given the
  33 .B \-s
  34 option,
  35 .I klist
  36 does not print the issue and expire times, the name of the tickets file,
  37 or the identity of the principal.
  38
  39 If given the
  40 .B \-t
  41 option,
  42 .B klist
  43 checks for the existence of a non-expired ticket-granting-ticket in the
  44 ticket file.  If one is present, it exits with status 0, else it exits
  45 with status 1.  No output is generated when this option is specified.
  46
  47 If given the
  48 .B \-file
  49 option, the following argument is used as the ticket file.
  50 Otherwise, if the
  51 .B KRBTKFILE
  52 environment variable is set, it is used.
  53 If this environment variable
  54 is not set, the file
  55 .B /tmp/tkt[uid]
  56 is used, where
  57 .B uid
  58 is the current user-id of the user.
  59
  60 If given the
  61 .B \-srvtab
  62 option, the file is treated as a service key file, and the names of the
  63 keys contained therein are printed.  If no file is
  64 specified with a
  65 .B \-file
  66 option, the default is
  67 .IR /etc/srvtab .
  68 .SH FILES
  69 .TP 2i
  70 /etc/krb.conf
  71 to get the name of the local realm
  72 .TP
  73 /tmp/tkt[uid]
  74 as the default ticket file ([uid] is the decimal UID of the user).
  75 .TP
  76 /etc/srvtab
  77 as the default service key file
  78 .SH SEE ALSO
  79 .PP
  80 kerberos(1), kinit(1), kdestroy(1)
  81 .SH BUGS
  82 When reading a file as a service key file, very little sanity or error
  83 checking is performed.