share/man/man1/klist.1

   1 '\" te
   2 .\" Copyright 1987, 1989 by the Student Information Processing Board of the Massachusetts Institute of Technology.  For copying and distribution information,  please see the file kerberosv5/mit-sipb-copyright.h.
   3 .\" Portions Copyright (c) 2004, Sun Microsystems, Inc.  All Rights Reserved
   4 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   5 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   6 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   7 .TH KLIST 1 "Nov 16, 2006"
   8 .SH NAME
   9 klist \- list currently held Kerberos tickets
  10 .SH SYNOPSIS
  11 .LP
  12 .nf
  13 \fB/usr/bin/klist\fR [\fB-e\fR]
  14      [ [\fB-c\fR] [\fB-f\fR] [\fB-s\fR] [\fB-a\fR [\fB-n\fR]] [\fIcache_name\fR]]
  15      [\fB-k\fR [\fB-t\fR] [\fB-K\fR] [\fIkeytab_file\fR]]
  16 .fi
  17
  18 .SH DESCRIPTION
  19 .sp
  20 .LP
  21 The \fBklist\fR utility prints the name of the credentials cache, the identity
  22 of the principal that the tickets are for (as listed in the ticket file), and
  23 the principal names of all Kerberos tickets currently held by the user, along
  24 with the issue and expiration time for each authenticator. Principal names are
  25 listed in the form \fIname\fR\fB/\fR\fIinstance\fR\fB@\fR\fIrealm\fR, with
  26 the '\fB/\fR' omitted if the instance is not included, and the '\fB@\fR' omitted if
  27 the realm is  not included.
  28 .sp
  29 .LP
  30 If \fIcache_file\fR or \fIkeytab_name\fR is not specified, \fBklist\fR displays
  31 the credentials in the default credentials cache or keytab files as
  32 appropriate. By default, your ticket is stored in the file
  33 \fB/tmp/krb5cc_\fIuid\fR\fR, where \fIuid\fR is the current user-ID of the
  34 user.
  35 .SH OPTIONS
  36 .sp
  37 .LP
  38 The following options are supported:
  39 .sp
  40 .ne 2
  41 .na
  42 \fB\fB-a\fR\fR
  43 .ad
  44 .RS 20n
  45 Displays list of addresses in credentials. Uses the configured nameservice to
  46 translate numeric network addresses to the associated hostname if possible.
  47 .RE
  48
  49 .sp
  50 .ne 2
  51 .na
  52 \fB\fB-c\fR [\fIcache_name\fR]\fR
  53 .ad
  54 .RS 20n
  55 Lists tickets held in a credentials cache. This is the default if neither
  56 \fB-c\fR nor \fB-k\fR is specified.
  57 .RE
  58
  59 .sp
  60 .ne 2
  61 .na
  62 \fB\fB-e\fR\fR
  63 .ad
  64 .RS 20n
  65 Displays the encryption types of the session key and the ticket for each
  66 credential in the credential cache, or each key in the keytab file.
  67 .RE
  68
  69 .sp
  70 .ne 2
  71 .na
  72 \fB\fB-f\fR\fR
  73 .ad
  74 .RS 20n
  75 Shows the flags present in the credentials, using the following abbreviations:
  76 .sp
  77 .ne 2
  78 .na
  79 \fBa\fR
  80 .ad
  81 .RS 5n
  82 Anonymous
  83 .RE
  84
  85 .sp
  86 .ne 2
  87 .na
  88 \fBA\fR
  89 .ad
  90 .RS 5n
  91 Pre-authenticated
  92 .RE
  93
  94 .sp
  95 .ne 2
  96 .na
  97 \fBd\fR
  98 .ad
  99 .RS 5n
 100 Post-dated
 101 .RE
 102
 103 .sp
 104 .ne 2
 105 .na
 106 \fBD\fR
 107 .ad
 108 .RS 5n
 109 Post-dateable
 110 .RE
 111
 112 .sp
 113 .ne 2
 114 .na
 115 \fBf\fR
 116 .ad
 117 .RS 5n
 118 Forwarded
 119 .RE
 120
 121 .sp
 122 .ne 2
 123 .na
 124 \fBF\fR
 125 .ad
 126 .RS 5n
 127 Forwardable
 128 .RE
 129
 130 .sp
 131 .ne 2
 132 .na
 133 \fBH\fR
 134 .ad
 135 .RS 5n
 136 Hardware authenticated
 137 .RE
 138
 139 .sp
 140 .ne 2
 141 .na
 142 \fBi\fR
 143 .ad
 144 .RS 5n
 145 Invalid
 146 .RE
 147
 148 .sp
 149 .ne 2
 150 .na
 151 \fBI\fR
 152 .ad
 153 .RS 5n
 154 Initial
 155 .RE
 156
 157 .sp
 158 .ne 2
 159 .na
 160 \fBO\fR
 161 .ad
 162 .RS 5n
 163 Okay as delegate
 164 .RE
 165
 166 .sp
 167 .ne 2
 168 .na
 169 \fBp\fR
 170 .ad
 171 .RS 5n
 172 Proxy
 173 .RE
 174
 175 .sp
 176 .ne 2
 177 .na
 178 \fBP\fR
 179 .ad
 180 .RS 5n
 181 Proxiable
 182 .RE
 183
 184 .sp
 185 .ne 2
 186 .na
 187 \fBR\fR
 188 .ad
 189 .RS 5n
 190 Renewable
 191 .RE
 192
 193 .sp
 194 .ne 2
 195 .na
 196 \fBT\fR
 197 .ad
 198 .RS 5n
 199 Transit policy checked
 200 .RE
 201
 202 .RE
 203
 204 .sp
 205 .ne 2
 206 .na
 207 \fB\fB-k\fR [\fIkeytab_file\fR]\fR
 208 .ad
 209 .RS 20n
 210 List keys held in a \fBkeytab\fR file.
 211 .RE
 212
 213 .sp
 214 .ne 2
 215 .na
 216 \fB\fB-K\fR\fR
 217 .ad
 218 .RS 20n
 219 Displays the value of the encryption key in each keytab entry in the keytab
 220 file.
 221 .RE
 222
 223 .sp
 224 .ne 2
 225 .na
 226 \fB\fB-n\fR\fR
 227 .ad
 228 .RS 20n
 229 Shows numeric \fBIP\fR addresses instead of reverse-resolving addresses. Only
 230 valid with \fB-a\fR option.
 231 .RE
 232
 233 .sp
 234 .ne 2
 235 .na
 236 \fB\fB-s\fR\fR
 237 .ad
 238 .RS 20n
 239 Causes \fBklist\fR to run silently (produce no output), but to still set the
 240 exit status according to whether it finds the credentials cache. The exit
 241 status is \fB0\fR if \fBklist\fR finds a credentials cache, and `\fB1\fRif it
 242 does not, or if the local-realm TGT has expired.
 243 .RE
 244
 245 .sp
 246 .ne 2
 247 .na
 248 \fB\fB-t\fR\fR
 249 .ad
 250 .RS 20n
 251 Displays the time entry timestamps for each keytab entry in the keytab file.
 252 .RE
 253
 254 .SH ENVIRONMENT VARIABLES
 255 .sp
 256 .LP
 257 \fBklist\fR uses the following environment variable:
 258 .sp
 259 .ne 2
 260 .na
 261 \fB\fBKRB5CCNAME\fR\fR
 262 .ad
 263 .RS 14n
 264 Location of the credentials (ticket) cache. See \fBkrb5envvar\fR(5) for syntax
 265 and details.
 266 .RE
 267
 268 .SH FILES
 269 .sp
 270 .ne 2
 271 .na
 272 \fB\fB/tmp/krb5cc_\fIuid\fR\fR\fR
 273 .ad
 274 .RS 25n
 275 Default credentials cache (\fIuid\fR is the decimal \fBUID\fR of the user).
 276 .RE
 277
 278 .sp
 279 .ne 2
 280 .na
 281 \fB\fB/etc/krb5/krb5.keytab\fR\fR
 282 .ad
 283 .RS 25n
 284 Default location for the local host's \fBkeytab\fR file.
 285 .RE
 286
 287 .sp
 288 .ne 2
 289 .na
 290 \fB\fB/etc/krb5/krb5.conf\fR\fR
 291 .ad
 292 .RS 25n
 293 Default location for the local host's configuration file. See
 294 \fBkrb5.conf\fR(4).
 295 .RE
 296
 297 .SH ATTRIBUTES
 298 .sp
 299 .LP
 300 See \fBattributes\fR(5) for descriptions of the following attributes:
 301 .sp
 302
 303 .sp
 304 .TS
 305 box;
 306 c | c
 307 l | l .
 308 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 309 _
 310 Interface Stability     See below.
 311 .TE
 312
 313 .sp
 314 .LP
 315 The command arguments are Evolving. The command output is Unstable.
 316 .SH SEE ALSO
 317 .sp
 318 .LP
 319 \fBkdestroy\fR(1), \fBkinit\fR(1), \fBkrb5.conf\fR(4), \fBattributes\fR(5),
 320 \fBkrb5envvar\fR(5), \fBkerberos\fR(5)
 321 .SH BUGS
 322 .sp
 323 .LP
 324 When reading a file as a service key file, very little error checking is
 325 performed.