crypto/heimdal/kuser/klist.1

   1 .\" Copyright (c) 2000 - 2002 Kungliga Tekniska Högskolan
   2 .\" (Royal Institute of Technology, Stockholm, Sweden).
   3 .\" All rights reserved.
   4 .\"
   5 .\" Redistribution and use in source and binary forms, with or without
   6 .\" modification, are permitted provided that the following conditions
   7 .\" are met:
   8 .\"
   9 .\" 1. Redistributions of source code must retain the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer.
  11 .\"
  12 .\" 2. Redistributions in binary form must reproduce the above copyright
  13 .\"    notice, this list of conditions and the following disclaimer in the
  14 .\"    documentation and/or other materials provided with the distribution.
  15 .\"
  16 .\" 3. Neither the name of the Institute nor the names of its contributors
  17 .\"    may be used to endorse or promote products derived from this software
  18 .\"    without specific prior written permission.
  19 .\"
  20 .\" THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
  21 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  22 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  23 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
  24 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  25 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  26 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  27 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  28 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  29 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  30 .\" SUCH DAMAGE.
  31 .\"
  32 .\" $Id: klist.1,v 1.12 2003/02/16 21:10:26 lha Exp $
  33 .\"
  34 .Dd July 8, 2000
  35 .Dt KLIST 1
  36 .Os HEIMDAL
  37 .Sh NAME
  38 .Nm klist
  39 .Nd list Kerberos credentials
  40 .Sh SYNOPSIS
  41 .Nm
  42 .Oo Fl c Ar cache \*(Ba Xo
  43 .Fl -cache= Ns Ar cache
  44 .Xc
  45 .Oc
  46 .Op Fl s | Fl t | Fl -test
  47 .Op Fl 4 | Fl -v4
  48 .Op Fl T | Fl -tokens
  49 .Op Fl 5 | Fl -v5
  50 .Op Fl v | Fl -verbose
  51 .Op Fl f
  52 .Op Fl -version
  53 .Op Fl -help
  54 .Sh DESCRIPTION
  55 .Nm
  56 reads and displays the current tickets in the crential cache (also
  57 known as the ticket file).
  58 .Pp
  59 Options supported:
  60 .Bl -tag -width Ds
  61 .It Xo
  62 .Fl c Ar cache ,
  63 .Fl -cache= Ns Ar cache
  64 .Xc
  65 credentials cache to list
  66 .It Xo
  67 .Fl s ,
  68 .Fl t ,
  69 .Fl -test
  70 .Xc
  71 Test for there being an active and valid TGT for the local realm of
  72 the user in the credential cache.
  73 .It Xo
  74 .Fl 4 ,
  75 .Fl -v4
  76 .Xc
  77 display v4 tickets
  78 .It Xo
  79 .Fl T ,
  80 .Fl -tokens
  81 .Xc
  82 display AFS tokens
  83 .It Xo
  84 .Fl 5 ,
  85 .Fl -v5
  86 .Xc
  87 display v5 cred cache (this is the default)
  88 .It Fl f
  89 Include ticket flags in short form, each charcted stands for a
  90 specific flag, as follows:
  91 .Bl -tag -width  XXX -compact -offset indent
  92 .It F
  93 forwardable
  94 .It f
  95 forwarded
  96 .It P
  97 proxiable
  98 .It p
  99 proxied
 100 .It D
 101 postdate-able
 102 .It d
 103 postdated
 104 .It R
 105 renewable
 106 .It I
 107 initial
 108 .It i
 109 invalid
 110 .It A
 111 pre-authenticated
 112 .It H
 113 hardware authenticated
 114 .El
 115 .Pp
 116 This information is also output with the
 117 .Fl -verbose
 118 option, but in a more verbose way.
 119 .It Xo
 120 .Fl v ,
 121 .Fl -verbose
 122 .Xc
 123 Verbose output. Include all possible information:
 124 .Bl -tag -width XXXX -offset indent
 125 .It Server
 126 the princial the ticket is for
 127 .It Ticket etype
 128 the encryption type use in the ticket, followed by the key version of
 129 the ticket, if it is available
 130 .It Session key
 131 the encryption type of the session key, if it's different from the
 132 encryption type of the ticket
 133 .It Auth time
 134 the time the authentication exchange took place
 135 .It Start time
 136 the time that this tickets is valid from (only printed if it's
 137 different from the auth time)
 138 .It End time
 139 when the ticket expires, if it has already expired this is also noted
 140 .It Renew till
 141 the maximum possible end time of any ticket derived from this one
 142 .It Ticket flags
 143 the flags set on the ticket
 144 .It Addresses
 145 the set of addresses from which this ticket is valid
 146 .El
 147 .El
 148 .Sh SEE ALSO
 149 .Xr kdestroy 1 ,
 150 .Xr kinit 1