crypto/dist/heimdal/kuser/klist.1

   1 .\" Copyright (c) 2000 - 2005 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 .\" $Heimdal: klist.1 20458 2007-04-19 20:41:27Z lha $
  33 .\" $NetBSD: klist.1,v 1.10 2008/03/22 08:37:03 mlelstv Exp $
  34 .\"
  35 .Dd October  6, 2005
  36 .Dt KLIST 1
  37 .Os
  38 .Sh NAME
  39 .Nm klist
  40 .Nd list Kerberos credentials
  41 .Sh SYNOPSIS
  42 .Nm
  43 .Bk -words
  44 .Oo Fl c Ar cache \*(Ba Xo
  45 .Fl -cache= Ns Ar cache
  46 .Xc
  47 .Oc
  48 .Op Fl s | Fl t | Fl -test
  49 .Op Fl T | Fl -tokens
  50 .Op Fl 5 | Fl -v5
  51 .Op Fl v | Fl -verbose
  52 .Op Fl l | Fl -list-caches
  53 .Op Fl f
  54 .Op Fl -version
  55 .Op Fl -help
  56 .Ek
  57 .Sh DESCRIPTION
  58 .Nm
  59 reads and displays the current tickets in the credential cache (also
  60 known as the ticket file).
  61 .Pp
  62 Options supported:
  63 .Bl -tag -width Ds
  64 .It Fl c Ar cache , Fl -cache= Ns Ar cache
  65 credential cache to list
  66 .It Fl s , Fl t , Fl -test
  67 Test for there being an active and valid TGT for the local realm of
  68 the user in the credential cache.
  69 .It Fl T , Fl -tokens
  70 display AFS tokens
  71 .It Fl 5 , Fl -v5
  72 display v5 cred cache (this is the default)
  73 .It Fl f
  74 Include ticket flags in short form, each character stands for a
  75 specific flag, as follows:
  76 .Bl -tag -width  XXX -compact -offset indent
  77 .It F
  78 forwardable
  79 .It f
  80 forwarded
  81 .It P
  82 proxiable
  83 .It p
  84 proxied
  85 .It D
  86 postdate-able
  87 .It d
  88 postdated
  89 .It R
  90 renewable
  91 .It I
  92 initial
  93 .It i
  94 invalid
  95 .It A
  96 pre-authenticated
  97 .It H
  98 hardware authenticated
  99 .El
 100 .Pp
 101 This information is also output with the
 102 .Fl -verbose
 103 option, but in a more verbose way.
 104 .It Fl v , Fl -verbose
 105 Verbose output. Include all possible information:
 106 .Bl -tag -width XXXX -offset indent
 107 .It Server
 108 the principal the ticket is for
 109 .It Ticket etype
 110 the encryption type used in the ticket, followed by the key version of
 111 the ticket, if it is available
 112 .It Session key
 113 the encryption type of the session key, if it's different from the
 114 encryption type of the ticket
 115 .It Auth time
 116 the time the authentication exchange took place
 117 .It Start time
 118 the time that this ticket is valid from (only printed if it's
 119 different from the auth time)
 120 .It End time
 121 when the ticket expires, if it has already expired this is also noted
 122 .It Renew till
 123 the maximum possible end time of any ticket derived from this one
 124 .It Ticket flags
 125 the flags set on the ticket
 126 .It Addresses
 127 the set of addresses from which this ticket is valid
 128 .El
 129 .It Fl l , Fl -list-caches
 130 List the credential caches for the current users, not all cache types
 131 supports listing multiple caches.
 132 .Pp
 133 .El
 134 .Sh SEE ALSO
 135 .Xr kdestroy 1 ,
 136 .Xr kinit 1